@tscaps/engine 0.1.1

package/dist/modules/svg-filter/SvgFilterScopeProvider.d.ts

@@ -0,0 +1,52 @@
+import type { SvgFilterScope } from '../svg-filter/SvgFilterScope';
+/**
+ * Frame-level context the renderer passes when resolving the
+ * variable scope a filter materializes against. Carries the timestamp
+ * being rendered and the height of the render target in user-space
+ * px; the renderer adds its own render-time variables (video frame,
+ * dimensions) on top of the returned scope before passing it to
+ * `SvgFilter.materialize`.
+ *
+ * `renderHeightPx` is the height of the render target in px. The same
+ * content is rendered into targets of different heights, so
+ * font/viewport-relative filter lengths must be resolved against it
+ * per render — see `SvgFilterLengthResolver`.
+ */
+export interface SvgFilterRenderContext {
+    readonly currentTime: number;
+    readonly renderHeightPx: number;
+}
+/**
+ * Multipliers that convert font/viewport-relative lengths to
+ * user-space px for one render context. `SvgFilterLengthResolver`
+ * applies them to `em` / `cqh` tokens in a materialized filter body.
+ */
+export interface SvgFilterLengthFactors {
+    /** User-space px for one `em` at the resolved font-size. */
+    readonly pxPerEm: number;
+    /** User-space px for one `cqh` (1% of the render target height). */
+    readonly pxPerCqh: number;
+}
+/**
+ * Strategy that resolves the variable scope for one render context.
+ * The renderer invokes `scopeAt` once per output tile.
+ *
+ * Implementations whose scope does not depend on the context return
+ * the same scope on every call. Implementations whose scope varies
+ * with `currentTime` (typically deriving integer ticks from it)
+ * return a scope whose entries change per call.
+ *
+ * `lengthFactorsAt` supplies the px-per-`em` / px-per-`cqh`
+ * multipliers for the same context. SVG filter primitive attributes
+ * (`radius`, `stdDeviation`, `dx`, …) accept neither relative units
+ * nor `calc()`, so a filter that must track text size is authored in
+ * `em`/`cqh` and resolved to px at render time. The px-per-`em`
+ * factor depends on the consumer's font-size, which the engine does
+ * not know — hence it comes from the provider, while the engine
+ * supplies only the render height via the context.
+ */
+export interface SvgFilterScopeProvider {
+    scopeAt(context: SvgFilterRenderContext): SvgFilterScope;
+    lengthFactorsAt(context: SvgFilterRenderContext): SvgFilterLengthFactors;
+}
+//# sourceMappingURL=SvgFilterScopeProvider.d.ts.map

package/dist/modules/svg-filter/SvgFilterScopeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterScopeProvider.d.ts","sourceRoot":"","sources":["../../../src/modules/svg-filter/SvgFilterScopeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAAC;IACzD,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,sBAAsB,CAAC;CAC1E"}

package/dist/modules/svg-filter/SvgFilterScopeProvider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SvgFilterScopeProvider.js.map

package/dist/modules/svg-filter/SvgFilterScopeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterScopeProvider.js","sourceRoot":"","sources":["../../../src/modules/svg-filter/SvgFilterScopeProvider.ts"],"names":[],"mappings":""}

package/dist/modules/svg-filter/SvgFilterScoper.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Output of `SvgFilterScoper.rewriteCss`. The stylesheet with every
+ * `url(#localId)` filter reference replaced by a CSS-variable
+ * indirection, plus the set of local ids that were rewritten — the
+ * caller must bind each one on an element that contains the
+ * filtered descendants.
+ */
+export interface CssRewriteResult {
+    readonly css: string;
+    readonly localIds: ReadonlySet<string>;
+}
+/**
+ * Output of `SvgFilterScoper.scopeIds`. `idByLocal` maps each local
+ * id to its scoped counterpart (the value to emit inside
+ * `<filter id="…">` in the SVG defs block). `bindings` maps each
+ * CSS variable name to the `url(#scopedId)` expression to splice
+ * into a wrapper element's inline style.
+ */
+export interface IdScopeResult {
+    readonly idByLocal: ReadonlyMap<string, string>;
+    readonly bindings: ReadonlyMap<string, string>;
+}
+/**
+ * Generates a unique namespace for a set of `<filter>` ids and pairs
+ * those scoped ids with the CSS variables that consuming elements
+ * use to reach them. The same scheme rewrites the stylesheet's
+ * `url(#id)` references so the binding chain is closed.
+ *
+ * The indirection is what lets independent filter sets coexist in
+ * the same SVG document without id collisions, and what makes
+ * per-tile filters compatible with stylesheets that animate
+ * `filter:` via `@keyframes`: an inline style cannot override an
+ * active animation value, but it CAN supply the variable the
+ * animation references, which is resolved per element through
+ * ordinary CSS variable inheritance.
+ *
+ * Only the top-level `<filter>` ids are rewritten. The SVG filter
+ * primitive id space (`in`, `result`, `feMergeNode in=...`) is local
+ * to each `<filter>` element and is left untouched.
+ */
+export declare class SvgFilterScoper {
+    /**
+     * Replaces every `url(#localId)` reference in the stylesheet with
+     * `var(--svg-filter-<localId>)`. The local ids that were
+     * encountered are returned so the caller knows which variables a
+     * consuming element must bind. Refs that point at an id the
+     * caller never binds resolve to the empty filter list at render
+     * time — equivalent to no filter.
+     */
+    rewriteCss(css: string): CssRewriteResult;
+    /**
+     * Generates a scoped id for each local id under `scopeKey` and
+     * returns the inline-style bindings that wire each
+     * `--svg-filter-<localId>` to its scoped URL. `scopeKey` must be
+     * unique among coexisting filter sets in the same SVG document.
+     */
+    scopeIds(localIds: Iterable<string>, scopeKey: string): IdScopeResult;
+    private bindingVarName;
+}
+//# sourceMappingURL=SvgFilterScoper.d.ts.map

package/dist/modules/svg-filter/SvgFilterScoper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterScoper.d.ts","sourceRoot":"","sources":["../../../src/modules/svg-filter/SvgFilterScoper.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAC1B;;;;;;;OAOG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;IASzC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa;IAWrE,OAAO,CAAC,cAAc;CAGvB"}

package/dist/modules/svg-filter/SvgFilterScoper.js

@@ -0,0 +1,58 @@
+const FILTER_URL_REF_RE = /url\(\s*(['"]?)#([a-zA-Z0-9_-]+)\1\s*\)/g;
+const BINDING_VAR_PREFIX = '--svg-filter-';
+/**
+ * Generates a unique namespace for a set of `<filter>` ids and pairs
+ * those scoped ids with the CSS variables that consuming elements
+ * use to reach them. The same scheme rewrites the stylesheet's
+ * `url(#id)` references so the binding chain is closed.
+ *
+ * The indirection is what lets independent filter sets coexist in
+ * the same SVG document without id collisions, and what makes
+ * per-tile filters compatible with stylesheets that animate
+ * `filter:` via `@keyframes`: an inline style cannot override an
+ * active animation value, but it CAN supply the variable the
+ * animation references, which is resolved per element through
+ * ordinary CSS variable inheritance.
+ *
+ * Only the top-level `<filter>` ids are rewritten. The SVG filter
+ * primitive id space (`in`, `result`, `feMergeNode in=...`) is local
+ * to each `<filter>` element and is left untouched.
+ */
+export class SvgFilterScoper {
+    /**
+     * Replaces every `url(#localId)` reference in the stylesheet with
+     * `var(--svg-filter-<localId>)`. The local ids that were
+     * encountered are returned so the caller knows which variables a
+     * consuming element must bind. Refs that point at an id the
+     * caller never binds resolve to the empty filter list at render
+     * time — equivalent to no filter.
+     */
+    rewriteCss(css) {
+        const localIds = new Set();
+        const rewritten = css.replace(FILTER_URL_REF_RE, (_match, _quote, id) => {
+            localIds.add(id);
+            return `var(${this.bindingVarName(id)})`;
+        });
+        return { css: rewritten, localIds };
+    }
+    /**
+     * Generates a scoped id for each local id under `scopeKey` and
+     * returns the inline-style bindings that wire each
+     * `--svg-filter-<localId>` to its scoped URL. `scopeKey` must be
+     * unique among coexisting filter sets in the same SVG document.
+     */
+    scopeIds(localIds, scopeKey) {
+        const idByLocal = new Map();
+        const bindings = new Map();
+        for (const localId of localIds) {
+            const scopedId = `tscaps-filter-${scopeKey}-${localId}`;
+            idByLocal.set(localId, scopedId);
+            bindings.set(this.bindingVarName(localId), `url(#${scopedId})`);
+        }
+        return { idByLocal, bindings };
+    }
+    bindingVarName(localId) {
+        return `${BINDING_VAR_PREFIX}${localId}`;
+    }
+}
+//# sourceMappingURL=SvgFilterScoper.js.map

package/dist/modules/svg-filter/SvgFilterScoper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterScoper.js","sourceRoot":"","sources":["../../../src/modules/svg-filter/SvgFilterScoper.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,0CAA0C,CAAC;AAErE,MAAM,kBAAkB,GAAG,eAAe,CAAC;AA0B3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;;;;OAOG;IACH,UAAU,CAAC,GAAW;QACpB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE;YACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjB,OAAO,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC;QAC3C,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAA0B,EAAE,QAAgB;QACnD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,iBAAiB,QAAQ,IAAI,OAAO,EAAE,CAAC;YACxD,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,QAAQ,QAAQ,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;IAEO,cAAc,CAAC,OAAe;QACpC,OAAO,GAAG,kBAAkB,GAAG,OAAO,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/modules/svg-filter/index.d.ts

@@ -0,0 +1,10 @@
+export { SvgFilter } from '../svg-filter/SvgFilter';
+export { SvgFilterDefinitions } from '../svg-filter/SvgFilterDefinitions';
+export { SvgFilterDefinitionsParser } from '../svg-filter/SvgFilterDefinitionsParser';
+export { SvgFilterScope } from '../svg-filter/SvgFilterScope';
+export { SvgFilterBundle } from '../svg-filter/SvgFilterBundle';
+export { SvgFilterScoper } from '../svg-filter/SvgFilterScoper';
+export { SvgFilterLengthResolver } from '../svg-filter/SvgFilterLengthResolver';
+export type { CssRewriteResult, IdScopeResult } from '../svg-filter/SvgFilterScoper';
+export type { SvgFilterScopeProvider, SvgFilterRenderContext, SvgFilterLengthFactors } from '../svg-filter/SvgFilterScopeProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/svg-filter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/svg-filter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAC3F,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/modules/svg-filter/index.js

@@ -0,0 +1,8 @@
+export { SvgFilter } from '../svg-filter/SvgFilter';
+export { SvgFilterDefinitions } from '../svg-filter/SvgFilterDefinitions';
+export { SvgFilterDefinitionsParser } from '../svg-filter/SvgFilterDefinitionsParser';
+export { SvgFilterScope } from '../svg-filter/SvgFilterScope';
+export { SvgFilterBundle } from '../svg-filter/SvgFilterBundle';
+export { SvgFilterScoper } from '../svg-filter/SvgFilterScoper';
+export { SvgFilterLengthResolver } from '../svg-filter/SvgFilterLengthResolver';
+//# sourceMappingURL=index.js.map

package/dist/modules/svg-filter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/svg-filter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/modules/tagging/RegexTagger.d.ts

@@ -0,0 +1,11 @@
+import { Tagger } from '../tagging/Tagger';
+import { Document } from '../document/Document';
+export declare class RegexTagger extends Tagger {
+    private readonly tagName;
+    private readonly regex;
+    constructor(tagName: string, pattern: string | RegExp, flags?: string);
+    tag(document: Document): Document;
+    private tagSegment;
+    private tagLine;
+}
+//# sourceMappingURL=RegexTagger.d.ts.map

package/dist/modules/tagging/RegexTagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegexTagger.d.ts","sourceRoot":"","sources":["../../../src/modules/tagging/RegexTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAMtD,qBAAa,WAAY,SAAQ,MAAM;IAInC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAGZ,OAAO,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,KAAK,CAAC,EAAE,MAAM;IAOhB,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAOjC,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,OAAO;CAQhB"}

package/dist/modules/tagging/RegexTagger.js

@@ -0,0 +1,32 @@
+import { Tagger } from '../tagging/Tagger';
+import { Line } from '../document/Line';
+import { Tag } from '../document/Tag';
+// Tags words whose text matches a given regular expression.
+export class RegexTagger extends Tagger {
+    tagName;
+    regex;
+    constructor(tagName, pattern, flags) {
+        super();
+        this.tagName = tagName;
+        this.regex =
+            pattern instanceof RegExp ? pattern : new RegExp(pattern, flags ?? 'i');
+    }
+    tag(document) {
+        const sections = document.sections.map((section) => section.with({ segments: section.segments.map((segment) => this.tagSegment(segment)) }));
+        return document.with({ sections });
+    }
+    tagSegment(segment) {
+        const lines = segment.lines.map((line) => this.tagLine(line));
+        return segment.with({ lines });
+    }
+    tagLine(line) {
+        const words = line.words.map((word) => {
+            if (!this.regex.test(word.text))
+                return word;
+            const newSemanticTags = new Set([...word.semanticTags, Tag.of(this.tagName)]);
+            return word.with({ semanticTags: newSemanticTags });
+        });
+        return new Line({ words, structureTags: line.structureTags });
+    }
+}
+//# sourceMappingURL=RegexTagger.js.map

package/dist/modules/tagging/RegexTagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegexTagger.js","sourceRoot":"","sources":["../../../src/modules/tagging/RegexTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,4DAA4D;AAC5D,MAAM,OAAO,WAAY,SAAQ,MAAM;IAIlB;IAHF,KAAK,CAAS;IAE/B,YACmB,OAAe,EAChC,OAAwB,EACxB,KAAc;QAEd,KAAK,EAAE,CAAC;QAJS,YAAO,GAAP,OAAO,CAAQ;QAKhC,IAAI,CAAC,KAAK;YACR,OAAO,YAAY,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC;IAC5E,CAAC;IAED,GAAG,CAAC,QAAkB;QACpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CACxF,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;IAEO,UAAU,CAAC,OAAgB;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,OAAO,CAAC,IAAU;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACpC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/modules/tagging/SpanTagger.d.ts

@@ -0,0 +1,25 @@
+import { Tagger } from '../tagging/Tagger';
+import { Document } from '../document/Document';
+/**
+ * Tags every word that falls inside a span delimited by two
+ * boundary patterns: one that marks the word opening the span
+ * and one that marks the word closing it. Boundary words are
+ * tagged together with everything in between, and the span
+ * propagates across line, segment, and section boundaries.
+ *
+ * A word that matches both patterns is treated as a single-word
+ * span. A span that opens but never closes within the document
+ * is discarded: no word in it gets tagged.
+ */
+export declare class SpanTagger extends Tagger {
+    private readonly tagName;
+    private readonly openPattern;
+    private readonly closePattern;
+    constructor(tagName: string, openPattern: RegExp, closePattern: RegExp);
+    tag(document: Document): Document;
+    private collectSpannedWords;
+    private rebuildDocument;
+    private rebuildLine;
+    private withTag;
+}
+//# sourceMappingURL=SpanTagger.d.ts.map

package/dist/modules/tagging/SpanTagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanTagger.d.ts","sourceRoot":"","sources":["../../../src/modules/tagging/SpanTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAKtD;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,MAAM;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM;IAKvC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAKjC,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,OAAO;CAIhB"}

package/dist/modules/tagging/SpanTagger.js

@@ -0,0 +1,73 @@
+import { Tagger } from '../tagging/Tagger';
+import { Line } from '../document/Line';
+import { Tag } from '../document/Tag';
+/**
+ * Tags every word that falls inside a span delimited by two
+ * boundary patterns: one that marks the word opening the span
+ * and one that marks the word closing it. Boundary words are
+ * tagged together with everything in between, and the span
+ * propagates across line, segment, and section boundaries.
+ *
+ * A word that matches both patterns is treated as a single-word
+ * span. A span that opens but never closes within the document
+ * is discarded: no word in it gets tagged.
+ */
+export class SpanTagger extends Tagger {
+    tagName;
+    openPattern;
+    closePattern;
+    constructor(tagName, openPattern, closePattern) {
+        super();
+        this.tagName = tagName;
+        this.openPattern = openPattern;
+        this.closePattern = closePattern;
+    }
+    tag(document) {
+        const wordsToTag = this.collectSpannedWords(document);
+        return this.rebuildDocument(document, wordsToTag);
+    }
+    collectSpannedWords(document) {
+        const tagged = new Set();
+        let currentSpan = [];
+        let isInsideSpan = false;
+        for (const word of document.getWords()) {
+            const opens = this.openPattern.test(word.text);
+            const closes = this.closePattern.test(word.text);
+            if (isInsideSpan) {
+                currentSpan.push(word);
+                if (closes) {
+                    currentSpan.forEach((spanWord) => tagged.add(spanWord));
+                    currentSpan = [];
+                    isInsideSpan = false;
+                }
+            }
+            else if (opens) {
+                currentSpan.push(word);
+                isInsideSpan = true;
+                if (closes) {
+                    currentSpan.forEach((spanWord) => tagged.add(spanWord));
+                    currentSpan = [];
+                    isInsideSpan = false;
+                }
+            }
+        }
+        return tagged;
+    }
+    rebuildDocument(document, taggedWords) {
+        const sections = document.sections.map((section) => section.with({
+            segments: section.segments.map((segment) => segment.with({
+                lines: segment.lines.map((line) => this.rebuildLine(line, taggedWords)),
+            })),
+        }));
+        return document.with({ sections });
+    }
+    rebuildLine(line, taggedWords) {
+        const words = line.words.map((word) => taggedWords.has(word) ? this.withTag(word) : word);
+        return new Line({ words, structureTags: line.structureTags, id: line.id });
+    }
+    withTag(word) {
+        const semanticTags = new Set([...word.semanticTags, Tag.of(this.tagName)]);
+        return word.with({ semanticTags });
+    }
+}
+//# sourceMappingURL=SpanTagger.js.map

package/dist/modules/tagging/SpanTagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanTagger.js","sourceRoot":"","sources":["../../../src/modules/tagging/SpanTagger.ts"],"names":[],"mappings":"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"}

package/dist/modules/tagging/StructureTagger.d.ts

@@ -0,0 +1,20 @@
+import { Tagger } from '../tagging/Tagger';
+import { Document } from '../document/Document';
+/**
+ * Assigns positional structure tags across the Document hierarchy:
+ *   - Section-level: FIRST/LAST_SECTION_IN_DOCUMENT
+ *   - Segment-level: FIRST/LAST_SEGMENT_IN_SECTION
+ *   - Line-level:    FIRST/LAST_LINE_IN_SECTION, FIRST/LAST_LINE_IN_SEGMENT
+ *   - Word-level:    FIRST/LAST_WORD_IN_SECTION, FIRST/LAST_WORD_IN_SEGMENT,
+ *                    FIRST/LAST_WORD_IN_LINE
+ *
+ * Runs once after splitting, before rendering.
+ */
+export declare class StructureTagger extends Tagger {
+    tag(document: Document): Document;
+    private tagSection;
+    private tagSegment;
+    private tagLine;
+    private tagWord;
+}
+//# sourceMappingURL=StructureTagger.d.ts.map

package/dist/modules/tagging/StructureTagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructureTagger.d.ts","sourceRoot":"","sources":["../../../src/modules/tagging/StructureTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAOtD;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IACzC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAQjC,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,OAAO;IAuBf,OAAO,CAAC,OAAO;CAqBhB"}

package/dist/modules/tagging/StructureTagger.js

@@ -0,0 +1,74 @@
+import { Tagger } from '../tagging/Tagger';
+import { Line } from '../document/Line';
+import { Tag, StructureTag } from '../document/Tag';
+/**
+ * Assigns positional structure tags across the Document hierarchy:
+ *   - Section-level: FIRST/LAST_SECTION_IN_DOCUMENT
+ *   - Segment-level: FIRST/LAST_SEGMENT_IN_SECTION
+ *   - Line-level:    FIRST/LAST_LINE_IN_SECTION, FIRST/LAST_LINE_IN_SEGMENT
+ *   - Word-level:    FIRST/LAST_WORD_IN_SECTION, FIRST/LAST_WORD_IN_SEGMENT,
+ *                    FIRST/LAST_WORD_IN_LINE
+ *
+ * Runs once after splitting, before rendering.
+ */
+export class StructureTagger extends Tagger {
+    tag(document) {
+        const sections = document.sections;
+        const taggedSections = sections.map((section, secIdx) => this.tagSection(section, secIdx, sections.length));
+        return document.with({ sections: taggedSections });
+    }
+    tagSection(section, secIdx, totalSections) {
+        const tags = new Set();
+        if (secIdx === 0)
+            tags.add(Tag.of(StructureTag.FIRST_SECTION_IN_DOCUMENT));
+        if (secIdx === totalSections - 1)
+            tags.add(Tag.of(StructureTag.LAST_SECTION_IN_DOCUMENT));
+        const sectionWords = section.getWords();
+        const sectionLines = section.getLines();
+        const taggedSegments = section.segments.map((segment, segIdx) => this.tagSegment(segment, segIdx, section.segments.length, sectionWords, sectionLines));
+        return section.with({ segments: taggedSegments, structureTags: tags });
+    }
+    tagSegment(segment, segIdx, totalSegments, sectionWords, sectionLines) {
+        const tags = new Set();
+        if (segIdx === 0)
+            tags.add(Tag.of(StructureTag.FIRST_SEGMENT_IN_SECTION));
+        if (segIdx === totalSegments - 1)
+            tags.add(Tag.of(StructureTag.LAST_SEGMENT_IN_SECTION));
+        const segmentWords = segment.getWords();
+        const taggedLines = segment.lines.map((line, lineIdx) => this.tagLine(line, lineIdx, segment.lines.length, segmentWords, sectionWords, sectionLines));
+        return segment.with({ lines: taggedLines, structureTags: tags });
+    }
+    tagLine(line, lineIdx, totalLines, segmentWords, sectionWords, sectionLines) {
+        const tags = new Set();
+        if (lineIdx === 0)
+            tags.add(Tag.of(StructureTag.FIRST_LINE_IN_SEGMENT));
+        if (lineIdx === totalLines - 1)
+            tags.add(Tag.of(StructureTag.LAST_LINE_IN_SEGMENT));
+        const sectionLineIdx = sectionLines.indexOf(line);
+        if (sectionLineIdx === 0)
+            tags.add(Tag.of(StructureTag.FIRST_LINE_IN_SECTION));
+        if (sectionLineIdx === sectionLines.length - 1)
+            tags.add(Tag.of(StructureTag.LAST_LINE_IN_SECTION));
+        const taggedWords = line.words.map((word, wordIdx) => this.tagWord(word, wordIdx, line.words.length, segmentWords, sectionWords));
+        return new Line({ words: taggedWords, structureTags: tags, id: line.id });
+    }
+    tagWord(word, wordIdx, totalInLine, segmentWords, sectionWords) {
+        const tags = new Set();
+        if (wordIdx === 0)
+            tags.add(Tag.of(StructureTag.FIRST_WORD_IN_LINE));
+        if (wordIdx === totalInLine - 1)
+            tags.add(Tag.of(StructureTag.LAST_WORD_IN_LINE));
+        const segWordIdx = segmentWords.indexOf(word);
+        if (segWordIdx === 0)
+            tags.add(Tag.of(StructureTag.FIRST_WORD_IN_SEGMENT));
+        if (segWordIdx === segmentWords.length - 1)
+            tags.add(Tag.of(StructureTag.LAST_WORD_IN_SEGMENT));
+        const sectionWordIdx = sectionWords.indexOf(word);
+        if (sectionWordIdx === 0)
+            tags.add(Tag.of(StructureTag.FIRST_WORD_IN_SECTION));
+        if (sectionWordIdx === sectionWords.length - 1)
+            tags.add(Tag.of(StructureTag.LAST_WORD_IN_SECTION));
+        return word.with({ structureTags: tags });
+    }
+}
+//# sourceMappingURL=StructureTagger.js.map

package/dist/modules/tagging/StructureTagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructureTagger.js","sourceRoot":"","sources":["../../../src/modules/tagging/StructureTagger.ts"],"names":[],"mappings":"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"}

package/dist/modules/tagging/Tagger.d.ts

@@ -0,0 +1,5 @@
+import type { Document } from '../document/index';
+export declare abstract class Tagger {
+    abstract tag(document: Document): Document;
+}
+//# sourceMappingURL=Tagger.d.ts.map

package/dist/modules/tagging/Tagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tagger.d.ts","sourceRoot":"","sources":["../../../src/modules/tagging/Tagger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAIxD,8BAAsB,MAAM;IAC1B,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;CAC3C"}

package/dist/modules/tagging/Tagger.js

@@ -0,0 +1,5 @@
+// Applies tags to elements of the Document.
+// Returns a new Document with tags applied (immutable transform).
+export class Tagger {
+}
+//# sourceMappingURL=Tagger.js.map

package/dist/modules/tagging/Tagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tagger.js","sourceRoot":"","sources":["../../../src/modules/tagging/Tagger.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,kEAAkE;AAClE,MAAM,OAAgB,MAAM;CAE3B"}

package/dist/modules/tagging/WordlistTagger.d.ts

@@ -0,0 +1,11 @@
+import { Tagger } from '../tagging/Tagger';
+import { Document } from '../document/Document';
+export declare class WordlistTagger extends Tagger {
+    private readonly tagName;
+    private readonly wordSet;
+    constructor(tagName: string, words: string[]);
+    tag(document: Document): Document;
+    private tagSegment;
+    private tagLine;
+}
+//# sourceMappingURL=WordlistTagger.d.ts.map

package/dist/modules/tagging/WordlistTagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WordlistTagger.d.ts","sourceRoot":"","sources":["../../../src/modules/tagging/WordlistTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAMtD,qBAAa,cAAe,SAAQ,MAAM;IAItC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAGnB,OAAO,EAAE,MAAM,EAChC,KAAK,EAAE,MAAM,EAAE;IAMjB,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAOjC,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,OAAO;CAQhB"}

package/dist/modules/tagging/WordlistTagger.js

@@ -0,0 +1,31 @@
+import { Tagger } from '../tagging/Tagger';
+import { Line } from '../document/Line';
+import { Tag } from '../document/Tag';
+// Tags words that appear in a predefined word list (case-insensitive).
+export class WordlistTagger extends Tagger {
+    tagName;
+    wordSet;
+    constructor(tagName, words) {
+        super();
+        this.tagName = tagName;
+        this.wordSet = new Set(words.map((w) => w.toLowerCase()));
+    }
+    tag(document) {
+        const sections = document.sections.map((section) => section.with({ segments: section.segments.map((segment) => this.tagSegment(segment)) }));
+        return document.with({ sections });
+    }
+    tagSegment(segment) {
+        const lines = segment.lines.map((line) => this.tagLine(line));
+        return segment.with({ lines });
+    }
+    tagLine(line) {
+        const words = line.words.map((word) => {
+            if (!this.wordSet.has(word.text.toLowerCase()))
+                return word;
+            const newSemanticTags = new Set([...word.semanticTags, Tag.of(this.tagName)]);
+            return word.with({ semanticTags: newSemanticTags });
+        });
+        return new Line({ words, structureTags: line.structureTags });
+    }
+}
+//# sourceMappingURL=WordlistTagger.js.map

package/dist/modules/tagging/WordlistTagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WordlistTagger.js","sourceRoot":"","sources":["../../../src/modules/tagging/WordlistTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,uEAAuE;AACvE,MAAM,OAAO,cAAe,SAAQ,MAAM;IAIrB;IAHF,OAAO,CAAc;IAEtC,YACmB,OAAe,EAChC,KAAe;QAEf,KAAK,EAAE,CAAC;QAHS,YAAO,GAAP,OAAO,CAAQ;QAIhC,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,GAAG,CAAC,QAAkB;QACpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CACxF,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;IAEO,UAAU,CAAC,OAAgB;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,OAAO,CAAC,IAAU;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACpC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/modules/tagging/index.d.ts

@@ -0,0 +1,6 @@
+export { Tagger } from '../tagging/Tagger';
+export { StructureTagger } from '../tagging/StructureTagger';
+export { RegexTagger } from '../tagging/RegexTagger';
+export { WordlistTagger } from '../tagging/WordlistTagger';
+export { SpanTagger } from '../tagging/SpanTagger';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/tagging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/tagging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/modules/tagging/index.js

@@ -0,0 +1,6 @@
+export { Tagger } from '../tagging/Tagger';
+export { StructureTagger } from '../tagging/StructureTagger';
+export { RegexTagger } from '../tagging/RegexTagger';
+export { WordlistTagger } from '../tagging/WordlistTagger';
+export { SpanTagger } from '../tagging/SpanTagger';
+//# sourceMappingURL=index.js.map

package/dist/modules/tagging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/tagging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/modules/transcription/AudioDecoder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Decodes an audio/video Blob to mono PCM at the requested sample rate.
+ * Implementations choose how to do this — using browser Web Audio APIs,
+ * a pure-JS WAV parser, or trusting a pre-decoded byte stream — so the
+ * decode strategy is decoupled from the consumer (e.g. WhisperTranscriber)
+ * and from the platform (main thread vs Worker context).
+ */
+export interface AudioDecoder {
+    decode(audio: Blob, targetSampleRate: number): Promise<Float32Array>;
+}
+//# sourceMappingURL=AudioDecoder.d.ts.map

package/dist/modules/transcription/AudioDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioDecoder.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/AudioDecoder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACtE"}

package/dist/modules/transcription/AudioDecoder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AudioDecoder.js.map

package/dist/modules/transcription/AudioDecoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioDecoder.js","sourceRoot":"","sources":["../../../src/modules/transcription/AudioDecoder.ts"],"names":[],"mappings":""}