dtoro
d4d99a7473
Problem: the hexagonal refactor churns the backend tree for nine more phases; the UI delivery stack (web/ SPA, cmd/desktop Wails wrapper, compose/web image) must move to its own repo first so doc/layout rewrites land once on a backend-only tree. Change: - New repo git.hubris.network/dtoro/oikos-web (v0.33.0): web/, desktop/ (updateURL repointed to oikos-web releases), compose/, own CI (web + desktop jobs), own deploy script (CI-green gate, TOCTOU guard, version-tagged images, prune-to-3), own webhook receiver on :9798 + launchd unit, own compose project publishing the same 8091:80. - Cutover executed on mac-mini in order: oikos stack's web service stopped+removed, oikos-web project brought up on 8091; outer Caddy untouched (targets the published port) — serving + Authentik flow + /wails 404 quirk verified post-cutover. - Stripped from oikos: web/, cmd/desktop/, compose/web/, desktop CI workflow, ci.yml web job, Makefile ui/desktop/desktop-package/install targets, the compose web service, oikos-web from deploy.sh's fallback prune list; wails + go-keyring dropped from go.mod, vendor synced. - README / CONTRIBUTING / AGENTS.md / .agents dev+operations docs now point at the new repo; mbse + mascot design docs carry a path note. Risk: production SPA serving depends on the new pipeline now; rollback is versioned-image re-up of the old web service from a pre-split checkout (port 8091). Desktop builds installed before the split still check dtoro/oikos releases — one manual reinstall, noted in the oikos-web release notes. Verification: go vet, make test (race), make generate-check, golangci (no new findings; baseline down 400→365); post-cutover curls — localhost:8091 200, /wails/runtime.js 404, outer Caddy 302 Authentik.
115 lines
3.3 KiB
TypeScript
115 lines
3.3 KiB
TypeScript
import Document from './document.js'
|
||
import LazyResult from './lazy-result.js'
|
||
import NoWorkResult from './no-work-result.js'
|
||
import {
|
||
AcceptedPlugin,
|
||
Plugin,
|
||
ProcessOptions,
|
||
TransformCallback,
|
||
Transformer
|
||
} from './postcss.js'
|
||
import Result from './result.js'
|
||
import Root from './root.js'
|
||
|
||
declare namespace Processor {
|
||
export { Processor_ as default }
|
||
}
|
||
|
||
/**
|
||
* Contains plugins to process CSS. Create one `Processor` instance,
|
||
* initialize its plugins, and then use that instance on numerous CSS files.
|
||
*
|
||
* ```js
|
||
* const processor = postcss([autoprefixer, postcssNested])
|
||
* processor.process(css1).then(result => console.log(result.css))
|
||
* processor.process(css2).then(result => console.log(result.css))
|
||
* ```
|
||
*/
|
||
declare class Processor_ {
|
||
/**
|
||
* Plugins added to this processor.
|
||
*
|
||
* ```js
|
||
* const processor = postcss([autoprefixer, postcssNested])
|
||
* processor.plugins.length //=> 2
|
||
* ```
|
||
*/
|
||
plugins: (Plugin | TransformCallback | Transformer)[]
|
||
|
||
/**
|
||
* Current PostCSS version.
|
||
*
|
||
* ```js
|
||
* if (result.processor.version.split('.')[0] !== '6') {
|
||
* throw new Error('This plugin works only with PostCSS 6')
|
||
* }
|
||
* ```
|
||
*/
|
||
version: string
|
||
|
||
/**
|
||
* @param plugins PostCSS plugins
|
||
*/
|
||
constructor(plugins?: readonly AcceptedPlugin[])
|
||
|
||
/**
|
||
* Parses source CSS and returns a `LazyResult` Promise proxy.
|
||
* Because some plugins can be asynchronous it doesn’t make
|
||
* any transformations. Transformations will be applied
|
||
* in the `LazyResult` methods.
|
||
*
|
||
* ```js
|
||
* processor.process(css, { from: 'a.css', to: 'a.out.css' })
|
||
* .then(result => {
|
||
* console.log(result.css)
|
||
* })
|
||
* ```
|
||
*
|
||
* @param css String with input CSS or any object with a `toString()` method,
|
||
* like a Buffer. Optionally, send a `Result` instance
|
||
* and the processor will take the `Root` from it.
|
||
* @param opts Options.
|
||
* @return Promise proxy.
|
||
*/
|
||
process(
|
||
css: { toString(): string } | LazyResult | Result | Root | string
|
||
): LazyResult | NoWorkResult
|
||
process<RootNode extends Document | Root = Root>(
|
||
css: { toString(): string } | LazyResult | Result | Root | string,
|
||
options: ProcessOptions<RootNode>
|
||
): LazyResult<RootNode>
|
||
|
||
/**
|
||
* Adds a plugin to be used as a CSS processor.
|
||
*
|
||
* PostCSS plugin can be in 4 formats:
|
||
* * A plugin in `Plugin` format.
|
||
* * A plugin creator function with `pluginCreator.postcss = true`.
|
||
* PostCSS will call this function without argument to get plugin.
|
||
* * A function. PostCSS will pass the function a {@link Root}
|
||
* as the first argument and current `Result` instance
|
||
* as the second.
|
||
* * Another `Processor` instance. PostCSS will copy plugins
|
||
* from that instance into this one.
|
||
*
|
||
* Plugins can also be added by passing them as arguments when creating
|
||
* a `postcss` instance (see [`postcss(plugins)`]).
|
||
*
|
||
* Asynchronous plugins should return a `Promise` instance.
|
||
*
|
||
* ```js
|
||
* const processor = postcss()
|
||
* .use(autoprefixer)
|
||
* .use(postcssNested)
|
||
* ```
|
||
*
|
||
* @param plugin PostCSS plugin or `Processor` with plugins.
|
||
* @return Current processor to make methods chain.
|
||
*/
|
||
use(plugin: AcceptedPlugin): this
|
||
}
|
||
|
||
declare class Processor extends Processor_ {}
|
||
|
||
export = Processor
|