labre-mcp 0.1.0

package/dist/lib/owm/owm-dsl.mjs

@@ -0,0 +1,330 @@
+// fallow-ignore-file unused-export
+// The OWM DSL kit is intentionally over-published as a complete emit-helper
+// surface; future emit strategies will pick the subset they need. Trim with
+// care — these are reference primitives consumed in stages (emit-owm now,
+// climate/doctrine emitters later).
+//
+// Shared catalog of OWM (onlinewardleymaps.com) DSL commands.
+//
+// Single source of truth for emitting OWM syntax across the codebase.
+// Grammar mirrors the reference parsers in damonsk/onlinewardleymaps under
+// frontend/src/conversion/*ExtractionStrategy.ts.
+//
+// Two surfaces:
+//   1. Pure `emit*` helpers for composing OWM lines.
+//   2. `OWM_DSL_REFERENCE` — a metadata catalog describing every command,
+//      its syntax, and a usage example. Functions that produce OWM can pick
+//      the subset of commands they need.
+// ─── Formatting primitives ──────────────────────────────────────────────────
+/** Round to 2 decimals — OWM coordinates convention. */
+export function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+/** Format a [vis, evo] coordinate pair. */
+export function fmtCoords(c) {
+    return `[${round2(c.visibility)}, ${round2(c.evolution)}]`;
+}
+/** Format a label [dx, dy] offset. */
+export function fmtLabel(l) {
+    return `[${Math.round(l.dx)}, ${Math.round(l.dy)}]`;
+}
+/** Strip embedded double quotes — OWM has no escape syntax. */
+export function safeName(name) {
+    return name.replace(/"/g, "'");
+}
+/** Maximum visible label length OWM accepts (rendered text, not counting
+ *  surrounding quotes or escape sequences). */
+export const MAX_LABEL_LENGTH = 500;
+/** Word-count threshold above which a name is wrapped with quotes and
+ *  broken into two lines via `\n`. Mirrors the user-observed convention. */
+export const LINE_BREAK_WORD_THRESHOLD = 4;
+/**
+ * Format a component name for use in OWM declarations and links. The same
+ * formatted output MUST be reused in both places (declaration line and
+ * `A->B` lines) so the OWM parser can match them.
+ *
+ * Rules:
+ *  - 0..N words ≤ threshold → bare name (multi-word names with spaces are
+ *    valid OWM identifiers; the parser reads up to the trailing `[`).
+ *  - words > threshold → wrap in double quotes and insert ` \n ` after
+ *    the `Math.ceil(n/2)`-th word so the rendered label breaks cleanly.
+ *  - Throws when the visible label would exceed MAX_LABEL_LENGTH.
+ */
+export function formatComponentName(name, opts = {}) {
+    const cleaned = safeName(name).trim();
+    if (cleaned.length === 0)
+        return '"Component"';
+    if (cleaned.length > MAX_LABEL_LENGTH) {
+        throw new Error(`OWM label exceeds ${MAX_LABEL_LENGTH} characters (got ${cleaned.length}): ${cleaned.slice(0, 60)}…`);
+    }
+    const words = cleaned.split(/\s+/);
+    const threshold = opts.wordThreshold ?? LINE_BREAK_WORD_THRESHOLD;
+    const shouldBreak = opts.forceLineBreak === true || words.length > threshold;
+    if (!shouldBreak)
+        return cleaned;
+    const breakIdx = Math.ceil(words.length / 2);
+    const head = words.slice(0, breakIdx).join(' ');
+    const tail = words.slice(breakIdx).join(' ');
+    return `"${head} \\n ${tail}"`;
+}
+// ─── Commands ───────────────────────────────────────────────────────────────
+/** `title <text>` — first non-comment line idiomatically. */
+export function emitTitle(text) {
+    return `title ${text.trim()}`;
+}
+/** `anchor <name> [vis, evo]` — stakeholder beneficiary. */
+export function emitAnchor(name, coords, label) {
+    const base = `anchor ${formatComponentName(name)} ${fmtCoords(coords)}`;
+    return label ? `${base} label ${fmtLabel(label)}` : base;
+}
+/** `component <name> [vis, evo] label [dx, dy]` */
+export function emitComponent(name, coords, label) {
+    const base = `component ${formatComponentName(name)} ${fmtCoords(coords)}`;
+    return label ? `${base} label ${fmtLabel(label)}` : base;
+}
+/** `market <name> [vis, evo] label [dx, dy]` */
+export function emitMarket(name, coords, label) {
+    const base = `market ${formatComponentName(name)} ${fmtCoords(coords)}`;
+    return label ? `${base} label ${fmtLabel(label)}` : base;
+}
+/** `ecosystem <name> [vis, evo] label [dx, dy]` */
+export function emitEcosystem(name, coords, label) {
+    const base = `ecosystem ${formatComponentName(name)} ${fmtCoords(coords)}`;
+    return label ? `${base} label ${fmtLabel(label)}` : base;
+}
+/** `pipeline <name> [evo_min, evo_max]` (one-line form). */
+export function emitPipelineLine(name, evoMin, evoMax) {
+    return `pipeline ${formatComponentName(name)} [${round2(evoMin)}, ${round2(evoMax)}]`;
+}
+/**
+ * `pipeline <name> { … }` block form. Inner lines should be `component …`
+ * declarations produced separately and joined here.
+ */
+export function emitPipelineBlock(name, innerLines) {
+    const opener = `pipeline ${formatComponentName(name)}`;
+    const body = innerLines.map(l => `    ${l}`).join('\n');
+    return `${opener}\n{\n${body}\n}`;
+}
+/** `evolve <name> <new_evo> label [dx, dy]` */
+export function emitEvolve(name, newEvolution, label) {
+    const base = `evolve ${formatComponentName(name)} ${round2(newEvolution)}`;
+    return label ? `${base} label ${fmtLabel(label)}` : base;
+}
+/** `note <text> [vis, evo]` */
+export function emitNote(text, coords) {
+    return `note ${text} ${fmtCoords(coords)}`;
+}
+/** `annotation <num> [vis, evo] <text>` */
+export function emitAnnotation(num, coords, text) {
+    return `annotation ${num} ${fmtCoords(coords)} ${text}`;
+}
+/** `annotations [vis, evo]` — placement of the legend block. */
+export function emitAnnotationsLegend(coords) {
+    return `annotations ${fmtCoords(coords)}`;
+}
+/** `url <name> <link>` */
+export function emitUrl(name, link) {
+    return `url ${safeName(name)} ${link}`;
+}
+/** `style <name>` */
+export function emitStyle(style) {
+    return `style ${style}`;
+}
+/** `size [w, h]` */
+export function emitSize(size) {
+    return `size [${Math.round(size.width)}, ${Math.round(size.height)}]`;
+}
+/** `evolution <l1> -> <l2> -> <l3> -> <l4>` — X-axis labels. */
+export function emitEvolutionAxis(labels) {
+    return `evolution ${labels.join(' -> ')}`;
+}
+/** `submap <name> [vis, evo] url(<ref>) label [dx, dy]` */
+export function emitSubmap(name, coords, urlRef, label) {
+    const base = `submap ${safeName(name)} ${fmtCoords(coords)} url(${urlRef})`;
+    return label ? `${base} label ${fmtLabel(label)}` : base;
+}
+export function emitMethod(method, name) {
+    return `${method} ${safeName(name)}`;
+}
+export function emitAttitude(kind, coords, size) {
+    return `${kind} ${fmtCoords(coords)} [${Math.round(size.width)}, ${Math.round(size.height)}]`;
+}
+/** `accelerator <name> [vis, evo]` (or `deaccelerator`). */
+export function emitAccelerator(name, coords, decel = false) {
+    const kw = decel ? 'deaccelerator' : 'accelerator';
+    return `${kw} ${safeName(name)} ${fmtCoords(coords)}`;
+}
+// ─── Links ───────────────────────────────────────────────────────────────────
+/** Default flow link `A->B` (A consumes B). */
+export function emitLink(from, to, context) {
+    const base = `${formatComponentName(from)}->${formatComponentName(to)}`;
+    return context ? `${base} ; ${context}` : base;
+}
+/** Future flow link `A+>B`. */
+export function emitLinkFuture(from, to, context) {
+    const base = `${formatComponentName(from)}+>${formatComponentName(to)}`;
+    return context ? `${base} ; ${context}` : base;
+}
+/** Past flow link `A+<B`. */
+export function emitLinkPast(from, to, context) {
+    const base = `${formatComponentName(from)}+<${formatComponentName(to)}`;
+    return context ? `${base} ; ${context}` : base;
+}
+/** Past + future flow link `A+<>B`. */
+export function emitLinkBoth(from, to, context) {
+    const base = `${formatComponentName(from)}+<>${formatComponentName(to)}`;
+    return context ? `${base} ; ${context}` : base;
+}
+/** Named flow `A+'label'>B` (and variants). */
+export function emitLinkNamed(from, to, label, variant = 'future', context) {
+    const arrow = variant === 'future' ? "'>" : variant === 'past' ? "'<" : "'<>";
+    const base = `${formatComponentName(from)}+'${label}${arrow}${formatComponentName(to)}`;
+    return context ? `${base} ; ${context}` : base;
+}
+/** OWM line-comment. */
+export function emitComment(text) {
+    return `// ${text}`;
+}
+export const OWM_DSL_REFERENCE = Object.freeze({
+    title: {
+        keyword: 'title',
+        description: 'Map title displayed at the top of the canvas.',
+        syntax: 'title <text>',
+        example: 'title Value chain of an online payment provider',
+        parser: 'TitleExtractionStrategy',
+    },
+    anchor: {
+        keyword: 'anchor',
+        description: 'Stakeholder beneficiary at the root of the value chain. Rendered with anchor-specific styling.',
+        syntax: 'anchor <name> [vis, evo]',
+        example: 'anchor Merchant [0.95, 0.5]',
+        parser: 'AnchorExtractionStrategy',
+    },
+    component: {
+        keyword: 'component',
+        description: 'Standard component (activity, practice, knowledge, data) with a 2D position and optional label offset.',
+        syntax: 'component <name> [vis, evo] label [dx, dy]',
+        example: 'component Payment Gateway [0.5, 0.6] label [-40, 5]',
+        parser: 'ComponentExtractionStrategy',
+    },
+    pipeline: {
+        keyword: 'pipeline',
+        description: 'Wraps multiple components serving the same capability across evolution stages. One-line form pins the X range; block form `pipeline X { … }` lists inner components.',
+        syntax: 'pipeline <name> [evo_min, evo_max]    OR    pipeline <name> { component … }',
+        example: 'pipeline "Container Orchestration" [0.4, 0.78]',
+        parser: 'PipelineExtractionStrategy',
+    },
+    evolve: {
+        keyword: 'evolve',
+        description: 'Evolution trajectory of a component over time — emits an arrow on the map.',
+        syntax: 'evolve <name> <new_evolution> label [dx, dy]',
+        example: 'evolve Kubernetes 0.85 label [10, 5]',
+        parser: 'EvolveExtractionStrategy',
+    },
+    market: {
+        keyword: 'market',
+        description: 'Competitive crossroad where multiple providers compete.',
+        syntax: 'market <name> [vis, evo] label [dx, dy]',
+        example: 'market Cloud [0.4, 0.7] label [10, 5]',
+        parser: 'MarketExtractionStrategy',
+    },
+    ecosystem: {
+        keyword: 'ecosystem',
+        description: 'Interconnected system of components — rendered with ecosystem styling.',
+        syntax: 'ecosystem <name> [vis, evo] label [dx, dy]',
+        example: 'ecosystem AppStore [0.6, 0.65]',
+        parser: 'EcosystemExtractionStrategy',
+    },
+    submap: {
+        keyword: 'submap',
+        description: 'Reference to another map embedded as a node.',
+        syntax: 'submap <name> [vis, evo] url(<ref>) label [dx, dy]',
+        example: 'submap Logistics [0.5, 0.5] url(https://...)',
+        parser: 'SubMapExtractionStrategy',
+    },
+    note: {
+        keyword: 'note',
+        description: 'Free-text annotation placed on the canvas.',
+        syntax: 'note <text> [vis, evo]',
+        example: 'note "key insight here" [0.2, 0.6]',
+        parser: 'NoteExtractionStrategy',
+    },
+    annotation: {
+        keyword: 'annotation',
+        description: 'Numbered annotation referenced from a legend; pair with `annotations [vis, evo]` to position the legend.',
+        syntax: 'annotation <num> [vis, evo] <text>',
+        example: 'annotation 1 [0.5, 0.4] First milestone',
+        parser: 'AnnotationExtractionStrategy',
+    },
+    url: {
+        keyword: 'url',
+        description: 'Hyperlink attached to a named resource. Used by submap, etc.',
+        syntax: 'url <name> <link>',
+        example: 'url logistics https://example.com/logistics',
+        parser: 'UrlExtractionStrategy',
+    },
+    style: {
+        keyword: 'style',
+        description: 'Map rendering style. One of: plain | wardley | handwritten | colour | dark.',
+        syntax: 'style <name>',
+        example: 'style plain',
+        parser: 'PresentationExtractionStrategy',
+    },
+    size: {
+        keyword: 'size',
+        description: 'Canvas dimensions in pixels.',
+        syntax: 'size [w, h]',
+        example: 'size [1200, 800]',
+        parser: 'PresentationExtractionStrategy',
+    },
+    evolution: {
+        keyword: 'evolution',
+        description: 'X-axis labels (4 phases). Default OWM labels: Genesis -> Custom-Built -> Product -> Commodity.',
+        syntax: 'evolution <l1> -> <l2> -> <l3> -> <l4>',
+        example: 'evolution Genesis -> Custom-Built -> Product -> Commodity',
+        parser: 'XAxisLabelsExtractionStrategy',
+    },
+    method: {
+        keyword: 'buy|build|outsource',
+        description: 'Sourcing method marker on a component.',
+        syntax: '<method> <name>',
+        example: 'buy "Card Network Access"',
+        parser: 'MethodExtractionStrategy',
+    },
+    attitude: {
+        keyword: 'pioneers|settlers|townplanners',
+        description: 'Pioneers/Settlers/Townplanners (PST) zones drawn on the canvas.',
+        syntax: '<attitude> [vis, evo] [w, h]',
+        example: 'pioneers [0.9, 0.2] [0.2, 0.2]',
+        parser: 'AttitudeExtractionStrategy',
+    },
+    accelerator: {
+        keyword: 'accelerator|deaccelerator',
+        description: 'Tempo marker indicating where adoption accelerates or stalls.',
+        syntax: 'accelerator <name> [vis, evo]',
+        example: 'accelerator AI [0.5, 0.6]',
+        parser: 'AcceleratorExtractionStrategy',
+    },
+    link: {
+        keyword: 'A->B',
+        description: 'Default flow link from A to B. A consumes B (A is positioned higher in visibility). Variants: `+>` future, `+<` past, `+<>` both, `+\'label\'>` named flow. Trailing `; <text>` adds context.',
+        syntax: '<from>-><to>    OR    <from>+><to>    etc.',
+        example: 'Merchant->Payment Gateway',
+        parser: 'LinksExtractionStrategy',
+    },
+    comment: {
+        keyword: '//',
+        description: 'Line comment ignored by the parser.',
+        syntax: '// <text>',
+        example: '// scope: payment processing',
+        parser: '(none)',
+    },
+});
+/** Default OWM evolution-axis labels (matches the OWM parser's defaults). */
+export const DEFAULT_EVOLUTION_LABELS = [
+    'Genesis',
+    'Custom-Built',
+    'Product',
+    'Commodity',
+];
+//# sourceMappingURL=owm-dsl.mjs.map

package/dist/lib/owm/owm-dsl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"owm-dsl.mjs","sourceRoot":"","sources":["../../../src/lib/owm/owm-dsl.mts"],"names":[],"mappings":"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"}

package/dist/lib/owm/render-adapter.d.mts

@@ -0,0 +1,8 @@
+export interface OwmRenderAdapter {
+    /** Render an OWM DSL string to its SVG representation. Synchronous —
+     *  cli-owm is in-process. Future async engines (e.g. Playwright)
+     *  will introduce a separate async-flavoured interface rather than
+     *  promote-everything-to-Promise here. */
+    render(dsl: string): string;
+}
+//# sourceMappingURL=render-adapter.d.mts.map

package/dist/lib/owm/render-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-adapter.d.mts","sourceRoot":"","sources":["../../../src/lib/owm/render-adapter.mts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B;;;8CAG0C;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B"}

package/dist/lib/owm/render-adapter.mjs

@@ -0,0 +1,19 @@
+// Stable contract between the chain pipeline and ANY engine that can
+// turn an OWM DSL string into a rendered SVG.
+//
+// Why an interface and not a direct call into the vendored cli-owm:
+//   - keeps `src/work-on-value-chain/` decoupled from any specific
+//     renderer ; the pipeline imports `OwmRenderAdapter`, never the
+//     vendored module.
+//   - lets us swap cli-owm for a Playwright-based engine, a future
+//     official OWM npm package, or a mock in tests, with zero ripple.
+//   - the contract is text-in / text-out (DSL → SVG) so it survives any
+//     internal refactor of the renderer.
+//
+// V1 takes no options — sizing, theming and other knobs live inside
+// the OWM DSL itself (`size [w, h]`, `style plain|wardley|...`). When
+// a future need arises (e.g. forcing a specific bbox grid for
+// regression tests), extend this interface deliberately rather than
+// surface every renderer-specific knob.
+export {};
+//# sourceMappingURL=render-adapter.mjs.map

package/dist/lib/owm/render-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-adapter.mjs","sourceRoot":"","sources":["../../../src/lib/owm/render-adapter.mts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,8CAA8C;AAC9C,EAAE;AACF,oEAAoE;AACpE,mEAAmE;AACnE,oEAAoE;AACpE,uBAAuB;AACvB,mEAAmE;AACnE,sEAAsE;AACtE,wEAAwE;AACxE,yCAAyC;AACzC,EAAE;AACF,oEAAoE;AACpE,sEAAsE;AACtE,8DAA8D;AAC9D,oEAAoE;AACpE,wCAAwC"}

package/dist/lib/owm/svg-bbox-parser.d.mts

@@ -0,0 +1,77 @@
+/** Pixel-space rectangle, axis-aligned. (x, y) is the top-left corner. */
+export interface Bbox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type GeometryKind = 'component' | 'label' | 'anchor';
+export interface GeometryItem {
+    name: string;
+    kind: GeometryKind;
+    bbox: Bbox;
+}
+export type GeometryReport = GeometryItem[];
+/** A dependency line `from`→`to` rendered as a `<line>` between the
+ *  centres of the two components. Endpoints are matched by coordinate
+ *  to known component circles (or anchor text positions). */
+export interface EdgeSegment {
+    from: string;
+    to: string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/** Outer canvas dimensions of the SVG (root `<svg width height>`). When
+ *  the renderer omits these attributes, both fields are 0 and callers
+ *  should treat canvas-overflow as undecidable. */
+export interface Canvas {
+    width: number;
+    height: number;
+}
+/** Aggregate geometry returned by `parseSvgGeometry`. */
+export interface SvgGeometry {
+    items: GeometryReport;
+    edges: EdgeSegment[];
+    canvas: Canvas;
+    /** The visible map drawing area inside the SVG, captured from
+     *  `<rect id="fillArea">`. Falls back to `(0, 0, canvas.width,
+     *  canvas.height)` if cli-owm omits the rect. Used by the phase-axis
+     *  computation. */
+    mapArea: Bbox;
+    /** Pixel X coordinates of the OWM phase boundaries (Genesis|Custom,
+     *  Custom|Product, Product|Commodity) inside `mapArea`. Three
+     *  entries when the map area is known, empty array otherwise. */
+    phaseAxes: number[];
+}
+/** Approximate pixel width of one character at the cli-owm default 14px
+ *  font (Helvetica Neue / Arial). Empirical, slightly over-estimates. */
+export declare const LABEL_CHAR_WIDTH = 7;
+/** Approximate text bbox height — cap height + descent at 14px font. */
+export declare const LABEL_HEIGHT = 16;
+/** Default `r` attribute used by cli-owm for component circles. */
+export declare const COMPONENT_RADIUS = 5;
+/** Tolerance (px) used when matching `<line>` endpoints to known
+ *  component centres. cli-owm emits coordinates with floating-point
+ *  rounding noise (e.g. `30.00000000000003`), so an exact match would
+ *  miss legitimate edges. */
+export declare const ENDPOINT_MATCH_TOLERANCE = 0.5;
+/** Phase boundary ratios inside the visible map area, matching the
+ *  OWM canonical Genesis|Custom-Built|Product|Commodity divisions
+ *  (verified by inspection of cli-owm's `<g id="valueChain">` 2026-05-06). */
+export declare const PHASE_AXIS_RATIOS: ReadonlyArray<number>;
+/**
+ * Parse a cli-owm SVG into a flat geometry report plus its edges and
+ * canvas dimensions. Only elements whose text content is in
+ * `knownNames` survive the filter — this is by design (see file-level
+ * comment).
+ */
+export declare function parseSvgGeometry(svg: string, knownNames: ReadonlySet<string>): SvgGeometry;
+/**
+ * Backward-compatible alias for the V2 API. Equivalent to
+ * `parseSvgGeometry(...).items`. Existing callers that only need
+ * rect-rect collision detection keep working unchanged.
+ */
+export declare function parseSvgToBboxes(svg: string, knownNames: ReadonlySet<string>): GeometryReport;
+//# sourceMappingURL=svg-bbox-parser.d.mts.map

package/dist/lib/owm/svg-bbox-parser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-bbox-parser.d.mts","sourceRoot":"","sources":["../../../src/lib/owm/svg-bbox-parser.mts"],"names":[],"mappings":"AA0BA,0EAA0E;AAC1E,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,EAAE,CAAC;AAE5C;;6DAE6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;mDAEmD;AACnD,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf;;;uBAGmB;IACnB,OAAO,EAAE,IAAI,CAAC;IACd;;qEAEiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAID;yEACyE;AACzE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,wEAAwE;AACxE,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC;;;6BAG6B;AAC7B,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;8EAE8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAuB,CAAC;AAiO5E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,WAAW,CAOb;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,cAAc,CAEhB"}