@invinite-org/create-chartlang 0.1.1

package/dist/rewritePackageJson.js

@@ -0,0 +1,128 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { CHARTLANG_VERSIONS } from "./chartlangVersions.js";
+const WORKSPACE_RANGE = "workspace:*";
+const CHARTLANG_SCOPE = "@invinite-org/chartlang-";
+const EXAMPLE_ADAPTER_PREFIX = "chartlang-example-";
+const EXAMPLE_ADAPTER_SUFFIX = "-adapter";
+// The starter ships every adapter-matrix chart lib (echarts in deps;
+// konva/lightweight-charts/uplot in devDeps) for its in-monorepo dev setup.
+// A standalone clone needs only the chosen library, so all four are dropped
+// here; the caller re-adds the chosen one at its registry range afterwards.
+const MATRIX_CHART_LIBS = [
+    "echarts",
+    "konva",
+    "lightweight-charts",
+    "uplot",
+];
+function isExampleAdapterName(name) {
+    return name.startsWith(EXAMPLE_ADAPTER_PREFIX) && name.endsWith(EXAMPLE_ADAPTER_SUFFIX);
+}
+function resolveChartlangRange(name, bundleVersions) {
+    const fromBundle = bundleVersions[name];
+    if (fromBundle !== undefined) {
+        return fromBundle;
+    }
+    const fromManifest = CHARTLANG_VERSIONS[name];
+    if (fromManifest === undefined) {
+        throw new Error(`no published version known for "${name}" — add it to CHARTLANG_VERSIONS in create-chartlang`);
+    }
+    return fromManifest;
+}
+/**
+ * Rewrite ONE dependency block (deps or devDeps): replace every
+ * `@invinite-org/chartlang-*: workspace:*` with its published `^`-range, drop
+ * every `chartlang-example-*-adapter: workspace:*` (the chosen one is vendored
+ * locally), drop every matrix chart lib (the caller re-adds only the chosen
+ * one), and leave non-chartlang deps untouched.
+ */
+function rewriteBlock(block, bundleVersions) {
+    if (block === undefined) {
+        return undefined;
+    }
+    const out = {};
+    for (const [name, range] of Object.entries(block)) {
+        if (isExampleAdapterName(name)) {
+            // The chosen adapter is vendored; the other examples are not shipped.
+            continue;
+        }
+        if (MATRIX_CHART_LIBS.includes(name)) {
+            // Drop every matrix chart lib; the caller re-adds only the chosen one.
+            continue;
+        }
+        if (name.startsWith(CHARTLANG_SCOPE) && range === WORKSPACE_RANGE) {
+            out[name] = resolveChartlangRange(name, bundleVersions);
+            continue;
+        }
+        out[name] = range;
+    }
+    return out;
+}
+// The e2e suite (Playwright + `tests/` + `playwright.config.ts`) is stripped
+// from the clone, so its scripts + runner devDependency are dropped too —
+// they would otherwise reference deleted files.
+const E2E_SCRIPTS = ["e2e", "e2e:install"];
+const E2E_DEV_DEPS = ["@playwright/test"];
+/** Return a copy of `block` without the named keys (or `undefined` as-is). */
+function omitKeys(block, keys) {
+    if (block === undefined) {
+        return undefined;
+    }
+    const out = {};
+    for (const [name, value] of Object.entries(block)) {
+        if (keys.includes(name)) {
+            continue;
+        }
+        out[name] = value;
+    }
+    return out;
+}
+/**
+ * Rewrite the cloned starter's `package.json` for a standalone, installable
+ * project: stamp the project name, replace every `workspace:*` chartlang dep
+ * with its published `^`-range, drop the unused example-adapter deps, wire the
+ * vendored adapter as a local `file:` dep, and add the chosen chart library +
+ * range. The result contains NO `workspace:` ranges (asserted) so it resolves
+ * straight from npm.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { rewriteStarterPackageJson } from "@invinite-org/create-chartlang";
+ *     const next = rewriteStarterPackageJson({
+ *         source: '{"name":"x","dependencies":{}}',
+ *         projectName: "my-app",
+ *         libraryId: "echarts",
+ *         chartLibrary: "echarts",
+ *         chartLibraryRange: "^5",
+ *         vendoredAdapterName: "@local/echarts-adapter",
+ *         vendoredAdapterSpec: "file:./vendor/echarts-adapter",
+ *         bundleVersions: {},
+ *     });
+ *     void next;
+ */
+export function rewriteStarterPackageJson(opts) {
+    const parsed = JSON.parse(opts.source);
+    parsed.name = opts.projectName;
+    const deps = rewriteBlock(parsed.dependencies, opts.bundleVersions) ?? {};
+    parsed.dependencies = deps;
+    const devDeps = omitKeys(rewriteBlock(parsed.devDependencies, opts.bundleVersions), E2E_DEV_DEPS);
+    if (devDeps !== undefined) {
+        parsed.devDependencies = devDeps;
+    }
+    const scripts = omitKeys(parsed.scripts, E2E_SCRIPTS);
+    if (scripts !== undefined) {
+        parsed.scripts = scripts;
+    }
+    // Wire the vendored adapter + its chart library as runtime deps.
+    deps[opts.vendoredAdapterName] = opts.vendoredAdapterSpec;
+    if (opts.chartLibrary !== "") {
+        deps[opts.chartLibrary] = opts.chartLibraryRange;
+    }
+    const out = `${JSON.stringify(parsed, null, 4)}\n`;
+    if (out.includes(WORKSPACE_RANGE)) {
+        throw new Error("rewritten package.json still contains a workspace: dependency");
+    }
+    return out;
+}
+//# sourceMappingURL=rewritePackageJson.js.map

package/dist/rewritePackageJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewritePackageJson.js","sourceRoot":"","sources":["../src/rewritePackageJson.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport { CHARTLANG_VERSIONS } from \"./chartlangVersions.js\";\nimport type { SeamId } from \"./seamTemplates.js\";\n\nconst WORKSPACE_RANGE = \"workspace:*\";\nconst CHARTLANG_SCOPE = \"@invinite-org/chartlang-\";\nconst EXAMPLE_ADAPTER_PREFIX = \"chartlang-example-\";\nconst EXAMPLE_ADAPTER_SUFFIX = \"-adapter\";\n\n// The starter ships every adapter-matrix chart lib (echarts in deps;\n// konva/lightweight-charts/uplot in devDeps) for its in-monorepo dev setup.\n// A standalone clone needs only the chosen library, so all four are dropped\n// here; the caller re-adds the chosen one at its registry range afterwards.\nconst MATRIX_CHART_LIBS: ReadonlyArray<string> = [\n    \"echarts\",\n    \"konva\",\n    \"lightweight-charts\",\n    \"uplot\",\n];\n\n/**\n * Options for {@link rewriteStarterPackageJson}.\n *\n * @since 0.1\n * @stable\n * @example\n *     import type { RewriteOpts } from \"@invinite-org/create-chartlang\";\n *     declare const opts: RewriteOpts;\n *     void opts.projectName;\n */\nexport type RewriteOpts = Readonly<{\n    /** The cloned starter's raw `package.json` text. */\n    source: string;\n    /** The project name to stamp into the rewritten `package.json`. */\n    projectName: string;\n    /** The chosen chart-library adapter id. */\n    libraryId: SeamId;\n    /** The npm chart library the chosen adapter depends on (empty for canvas2d). */\n    chartLibrary: string;\n    /** The semver range for {@link chartLibrary} (from the adapter registry). */\n    chartLibraryRange: string;\n    /** The local package name the chosen adapter was vendored under. */\n    vendoredAdapterName: string;\n    /** The dependency value for the vendored adapter (e.g. `file:./vendor/echarts-adapter`). */\n    vendoredAdapterSpec: string;\n    /**\n     * Published `^`-ranges harvested from the vendored bundle's own (already\n     * generator-pinned) `package.json` deps. Preferred over the baked\n     * {@link CHARTLANG_VERSIONS} manifest for the packages it covers.\n     */\n    bundleVersions: Readonly<Record<string, string>>;\n}>;\n\ntype DepMap = Record<string, string>;\n\nfunction isExampleAdapterName(name: string): boolean {\n    return name.startsWith(EXAMPLE_ADAPTER_PREFIX) && name.endsWith(EXAMPLE_ADAPTER_SUFFIX);\n}\n\nfunction resolveChartlangRange(\n    name: string,\n    bundleVersions: Readonly<Record<string, string>>,\n): string {\n    const fromBundle = bundleVersions[name];\n    if (fromBundle !== undefined) {\n        return fromBundle;\n    }\n    const fromManifest = CHARTLANG_VERSIONS[name];\n    if (fromManifest === undefined) {\n        throw new Error(\n            `no published version known for \"${name}\" — add it to CHARTLANG_VERSIONS in create-chartlang`,\n        );\n    }\n    return fromManifest;\n}\n\n/**\n * Rewrite ONE dependency block (deps or devDeps): replace every\n * `@invinite-org/chartlang-*: workspace:*` with its published `^`-range, drop\n * every `chartlang-example-*-adapter: workspace:*` (the chosen one is vendored\n * locally), drop every matrix chart lib (the caller re-adds only the chosen\n * one), and leave non-chartlang deps untouched.\n */\nfunction rewriteBlock(\n    block: DepMap | undefined,\n    bundleVersions: Readonly<Record<string, string>>,\n): DepMap | undefined {\n    if (block === undefined) {\n        return undefined;\n    }\n    const out: DepMap = {};\n    for (const [name, range] of Object.entries(block)) {\n        if (isExampleAdapterName(name)) {\n            // The chosen adapter is vendored; the other examples are not shipped.\n            continue;\n        }\n        if (MATRIX_CHART_LIBS.includes(name)) {\n            // Drop every matrix chart lib; the caller re-adds only the chosen one.\n            continue;\n        }\n        if (name.startsWith(CHARTLANG_SCOPE) && range === WORKSPACE_RANGE) {\n            out[name] = resolveChartlangRange(name, bundleVersions);\n            continue;\n        }\n        out[name] = range;\n    }\n    return out;\n}\n\n// The e2e suite (Playwright + `tests/` + `playwright.config.ts`) is stripped\n// from the clone, so its scripts + runner devDependency are dropped too —\n// they would otherwise reference deleted files.\nconst E2E_SCRIPTS = [\"e2e\", \"e2e:install\"] as const;\nconst E2E_DEV_DEPS = [\"@playwright/test\"] as const;\n\n/** Return a copy of `block` without the named keys (or `undefined` as-is). */\nfunction omitKeys(block: DepMap | undefined, keys: ReadonlyArray<string>): DepMap | undefined {\n    if (block === undefined) {\n        return undefined;\n    }\n    const out: DepMap = {};\n    for (const [name, value] of Object.entries(block)) {\n        if (keys.includes(name)) {\n            continue;\n        }\n        out[name] = value;\n    }\n    return out;\n}\n\ntype PackageJson = {\n    name?: string;\n    scripts?: DepMap;\n    dependencies?: DepMap;\n    devDependencies?: DepMap;\n    [key: string]: unknown;\n};\n\n/**\n * Rewrite the cloned starter's `package.json` for a standalone, installable\n * project: stamp the project name, replace every `workspace:*` chartlang dep\n * with its published `^`-range, drop the unused example-adapter deps, wire the\n * vendored adapter as a local `file:` dep, and add the chosen chart library +\n * range. The result contains NO `workspace:` ranges (asserted) so it resolves\n * straight from npm.\n *\n * @since 0.1\n * @stable\n * @example\n *     import { rewriteStarterPackageJson } from \"@invinite-org/create-chartlang\";\n *     const next = rewriteStarterPackageJson({\n *         source: '{\"name\":\"x\",\"dependencies\":{}}',\n *         projectName: \"my-app\",\n *         libraryId: \"echarts\",\n *         chartLibrary: \"echarts\",\n *         chartLibraryRange: \"^5\",\n *         vendoredAdapterName: \"@local/echarts-adapter\",\n *         vendoredAdapterSpec: \"file:./vendor/echarts-adapter\",\n *         bundleVersions: {},\n *     });\n *     void next;\n */\nexport function rewriteStarterPackageJson(opts: RewriteOpts): string {\n    const parsed = JSON.parse(opts.source) as PackageJson;\n\n    parsed.name = opts.projectName;\n\n    const deps = rewriteBlock(parsed.dependencies, opts.bundleVersions) ?? {};\n    parsed.dependencies = deps;\n    const devDeps = omitKeys(\n        rewriteBlock(parsed.devDependencies, opts.bundleVersions),\n        E2E_DEV_DEPS,\n    );\n    if (devDeps !== undefined) {\n        parsed.devDependencies = devDeps;\n    }\n\n    const scripts = omitKeys(parsed.scripts, E2E_SCRIPTS);\n    if (scripts !== undefined) {\n        parsed.scripts = scripts;\n    }\n\n    // Wire the vendored adapter + its chart library as runtime deps.\n    deps[opts.vendoredAdapterName] = opts.vendoredAdapterSpec;\n    if (opts.chartLibrary !== \"\") {\n        deps[opts.chartLibrary] = opts.chartLibraryRange;\n    }\n\n    const out = `${JSON.stringify(parsed, null, 4)}\\n`;\n    if (out.includes(WORKSPACE_RANGE)) {\n        throw new Error(\"rewritten package.json still contains a workspace: dependency\");\n    }\n    return out;\n}\n"]}

package/dist/seamTemplates.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The five bundled adapter ids the installer can vendor + rewrite the seam for.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { SEAM_IDS } from "@invinite-org/create-chartlang";
+ *     for (const id of SEAM_IDS) void id;
+ */
+export declare const SEAM_IDS: readonly ["canvas2d", "lightweight-charts", "uplot", "echarts", "konva"];
+/**
+ * A bundled-adapter id the installer can rewrite the seam for (one of
+ * {@link SEAM_IDS}).
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import type { SeamId } from "@invinite-org/create-chartlang";
+ *     const id: SeamId = "echarts";
+ *     void id;
+ */
+export type SeamId = (typeof SEAM_IDS)[number];
+/**
+ * Type guard: is `value` one of the five bundled-adapter ids the installer
+ * can rewrite the seam for?
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { isSeamId } from "@invinite-org/create-chartlang";
+ *     if (isSeamId("echarts")) {
+ *         // narrowed to SeamId
+ *     }
+ */
+export declare function isSeamId(value: string): value is SeamId;
+/**
+ * Produce the `activeAdapter.ts` body the installer writes for `id`, with the
+ * example-adapter import specifier rewritten to the vendored local adapter
+ * package name. The returned string is byte-identical to
+ * `SEAM_VARIANTS[id].seamSource` after that single substitution — the parity
+ * the matrix-proven SSOT guarantees.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { seamTemplateFor } from "@invinite-org/create-chartlang";
+ *     const body = seamTemplateFor("echarts", "@local/echarts-adapter");
+ *     void body;
+ */
+export declare function seamTemplateFor(id: SeamId, adapterPkgName: string): string;
+//# sourceMappingURL=seamTemplates.d.ts.map

package/dist/seamTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seamTemplates.d.ts","sourceRoot":"","sources":["../src/seamTemplates.ts"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,0EAA2E,CAAC;AAEjG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AA+Q/C;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAEvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/seamTemplates.js

@@ -0,0 +1,318 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// SEAM TEMPLATES — the installer's emit copy of the per-library
+// `activeAdapter.ts` body. Each body MUST stay byte-identical to
+// `apps/react-starter/src/lib/chart/seamVariants.ts`'s
+// `SEAM_VARIANTS[id].seamSource` (the matrix-proven SSOT) AFTER the single
+// deterministic clone-time substitution this module applies: the package
+// name `chartlang-example-<id>-adapter` → the vendored local adapter name.
+// `seamTemplates.test.ts` clones the real starter tree and byte-diffs every
+// id against that SSOT, so the installer can never emit a seam the starter's
+// `adapter-matrix.spec.ts` never rendered.
+//
+// Edit a library's seam in `seamVariants.ts` (the app SSOT), then mirror it
+// here — the parity test fails the build until they agree.
+/**
+ * The five bundled adapter ids the installer can vendor + rewrite the seam for.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { SEAM_IDS } from "@invinite-org/create-chartlang";
+ *     for (const id of SEAM_IDS) void id;
+ */
+export const SEAM_IDS = ["canvas2d", "lightweight-charts", "uplot", "echarts", "konva"];
+const HEADER = `// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// ACTIVE CHART ADAPTER — the single point the create-chartlang installer
+// rewrites for the chosen library. Do NOT import a concrete
+// chartlang-example-*-adapter anywhere else; the rest of the app drives
+// charts through the abstract \`ActiveAdapterHandle\` + \`createActiveAdapter\`
+// + \`runActiveLoop\` exported here.
+
+import type { AlertEmission, CandleEvent } from "@invinite-org/chartlang-adapter-kit"`;
+const OPTS_TYPES = `/** Library-agnostic options ChartPane passes to {@link createActiveAdapter}. */
+export type CreateAdapterOpts = Readonly<{
+  container: HTMLElement
+  candleSource: AsyncIterable<CandleEvent>
+  interval?: string
+  onAlert?: (a: AlertEmission) => void
+}>
+
+/** Options forwarded to {@link runActiveLoop} (cancellation via \`signal\`). */
+export type RunActiveLoopOpts = Readonly<{ signal?: AbortSignal }>`;
+const CANVAS2D_SEAM = `${HEADER}
+import {
+  createCanvas2dAdapter,
+  type Canvas2dAdapterHandle,
+  runRendererLoop,
+} from "chartlang-example-canvas2d-adapter"
+
+export type ActiveAdapterHandle = Canvas2dAdapterHandle
+
+export const ACTIVE_ADAPTER_ID = "canvas2d"
+
+${OPTS_TYPES}
+
+// canvas2d paints onto a <canvas>; the seam creates one inside the generic
+// container so ChartPane only ever provides a DOM node.
+export function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {
+  const canvas = opts.container.ownerDocument.createElement("canvas")
+  canvas.width = opts.container.clientWidth || 800
+  canvas.height = opts.container.clientHeight || 480
+  opts.container.replaceChildren(canvas)
+  return createCanvas2dAdapter({
+    canvas,
+    candleSource: opts.candleSource,
+    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),
+    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),
+  })
+}
+
+export async function runActiveLoop(
+  handle: ActiveAdapterHandle,
+  opts: RunActiveLoopOpts = {},
+): Promise<void> {
+  await runRendererLoop(handle, opts)
+}
+`;
+const LWC_SEAM = `${HEADER}
+import { createChart } from "lightweight-charts"
+import {
+  createLightweightChartsAdapter,
+  type CreateLightweightChartsAdapterOpts,
+  type LwcAdapterHandle,
+  runRendererLoop,
+} from "chartlang-example-lightweight-charts-adapter"
+
+export type ActiveAdapterHandle = LwcAdapterHandle
+
+export const ACTIVE_ADAPTER_ID = "lightweight-charts"
+
+${OPTS_TYPES}
+
+// The real lightweight-charts \`IChartApi\` is wider than the slice the adapter
+// consumes (its internal \`LwcChart\`); the two do not structurally overlap for
+// TS, so go through \`unknown\` at the boundary.
+const makeChart = (el: HTMLElement) =>
+  createChart(el) as unknown as ReturnType<
+    NonNullable<CreateLightweightChartsAdapterOpts["createChart"]>
+  >
+
+export function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {
+  return createLightweightChartsAdapter({
+    container: opts.container,
+    createChart: makeChart,
+    candleSource: opts.candleSource,
+    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),
+    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),
+  })
+}
+
+export async function runActiveLoop(
+  handle: ActiveAdapterHandle,
+  opts: RunActiveLoopOpts = {},
+): Promise<void> {
+  await runRendererLoop(handle, opts)
+}
+`;
+const UPLOT_SEAM = `${HEADER}
+import "uplot/dist/uPlot.min.css"
+import {
+  createUplotAdapter,
+  type UplotAdapterHandle,
+  runUplotLoop,
+} from "chartlang-example-uplot-adapter"
+
+export type ActiveAdapterHandle = UplotAdapterHandle
+
+export const ACTIVE_ADAPTER_ID = "uplot"
+
+${OPTS_TYPES}
+
+export function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {
+  return createUplotAdapter({
+    target: opts.container,
+    width: opts.container.clientWidth || 800,
+    height: opts.container.clientHeight || 480,
+    candleSource: opts.candleSource,
+    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),
+    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),
+  })
+}
+
+export async function runActiveLoop(
+  handle: ActiveAdapterHandle,
+  opts: RunActiveLoopOpts = {},
+): Promise<void> {
+  await runUplotLoop(handle, opts)
+}
+`;
+const ECHARTS_SEAM = `${HEADER}
+import * as echarts from "echarts"
+import {
+  createEChartsAdapter,
+  type EChartsAdapterHandle,
+  type EChartsSurface,
+  runEChartsLoop,
+} from "chartlang-example-echarts-adapter"
+
+export type ActiveAdapterHandle = EChartsAdapterHandle
+
+export const ACTIVE_ADAPTER_ID = "echarts"
+
+${OPTS_TYPES}
+
+// echarts needs a DOM container + sizing it does not own, so the factory —
+// not a raw container — is the seam: this module owns the echarts.init call.
+//
+// The adapter's \`buildViewport\` treats \`convertToPixel\` as "returns undefined
+// when the chart isn't laid out yet"; the real echarts instance instead THROWS
+// before its first laid-out \`setOption\` (reading \`queryComponents\` of an
+// undefined coordinate system). Wrap it so a pre-layout call returns undefined,
+// honouring the adapter contract and letting it fall back to a deterministic
+// viewport instead of killing the render loop.
+function makeEchartsSurface(container: HTMLElement): EChartsSurface {
+  const chart = echarts.init(container)
+  return {
+    setOption: (option, setOpts) => chart.setOption(option, setOpts),
+    resize: () => chart.resize(),
+    dispose: () => chart.dispose(),
+    convertToPixel: (finder, value) => {
+      try {
+        const px = chart.convertToPixel(finder, value as unknown as number[])
+        return Array.isArray(px) ? ([px[0], px[1]] as const) : undefined
+      } catch {
+        return undefined
+      }
+    },
+  }
+}
+
+export function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {
+  return createEChartsAdapter({
+    echartsFactory: () => makeEchartsSurface(opts.container),
+    candleSource: opts.candleSource,
+    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),
+    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),
+  })
+}
+
+export async function runActiveLoop(
+  handle: ActiveAdapterHandle,
+  opts: RunActiveLoopOpts = {},
+): Promise<void> {
+  await runEChartsLoop(handle, opts)
+}
+`;
+const KONVA_SEAM = `${HEADER}
+import Konva from "konva"
+import type { RunnerEmissions } from "@invinite-org/chartlang-adapter-kit"
+import {
+  type CreateKonvaAdapterOpts,
+  createKonvaAdapter,
+  feedCandleEvent,
+  handleInterval,
+  type KonvaAdapterHandle,
+} from "chartlang-example-konva-adapter"
+
+export type ActiveAdapterHandle = KonvaAdapterHandle
+
+export const ACTIVE_ADAPTER_ID = "konva"
+
+${OPTS_TYPES}
+
+export function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {
+  const width = opts.container.clientWidth || 800
+  const height = opts.container.clientHeight || 480
+  // The Konva adapter's StageConfig omits \`container\` (it renders headlessly
+  // and lets the caller wire the DOM node), but the real Konva.Stage requires
+  // one. Inject the seam's container by subclassing Stage so the adapter's
+  // \`new konva.Stage({ width, height })\` mounts onto our DOM node. The real
+  // Konva namespace is wider than the slice the adapter consumes, so cast it
+  // to the adapter's own \`konva\` field type.
+  const konva = {
+    ...Konva,
+    Stage: class extends Konva.Stage {
+      constructor(config: { width: number; height: number }) {
+        super({ ...config, container: opts.container as HTMLDivElement })
+      }
+    },
+  } as unknown as CreateKonvaAdapterOpts["konva"]
+  return createKonvaAdapter({
+    konva,
+    stage: { width, height },
+    candleSource: opts.candleSource,
+    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),
+  })
+}
+
+// konva has no exported async loop; mirror the shared loop shape locally over
+// feedCandleEvent / handleInterval and forward alerts from each drain (its
+// factory carries no onAlert hook).
+export async function runActiveLoop(
+  handle: ActiveAdapterHandle,
+  opts: RunActiveLoopOpts = {},
+): Promise<void> {
+  const signal = opts.signal
+  const aborted = (): boolean => signal?.aborted ?? false
+  if (aborted()) return
+  for await (const event of handle.candles({ interval: handleInterval(handle) })) {
+    if (aborted()) return
+    feedCandleEvent(handle, event)
+    await handle.host.push(event)
+    if (aborted()) return
+    await new Promise<void>((r) => setTimeout(r, 0))
+    if (aborted()) return
+    const emissions: RunnerEmissions = await handle.host.drain()
+    if (aborted()) return
+    handle.onEmissions(emissions)
+  }
+}
+`;
+const SEAM_BODIES = {
+    canvas2d: CANVAS2D_SEAM,
+    "lightweight-charts": LWC_SEAM,
+    uplot: UPLOT_SEAM,
+    echarts: ECHARTS_SEAM,
+    konva: KONVA_SEAM,
+};
+/** The example-adapter package name for an id (the seam's import specifier). */
+function exampleAdapterPkg(id) {
+    return `chartlang-example-${id}-adapter`;
+}
+/**
+ * Type guard: is `value` one of the five bundled-adapter ids the installer
+ * can rewrite the seam for?
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { isSeamId } from "@invinite-org/create-chartlang";
+ *     if (isSeamId("echarts")) {
+ *         // narrowed to SeamId
+ *     }
+ */
+export function isSeamId(value) {
+    return SEAM_IDS.includes(value);
+}
+/**
+ * Produce the `activeAdapter.ts` body the installer writes for `id`, with the
+ * example-adapter import specifier rewritten to the vendored local adapter
+ * package name. The returned string is byte-identical to
+ * `SEAM_VARIANTS[id].seamSource` after that single substitution — the parity
+ * the matrix-proven SSOT guarantees.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { seamTemplateFor } from "@invinite-org/create-chartlang";
+ *     const body = seamTemplateFor("echarts", "@local/echarts-adapter");
+ *     void body;
+ */
+export function seamTemplateFor(id, adapterPkgName) {
+    return SEAM_BODIES[id].split(exampleAdapterPkg(id)).join(adapterPkgName);
+}
+//# sourceMappingURL=seamTemplates.js.map

package/dist/seamTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seamTemplates.js","sourceRoot":"","sources":["../src/seamTemplates.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,gEAAgE;AAChE,iEAAiE;AACjE,uDAAuD;AACvD,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,2DAA2D;AAE3D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAejG,MAAM,MAAM,GAAG;;;;;;;;;sFASuE,CAAC;AAEvF,MAAM,UAAU,GAAG;;;;;;;;;mEASgD,CAAC;AAEpE,MAAM,aAAa,GAAG,GAAG,MAAM;;;;;;;;;;;EAW7B,UAAU;;;;;;;;;;;;;;;;;;;;;;;CAuBX,CAAC;AAEF,MAAM,QAAQ,GAAG,GAAG,MAAM;;;;;;;;;;;;;EAaxB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BX,CAAC;AAEF,MAAM,UAAU,GAAG,GAAG,MAAM;;;;;;;;;;;;EAY1B,UAAU;;;;;;;;;;;;;;;;;;;CAmBX,CAAC;AAEF,MAAM,YAAY,GAAG,GAAG,MAAM;;;;;;;;;;;;;EAa5B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CX,CAAC;AAEF,MAAM,UAAU,GAAG,GAAG,MAAM;;;;;;;;;;;;;;;EAe1B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDX,CAAC;AAEF,MAAM,WAAW,GAAqC;IAClD,QAAQ,EAAE,aAAa;IACvB,oBAAoB,EAAE,QAAQ;IAC9B,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,UAAU;CACpB,CAAC;AAEF,gFAAgF;AAChF,SAAS,iBAAiB,CAAC,EAAU;IACjC,OAAO,qBAAqB,EAAE,UAAU,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IAClC,OAAQ,QAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,cAAsB;IAC9D,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n//\n// SEAM TEMPLATES — the installer's emit copy of the per-library\n// `activeAdapter.ts` body. Each body MUST stay byte-identical to\n// `apps/react-starter/src/lib/chart/seamVariants.ts`'s\n// `SEAM_VARIANTS[id].seamSource` (the matrix-proven SSOT) AFTER the single\n// deterministic clone-time substitution this module applies: the package\n// name `chartlang-example-<id>-adapter` → the vendored local adapter name.\n// `seamTemplates.test.ts` clones the real starter tree and byte-diffs every\n// id against that SSOT, so the installer can never emit a seam the starter's\n// `adapter-matrix.spec.ts` never rendered.\n//\n// Edit a library's seam in `seamVariants.ts` (the app SSOT), then mirror it\n// here — the parity test fails the build until they agree.\n\n/**\n * The five bundled adapter ids the installer can vendor + rewrite the seam for.\n *\n * @since 0.1\n * @stable\n * @example\n *     import { SEAM_IDS } from \"@invinite-org/create-chartlang\";\n *     for (const id of SEAM_IDS) void id;\n */\nexport const SEAM_IDS = [\"canvas2d\", \"lightweight-charts\", \"uplot\", \"echarts\", \"konva\"] as const;\n\n/**\n * A bundled-adapter id the installer can rewrite the seam for (one of\n * {@link SEAM_IDS}).\n *\n * @since 0.1\n * @stable\n * @example\n *     import type { SeamId } from \"@invinite-org/create-chartlang\";\n *     const id: SeamId = \"echarts\";\n *     void id;\n */\nexport type SeamId = (typeof SEAM_IDS)[number];\n\nconst HEADER = `// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n//\n// ACTIVE CHART ADAPTER — the single point the create-chartlang installer\n// rewrites for the chosen library. Do NOT import a concrete\n// chartlang-example-*-adapter anywhere else; the rest of the app drives\n// charts through the abstract \\`ActiveAdapterHandle\\` + \\`createActiveAdapter\\`\n// + \\`runActiveLoop\\` exported here.\n\nimport type { AlertEmission, CandleEvent } from \"@invinite-org/chartlang-adapter-kit\"`;\n\nconst OPTS_TYPES = `/** Library-agnostic options ChartPane passes to {@link createActiveAdapter}. */\nexport type CreateAdapterOpts = Readonly<{\n  container: HTMLElement\n  candleSource: AsyncIterable<CandleEvent>\n  interval?: string\n  onAlert?: (a: AlertEmission) => void\n}>\n\n/** Options forwarded to {@link runActiveLoop} (cancellation via \\`signal\\`). */\nexport type RunActiveLoopOpts = Readonly<{ signal?: AbortSignal }>`;\n\nconst CANVAS2D_SEAM = `${HEADER}\nimport {\n  createCanvas2dAdapter,\n  type Canvas2dAdapterHandle,\n  runRendererLoop,\n} from \"chartlang-example-canvas2d-adapter\"\n\nexport type ActiveAdapterHandle = Canvas2dAdapterHandle\n\nexport const ACTIVE_ADAPTER_ID = \"canvas2d\"\n\n${OPTS_TYPES}\n\n// canvas2d paints onto a <canvas>; the seam creates one inside the generic\n// container so ChartPane only ever provides a DOM node.\nexport function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {\n  const canvas = opts.container.ownerDocument.createElement(\"canvas\")\n  canvas.width = opts.container.clientWidth || 800\n  canvas.height = opts.container.clientHeight || 480\n  opts.container.replaceChildren(canvas)\n  return createCanvas2dAdapter({\n    canvas,\n    candleSource: opts.candleSource,\n    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),\n    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),\n  })\n}\n\nexport async function runActiveLoop(\n  handle: ActiveAdapterHandle,\n  opts: RunActiveLoopOpts = {},\n): Promise<void> {\n  await runRendererLoop(handle, opts)\n}\n`;\n\nconst LWC_SEAM = `${HEADER}\nimport { createChart } from \"lightweight-charts\"\nimport {\n  createLightweightChartsAdapter,\n  type CreateLightweightChartsAdapterOpts,\n  type LwcAdapterHandle,\n  runRendererLoop,\n} from \"chartlang-example-lightweight-charts-adapter\"\n\nexport type ActiveAdapterHandle = LwcAdapterHandle\n\nexport const ACTIVE_ADAPTER_ID = \"lightweight-charts\"\n\n${OPTS_TYPES}\n\n// The real lightweight-charts \\`IChartApi\\` is wider than the slice the adapter\n// consumes (its internal \\`LwcChart\\`); the two do not structurally overlap for\n// TS, so go through \\`unknown\\` at the boundary.\nconst makeChart = (el: HTMLElement) =>\n  createChart(el) as unknown as ReturnType<\n    NonNullable<CreateLightweightChartsAdapterOpts[\"createChart\"]>\n  >\n\nexport function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {\n  return createLightweightChartsAdapter({\n    container: opts.container,\n    createChart: makeChart,\n    candleSource: opts.candleSource,\n    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),\n    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),\n  })\n}\n\nexport async function runActiveLoop(\n  handle: ActiveAdapterHandle,\n  opts: RunActiveLoopOpts = {},\n): Promise<void> {\n  await runRendererLoop(handle, opts)\n}\n`;\n\nconst UPLOT_SEAM = `${HEADER}\nimport \"uplot/dist/uPlot.min.css\"\nimport {\n  createUplotAdapter,\n  type UplotAdapterHandle,\n  runUplotLoop,\n} from \"chartlang-example-uplot-adapter\"\n\nexport type ActiveAdapterHandle = UplotAdapterHandle\n\nexport const ACTIVE_ADAPTER_ID = \"uplot\"\n\n${OPTS_TYPES}\n\nexport function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {\n  return createUplotAdapter({\n    target: opts.container,\n    width: opts.container.clientWidth || 800,\n    height: opts.container.clientHeight || 480,\n    candleSource: opts.candleSource,\n    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),\n    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),\n  })\n}\n\nexport async function runActiveLoop(\n  handle: ActiveAdapterHandle,\n  opts: RunActiveLoopOpts = {},\n): Promise<void> {\n  await runUplotLoop(handle, opts)\n}\n`;\n\nconst ECHARTS_SEAM = `${HEADER}\nimport * as echarts from \"echarts\"\nimport {\n  createEChartsAdapter,\n  type EChartsAdapterHandle,\n  type EChartsSurface,\n  runEChartsLoop,\n} from \"chartlang-example-echarts-adapter\"\n\nexport type ActiveAdapterHandle = EChartsAdapterHandle\n\nexport const ACTIVE_ADAPTER_ID = \"echarts\"\n\n${OPTS_TYPES}\n\n// echarts needs a DOM container + sizing it does not own, so the factory —\n// not a raw container — is the seam: this module owns the echarts.init call.\n//\n// The adapter's \\`buildViewport\\` treats \\`convertToPixel\\` as \"returns undefined\n// when the chart isn't laid out yet\"; the real echarts instance instead THROWS\n// before its first laid-out \\`setOption\\` (reading \\`queryComponents\\` of an\n// undefined coordinate system). Wrap it so a pre-layout call returns undefined,\n// honouring the adapter contract and letting it fall back to a deterministic\n// viewport instead of killing the render loop.\nfunction makeEchartsSurface(container: HTMLElement): EChartsSurface {\n  const chart = echarts.init(container)\n  return {\n    setOption: (option, setOpts) => chart.setOption(option, setOpts),\n    resize: () => chart.resize(),\n    dispose: () => chart.dispose(),\n    convertToPixel: (finder, value) => {\n      try {\n        const px = chart.convertToPixel(finder, value as unknown as number[])\n        return Array.isArray(px) ? ([px[0], px[1]] as const) : undefined\n      } catch {\n        return undefined\n      }\n    },\n  }\n}\n\nexport function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {\n  return createEChartsAdapter({\n    echartsFactory: () => makeEchartsSurface(opts.container),\n    candleSource: opts.candleSource,\n    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),\n    ...(opts.onAlert !== undefined ? { onAlert: opts.onAlert } : {}),\n  })\n}\n\nexport async function runActiveLoop(\n  handle: ActiveAdapterHandle,\n  opts: RunActiveLoopOpts = {},\n): Promise<void> {\n  await runEChartsLoop(handle, opts)\n}\n`;\n\nconst KONVA_SEAM = `${HEADER}\nimport Konva from \"konva\"\nimport type { RunnerEmissions } from \"@invinite-org/chartlang-adapter-kit\"\nimport {\n  type CreateKonvaAdapterOpts,\n  createKonvaAdapter,\n  feedCandleEvent,\n  handleInterval,\n  type KonvaAdapterHandle,\n} from \"chartlang-example-konva-adapter\"\n\nexport type ActiveAdapterHandle = KonvaAdapterHandle\n\nexport const ACTIVE_ADAPTER_ID = \"konva\"\n\n${OPTS_TYPES}\n\nexport function createActiveAdapter(opts: CreateAdapterOpts): ActiveAdapterHandle {\n  const width = opts.container.clientWidth || 800\n  const height = opts.container.clientHeight || 480\n  // The Konva adapter's StageConfig omits \\`container\\` (it renders headlessly\n  // and lets the caller wire the DOM node), but the real Konva.Stage requires\n  // one. Inject the seam's container by subclassing Stage so the adapter's\n  // \\`new konva.Stage({ width, height })\\` mounts onto our DOM node. The real\n  // Konva namespace is wider than the slice the adapter consumes, so cast it\n  // to the adapter's own \\`konva\\` field type.\n  const konva = {\n    ...Konva,\n    Stage: class extends Konva.Stage {\n      constructor(config: { width: number; height: number }) {\n        super({ ...config, container: opts.container as HTMLDivElement })\n      }\n    },\n  } as unknown as CreateKonvaAdapterOpts[\"konva\"]\n  return createKonvaAdapter({\n    konva,\n    stage: { width, height },\n    candleSource: opts.candleSource,\n    ...(opts.interval !== undefined ? { interval: opts.interval } : {}),\n  })\n}\n\n// konva has no exported async loop; mirror the shared loop shape locally over\n// feedCandleEvent / handleInterval and forward alerts from each drain (its\n// factory carries no onAlert hook).\nexport async function runActiveLoop(\n  handle: ActiveAdapterHandle,\n  opts: RunActiveLoopOpts = {},\n): Promise<void> {\n  const signal = opts.signal\n  const aborted = (): boolean => signal?.aborted ?? false\n  if (aborted()) return\n  for await (const event of handle.candles({ interval: handleInterval(handle) })) {\n    if (aborted()) return\n    feedCandleEvent(handle, event)\n    await handle.host.push(event)\n    if (aborted()) return\n    await new Promise<void>((r) => setTimeout(r, 0))\n    if (aborted()) return\n    const emissions: RunnerEmissions = await handle.host.drain()\n    if (aborted()) return\n    handle.onEmissions(emissions)\n  }\n}\n`;\n\nconst SEAM_BODIES: Readonly<Record<SeamId, string>> = {\n    canvas2d: CANVAS2D_SEAM,\n    \"lightweight-charts\": LWC_SEAM,\n    uplot: UPLOT_SEAM,\n    echarts: ECHARTS_SEAM,\n    konva: KONVA_SEAM,\n};\n\n/** The example-adapter package name for an id (the seam's import specifier). */\nfunction exampleAdapterPkg(id: SeamId): string {\n    return `chartlang-example-${id}-adapter`;\n}\n\n/**\n * Type guard: is `value` one of the five bundled-adapter ids the installer\n * can rewrite the seam for?\n *\n * @since 0.1\n * @stable\n * @example\n *     import { isSeamId } from \"@invinite-org/create-chartlang\";\n *     if (isSeamId(\"echarts\")) {\n *         // narrowed to SeamId\n *     }\n */\nexport function isSeamId(value: string): value is SeamId {\n    return (SEAM_IDS as ReadonlyArray<string>).includes(value);\n}\n\n/**\n * Produce the `activeAdapter.ts` body the installer writes for `id`, with the\n * example-adapter import specifier rewritten to the vendored local adapter\n * package name. The returned string is byte-identical to\n * `SEAM_VARIANTS[id].seamSource` after that single substitution — the parity\n * the matrix-proven SSOT guarantees.\n *\n * @since 0.1\n * @stable\n * @example\n *     import { seamTemplateFor } from \"@invinite-org/create-chartlang\";\n *     const body = seamTemplateFor(\"echarts\", \"@local/echarts-adapter\");\n *     void body;\n */\nexport function seamTemplateFor(id: SeamId, adapterPkgName: string): string {\n    return SEAM_BODIES[id].split(exampleAdapterPkg(id)).join(adapterPkgName);\n}\n"]}

package/dist/starterTsconfig.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The monorepo `tsconfig.base.json` compiler options, baked verbatim so the
+ * standalone clone has a self-contained base to `extends`. Kept in sync with
+ * the repo-root file by the parity test.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { STANDALONE_TSCONFIG_BASE } from "@invinite-org/create-chartlang";
+ *     void STANDALONE_TSCONFIG_BASE.compilerOptions.strict;
+ */
+export declare const STANDALONE_TSCONFIG_BASE: {
+    readonly compilerOptions: {
+        readonly target: "ES2022";
+        readonly module: "NodeNext";
+        readonly moduleResolution: "NodeNext";
+        readonly lib: readonly ["ES2022", "DOM", "DOM.Iterable"];
+        readonly strict: true;
+        readonly noImplicitAny: true;
+        readonly noImplicitOverride: true;
+        readonly noImplicitReturns: true;
+        readonly noUnusedLocals: true;
+        readonly noUnusedParameters: true;
+        readonly noFallthroughCasesInSwitch: true;
+        readonly exactOptionalPropertyTypes: true;
+        readonly isolatedModules: true;
+        readonly esModuleInterop: true;
+        readonly forceConsistentCasingInFileNames: true;
+        readonly skipLibCheck: true;
+        readonly declaration: true;
+        readonly declarationMap: true;
+        readonly sourceMap: true;
+        readonly inlineSources: true;
+        readonly verbatimModuleSyntax: true;
+        readonly resolveJsonModule: true;
+        readonly noEmit: false;
+    };
+};
+/**
+ * Make the cloned starter's TypeScript config self-contained: write
+ * `<dir>/tsconfig.base.json` from {@link STANDALONE_TSCONFIG_BASE}, then repoint
+ * the cloned `<dir>/tsconfig.json` `extends` to the sibling
+ * `"./tsconfig.base.json"`. If the clone has no `tsconfig.json`, the base is
+ * still written and the repoint is skipped (so the vendored adapter's own
+ * `extends: "../../tsconfig.base.json"` still resolves to the clone-root base).
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { writeStandaloneTsconfig } from "@invinite-org/create-chartlang";
+ *     await writeStandaloneTsconfig("/tmp/my-app");
+ */
+export declare function writeStandaloneTsconfig(dir: string): Promise<void>;
+//# sourceMappingURL=starterTsconfig.d.ts.map

package/dist/starterTsconfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starterTsconfig.d.ts","sourceRoot":"","sources":["../src/starterTsconfig.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B3B,CAAC;AAOX;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcxE"}