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.
85 lines
2.5 KiB
TypeScript
85 lines
2.5 KiB
TypeScript
import type { Token } from './cst';
|
|
/**
|
|
* A YAML concrete syntax tree (CST) parser
|
|
*
|
|
* ```ts
|
|
* const src: string = ...
|
|
* for (const token of new Parser().parse(src)) {
|
|
* // token: Token
|
|
* }
|
|
* ```
|
|
*
|
|
* To use the parser with a user-provided lexer:
|
|
*
|
|
* ```ts
|
|
* function* parse(source: string, lexer: Lexer) {
|
|
* const parser = new Parser()
|
|
* for (const lexeme of lexer.lex(source))
|
|
* yield* parser.next(lexeme)
|
|
* yield* parser.end()
|
|
* }
|
|
*
|
|
* const src: string = ...
|
|
* const lexer = new Lexer()
|
|
* for (const token of parse(src, lexer)) {
|
|
* // token: Token
|
|
* }
|
|
* ```
|
|
*/
|
|
export declare class Parser {
|
|
private onNewLine?;
|
|
/** If true, space and sequence indicators count as indentation */
|
|
private atNewLine;
|
|
/** If true, next token is a scalar value */
|
|
private atScalar;
|
|
/** Current indentation level */
|
|
private indent;
|
|
/** Current offset since the start of parsing */
|
|
offset: number;
|
|
/** On the same line with a block map key */
|
|
private onKeyLine;
|
|
/** Top indicates the node that's currently being built */
|
|
stack: Token[];
|
|
/** The source of the current token, set in parse() */
|
|
private source;
|
|
/** The type of the current token, set in parse() */
|
|
private type;
|
|
/**
|
|
* @param onNewLine - If defined, called separately with the start position of
|
|
* each new line (in `parse()`, including the start of input).
|
|
*/
|
|
constructor(onNewLine?: (offset: number) => void);
|
|
/**
|
|
* Parse `source` as a YAML stream.
|
|
* If `incomplete`, a part of the last line may be left as a buffer for the next call.
|
|
*
|
|
* Errors are not thrown, but yielded as `{ type: 'error', message }` tokens.
|
|
*
|
|
* @returns A generator of tokens representing each directive, document, and other structure.
|
|
*/
|
|
parse(source: string, incomplete?: boolean): Generator<Token, void>;
|
|
/**
|
|
* Advance the parser by the `source` of one lexical token.
|
|
*/
|
|
next(source: string): Generator<Token, void>;
|
|
private lexer;
|
|
/** Call at end of input to push out any remaining constructions */
|
|
end(): Generator<Token, void>;
|
|
private get sourceToken();
|
|
private step;
|
|
private peek;
|
|
private pop;
|
|
private stream;
|
|
private document;
|
|
private scalar;
|
|
private blockScalar;
|
|
private blockMap;
|
|
private blockSequence;
|
|
private flowCollection;
|
|
private flowScalar;
|
|
private startBlockValue;
|
|
private atIndentedComment;
|
|
private documentEnd;
|
|
private lineEnd;
|
|
}
|