@batterai/host 0.1.0

package/dist/resolver/resolution-service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * BindingResolutionService (decision 004 §2.2 + §3.2): the one facade every
+ * render path calls. Wave 1 = page-level needs + repeater row sets; wave N =
+ * per-item template needs, batched across ALL items of ALL repeaters at that
+ * depth — depth+1 loader calls for nesting depth d, never per-row I/O.
+ * Records binding->page dependencies as a by-product (invariant F).
+ */
+import { type ContentType, type ContentTypeId, type DataView, type Instance, type Locale, type Page, type RepeaterNode, type ScopeStack, type TimeZone } from "@batterai/bind-core";
+import type { ContentSource } from "../content-source/content-source";
+import type { Viewer } from "../content-source/viewer";
+import type { BindingDependencyGraph } from "../cache/dependency-graph";
+export interface RenderRequestCtx {
+    readonly locale: Locale;
+    readonly fallbackLocale?: Locale;
+    readonly timeZone: TimeZone;
+    readonly viewer: Viewer;
+}
+export interface RepeaterRender {
+    readonly node: RepeaterNode;
+    readonly items: readonly Instance[];
+    readonly itemStacks: readonly ScopeStack[];
+    readonly cursor?: string;
+    readonly hasMore: boolean;
+}
+export interface ResolvedPage {
+    readonly view: DataView;
+    readonly pageStack: ScopeStack;
+    readonly repeaters: ReadonlyMap<string, RepeaterRender>;
+    readonly loaderCalls: readonly string[];
+}
+export declare class BindingResolutionService {
+    private readonly source;
+    private readonly contentTypes;
+    private readonly depGraph?;
+    constructor(source: ContentSource, contentTypes: ReadonlyMap<ContentTypeId, ContentType>, depGraph?: BindingDependencyGraph | undefined);
+    private ctxOf;
+    resolvePage(page: Page, ctx: RenderRequestCtx, detail?: {
+        contentTypeId: ContentTypeId;
+        instanceId: Instance["id"];
+    }): Promise<ResolvedPage>;
+    /** Infinite-scroll append (Phase 7): resolve ONE top-level repeater's next
+     * page through the SAME loader/query machinery as the initial render —
+     * never a bespoke lighter path that could drift (invariant A append). */
+    resolveNextPage(page: Page, repeaterId: string, cursor: string, ctx: RenderRequestCtx): Promise<{
+        render: RepeaterRender;
+        view: DataView;
+    } | undefined>;
+}
+//# sourceMappingURL=resolution-service.d.ts.map

package/dist/resolver/resolution-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-service.d.ts","sourceRoot":"","sources":["../../src/resolver/resolution-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAElB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EAGT,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAWxE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAcD,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAFT,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,WAAW,CAAC,aAAa,EAAE,WAAW,CAAC,EACrD,QAAQ,CAAC,EAAE,sBAAsB,YAAA;IAGpD,OAAO,CAAC,KAAK;IAUP,WAAW,CACf,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,gBAAgB,EACrB,MAAM,CAAC,EAAE;QAAE,aAAa,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;KAAE,GACpE,OAAO,CAAC,YAAY,CAAC;IAqHxB;;6EAEyE;IACnE,eAAe,CACnB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,SAAS,CAAC;CA2BnE"}

package/dist/resolver/resolution-service.js

@@ -0,0 +1,193 @@
+/**
+ * BindingResolutionService (decision 004 §2.2 + §3.2): the one facade every
+ * render path calls. Wave 1 = page-level needs + repeater row sets; wave N =
+ * per-item template needs, batched across ALL items of ALL repeaters at that
+ * depth — depth+1 loader calls for nesting depth d, never per-row I/O.
+ * Records binding->page dependencies as a by-product (invariant F).
+ */
+import { planDataNeeds, } from "@batterai/bind-core";
+import { buildDetailStack, buildPageStack, fillStructural, itemStack, } from "../scope-engine/build-stack.js";
+import { applyRepeaterQuery } from "../scope-engine/repeater-query.js";
+import { HostDataLoader } from "./data-loader.js";
+function collectRepeaters(nodes, out = []) {
+    for (const n of nodes) {
+        if (n.kind === "repeater") {
+            out.push(n);
+            collectRepeaters([n.itemTemplate], out);
+        }
+        else if (n.children) {
+            collectRepeaters(n.children, out);
+        }
+    }
+    return out;
+}
+export class BindingResolutionService {
+    source;
+    contentTypes;
+    depGraph;
+    constructor(source, contentTypes, depGraph) {
+        this.source = source;
+        this.contentTypes = contentTypes;
+        this.depGraph = depGraph;
+    }
+    ctxOf(ctx) {
+        // No viewer/scope cross-check (decision 012, invariant D4): data scoping is
+        // delegated to the CMS and the resolve pipeline carries no owner brand.
+        return {
+            locale: ctx.locale,
+            fallbackLocale: ctx.fallbackLocale,
+            timeZone: ctx.timeZone,
+        };
+    }
+    async resolvePage(page, ctx, detail) {
+        const planCtx = this.ctxOf(ctx);
+        const structural = detail
+            ? buildDetailStack(page, detail.contentTypeId)
+            : buildPageStack(page);
+        const loader = new HostDataLoader(this.source, ctx.viewer, this.contentTypes);
+        const needKeyOf = (node) => HostDataLoader.needKey({ kind: "instances", contentTypeId: node.boundType, query: node.query });
+        // ---- wave 1: page-level needs + the detail instance ------------------
+        const waveOneNeeds = [];
+        if (detail) {
+            waveOneNeeds.push({
+                kind: "instance",
+                contentTypeId: detail.contentTypeId,
+                instanceId: detail.instanceId,
+            });
+        }
+        const topRepeaters = collectRepeaters(page.root).filter((r) => !isNested(r, page.root));
+        for (const rep of topRepeaters) {
+            waveOneNeeds.push({ kind: "instances", contentTypeId: rep.boundType, query: rep.query });
+        }
+        // Page-level (non-repeater) block needs against the (partially) filled stack.
+        const filledHoles = new Map();
+        let view = await loader.load(waveOneNeeds, planCtx);
+        if (detail) {
+            const inst = view.getInstance(detail.contentTypeId, detail.instanceId);
+            if (!inst) {
+                // Loader contract already threw UnsatisfiableNeed if missing; this is
+                // a type-level guard only.
+                throw new Error("detail instance missing after load");
+            }
+            const ct = this.contentTypes.get(detail.contentTypeId);
+            const holeId = structural.find((f) => f.kind === "instance-hole").scopeId;
+            filledHoles.set(holeId, { instance: inst, contentType: ct });
+            this.depGraph?.recordDependency(page.id, {
+                kind: "instance",
+                contentTypeId: detail.contentTypeId,
+                instanceId: detail.instanceId,
+            });
+        }
+        const pageStack = fillStructural(structural, filledHoles);
+        // Plan the non-repeater needs of the page tree now that the root stack is real.
+        const pageNeeds = [];
+        for (const node of page.root) {
+            pageNeeds.push(...planDataNeeds(node, pageStack, planCtx));
+        }
+        if (pageNeeds.length > 0)
+            view = await loader.load(pageNeeds, planCtx);
+        // ---- wave 2..depth+1: repeater items, batched per depth --------------
+        const repeaters = new Map();
+        let frontier = topRepeaters.map((node) => ({
+            node,
+            parent: structural,
+        }));
+        while (frontier.length > 0) {
+            const next = [];
+            const waveNeeds = [];
+            const perRepeater = [];
+            for (const entry of frontier) {
+                const { node } = entry;
+                const ct = this.contentTypes.get(node.boundType);
+                if (!ct)
+                    throw new Error(`unknown content type ${node.boundType}`);
+                const raw = view.getInstancePage(node.boundType, needKeyOf(node)) ?? [];
+                // Invariant I: filter -> sort -> pageSize against candidates.
+                const items = applyRepeaterQuery(raw, node.query, (inst, i) => itemStack(entry.parent, node, i, inst, ct), view);
+                const stacks = items.map((inst, i) => itemStack(entry.parent, node, i, inst, ct));
+                perRepeater.push({ entry, items, stacks });
+                this.depGraph?.recordDependency(page.id, {
+                    kind: "instance",
+                    contentTypeId: node.boundType,
+                    instanceId: "*", // content-type-granular (conservative)
+                });
+                // Union the item templates' needs across ALL items (batched wave).
+                items.forEach((_inst, i) => {
+                    waveNeeds.push(...planDataNeeds(node.itemTemplate, stacks[i], planCtx));
+                });
+                // Discover nested repeaters for the next depth.
+                for (const nested of collectRepeaters([node.itemTemplate]).filter((r) => r !== node)) {
+                    waveNeeds.push({ kind: "instances", contentTypeId: nested.boundType, query: nested.query });
+                    next.push({ node: nested, parent: entry.parent });
+                }
+            }
+            if (waveNeeds.length > 0)
+                view = await loader.load(waveNeeds, planCtx);
+            for (const { entry, items, stacks } of perRepeater) {
+                const meta = loader.pageMeta(needKeyOf(entry.node));
+                repeaters.set(entry.node.id, {
+                    node: entry.node,
+                    items,
+                    itemStacks: stacks,
+                    cursor: meta?.cursor,
+                    hasMore: meta?.hasMore ?? false,
+                });
+            }
+            frontier = next;
+        }
+        return { view, pageStack, repeaters, loaderCalls: loader.callLog };
+    }
+    /** Infinite-scroll append (Phase 7): resolve ONE top-level repeater's next
+     * page through the SAME loader/query machinery as the initial render —
+     * never a bespoke lighter path that could drift (invariant A append). */
+    async resolveNextPage(page, repeaterId, cursor, ctx) {
+        const planCtx = this.ctxOf(ctx);
+        const node = collectRepeaters(page.root).find((r) => r.id === repeaterId);
+        if (!node)
+            return undefined;
+        const structural = buildPageStack(page);
+        const loader = new HostDataLoader(this.source, ctx.viewer, this.contentTypes);
+        const need = {
+            kind: "instances",
+            contentTypeId: node.boundType,
+            query: node.query,
+            cursor,
+        };
+        let view = await loader.load([need], planCtx);
+        const ct = this.contentTypes.get(node.boundType);
+        if (!ct)
+            throw new Error(`unknown content type ${node.boundType}`);
+        const raw = view.getInstancePage(node.boundType, HostDataLoader.needKey(need)) ?? [];
+        const items = applyRepeaterQuery(raw, node.query, (inst, i) => itemStack(structural, node, i, inst, ct), view);
+        const stacks = items.map((inst, i) => itemStack(structural, node, i, inst, ct));
+        const waveNeeds = [];
+        items.forEach((_inst, i) => waveNeeds.push(...planDataNeeds(node.itemTemplate, stacks[i], planCtx)));
+        if (waveNeeds.length > 0)
+            view = await loader.load(waveNeeds, planCtx);
+        const meta = loader.pageMeta(HostDataLoader.needKey(need));
+        return {
+            render: { node, items, itemStacks: stacks, cursor: meta?.cursor, hasMore: meta?.hasMore ?? false },
+            view,
+        };
+    }
+}
+function isNested(rep, roots) {
+    // A repeater is nested iff it appears inside another repeater's itemTemplate.
+    const walk = (nodes, insideRepeater) => {
+        for (const n of nodes) {
+            if (n.kind === "repeater") {
+                if (n === rep)
+                    return insideRepeater;
+                if (walk([n.itemTemplate], true))
+                    return true;
+            }
+            else if (n.children) {
+                if (walk(n.children, insideRepeater))
+                    return true;
+            }
+        }
+        return false;
+    };
+    return walk(roots, false);
+}
+//# sourceMappingURL=resolution-service.js.map

package/dist/resolver/resolution-service.js.map

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

package/dist/routing/route-resolver.d.ts

@@ -0,0 +1,73 @@
+/**
+ * RouteResolver (decision 004 §6): path -> page | detail+instance,
+ * preview-vs-public modes, real 404 semantics. Public mode reads ONLY
+ * published snapshots. Tenancy is delegated to the CMS (decision 012): the
+ * resolver never gates on identity — the CMS authorizes each delegated read.
+ */
+import type { ContentTypeId, InstanceId, Page, PageId } from "@batterai/bind-core";
+import type { Viewer } from "../content-source/viewer";
+import type { ContentSource } from "../content-source/content-source";
+import type { LifecycleStore } from "../lifecycle/lifecycle-store";
+import type { PageMetadataModel } from "../seo/metadata";
+import type { CanvasPage } from "@batterai/contract";
+export type RequestMode = "public" | "preview";
+export type RouteMatch = {
+    readonly kind: "page";
+    readonly page: Page;
+    readonly metadata?: PageMetadataModel;
+} | {
+    readonly kind: "detail";
+    readonly page: Page;
+    readonly metadata?: PageMetadataModel;
+    readonly contentTypeId: ContentTypeId;
+    readonly instanceId: InstanceId;
+} | {
+    readonly kind: "not-found";
+} | {
+    readonly kind: "forbidden";
+    readonly reason: string;
+};
+/** The lifecycle unit: page tree + its metadata versioned TOGETHER (decision
+ * 004 §7.1 — a rollback can't leave stale bound metadata behind). */
+export interface PageRecord {
+    readonly page: Page;
+    readonly metadata?: PageMetadataModel;
+    /** Canvas-owned page fields versioned in the same durable collaboration
+     * record as the ordered block tree. CMS authority fields never belong here. */
+    readonly canvasSettings?: Omit<CanvasPage, "id" | "root">;
+}
+export interface DetailRoutePattern {
+    /** e.g. "/nieuws/" — a path prefix; the remainder is the instance slug/id. */
+    readonly prefix: string;
+    readonly contentTypeId: ContentTypeId;
+    readonly detailPageId: PageId;
+    /** Which field carries the slug; "id" means the raw instance id. */
+    readonly slugField: string;
+}
+export interface RouteRegistry {
+    /** Static page routes: path -> pageId. */
+    readonly pages: ReadonlyMap<string, PageId>;
+    readonly detailPatterns: readonly DetailRoutePattern[];
+}
+export interface RouteResolverDeps {
+    readonly registry: RouteRegistry | undefined;
+    readonly lifecycle: LifecycleStore<PageRecord>;
+    readonly source: ContentSource;
+    /** Resolve a slug to an instance id (adapter-backed; "id" slugField skips). */
+    readonly findBySlug: (contentTypeId: ContentTypeId, slugField: string, slug: string, viewer: Viewer) => Promise<InstanceId | undefined>;
+}
+export declare function createRouteResolver(deps: RouteResolverDeps): {
+    resolve(path: string, mode: RequestMode, viewer: Viewer): Promise<RouteMatch>;
+    /** Public-mode routable URLs — the sitemap's data source. Draft-only and
+     * unpublished content never appears. */
+    listPublicRoutes(viewer: Viewer): AsyncIterable<{
+        path: string;
+        lastModified: string;
+    }>;
+    /** page-id -> public href lookup for portable internal links. Detail
+     * routes remain instance-driven; this helper only maps static page ids
+     * present in the route registry. */
+    hrefForPage(pageId: PageId): string | undefined;
+};
+export type RouteResolver = ReturnType<typeof createRouteResolver>;
+//# sourceMappingURL=route-resolver.d.ts.map

package/dist/routing/route-resolver.d.ts.map

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

package/dist/routing/route-resolver.js

@@ -0,0 +1,114 @@
+function instanceLastModified(inst, fallback) {
+    for (const field of ["updatedAt", "publishedAt", "date"]) {
+        const value = inst.values[field];
+        if (typeof value === "string" && !Number.isNaN(Date.parse(value)))
+            return value;
+    }
+    return fallback;
+}
+export function createRouteResolver(deps) {
+    async function loadPage(pageId, mode, viewer) {
+        if (mode === "preview") {
+            // Preview requires an authenticated viewer — checked by resolve().
+            return ((await deps.lifecycle.getDraft({ kind: "page", pageId }, viewer)) ??
+                (await deps.lifecycle.getPublished({ kind: "page", pageId }))?.data);
+        }
+        // Public: ONLY published snapshots; never a draft fallback.
+        return (await deps.lifecycle.getPublished({ kind: "page", pageId }))?.data;
+    }
+    return {
+        async resolve(path, mode, viewer) {
+            // No identity gate here (decision 012, invariant D4): every Viewer carries
+            // a delegated CMS session, and the CMS authorizes each draft/published
+            // read (getDraft/getPublished delegate the session). battery-editor is not
+            // a second authority — it never refuses on its own.
+            const registry = deps.registry;
+            if (!registry)
+                return { kind: "not-found" };
+            const normalized = path !== "/" && path.endsWith("/") ? path.slice(0, -1) : path;
+            const pageId = registry.pages.get(normalized);
+            if (pageId) {
+                const record = await loadPage(pageId, mode, viewer);
+                if (!record)
+                    return { kind: "not-found" }; // never published => 404, not an empty shell
+                return { kind: "page", page: record.page, metadata: record.metadata };
+            }
+            for (const pattern of registry.detailPatterns) {
+                if (!normalized.startsWith(pattern.prefix))
+                    continue;
+                const slug = normalized.slice(pattern.prefix.length);
+                if (!slug || slug.includes("/"))
+                    continue;
+                const instanceId = pattern.slugField === "id"
+                    ? slug
+                    : await deps.findBySlug(pattern.contentTypeId, pattern.slugField, slug, viewer);
+                if (!instanceId)
+                    return { kind: "not-found" };
+                const exists = await deps.source.getInstance(pattern.contentTypeId, instanceId, viewer);
+                if (!exists)
+                    return { kind: "not-found" };
+                const record = await loadPage(pattern.detailPageId, mode, viewer);
+                if (!record)
+                    return { kind: "not-found" };
+                return {
+                    kind: "detail",
+                    page: record.page,
+                    metadata: record.metadata,
+                    contentTypeId: pattern.contentTypeId,
+                    instanceId,
+                };
+            }
+            return { kind: "not-found" };
+        },
+        /** Public-mode routable URLs — the sitemap's data source. Draft-only and
+         * unpublished content never appears. */
+        async *listPublicRoutes(viewer) {
+            const registry = deps.registry;
+            if (!registry)
+                return;
+            for (const [path, pageId] of registry.pages) {
+                const snap = await deps.lifecycle.getPublished({ kind: "page", pageId });
+                if (snap)
+                    yield { path, lastModified: snap.publishedAt };
+            }
+            for (const pattern of registry.detailPatterns) {
+                const detailPublished = await deps.lifecycle.getPublished({
+                    kind: "page",
+                    pageId: pattern.detailPageId,
+                });
+                if (!detailPublished)
+                    continue;
+                let cursor;
+                do {
+                    const page = await deps.source.listInstances(pattern.contentTypeId, { pageSize: 100 }, cursor, viewer);
+                    for (const inst of page.items) {
+                        const slug = pattern.slugField === "id"
+                            ? inst.id
+                            : String(inst.values[pattern.slugField] ?? "");
+                        if (slug) {
+                            yield {
+                                path: `${pattern.prefix}${slug}`,
+                                lastModified: instanceLastModified(inst, detailPublished.publishedAt),
+                            };
+                        }
+                    }
+                    cursor = page.hasMore ? page.cursor : undefined;
+                } while (cursor);
+            }
+        },
+        /** page-id -> public href lookup for portable internal links. Detail
+         * routes remain instance-driven; this helper only maps static page ids
+         * present in the route registry. */
+        hrefForPage(pageId) {
+            const registry = deps.registry;
+            if (!registry)
+                return undefined;
+            for (const [path, candidate] of registry.pages) {
+                if (candidate === pageId)
+                    return path;
+            }
+            return undefined;
+        },
+    };
+}
+//# sourceMappingURL=route-resolver.js.map

package/dist/routing/route-resolver.js.map

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

package/dist/scope-engine/build-stack.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Structural scope-stack construction (decision 004 §2.1). Pure sync tree
+ * shaping; instances attach in the planning waves. StructuralStack is a
+ * distinct type so the compiler forces callers through the fill functions
+ * before treating a stack as resolve()-ready.
+ */
+import { type ContentType, type ContentTypeId, type Instance, type Page, type RepeaterNode, type ScopeId, type ScopeStack } from "@batterai/bind-core";
+export type StructuralFrame = {
+    readonly kind: "page";
+    readonly scopeId: ScopeId;
+    readonly page: Page;
+} | {
+    readonly kind: "repeater-hole";
+    readonly scopeId: ScopeId;
+    readonly node: RepeaterNode;
+} | {
+    readonly kind: "instance-hole";
+    readonly scopeId: ScopeId;
+    readonly contentTypeId: ContentTypeId;
+};
+export type StructuralStack = readonly StructuralFrame[];
+/**
+ * STABLE TEMPLATE SCOPE IDS (host convention, surfaced during the Phase-5
+ * build — a gap decision 004 didn't name): templates are authored ONCE but
+ * render for MANY instances, so the frame scopeId an authored chip matches
+ * must be stable across instances. Sentinels:
+ *   detail template's instance frame : instance:<ct>:@detail
+ *   repeater item's instance frame   : <repeaterScope>>>>instance:<ct>:@item
+ * The frame's DATA varies per item; its identity does not. bind-core's exact
+ * findFrame match is untouched — this is purely how the host names frames.
+ */
+export declare function detailScopeId(contentTypeId: ContentTypeId): ScopeId;
+export declare function itemScopeId(repeaterScope: ScopeId, contentTypeId: ContentTypeId): ScopeId;
+export declare function buildPageStack(page: Page): StructuralStack;
+/** Detail-template root: page frame + one instance hole under the STABLE
+ * detail scope id (authored chips match every routed instance). */
+export declare function buildDetailStack(page: Page, contentTypeId: ContentTypeId): StructuralStack;
+/** Per-item descent for a repeater: repeater frame (index) + instance frame
+ * under the STABLE item scope id. Nested repeaters chain via the parent's
+ * item scope so ids never collide across nesting levels. */
+export declare function itemStack(parent: StructuralStack, node: RepeaterNode, index: number, instance: Instance, contentType: ContentType): ScopeStack;
+/** Fill a structural stack whose holes have known data into a real ScopeStack.
+ * Holes without data are DROPPED — resolve() throwing MissingData on a ref
+ * into a dropped frame is the honest failure, never a fabricated frame. */
+export declare function fillStructural(stack: StructuralStack, instances?: ReadonlyMap<ScopeId, {
+    instance: Instance;
+    contentType: ContentType;
+}>): ScopeStack;
+//# sourceMappingURL=build-stack.d.ts.map

package/dist/scope-engine/build-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-stack.d.ts","sourceRoot":"","sources":["../../src/scope-engine/build-stack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,IAAI,EACT,KAAK,YAAY,EAEjB,KAAK,OAAO,EACZ,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;CAAE,CAAC;AAEzG,MAAM,MAAM,eAAe,GAAG,SAAS,eAAe,EAAE,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAEnE;AAED,wBAAgB,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAEzF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CAE1D;AAED;mEACmE;AACnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,aAAa,GAAG,eAAe,CAK1F;AAED;;4DAE4D;AAC5D,wBAAgB,SAAS,CACvB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,UAAU,CAcZ;AAED;;2EAE2E;AAC3E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,SAAS,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC,GACjF,UAAU,CAmBZ"}

package/dist/scope-engine/build-stack.js

@@ -0,0 +1,77 @@
+/**
+ * Structural scope-stack construction (decision 004 §2.1). Pure sync tree
+ * shaping; instances attach in the planning waves. StructuralStack is a
+ * distinct type so the compiler forces callers through the fill functions
+ * before treating a stack as resolve()-ready.
+ */
+import { instanceScopeId, nestedScopeId, pageScopeId, } from "@batterai/bind-core";
+/**
+ * STABLE TEMPLATE SCOPE IDS (host convention, surfaced during the Phase-5
+ * build — a gap decision 004 didn't name): templates are authored ONCE but
+ * render for MANY instances, so the frame scopeId an authored chip matches
+ * must be stable across instances. Sentinels:
+ *   detail template's instance frame : instance:<ct>:@detail
+ *   repeater item's instance frame   : <repeaterScope>>>>instance:<ct>:@item
+ * The frame's DATA varies per item; its identity does not. bind-core's exact
+ * findFrame match is untouched — this is purely how the host names frames.
+ */
+export function detailScopeId(contentTypeId) {
+    return instanceScopeId(contentTypeId, "@detail");
+}
+export function itemScopeId(repeaterScope, contentTypeId) {
+    return nestedScopeId(repeaterScope, instanceScopeId(contentTypeId, "@item"));
+}
+export function buildPageStack(page) {
+    return [{ kind: "page", scopeId: pageScopeId(page.id), page }];
+}
+/** Detail-template root: page frame + one instance hole under the STABLE
+ * detail scope id (authored chips match every routed instance). */
+export function buildDetailStack(page, contentTypeId) {
+    return [
+        { kind: "page", scopeId: pageScopeId(page.id), page },
+        { kind: "instance-hole", scopeId: detailScopeId(contentTypeId), contentTypeId },
+    ];
+}
+/** Per-item descent for a repeater: repeater frame (index) + instance frame
+ * under the STABLE item scope id. Nested repeaters chain via the parent's
+ * item scope so ids never collide across nesting levels. */
+export function itemStack(parent, node, index, instance, contentType) {
+    const parentInstance = [...parent].reverse().find((f) => f.kind === "instance-hole");
+    const repScope = parentInstance ? nestedScopeId(parentInstance.scopeId, node.scopeId) : node.scopeId;
+    const filled = fillStructural(parent);
+    return [
+        ...filled,
+        { kind: "repeater", scopeId: repScope, index },
+        {
+            kind: "instance",
+            scopeId: itemScopeId(repScope, instance.contentTypeId),
+            instance,
+            contentType,
+        },
+    ];
+}
+/** Fill a structural stack whose holes have known data into a real ScopeStack.
+ * Holes without data are DROPPED — resolve() throwing MissingData on a ref
+ * into a dropped frame is the honest failure, never a fabricated frame. */
+export function fillStructural(stack, instances) {
+    const out = [];
+    for (const f of stack) {
+        if (f.kind === "page")
+            out.push({ kind: "page", scopeId: f.scopeId, page: f.page });
+        else if (f.kind === "instance-hole") {
+            const hit = instances?.get(f.scopeId);
+            if (hit) {
+                out.push({
+                    kind: "instance",
+                    scopeId: f.scopeId,
+                    instance: hit.instance,
+                    contentType: hit.contentType,
+                });
+            }
+        }
+        // repeater-holes never appear in a resolve-ready stack; itemStack builds
+        // real repeater frames per item.
+    }
+    return out;
+}
+//# sourceMappingURL=build-stack.js.map

package/dist/scope-engine/build-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-stack.js","sourceRoot":"","sources":["../../src/scope-engine/build-stack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,GASZ,MAAM,qBAAqB,CAAC;AAS7B;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,aAA4B;IACxD,OAAO,eAAe,CAAC,aAAa,EAAE,SAA2B,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,aAAsB,EAAE,aAA4B;IAC9E,OAAO,aAAa,CAAC,aAAa,EAAE,eAAe,CAAC,aAAa,EAAE,OAAyB,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;mEACmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,aAA4B;IACvE,OAAO;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE;QACrD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE;KAChF,CAAC;AACJ,CAAC;AAED;;4DAE4D;AAC5D,MAAM,UAAU,SAAS,CACvB,MAAuB,EACvB,IAAkB,EAClB,KAAa,EACb,QAAkB,EAClB,WAAwB;IAExB,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACrG,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO;QACL,GAAG,MAAM;QACT,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC9C;YACE,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC;YACtD,QAAQ;YACR,WAAW;SACZ;KACF,CAAC;AACJ,CAAC;AAED;;2EAE2E;AAC3E,MAAM,UAAU,cAAc,CAC5B,KAAsB,EACtB,SAAkF;IAElF,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;aAC/E,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,WAAW,EAAE,GAAG,CAAC,WAAW;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,yEAAyE;QACzE,iCAAiC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/scope-engine/repeater-query.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Invariant-I filter/sort/limit (decision 004 §2.3): the authoritative,
+ * adapter-independent truth pass using bind-core's evaluators — one engine,
+ * never N adapter dialects. Order of operations is contract: filter -> sort
+ * -> slice(pageSize) — pagination never truncates a filtered set early.
+ */
+import { type DataView, type Instance, type RepeaterQuery, type ScopeStack } from "@batterai/bind-core";
+export declare function applyRepeaterQuery(candidates: readonly Instance[], query: RepeaterQuery, itemStackFor: (instance: Instance, index: number) => ScopeStack, data: DataView): readonly Instance[];
+//# sourceMappingURL=repeater-query.d.ts.map

package/dist/scope-engine/repeater-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeater-query.d.ts","sourceRoot":"","sources":["../../src/scope-engine/repeater-query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,QAAQ,EAAE,EAC/B,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,UAAU,EAC/D,IAAI,EAAE,QAAQ,GACb,SAAS,QAAQ,EAAE,CAgCrB"}