@meetelise/studio-components 0.0.19 → 0.0.20

package/dist/utils/nodeIdentity.js

@@ -0,0 +1,275 @@
+export const RENDERED_NODE_PATH_KEY = "renderedIdPath";
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNodeLike(value) {
+    return isPlainObject(value) && typeof value.type === "string";
+}
+function encodePart(value) {
+    return encodeURIComponent(value);
+}
+function decodePart(value) {
+    return decodeURIComponent(value);
+}
+export function normalizeAuthoredNodePath(path) {
+    return path.map((part) => encodePart(String(part))).join("/");
+}
+// cyrb53-style 53-bit string hash: deterministic, dependency-free, low collision rate.
+function hashString(input) {
+    let h1 = 0xdeadbeef ^ input.length;
+    let h2 = 0x41c6ce57 ^ input.length;
+    for (let i = 0; i < input.length; i++) {
+        const ch = input.charCodeAt(i);
+        h1 = Math.imul(h1 ^ ch, 2654435761);
+        h2 = Math.imul(h2 ^ ch, 1597334677);
+    }
+    h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);
+    h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);
+    return `${(h2 >>> 0).toString(36)}${(h1 >>> 0).toString(36)}`;
+}
+export function pathHashAuthoredId(path) {
+    return `n_${hashString(normalizeAuthoredNodePath(path))}`;
+}
+export function renderedNodePathForAuthoredId(authoredId) {
+    return [{ authoredId }];
+}
+export function getRenderedNodeAuthoredId(path) {
+    return path?.[0]?.authoredId;
+}
+export function appendRenderedNodePathSegments(path, segments) {
+    if (segments.length === 0)
+        return path;
+    return [...path, ...segments];
+}
+export function isRenderedNodePath(value) {
+    return (Array.isArray(value) &&
+        value.length > 0 &&
+        isPlainObject(value[0]) &&
+        typeof value[0].authoredId === "string");
+}
+export function getRenderedNodePath(node) {
+    if (!isPlainObject(node))
+        return undefined;
+    const path = node[RENDERED_NODE_PATH_KEY];
+    if (isRenderedNodePath(path))
+        return path;
+    return typeof node.id === "string" && node.id ? renderedNodePathForAuthoredId(node.id) : undefined;
+}
+export function renderedNodeIdFromPath(path) {
+    return path ? serializeRenderedNodePath(path) : undefined;
+}
+export function renderedNodeIdForNode(node) {
+    return renderedNodeIdFromPath(getRenderedNodePath(node));
+}
+function serializeSegment(segment) {
+    if ("authoredId" in segment)
+        return `a:${encodePart(segment.authoredId)}`;
+    if ("symbol" in segment) {
+        return `s:${encodePart(segment.symbol)}:${encodePart(segment.instanceId)}`;
+    }
+    if ("repeat" in segment) {
+        return [
+            "r",
+            encodePart(segment.repeat),
+            String(segment.index),
+            encodePart(segment.buildingId ?? ""),
+        ].join(":");
+    }
+    if ("buildingSlice" in segment) {
+        return [
+            "b",
+            encodePart(segment.buildingSlice),
+            String(segment.index),
+            encodePart(segment.buildingId),
+        ].join(":");
+    }
+    if ("runtimeRepeat" in segment) {
+        return [
+            "rr",
+            encodePart(segment.runtimeRepeat),
+            String(segment.index),
+            encodePart(segment.key),
+        ].join(":");
+    }
+    return `x:${encodePart(segment.synthetic)}`;
+}
+export function serializeRenderedNodePath(path) {
+    return path.map(serializeSegment).join("|");
+}
+export function parseRenderedNodePath(serialized) {
+    const parts = serialized.split("|").filter(Boolean);
+    if (parts.length === 0)
+        return undefined;
+    const segments = [];
+    for (const part of parts) {
+        const [kind, one = "", two = "", three = ""] = part.split(":");
+        if (kind === "a") {
+            segments.push({ authoredId: decodePart(one) });
+        }
+        else if (kind === "s") {
+            segments.push({ symbol: decodePart(one), instanceId: decodePart(two) });
+        }
+        else if (kind === "r") {
+            const buildingId = decodePart(three);
+            segments.push({
+                repeat: decodePart(one),
+                index: Number(two),
+                ...(buildingId ? { buildingId } : {}),
+            });
+        }
+        else if (kind === "b") {
+            segments.push({
+                buildingSlice: decodePart(one),
+                index: Number(two),
+                buildingId: decodePart(three),
+            });
+        }
+        else if (kind === "rr") {
+            segments.push({ runtimeRepeat: decodePart(one), index: Number(two), key: decodePart(three) });
+        }
+        else if (kind === "x") {
+            segments.push({ synthetic: decodePart(one) });
+        }
+        else {
+            return undefined;
+        }
+    }
+    return isRenderedNodePath(segments) ? segments : undefined;
+}
+export function getAuthoredIdFromSerializedRenderedNodeId(serialized) {
+    return getRenderedNodeAuthoredId(parseRenderedNodePath(serialized));
+}
+export function withRenderedNodePath(node, path) {
+    return { ...node, [RENDERED_NODE_PATH_KEY]: path };
+}
+export function withRenderedNodePathSegments(node, segments) {
+    const path = getRenderedNodePath(node);
+    return path ? withRenderedNodePath(node, appendRenderedNodePathSegments(path, segments)) : node;
+}
+export function appendRenderedNodePathSegmentsDeep(value, segments) {
+    if (segments.length === 0)
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((item) => appendRenderedNodePathSegmentsDeep(item, segments));
+    }
+    if (!isPlainObject(value))
+        return value;
+    const result = {};
+    for (const [key, child] of Object.entries(value)) {
+        result[key] = appendRenderedNodePathSegmentsDeep(child, segments);
+    }
+    return isNodeLike(value) ? withRenderedNodePathSegments(result, segments) : result;
+}
+function reserveAuthoredId(desiredId, path, seen) {
+    let candidate = desiredId;
+    let index = 1;
+    while (seen.has(candidate)) {
+        candidate = `${pathHashAuthoredId([...path, "duplicate", index])}_${index}`;
+        index += 1;
+    }
+    seen.add(candidate);
+    return candidate;
+}
+function cloneNodeWithAuthoredIds(node, path, seen) {
+    const desiredId = typeof node.id === "string" && node.id ? node.id : pathHashAuthoredId(path);
+    const id = reserveAuthoredId(desiredId, path, seen);
+    const result = {
+        ...node,
+        id,
+        [RENDERED_NODE_PATH_KEY]: renderedNodePathForAuthoredId(id),
+    };
+    if (Array.isArray(node.children)) {
+        result.children = node.children.map((child, index) => clonePotentialNode(child, [...path, "children", index], seen));
+    }
+    if ("template" in node) {
+        result.template = clonePotentialNode(node.template, [...path, "template"], seen);
+    }
+    if ("emptyState" in node) {
+        result.emptyState = clonePotentialNode(node.emptyState, [...path, "emptyState"], seen);
+    }
+    if (isPlainObject(node.slots)) {
+        const slots = {};
+        for (const [slotName, slotValue] of Object.entries(node.slots)) {
+            slots[slotName] = clonePotentialNode(slotValue, [...path, "slots", slotName], seen);
+        }
+        result.slots = slots;
+    }
+    if (isPlainObject(node.props)) {
+        const props = clonePotentialNode(node.props, [...path, "props"], seen);
+        if (props !== node.props)
+            result.props = props;
+    }
+    return result;
+}
+function clonePotentialNode(value, path, seen) {
+    if (isNodeLike(value)) {
+        return cloneNodeWithAuthoredIds(value, path, seen);
+    }
+    if (Array.isArray(value)) {
+        let changed = false;
+        const next = value.map((item, index) => {
+            const cloned = clonePotentialNode(item, [...path, index], seen);
+            changed ||= cloned !== item;
+            return cloned;
+        });
+        return changed ? next : value;
+    }
+    if (isPlainObject(value)) {
+        let changed = false;
+        const result = {};
+        for (const [key, child] of Object.entries(value)) {
+            const cloned = clonePotentialNode(child, [...path, key], seen);
+            changed ||= cloned !== child;
+            result[key] = cloned;
+        }
+        return changed ? result : value;
+    }
+    return value;
+}
+export function withAuthoredNodeIds(rawSiteJson) {
+    const seen = new Set();
+    const result = { ...rawSiteJson };
+    if (Array.isArray(rawSiteJson.pages)) {
+        result.pages = rawSiteJson.pages.map((page, index) => {
+            if (!isPlainObject(page))
+                return page;
+            const nextPage = { ...page };
+            if ("tree" in page) {
+                nextPage.tree = clonePotentialNode(page.tree, ["pages", index, "tree"], seen);
+            }
+            return nextPage;
+        });
+    }
+    if (isPlainObject(rawSiteJson.layouts)) {
+        const layouts = {};
+        for (const [layoutName, layoutDef] of Object.entries(rawSiteJson.layouts)) {
+            if (!isPlainObject(layoutDef)) {
+                layouts[layoutName] = layoutDef;
+                continue;
+            }
+            const nextLayout = { ...layoutDef };
+            if ("tree" in layoutDef) {
+                nextLayout.tree = clonePotentialNode(layoutDef.tree, ["layouts", layoutName, "tree"], seen);
+            }
+            layouts[layoutName] = nextLayout;
+        }
+        result.layouts = layouts;
+    }
+    if (isPlainObject(rawSiteJson.symbols)) {
+        const symbols = {};
+        for (const [symbolName, symbolDef] of Object.entries(rawSiteJson.symbols)) {
+            if (!isPlainObject(symbolDef)) {
+                symbols[symbolName] = symbolDef;
+                continue;
+            }
+            const nextSymbol = { ...symbolDef };
+            if ("tree" in symbolDef) {
+                nextSymbol.tree = clonePotentialNode(symbolDef.tree, ["symbols", symbolName, "tree"], seen);
+            }
+            symbols[symbolName] = nextSymbol;
+        }
+        result.symbols = symbols;
+    }
+    return result;
+}
+//# sourceMappingURL=nodeIdentity.js.map

package/dist/utils/nodeIdentity.js.map

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

package/dist/utils/resolveConfig.d.ts

@@ -28,6 +28,11 @@ export interface ResolveOptions {
     assetCdnBase: string;
     buildingIds: number[];
     preserveKeys?: boolean;
+    /**
+     * Editor/preview-only identity substrate. Default stays off so existing
+     * compiler/consumer output remains byte-identical.
+     */
+    includeIdentity?: boolean;
 }
 /**
  * A reusable named subtree. `tree` is a template that may contain

package/dist/utils/resolveConfig.d.ts.map

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

package/dist/utils/resolveConfig.js

@@ -11,6 +11,8 @@
  * interpolates {{variable}} tokens, resolves asset URLs, and expands
  * BuildingSlice / building_template directives.
  */
+import { appendRenderedNodePathSegments, getRenderedNodePath, renderedNodePathForAuthoredId, withAuthoredNodeIds, withRenderedNodePath, } from "./nodeIdentity";
+import { tokenToCssVarReference } from "./themeTokens";
 // Resolution order from most-specific to least-specific
 const RESOLUTION_ORDER = ["building", "site", "org", "template", "global"];
 // Authoring-only keys stripped from resolved output; `theme` stays (consumed by
@@ -100,6 +102,38 @@ function buildAssetScopes(siteId, orgId, templateId, buildingId) {
     scopes.push("assets/global/");
     return scopes;
 }
+function authoredIdOf(node) {
+    return typeof node["id"] === "string" && node["id"] ? node["id"] : undefined;
+}
+function renderedPathForNode(node, ctx) {
+    if (!ctx.identityEnabled)
+        return undefined;
+    const basePath = getRenderedNodePath(node);
+    if (!basePath)
+        return undefined;
+    return appendRenderedNodePathSegments(basePath, ctx.renderedSegments);
+}
+function applyRenderedContext(source, result, ctx) {
+    const path = renderedPathForNode(source, ctx);
+    return path ? withRenderedNodePath(result, path) : result;
+}
+function syntheticNodeFromSource(source, type, props, children, ctx, synthetic) {
+    const id = authoredIdOf(source);
+    const result = { type, props, children };
+    if (id) {
+        result["id"] = id;
+    }
+    if (id && ctx.identityEnabled) {
+        const path = appendRenderedNodePathSegments(renderedNodePathForAuthoredId(id), [...ctx.renderedSegments, { synthetic }]);
+        return withRenderedNodePath(result, path);
+    }
+    return result;
+}
+function withRenderedSegment(ctx, segment) {
+    if (!ctx.identityEnabled)
+        return ctx;
+    return { ...ctx, renderedSegments: [...ctx.renderedSegments, segment] };
+}
 function substituteNode(node, ctx) {
     if (typeof node === "string") {
         return interpolate(node, ctx.varsMap);
@@ -146,12 +180,18 @@ function substituteNode(node, ctx) {
             }
             return resolved;
         }
+        if (ctx.resolveTokenBindings && keys.length === 1 && keys[0] === "$token") {
+            const tokenName = obj["$token"];
+            return typeof tokenName === "string" ? tokenToCssVarReference(tokenName) : "";
+        }
         // Regular dict — recurse into values
         const result = {};
         for (const [k, v] of Object.entries(obj)) {
             result[k] = substituteNode(v, ctx);
         }
-        return result;
+        return typeof obj["type"] === "string"
+            ? applyRenderedContext(obj, result, ctx)
+            : result;
     }
     // int, float, bool, null — pass through
     return node;
@@ -174,16 +214,18 @@ function expandBuildingSlice(node, ctx) {
     const template = node["template"];
     const props = node["props"] ?? {};
     if (typeof template !== "object" || template === null || Array.isArray(template)) {
-        return { type: "Grid", props, children: [] };
+        return syntheticNodeFromSource(node, "Grid", props, [], ctx, "BuildingSlice");
     }
     const children = [];
-    for (const bid of ctx.buildingIds) {
+    for (const [index, bid] of ctx.buildingIds.entries()) {
         const buildingBlob = ctx.buildingBlobCache[bid] ?? {};
         const buildingBlobs = { ...ctx.commonBlobs, building: buildingBlob };
         const baseCtx = {
             assetManifest: ctx.assetManifest,
             assetCdnBase: ctx.assetCdnBase,
             preserveKeys: ctx.preserveKeys,
+            identityEnabled: ctx.identityEnabled,
+            resolveTokenBindings: ctx.resolveTokenBindings,
             buildingIds: ctx.buildingIds,
             buildingBlobCache: ctx.buildingBlobCache,
             commonBlobs: ctx.commonBlobs,
@@ -195,14 +237,19 @@ function expandBuildingSlice(node, ctx) {
             symbolBudget: ctx.symbolBudget,
             datasets: ctx.datasets,
             rawTheme: ctx.rawTheme,
+            renderedSegments: ctx.renderedSegments,
         };
         // Route the template root through substituteNode so a root-level directive
         // (Symbol/BuildingSlice/$content/$key) is dispatched, not left raw per-building.
-        const perBuildingCtx = makeCtx(buildingBlobs, baseCtx, bid);
+        const perBuildingCtx = withRenderedSegment(makeCtx(buildingBlobs, baseCtx, bid), {
+            buildingSlice: authoredIdOf(node) ?? "unknown",
+            index,
+            buildingId: String(bid),
+        });
         const resolved = substituteNode(template, perBuildingCtx);
         children.push(resolved);
     }
-    return { type: "Grid", props, children };
+    return syntheticNodeFromSource(node, "Grid", props, children, ctx, "BuildingSlice");
 }
 /** The non-empty `theme.modes[modeKey]` override map, or null. */
 function readBuildingMode(rawTheme, modeKey) {
@@ -243,11 +290,12 @@ function expandRepeat(node, ctx) {
     // No buildings → render the emptyState (in the current scope) or an empty group.
     if (ctx.buildingIds.length === 0) {
         const emptyState = node["emptyState"];
-        const emptyChildren = emptyState != null ? [substituteNode(emptyState, ctx)] : [];
-        return { type: "Fragment", props: {}, children: emptyChildren };
+        const emptyCtx = withRenderedSegment(ctx, { synthetic: "Repeat.emptyState" });
+        const emptyChildren = emptyState != null ? [substituteNode(emptyState, emptyCtx)] : [];
+        return syntheticNodeFromSource(node, "Fragment", {}, emptyChildren, ctx, "Repeat.emptyState");
     }
     const perBuilding = [];
-    for (const bid of ctx.buildingIds) {
+    for (const [index, bid] of ctx.buildingIds.entries()) {
         // Bound fan-out (shared Symbol budget): nested compile Repeats over the same dataset
         // are N^D nodes, which the depth-less expansion can't otherwise stop before OOM.
         ctx.symbolBudget.count += 1;
@@ -260,6 +308,8 @@ function expandRepeat(node, ctx) {
             assetManifest: ctx.assetManifest,
             assetCdnBase: ctx.assetCdnBase,
             preserveKeys: ctx.preserveKeys,
+            identityEnabled: ctx.identityEnabled,
+            resolveTokenBindings: ctx.resolveTokenBindings,
             buildingIds: ctx.buildingIds,
             buildingBlobCache: ctx.buildingBlobCache,
             commonBlobs: ctx.commonBlobs,
@@ -271,32 +321,25 @@ function expandRepeat(node, ctx) {
             symbolBudget: ctx.symbolBudget,
             datasets: ctx.datasets,
             rawTheme: ctx.rawTheme,
+            renderedSegments: ctx.renderedSegments,
         };
-        const perBuildingCtx = makeCtx(buildingBlobs, baseCtx, bid);
+        const perBuildingCtx = withRenderedSegment(makeCtx(buildingBlobs, baseCtx, bid), { repeat: String(datasetName), index, buildingId: String(bid) });
         const resolvedChildren = children.map((child) => substituteNode(child, perBuildingCtx));
         // Per-building data scope (D8). `as` lets a future runtime Repeat address the record.
         const providerProps = { propertyId: String(bid) };
         if (as != null)
             providerProps["as"] = as;
-        let wrapped = {
-            type: "DataProvider",
-            props: providerProps,
-            children: resolvedChildren,
-        };
+        let wrapped = syntheticNodeFromSource(node, "DataProvider", providerProps, resolvedChildren, perBuildingCtx, "Repeat.DataProvider");
         // Overlay the building's theme mode, if any. assembleTheme strips `modes` from the
         // resolved theme, so feed it to ThemeScope via props.
         const modeKey = `building:${bid}`;
         const modeOverrides = readBuildingMode(ctx.rawTheme, modeKey);
         if (modeOverrides) {
-            wrapped = {
-                type: "ThemeScope",
-                props: { theme: { modes: { [modeKey]: modeOverrides } }, modeKey },
-                children: [wrapped],
-            };
+            wrapped = syntheticNodeFromSource(node, "ThemeScope", { theme: { modes: { [modeKey]: modeOverrides } }, modeKey }, [wrapped], perBuildingCtx, "Repeat.ThemeScope");
         }
         perBuilding.push(wrapped);
     }
-    return { type: "Fragment", props: {}, children: perBuilding };
+    return syntheticNodeFromSource(node, "Fragment", {}, perBuilding, ctx, "Repeat");
 }
 /**
  * Runtime `Repeat`: does NOT fan out. Resolves the child subtree ONCE as a template (leaving
@@ -315,16 +358,20 @@ function emitRuntimeRepeat(node, dataset, ctx) {
     // A single child is the template; multiple children are wrapped in a Fragment so each record renders all of them.
     const template = resolvedChildren.length === 1
         ? resolvedChildren[0]
-        : { type: "Fragment", props: {}, children: resolvedChildren };
+        : syntheticNodeFromSource(node, "Fragment", {}, resolvedChildren, ctx, "Repeat.template");
     // Inline the dataset def (resolving any $content/{{var}} in a filter; {$data} stays intact) so the
     // emitted Repeat is self-contained — the top-level `datasets` map is stripped from the output.
     const resolvedDataset = substituteNode(dataset, ctx);
     const props = { dataset: resolvedDataset, as, template };
     const emptyState = node["emptyState"];
     if (emptyState != null) {
-        props["emptyState"] = substituteNode(emptyState, ctx);
+        props["emptyState"] = substituteNode(emptyState, withRenderedSegment(ctx, { synthetic: "Repeat.emptyState" }));
     }
-    return { type: "Repeat", props };
+    const result = { type: "Repeat", props };
+    const id = authoredIdOf(node);
+    if (id)
+        result["id"] = id;
+    return applyRenderedContext(node, result, ctx);
 }
 function isSingleKeyBinding(node, key) {
     return (typeof node === "object" &&
@@ -472,7 +519,7 @@ function expandSymbol(node, ctx) {
         throw new Error(`Symbol "${ref}" left a Slot after expansion (named slots must be filled; anonymous Slots are layout-only)`);
     }
     // Resolve in the instance scope; bump depth so a nested Symbol stays bounded.
-    const childCtx = { ...ctx, symbolDepth: ctx.symbolDepth + 1 };
+    const childCtx = withRenderedSegment({ ...ctx, symbolDepth: ctx.symbolDepth + 1 }, { symbol: ref, instanceId: authoredIdOf(node) ?? "unknown" });
     return substituteNode(rootNode, childCtx);
 }
 function replaceSlot(node, pageTree) {
@@ -566,7 +613,8 @@ export function assembleTheme(rawTheme, buildingId) {
 // Main resolver
 // ---------------------------------------------------------------------------
 export function resolveConfig(options) {
-    const { rawSiteJson, contentBlobs, assetManifest, assetCdnBase, buildingIds, preserveKeys = false, } = options;
+    const { rawSiteJson, contentBlobs, assetManifest, assetCdnBase, buildingIds, preserveKeys = false, includeIdentity = false, } = options;
+    const authoredSiteJson = includeIdentity ? withAuthoredNodeIds(rawSiteJson) : rawSiteJson;
     // Pre-fetch all building blobs from the content blobs input
     const buildingBlobCache = {};
     for (const bid of buildingIds) {
@@ -590,22 +638,24 @@ export function resolveConfig(options) {
     // Extract site context from rawSiteJson for asset scope resolution
     // (orgId/templateId are not in site.json — they come from DynamoDB in production.
     //  For client-side preview, we pass them via contentBlobs keys or infer from context.)
-    const siteId = rawSiteJson.siteId;
-    const orgId = rawSiteJson._orgId;
-    const templateId = rawSiteJson._templateId;
+    const siteId = authoredSiteJson.siteId;
+    const orgId = authoredSiteJson._orgId;
+    const templateId = authoredSiteJson._templateId;
     // Normalize a non-object `symbols` to {} so an invalid value can't crash on index.
-    const symbols = isPlainObject(rawSiteJson.symbols)
-        ? rawSiteJson.symbols
+    const symbols = isPlainObject(authoredSiteJson.symbols)
+        ? authoredSiteJson.symbols
         : {};
     // Same normalization for `datasets` (consumed by the compile-time Repeat expansion).
-    const datasets = isPlainObject(rawSiteJson.datasets)
-        ? rawSiteJson.datasets
+    const datasets = isPlainObject(authoredSiteJson.datasets)
+        ? authoredSiteJson.datasets
         : {};
-    const rawTheme = isPlainObject(rawSiteJson.theme) ? rawSiteJson.theme : undefined;
+    const rawTheme = isPlainObject(authoredSiteJson.theme) ? authoredSiteJson.theme : undefined;
     const baseCtx = {
         assetManifest,
         assetCdnBase,
         preserveKeys,
+        identityEnabled: includeIdentity,
+        resolveTokenBindings: true,
         buildingIds,
         buildingBlobCache,
         commonBlobs,
@@ -618,22 +668,27 @@ export function resolveConfig(options) {
         symbolBudget: { count: 0 },
         datasets,
         rawTheme,
+        renderedSegments: [],
     };
     // Resolve top-level fields without building scope. `symbols`/`datasets` are excluded:
     // they're consumed only at their use sites and stripped from output; walking them here
     // would resolve nested bindings out of context.
-    const rawLayouts = rawSiteJson.layouts ?? {};
+    const rawLayouts = authoredSiteJson.layouts ?? {};
     const siteMinusPages = {};
-    for (const [k, v] of Object.entries(rawSiteJson)) {
-        if (k !== "pages" && k !== "layouts" && k !== "symbols" && k !== "datasets") {
+    for (const [k, v] of Object.entries(authoredSiteJson)) {
+        if (k !== "pages" && k !== "layouts" && k !== "symbols" && k !== "datasets" && k !== "theme") {
             siteMinusPages[k] = v;
         }
     }
     const resolvedBase = substituteTree(siteMinusPages, siteBlobs, baseCtx, null);
+    if ("theme" in authoredSiteJson) {
+        const resolvedTheme = substituteTree({ theme: authoredSiteJson.theme }, siteBlobs, { ...baseCtx, resolveTokenBindings: false }, null);
+        resolvedBase["theme"] = resolvedTheme["theme"];
+    }
     // Resolve building slugs
     const buildingSlugs = resolveBuildingSlugs(buildingIds, buildingBlobCache, commonBlobs);
     // Resolve each page
-    const rawPages = rawSiteJson.pages ?? [];
+    const rawPages = authoredSiteJson.pages ?? [];
     const resolvedPages = [];
     for (const page of rawPages) {
         if (page.building_template) {