gazetta 0.7.0 → 0.8.0

package/dist/fragments/create.js

@@ -0,0 +1,93 @@
+/**
+ * Fragment Create — POST handler logic for `/api/fragments`.
+ *
+ * Peer of `pages/create.ts`. Differs from Page Create in three places:
+ *
+ *   1. Loader lookup: `site.fragments` (not `site.pages`)
+ *   2. No `content` field on the manifest (Fragments don't ship
+ *      initial content; templates supply defaults)
+ *   3. Cache invalidation hits both `fragments:` AND `pages:` because
+ *      Fragment References compose into Page summaries (same diff as
+ *      `saveFragment` per Q3 lock)
+ *
+ * Decision tree is the same as `createPage`:
+ *   - Live name in use → `LIVE_CONFLICT`
+ *   - Archived name + no flag → `ARCHIVED_CONFLICT` with details
+ *   - Archived name + mode → `resolveArchivedNameConflict`
+ *   - Otherwise → fresh create
+ */
+import { join } from 'node:path';
+import { resolveArchivedNameConflict, } from '../admin-api/archived-name-conflict.js';
+import { loadSiteFromSource } from '../admin-api/source-context.js';
+import { rebuildAssetRefs } from '../assets/asset-deps.js';
+import { rebuildFragmentDeps } from '../fragment-deps.js';
+/**
+ * Create a Fragment. Wraps the conflict-resolution decision tree +
+ * the fresh-create write path. Routes project the typed
+ * `CreateFragmentResult` to HTTP (200 / 400 / 409).
+ */
+export async function createFragment(input) {
+    const { source, name, template, onConflict, principal, audit } = input;
+    const { storage } = source;
+    const fragDir = source.contentRoot.path('fragments', name);
+    const manifestPath = join(fragDir, 'fragment.json');
+    if (await storage.exists(manifestPath)) {
+        const site = await loadSiteFromSource(source);
+        const existing = site.fragments.get(name);
+        const isArchived = existing?.archived === true;
+        if (!isArchived) {
+            return { ok: false, code: 'LIVE_CONFLICT', name };
+        }
+        if (!onConflict) {
+            return {
+                ok: false,
+                code: 'ARCHIVED_CONFLICT',
+                archive: {
+                    kind: 'fragment',
+                    name,
+                    ...(existing?.archivedAt ? { archivedAt: existing.archivedAt } : {}),
+                    ...(existing?.archivedBy ? { archivedBy: existing.archivedBy } : {}),
+                    ...(existing?.aliasOf ? { aliasOf: existing.aliasOf } : {}),
+                },
+            };
+        }
+        const result = await resolveArchivedNameConflict({
+            source,
+            kind: 'fragment',
+            name,
+            existing: existing,
+            mode: onConflict,
+            newTemplate: template,
+            actorId: principal.id,
+        });
+        if (result.kind === 'invalid-mode') {
+            return { ok: false, code: 'INVALID_CONFLICT_MODE', mode: onConflict };
+        }
+        const action = result.kind === 'restored' ? 'unarchive' : result.kind === 'replaced' ? 'archive' : 'rename';
+        await audit.record({
+            // Same cast posture as `pages/create.ts`: the resolver's audit
+            // events use the soft-delete vocabulary; the recorder type is
+            // narrow to the save-flow values.
+            action: action,
+            outcome: 'success',
+            scope: { kind: 'fragment', name },
+            metadata: { onConflict },
+        });
+        await Promise.all([source.cache.invalidatePrefix('fragments:'), source.cache.invalidatePrefix('pages:')]);
+        return { ok: true, name, resolution: result.kind };
+    }
+    // Fresh create — no existing manifest.
+    await storage.mkdir(fragDir);
+    const manifest = { template, components: [] };
+    await storage.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    const item = { source: 'fragment', name };
+    await Promise.all([
+        rebuildAssetRefs(source.contentRoot, item, null, manifest),
+        rebuildFragmentDeps(source.contentRoot, item, null, manifest),
+    ]);
+    // Fragment writes invalidate both summaries — page summaries reflect
+    // resolvable fragment refs.
+    await Promise.all([source.cache.invalidatePrefix('fragments:'), source.cache.invalidatePrefix('pages:')]);
+    return { ok: true, name };
+}
+//# sourceMappingURL=create.js.map

package/dist/fragments/create.js.map

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

package/dist/fragments/publish.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Fragment Publish — kind-specific wrapper around `publishItemCore`.
+ *
+ * Peer of `pages/publish.ts`. Differs from Page Publish in two places:
+ *
+ *   1. Mode resolution simpler: fragments have ONE rendering mode
+ *      (`fragment-rendered`) regardless of target type. Archive
+ *      short-circuit applies; otherwise always rendered.
+ *   2. No page-cache flow-through (fragments don't carry pub-state
+ *      sidecars; spine handles).
+ *
+ * Everything downstream is the spine.
+ */
+import { type PublishItemResult, type PublishRenderMode, type PublishTarget } from '../publish-item.js';
+import type { ContentRoot } from '../content-root.js';
+import type { Site } from '../site-loader.js';
+/** Inputs to `publishFragment`. Same shape as `PublishPageInput`. */
+export interface PublishFragmentInput {
+    readonly name: string;
+    readonly locale?: string;
+    readonly site: Site;
+    readonly sourceRoot: ContentRoot;
+    readonly target: PublishTarget;
+}
+/**
+ * Resolve the render mode for a fragment on a target. Pure dispatch
+ * fn. Always either 'archive-marker' or 'fragment-rendered'.
+ */
+export declare function resolveFragmentRenderMode(fragment: {
+    archived?: boolean;
+}): PublishRenderMode;
+/**
+ * Publish a fragment to a target. Wraps `publishItemCore` with the
+ * fragment-specific mode resolution.
+ */
+export declare function publishFragment(input: PublishFragmentInput): Promise<PublishItemResult>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/fragments/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/fragments/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAmB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACxH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,iBAAiB,CAG7F;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsB7F"}

package/dist/fragments/publish.js

@@ -0,0 +1,52 @@
+/**
+ * Fragment Publish — kind-specific wrapper around `publishItemCore`.
+ *
+ * Peer of `pages/publish.ts`. Differs from Page Publish in two places:
+ *
+ *   1. Mode resolution simpler: fragments have ONE rendering mode
+ *      (`fragment-rendered`) regardless of target type. Archive
+ *      short-circuit applies; otherwise always rendered.
+ *   2. No page-cache flow-through (fragments don't carry pub-state
+ *      sidecars; spine handles).
+ *
+ * Everything downstream is the spine.
+ */
+import { isArchived } from '../archive-helpers.js';
+import { publishItemCore } from '../publish-item.js';
+/**
+ * Resolve the render mode for a fragment on a target. Pure dispatch
+ * fn. Always either 'archive-marker' or 'fragment-rendered'.
+ */
+export function resolveFragmentRenderMode(fragment) {
+    if (isArchived(fragment))
+        return 'archive-marker';
+    return 'fragment-rendered';
+}
+/**
+ * Publish a fragment to a target. Wraps `publishItemCore` with the
+ * fragment-specific mode resolution.
+ */
+export async function publishFragment(input) {
+    const fragment = input.site.fragments.get(input.name);
+    if (!fragment) {
+        return {
+            kind: 'fragment',
+            name: input.name,
+            locale: input.locale,
+            ok: false,
+            code: 'NOT_FOUND',
+            reason: `Fragment "${input.name}" not found in source`,
+        };
+    }
+    const mode = resolveFragmentRenderMode(fragment);
+    return publishItemCore({
+        kind: 'fragment',
+        name: input.name,
+        locale: input.locale,
+        mode,
+        site: input.site,
+        sourceRoot: input.sourceRoot,
+        target: input.target,
+    });
+}
+//# sourceMappingURL=publish.js.map

package/dist/fragments/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/fragments/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAsE,MAAM,oBAAoB,CAAA;AAaxH;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgC;IACxE,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,gBAAgB,CAAA;IACjD,OAAO,mBAAmB,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA2B;IAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,aAAa,KAAK,CAAC,IAAI,uBAAuB;SACvD,CAAA;IACH,CAAC;IACD,MAAM,IAAI,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAA;IAChD,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAA;AACJ,CAAC"}

package/dist/fragments/save.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Fragment Save — kind-specific wrapper around `saveManifestCore`.
+ *
+ * Peer of `pages/save.ts`. Differs from Page Save in five places (per
+ * Q3 lock — the 5 page-vs-fragment diffs):
+ *
+ *   1. Loader lookup: `site.fragments` + `site.fragmentLocales` (not
+ *      `site.pages` / `site.pageLocales`)
+ *   2. Filename: `fragment.json` / `fragment.{locale}.json`
+ *   3. No `route` field (Fragments aren't routable) → `etagExtras` is
+ *      empty; manifest assembly omits route preservation
+ *   4. No `metadata` field carry-through
+ *   5. Cache invalidation hits both `fragments:` AND `pages:` because
+ *      Fragment References compose into Page summaries (a Fragment
+ *      edit can change the rendered Page output)
+ *
+ * Plus one scanner difference: `RescanCause` is `{ kind: 'fragment',
+ * name }` to walk transitive dependents via the Usage Sidecar
+ * primitive `findDependentsFromSidecars` — Page Saves use
+ * `{ kind: 'manifest', item }` to invalidate just the page.
+ *
+ * Everything downstream — etag check, validators, beforeSave hooks,
+ * history, write, sidecars, audit, afterSave hooks — is the spine.
+ */
+import { type SaveAuditRecorder, type SavePrincipal, type SaveResult, type SaveSourceWiring } from '../manifest-save.js';
+import type { FragmentManifest } from '../types.js';
+import type { Site } from '../site-loader.js';
+import type { ValidatorRegistry } from '../validation/registry.js';
+import type { ValidationScanner } from '../validation/scanner.js';
+import type { HookFiringEmitter, HookRegistry } from '../hooks/index.js';
+/**
+ * Inputs to `saveFragment`. Same shape as `SavePageInput` minus the
+ * route field (Fragments aren't routable). Routes destructure their
+ * request and pass the parts the pipeline needs.
+ */
+export interface SaveFragmentInput {
+    /** Fragment name (folder name under `fragments/`). */
+    readonly name: string;
+    /** BCP-47 locale when saving a Locale Variant; undefined for default. */
+    readonly locale?: string;
+    /** Incoming manifest body (template/content/components). */
+    readonly body: Partial<FragmentManifest> & Record<string, unknown>;
+    /** Optional save-etag for concurrency check. */
+    readonly ifMatch?: string;
+    /** Loaded site (caller does `loadSiteFromSource(source)` once). */
+    readonly site: Site;
+    /** Source wiring (cache, history, storage, contentRoot, manifest, targetName). */
+    readonly source: SaveSourceWiring;
+    /** Authenticated principal driving this save. */
+    readonly principal: SavePrincipal;
+    /** Audit recorder bound to the request. */
+    readonly audit: SaveAuditRecorder;
+    /** Validator registry built once at admin boot. */
+    readonly validators: ValidatorRegistry;
+    /** Hook registry; absent when no hooks contributed. */
+    readonly hooks?: HookRegistry;
+    /** Audit-firing emitter for hook dispatch. */
+    readonly hookAuditEmit?: HookFiringEmitter;
+    /** Background scanner; absent when scanner not enabled. */
+    readonly scanner?: ValidationScanner;
+    /** Per-request correlation id; fresh UUID when absent. */
+    readonly requestId?: string;
+}
+/** Fragment-name-not-found — routes project to 404. */
+export declare class FragmentNotFoundError extends Error {
+    readonly name: string;
+    constructor(name: string);
+}
+/** Invalid locale code per `isValidLocale` — routes project to 400. */
+export declare class InvalidLocaleError extends Error {
+    readonly raw: string;
+    constructor(raw: string);
+}
+/**
+ * Save a Fragment Manifest. Wraps `saveManifestCore` with the
+ * Fragment-specific resolution + assembly. Throws
+ * `FragmentNotFoundError` / `InvalidLocaleError` for route-level
+ * preconditions; returns `SaveResult` for save outcomes.
+ */
+export declare function saveFragment(input: SaveFragmentInput): Promise<SaveResult>;
+//# sourceMappingURL=save.d.ts.map

package/dist/fragments/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/fragments/save.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAExE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClE,gDAAgD;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAA;IAC1C,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,uDAAuD;AACvD,qBAAa,qBAAsB,SAAQ,KAAK;aAClB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC;AAED,uEAAuE;AACvE,qBAAa,kBAAmB,SAAQ,KAAK;aACf,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAIxC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqDhF"}

package/dist/fragments/save.js

@@ -0,0 +1,105 @@
+/**
+ * Fragment Save — kind-specific wrapper around `saveManifestCore`.
+ *
+ * Peer of `pages/save.ts`. Differs from Page Save in five places (per
+ * Q3 lock — the 5 page-vs-fragment diffs):
+ *
+ *   1. Loader lookup: `site.fragments` + `site.fragmentLocales` (not
+ *      `site.pages` / `site.pageLocales`)
+ *   2. Filename: `fragment.json` / `fragment.{locale}.json`
+ *   3. No `route` field (Fragments aren't routable) → `etagExtras` is
+ *      empty; manifest assembly omits route preservation
+ *   4. No `metadata` field carry-through
+ *   5. Cache invalidation hits both `fragments:` AND `pages:` because
+ *      Fragment References compose into Page summaries (a Fragment
+ *      edit can change the rendered Page output)
+ *
+ * Plus one scanner difference: `RescanCause` is `{ kind: 'fragment',
+ * name }` to walk transitive dependents via the Usage Sidecar
+ * primitive `findDependentsFromSidecars` — Page Saves use
+ * `{ kind: 'manifest', item }` to invalidate just the page.
+ *
+ * Everything downstream — etag check, validators, beforeSave hooks,
+ * history, write, sidecars, audit, afterSave hooks — is the spine.
+ */
+import { join } from 'node:path';
+import { ensureComponentIds } from '../component-ids.js';
+import { isValidLocale } from '../locale.js';
+import { saveManifestCore, } from '../manifest-save.js';
+/** Fragment-name-not-found — routes project to 404. */
+export class FragmentNotFoundError extends Error {
+    name;
+    constructor(name) {
+        super(`Fragment "${name}" not found`);
+        this.name = name;
+        this.name = 'FragmentNotFoundError';
+    }
+}
+/** Invalid locale code per `isValidLocale` — routes project to 400. */
+export class InvalidLocaleError extends Error {
+    raw;
+    constructor(raw) {
+        super(`Invalid locale code: "${raw}"`);
+        this.raw = raw;
+        this.name = 'InvalidLocaleError';
+    }
+}
+/**
+ * Save a Fragment Manifest. Wraps `saveManifestCore` with the
+ * Fragment-specific resolution + assembly. Throws
+ * `FragmentNotFoundError` / `InvalidLocaleError` for route-level
+ * preconditions; returns `SaveResult` for save outcomes.
+ */
+export async function saveFragment(input) {
+    let locale;
+    if (input.locale !== undefined) {
+        if (!isValidLocale(input.locale))
+            throw new InvalidLocaleError(input.locale);
+        locale = input.locale.toLowerCase();
+    }
+    const defaultFragment = input.site.fragments.get(input.name);
+    if (!defaultFragment)
+        throw new FragmentNotFoundError(input.name);
+    const localeVariant = locale ? input.site.fragmentLocales.get(input.name)?.locales.get(locale) : undefined;
+    const fragment = localeVariant ?? defaultFragment;
+    const components = ensureComponentIds(input.body.components ?? fragment.components);
+    // Fragments don't carry route or metadata. Plain three-field manifest.
+    const manifest = {
+        template: input.body.template ?? fragment.template,
+        content: input.body.content ?? fragment.content,
+        components,
+    };
+    const filename = locale ? `fragment.${locale}.json` : 'fragment.json';
+    const manifestPath = join(defaultFragment.dir, filename);
+    return saveManifestCore({
+        kind: 'fragment',
+        name: input.name,
+        locale,
+        manifest,
+        before: fragment,
+        manifestPath,
+        ifMatch: input.ifMatch,
+        site: input.site,
+        // Fragment Saves invalidate `pages:` too because Fragment
+        // References compose into Page summaries (Page summaries reflect
+        // resolved fragment content). Order matches what fragments.ts
+        // PUT did before the cutover.
+        cacheInvalidatePrefixes: ['fragments:', 'pages:'],
+        // No route or metadata to fold in — etag is pure manifest.
+        etagExtras: {},
+        source: input.source,
+        audit: input.audit,
+        principal: input.principal,
+        hookAuditEmit: input.hookAuditEmit,
+        validators: input.validators,
+        hooks: input.hooks,
+        scanner: input.scanner,
+        // Scanner cause: Fragment Saves walk transitive dependents via
+        // findDependentsFromSidecars (a fragment edit can affect every
+        // page that references @{name}). The 'fragment' RescanCause
+        // variant tells the scanner to expand the dependency set.
+        scannerCause: { kind: 'fragment', name: input.name },
+        requestId: input.requestId,
+    });
+}
+//# sourceMappingURL=save.js.map

package/dist/fragments/save.js.map

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

package/dist/history-recorder.d.ts

@@ -8,7 +8,7 @@
  * right thing:
  *
  *   - First revision on a target: walks the content tree once to
- *     snapshot every manifest (page.json, fragment.json, site.yaml).
+ *     snapshot every manifest (page.json, fragment.json).
  *   - Subsequent revisions: reads the previous snapshot and overlays
  *     the delta (changed items the caller passes in). `readBlob` for
  *     each carried-over path gives us the content for the new
@@ -28,8 +28,8 @@ export interface WrittenItem {
     path: string;
     /**
      * Current content as stored. `string` for text items (manifests,
-     * YAML), `Uint8Array` for binary items (asset bytes, variants).
-     * `null` marks a deletion.
+     * site config), `Uint8Array` for binary items (asset bytes,
+     * variants). `null` marks a deletion.
      */
     content: BlobContent | null;
 }
@@ -53,7 +53,7 @@ export interface ScanLocation {
 export declare const DEFAULT_SCAN_LOCATIONS: readonly ScanLocation[];
 /**
  * Flat files at the content root to capture in the baseline snapshot
- * (no per-subdirectory recursion). `site.yaml` is the only one today.
+ * (no per-subdirectory recursion).
  */
 export declare const DEFAULT_SCAN_ROOT_FILES: readonly string[];
 export interface RecordWriteOptions {
@@ -82,7 +82,7 @@ export interface RecordWriteOptions {
     scanLocations?: readonly ScanLocation[];
     /**
      * Override the flat files captured from the content root. Defaults
-     * to `DEFAULT_SCAN_ROOT_FILES` (`site.yaml`). Missing files are
+     * to `DEFAULT_SCAN_ROOT_FILES` (`site.config.ts`). Missing files are
      * silently skipped so empty publish-targets still record cleanly.
      */
     scanRootFiles?: readonly string[];

package/dist/history-recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history-recorder.d.ts","sourceRoot":"","sources":["../src/history-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAiB,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAA;IACX,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,YAAY,EAGzD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAkB,CAAA;AAEvE,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,OAAO,EAAE,eAAe,CAAA;IACxB,mEAAmE;IACnE,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,4CAmCzD"}
+{"version":3,"file":"history-recorder.d.ts","sourceRoot":"","sources":["../src/history-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAiB,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAA;IACX,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,YAAY,EAGzD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAuB,CAAA;AAE5E,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,OAAO,EAAE,eAAe,CAAA;IACxB,mEAAmE;IACnE,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,4CAmCzD"}

package/dist/history-recorder.js

@@ -8,7 +8,7 @@
  * right thing:
  *
  *   - First revision on a target: walks the content tree once to
- *     snapshot every manifest (page.json, fragment.json, site.yaml).
+ *     snapshot every manifest (page.json, fragment.json).
  *   - Subsequent revisions: reads the previous snapshot and overlays
  *     the delta (changed items the caller passes in). `readBlob` for
  *     each carried-over path gives us the content for the new
@@ -33,9 +33,9 @@ export const DEFAULT_SCAN_LOCATIONS = [
 ];
 /**
  * Flat files at the content root to capture in the baseline snapshot
- * (no per-subdirectory recursion). `site.yaml` is the only one today.
+ * (no per-subdirectory recursion).
  */
-export const DEFAULT_SCAN_ROOT_FILES = ['site.yaml'];
+export const DEFAULT_SCAN_ROOT_FILES = ['site.config.ts'];
 /**
  * Build + record a revision for the given write. Reads the previous
  * snapshot (if any), overlays the delta, and calls
@@ -87,7 +87,7 @@ export async function recordWrite(opts) {
  * Materialize the previous revision's full content snapshot as
  * `path → content`. If there is no previous revision, fall back to a
  * one-time scan of the target's content tree (pages, fragments,
- * site.yaml). That makes the first revision a proper baseline even
+ * root files). That makes the first revision a proper baseline even
  * when history was turned on after content already existed.
  */
 async function loadPreviousSnapshot(history, contentRoot, scanLocations, scanRootFiles) {

package/dist/history-recorder.js.map

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

package/dist/history-restorer.js

@@ -78,14 +78,14 @@ export async function restoreRevision(opts) {
             const { rebuildDepIndex } = await import('./publish-rendered.js');
             const { ASSET_REFS } = await import('./assets/asset-deps.js');
             const { FRAGMENT_DEPS } = await import('./fragment-deps.js');
-            const site = await loadSite({ contentRoot });
+            const site = await loadSite({ contentRoot, manifest: { name: '(history-restore)' } });
             await Promise.all([
                 rebuildDepIndex(ASSET_REFS, site, contentRoot.storage, contentRoot.rootPath),
                 rebuildDepIndex(FRAGMENT_DEPS, site, contentRoot.storage, contentRoot.rootPath),
             ]);
         }
         catch (err) {
-            // Non-fatal: if site.yaml is missing or load fails, dep indices
+            // Non-fatal: if site config is missing or load fails, dep indices
             // might drift. Reindex CLI recovers.
             // eslint-disable-next-line no-console
             console.warn(`dep-sidecar rebuild after restore failed: ${err.message}`);

package/dist/history-restorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"history-restorer.js","sourceRoot":"","sources":["../src/history-restorer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"history-restorer.js","sourceRoot":"","sources":["../src/history-restorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAkBH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAA4B;IAChE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAA;IACjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;IACrD,+DAA+D;IAC/D,oEAAoE;IACpE,sCAAsC;IACtC,MAAM,eAAe,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEvD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IAClF,oEAAoE;IACpE,uEAAuE;IACvE,mEAAmE;IACnE,oEAAoE;IACpE,iEAAiE;IACjE,iCAAiC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAA;IAExG,sEAAsE;IACtE,kEAAkE;IAClE,+DAA+D;IAC/D,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;QACnE,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;QACrD,IAAI,MAAM;YAAE,MAAM,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACnD,8DAA8D;QAC9D,qDAAqD;QACrD,6DAA6D;QAC7D,uDAAuD;QACvD,MAAM,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAClD,CAAC;IAED,mEAAmE;IACnE,gEAAgE;IAChE,mEAAmE;IACnE,sEAAsE;IACtE,0DAA0D;IAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACrD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;YACjE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;YAC7D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;YAC5D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAA;YACrF,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;gBAC5E,eAAe,CAAC,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;aAChF,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,kEAAkE;YAClE,qCAAqC;YACrC,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,6CAA8C,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;QACrF,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,kEAAkE;IAClE,OAAO,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE;QACzC,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,kBAAkB,CAC/B,OAAwB,EACxB,MAAwB,EACxB,IAAgG;IAEhG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/C,CAAC;IACD,OAAO,OAAO,CAAC,cAAc,CAAC;QAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,KAAK;KACN,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,gBAAgB,CAAC,OAAwB;IACtD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC7C,OAAO,CAAC,CAAC,QAAQ,CAAA;AACnB,CAAC"}

package/dist/history.d.ts

@@ -111,7 +111,7 @@ export interface HistoryProvider {
     readRevision(id: string): Promise<RevisionManifest>;
     /**
      * Read a content blob by hash. Returns raw bytes — callers that
-     * expect text (page/fragment manifests, site.yaml) decode UTF-8 on
+     * expect text (page/fragment manifests, site.config.ts) decode UTF-8 on
      * receipt. Callers that expect binary (asset bytes, variants) use
      * the bytes as-is.
      *

package/dist/hooks/audit-emitter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Hook firing audit emitter — the seam between the hooks
+ * dispatcher and the audit recorder.
+ *
+ * Per design-hooks.md "Audit events" + design-audit.md's locked
+ * `action: 'hook-fired'` + `outcome: 'hook-cancelled' | 'timeout'`
+ * extensions:
+ *
+ *   - Every hook firing emits an audit event with hook name +
+ *     priority + phase + durationMs.
+ *   - `outcome` reflects the hook firing's result:
+ *       'success'         — completed within timeout
+ *       'hook-cancelled'  — `before*` threw (or non-cancellation
+ *                            error wrapped as HookCancellation)
+ *       'timeout'         — per-handler timeout fired before
+ *                            resolve
+ *   - One firing = one event; correlation across firings in the
+ *     same operation is via shared `requestId` (audit + log).
+ *
+ * # Why a callback, not a direct audit dependency
+ *
+ * dispatch.ts must stay independent of audit-context wiring so
+ * the same code path runs in tests (no audit) and in production
+ * (full audit). The callback shape lets the caller decide
+ * whether/how to record. When the callback is undefined, dispatch
+ * is silent.
+ *
+ * # SOLID lenses
+ *
+ *   - SRP: this module owns the emitter contract; doesn't construct
+ *     audit providers, doesn't run hooks.
+ *   - DIP: dispatch depends on the `HookFiringEmitter` callback;
+ *     callers (admin-api wiring) supply an implementation that
+ *     forwards to `c.var.audit.record(...)`.
+ */
+import type { HookContext, HookPhase, HookRegistration } from './types.js';
+/**
+ * One audit-emittable hook firing event. Captured by the
+ * dispatcher and forwarded to the caller-supplied emitter.
+ */
+export interface HookFiringEvent {
+    /** Phase the hook fired in. */
+    phase: HookPhase;
+    /** Hook name (from registration meta or file basename). */
+    hookName: string;
+    /** Source identity ('site-local', plugin name, 'built-in'). */
+    source: string;
+    /** Priority at registration time. */
+    priority: number;
+    /**
+     * Outcome of the firing. `'success'` for handlers that resolved
+     * within the timeout window; `'hook-cancelled'` for `before*`
+     * handlers that threw; `'timeout'` for handlers that exceeded
+     * their per-handler timeout.
+     */
+    outcome: 'success' | 'hook-cancelled' | 'timeout';
+    /** Wall-clock duration (ms) from invocation to resolve / throw. */
+    durationMs: number;
+    /** Triggering request's HookContext (carries actor, requestId, etc.). */
+    ctx: HookContext;
+}
+/**
+ * Caller-supplied audit emitter. Invoked synchronously per hook
+ * firing; consumer typically forwards to `c.var.audit.record(...)`.
+ *
+ * The emitter MUST NOT throw — failures isolate to the dispatcher
+ * via try/catch. Consumers wanting to surface emit failures use
+ * their own logging.
+ */
+export type HookFiringEmitter = (event: HookFiringEvent) => void | Promise<void>;
+/** Helper for registrations — extracts the metadata the emitter needs. */
+export declare function eventFromRegistration<P extends HookPhase>(reg: HookRegistration<P>, ctx: HookContext, outcome: HookFiringEvent['outcome'], durationMs: number): HookFiringEvent;
+//# sourceMappingURL=audit-emitter.d.ts.map

package/dist/hooks/audit-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-emitter.d.ts","sourceRoot":"","sources":["../../src/hooks/audit-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE1E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,KAAK,EAAE,SAAS,CAAA;IAChB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,OAAO,EAAE,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAAA;IACjD,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,GAAG,EAAE,WAAW,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEhF,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,SAAS,EACvD,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACxB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EACnC,UAAU,EAAE,MAAM,GACjB,eAAe,CAUjB"}

package/dist/hooks/audit-emitter.js

@@ -0,0 +1,13 @@
+/** Helper for registrations — extracts the metadata the emitter needs. */
+export function eventFromRegistration(reg, ctx, outcome, durationMs) {
+    return {
+        phase: reg.phase,
+        hookName: reg.name,
+        source: reg.source,
+        priority: reg.priority,
+        outcome,
+        durationMs,
+        ctx,
+    };
+}
+//# sourceMappingURL=audit-emitter.js.map

package/dist/hooks/audit-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-emitter.js","sourceRoot":"","sources":["../../src/hooks/audit-emitter.ts"],"names":[],"mappings":"AAyEA,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CACnC,GAAwB,EACxB,GAAgB,EAChB,OAAmC,EACnC,UAAkB;IAElB,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,IAAI;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO;QACP,UAAU;QACV,GAAG;KACJ,CAAA;AACH,CAAC"}