@slowclap/rezi-core 0.1.0-fork.1

package/dist/router/router.js

@@ -0,0 +1,249 @@
+import { ZrUiError } from "../abi.js";
+const NODE_ENV = globalThis.process?.env?.NODE_ENV ??
+    "development";
+const DEV_MODE = NODE_ENV !== "production";
+function warnDev(message) {
+    if (!DEV_MODE)
+        return;
+    const c = globalThis.console;
+    c?.warn?.(message);
+}
+const DEFAULT_HISTORY_DEPTH = 50;
+function throwInvalidProps(detail) {
+    throw new ZrUiError("ZRUI_INVALID_PROPS", detail);
+}
+function normalizeRouteId(routeId) {
+    const normalized = routeId.trim();
+    if (!normalized) {
+        throwInvalidProps("route id must be a non-empty string");
+    }
+    if (DEV_MODE && /[^a-zA-Z0-9_\-.]/.test(normalized)) {
+        warnDev(`[rezi] route id "${normalized}" contains non-identifier characters. Use only letters, digits, hyphens, underscores, and dots.`);
+    }
+    return normalized;
+}
+/**
+ * Normalize params to an immutable, key-sorted object.
+ */
+export function normalizeRouteParams(params) {
+    if (!params)
+        return Object.freeze({});
+    const entries = Object.entries(params)
+        .map(([key, value]) => {
+        if (DEV_MODE && typeof value !== "string") {
+            warnDev(`[rezi] route param "${key}" has non-string value (${typeof value}), coerced to string. Pass string values to avoid implicit coercion.`);
+        }
+        return [String(key), String(value)];
+    })
+        .sort((a, b) => {
+        if (a[0] < b[0])
+            return -1;
+        if (a[0] > b[0])
+            return 1;
+        return 0;
+    });
+    const normalized = {};
+    for (const [key, value] of entries) {
+        normalized[key] = value;
+    }
+    return Object.freeze(normalized);
+}
+function routeParamsEqual(a, b) {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const key of aKeys) {
+        if (a[key] !== b[key])
+            return false;
+    }
+    return true;
+}
+function createStateEntry(visitId, id, params) {
+    return Object.freeze({ visitId, id, params });
+}
+function createState(maxDepth, nextVisitId, entries) {
+    return Object.freeze({
+        maxDepth,
+        nextVisitId,
+        entries: Object.freeze(entries.slice()),
+    });
+}
+function collectRouteDefinitions(routes, parentId, ancestryPrefix, routeMap, recordById, routeIdsByKeybinding) {
+    for (const route of routes) {
+        const routeId = normalizeRouteId(route.id);
+        if (routeMap.has(routeId)) {
+            throwInvalidProps(`duplicate route id: ${routeId}`);
+        }
+        const keybinding = route.keybinding?.trim();
+        if (keybinding) {
+            const existingRouteId = routeIdsByKeybinding.get(keybinding);
+            if (existingRouteId !== undefined && existingRouteId !== routeId) {
+                throwInvalidProps(`duplicate route keybinding "${keybinding}" for routes "${existingRouteId}" and "${routeId}"`);
+            }
+            routeIdsByKeybinding.set(keybinding, routeId);
+        }
+        const ancestry = Object.freeze([...ancestryPrefix, routeId]);
+        routeMap.set(routeId, route);
+        recordById.set(routeId, Object.freeze({
+            route,
+            parentId,
+            ancestry,
+        }));
+        const children = route.children;
+        if (children !== undefined) {
+            if (!Array.isArray(children)) {
+                throwInvalidProps(`children for route "${routeId}" must be an array when provided`);
+            }
+            collectRouteDefinitions(children, routeId, ancestry, routeMap, recordById, routeIdsByKeybinding);
+        }
+    }
+}
+/**
+ * Build and validate route registry metadata.
+ */
+export function createRouteRegistry(routes) {
+    if (routes.length === 0) {
+        throwInvalidProps("routes must contain at least one route");
+    }
+    const routeMap = new Map();
+    const recordById = new Map();
+    collectRouteDefinitions(routes, null, [], routeMap, recordById, new Map());
+    return Object.freeze({
+        routeMap,
+        recordById,
+    });
+}
+/**
+ * Build and validate a route map.
+ */
+export function createRouteMap(routes) {
+    return createRouteRegistry(routes).routeMap;
+}
+/**
+ * Create initial router state.
+ */
+export function createRouterState(initialRouteId, opts = {}) {
+    const routeId = normalizeRouteId(initialRouteId);
+    const maxDepth = opts.maxDepth ?? DEFAULT_HISTORY_DEPTH;
+    if (!Number.isInteger(maxDepth) || maxDepth <= 0) {
+        throwInvalidProps("routeHistoryMaxDepth must be a positive integer");
+    }
+    const initialEntry = createStateEntry(1, routeId, normalizeRouteParams(opts.initialParams));
+    return createState(maxDepth, 2, [initialEntry]);
+}
+function pushBounded(entries, entry, maxDepth) {
+    const next = [...entries, entry];
+    if (next.length > maxDepth) {
+        next.shift();
+    }
+    return next;
+}
+/**
+ * Push navigation.
+ */
+export function navigateRouterState(state, routeId, params) {
+    const id = normalizeRouteId(routeId);
+    const nextParams = normalizeRouteParams(params);
+    const current = state.entries[state.entries.length - 1];
+    if (current && current.id === id && routeParamsEqual(current.params, nextParams)) {
+        return state;
+    }
+    const nextEntry = createStateEntry(state.nextVisitId, id, nextParams);
+    const nextEntries = pushBounded(state.entries, nextEntry, state.maxDepth);
+    return createState(state.maxDepth, state.nextVisitId + 1, nextEntries);
+}
+/**
+ * Replace current navigation entry.
+ */
+export function replaceRouterState(state, routeId, params) {
+    const id = normalizeRouteId(routeId);
+    const nextParams = normalizeRouteParams(params);
+    const current = state.entries[state.entries.length - 1];
+    if (current && current.id === id && routeParamsEqual(current.params, nextParams)) {
+        return state;
+    }
+    const nextEntry = createStateEntry(state.nextVisitId, id, nextParams);
+    const nextEntries = state.entries.slice(0, -1);
+    nextEntries.push(nextEntry);
+    return createState(state.maxDepth, state.nextVisitId + 1, nextEntries);
+}
+/**
+ * Pop navigation history.
+ */
+export function backRouterState(state) {
+    if (state.entries.length <= 1)
+        return state;
+    return createState(state.maxDepth, state.nextVisitId, state.entries.slice(0, -1));
+}
+/**
+ * Read current route location.
+ */
+export function currentRouteFromState(state) {
+    const current = state.entries[state.entries.length - 1];
+    if (!current) {
+        throw new ZrUiError("ZRUI_INVALID_STATE", "router state is empty");
+    }
+    return Object.freeze({ id: current.id, params: current.params });
+}
+/**
+ * Read full route history from oldest to newest.
+ */
+export function historyFromState(state) {
+    return Object.freeze(state.entries.map((entry) => Object.freeze({
+        id: entry.id,
+        params: entry.params,
+    })));
+}
+/**
+ * Whether back() can pop.
+ */
+export function canGoBackFromState(state) {
+    return state.entries.length > 1;
+}
+/**
+ * Serialize router state.
+ */
+export function serializeRouterState(state) {
+    return Object.freeze({
+        maxDepth: state.maxDepth,
+        nextVisitId: state.nextVisitId,
+        entries: Object.freeze(state.entries.map((entry) => Object.freeze({
+            visitId: entry.visitId,
+            id: entry.id,
+            params: normalizeRouteParams(entry.params),
+        }))),
+    });
+}
+/**
+ * Deserialize and validate router state.
+ */
+export function deserializeRouterState(snapshot) {
+    const maxDepth = snapshot.maxDepth;
+    if (!Number.isInteger(maxDepth) || maxDepth <= 0) {
+        throwInvalidProps("router snapshot maxDepth must be a positive integer");
+    }
+    const nextVisitId = snapshot.nextVisitId;
+    if (!Number.isInteger(nextVisitId) || nextVisitId <= 0) {
+        throwInvalidProps("router snapshot nextVisitId must be a positive integer");
+    }
+    if (!Array.isArray(snapshot.entries) || snapshot.entries.length === 0) {
+        throwInvalidProps("router snapshot entries must contain at least one item");
+    }
+    const entries = [];
+    for (const entry of snapshot.entries) {
+        if (!Number.isInteger(entry.visitId) || entry.visitId <= 0) {
+            throwInvalidProps("router snapshot visitId must be a positive integer");
+        }
+        const id = normalizeRouteId(entry.id);
+        entries.push(createStateEntry(entry.visitId, id, normalizeRouteParams(entry.params)));
+    }
+    return createState(maxDepth, nextVisitId, entries);
+}
+/**
+ * Return the default bounded router history depth.
+ */
+export function defaultRouteHistoryDepth() {
+    return DEFAULT_HISTORY_DEPTH;
+}
+//# sourceMappingURL=router.js.map

package/dist/router/router.js.map

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

package/dist/router/types.d.ts

@@ -0,0 +1,114 @@
+import type { VNode } from "../widgets/types.js";
+/**
+ * Route params passed to a screen.
+ *
+ * Params are stored as an immutable string map so routing history remains
+ * serializable and deterministic.
+ */
+export type RouteParams = Readonly<Record<string, string>>;
+/**
+ * Public route location entry.
+ */
+export type RouteLocation = Readonly<{
+    id: string;
+    params: RouteParams;
+}>;
+/**
+ * Public navigation API for page-level routing.
+ */
+export interface RouterApi {
+    /** Push a route on top of history. */
+    navigate(routeId: string, params?: RouteParams): void;
+    /** Replace the current route entry without growing history. */
+    replace(routeId: string, params?: RouteParams): void;
+    /** Pop one entry from history when possible. */
+    back(): void;
+    /** Get the current route location. */
+    currentRoute(): RouteLocation;
+    /** True when back() can pop an entry. */
+    canGoBack(): boolean;
+    /** Ordered history from oldest entry to current entry. */
+    history(): readonly RouteLocation[];
+}
+/**
+ * Optional redirect outcome from a route guard.
+ */
+export type RouteGuardRedirect = Readonly<{
+    redirect: string;
+    params?: RouteParams;
+}>;
+/**
+ * Return contract for route guards.
+ *
+ * - `true`: allow navigation
+ * - `false`: block navigation
+ * - `{ redirect }`: reroute before committing navigation
+ */
+export type RouteGuardResult = true | false | RouteGuardRedirect;
+/**
+ * Extra metadata passed to route guards.
+ */
+export type RouteGuardContext = Readonly<{
+    from: RouteLocation;
+    to: RouteLocation;
+    action: "navigate" | "replace" | "back";
+}>;
+/**
+ * Route guard callback for pre-navigation checks.
+ */
+export type RouteGuard<S> = (params: RouteParams, state: Readonly<S>, context: RouteGuardContext) => RouteGuardResult;
+/**
+ * Context passed to route screen render functions.
+ *
+ * A route screen can ignore this context and use only `params`, or use it to
+ * read state, schedule updates, and navigate.
+ */
+export type RouteRenderContext<S> = Readonly<{
+    router: RouterApi;
+    state: Readonly<S>;
+    update: (updater: S | ((prev: Readonly<S>) => S)) => void;
+    /**
+     * Nested route outlet. Null for leaf routes.
+     */
+    outlet: VNode | null;
+}>;
+/**
+ * Route registration entry.
+ */
+export type RouteDefinition<S = unknown> = Readonly<{
+    /** Unique route identifier. */
+    id: string;
+    /** Route screen render function. */
+    screen: (params: RouteParams, context: RouteRenderContext<S>) => VNode;
+    /** Optional navigation guard run before entering the route. */
+    guard?: RouteGuard<S>;
+    /** Optional nested child routes rendered through `context.outlet`. */
+    children?: readonly RouteDefinition<S>[];
+    /** Human-readable title for breadcrumbs/tabs/navigation UI. */
+    title?: string;
+    /** Optional global keybinding (e.g. "ctrl+1"). */
+    keybinding?: string;
+}>;
+/**
+ * Internal route stack entry (includes stable visit id for focus snapshots).
+ */
+export type RouterStateEntry = Readonly<{
+    visitId: number;
+    id: string;
+    params: RouteParams;
+}>;
+/**
+ * Internal router state.
+ *
+ * Serializable by design for record/replay and deterministic tests.
+ */
+export type RouterState = Readonly<{
+    maxDepth: number;
+    nextVisitId: number;
+    entries: readonly RouterStateEntry[];
+}>;
+/**
+ * Serialized router state snapshot.
+ */
+export type RouterStateSnapshot = RouterState;
+//# sourceMappingURL=types.d.ts.map

package/dist/router/types.d.ts.map

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

package/dist/router/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":""}

package/dist/runtime/commit/composite.d.ts

@@ -0,0 +1,11 @@
+import type { Theme } from "../../theme/theme.js";
+import type { ColorTokens } from "../../theme/tokens.js";
+import { type CompositeWidgetMeta } from "../../widgets/composition.js";
+import type { VNode } from "../../widgets/types.js";
+import type { InstanceId } from "../instance.js";
+import { type CommitContainerFn, type CommitCtx, type CommitNodeResult } from "./shared.js";
+export declare function currentCompositeTheme(ctx: CommitCtx): Theme | null;
+export declare function resolveCompositeChildTheme(parentTheme: Theme, vnode: VNode): Theme;
+export declare function readCompositeColorTokens(ctx: CommitCtx): ColorTokens;
+export declare function executeCompositeRender(instanceId: InstanceId, vnode: VNode, compositeMeta: CompositeWidgetMeta, ctx: CommitCtx, nodePath: string[], depth: number, commitContainer: CommitContainerFn): CommitNodeResult;
+//# sourceMappingURL=composite.d.ts.map

package/dist/runtime/commit/composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../../../src/runtime/commit/composite.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,KAAK,mBAAmB,EAIzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,EAEtB,MAAM,aAAa,CAAC;AAUrB,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI,CAGlE;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAiBlF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,GAAG,WAAW,CAWpE;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,mBAAmB,EAClC,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,iBAAiB,GACjC,gBAAgB,CAsMlB"}

package/dist/runtime/commit/composite.js

@@ -0,0 +1,238 @@
+import { describeThrown } from "../../debug/describeThrown.js";
+import { defaultTheme } from "../../theme/defaultTheme.js";
+import { mergeThemeOverride } from "../../theme/interop.js";
+import { getCompositeMeta, scopedId, } from "../../widgets/composition.js";
+import { createHookContext } from "../instances.js";
+import { compositePropsEqual, evaluateAppStateSelections } from "./equality.js";
+import { EMPTY_CHILDREN, } from "./shared.js";
+import { isContainerVNode } from "./validation.js";
+const MAX_COMPOSITE_RENDER_DEPTH = 100;
+const DEFAULT_VIEWPORT_SNAPSHOT = Object.freeze({
+    width: 0,
+    height: 0,
+    breakpoint: "sm",
+});
+export function currentCompositeTheme(ctx) {
+    if (ctx.compositeThemeStack.length === 0)
+        return null;
+    return ctx.compositeThemeStack[ctx.compositeThemeStack.length - 1] ?? null;
+}
+export function resolveCompositeChildTheme(parentTheme, vnode) {
+    if (vnode.kind === "themed") {
+        const props = vnode.props;
+        return mergeThemeOverride(parentTheme, props.theme);
+    }
+    if (vnode.kind === "row" ||
+        vnode.kind === "column" ||
+        vnode.kind === "grid" ||
+        vnode.kind === "box") {
+        const props = vnode.props;
+        return mergeThemeOverride(parentTheme, props.theme);
+    }
+    return parentTheme;
+}
+export function readCompositeColorTokens(ctx) {
+    const composite = ctx.composite;
+    if (!composite)
+        return defaultTheme.definition.colors;
+    const theme = currentCompositeTheme(ctx);
+    if (theme !== null) {
+        if (!composite.getColorTokens)
+            return theme.definition.colors;
+        return composite.getColorTokens(theme) ?? theme.definition.colors;
+    }
+    return composite.colorTokens ?? defaultTheme.definition.colors;
+}
+export function executeCompositeRender(instanceId, vnode, compositeMeta, ctx, nodePath, depth, commitContainer) {
+    const prev = ctx.prevNodeStack.length > 0 ? (ctx.prevNodeStack[ctx.prevNodeStack.length - 1] ?? null) : null;
+    const compositeRuntime = ctx.composite;
+    let compositeChild = null;
+    let popCompositeStack = false;
+    try {
+        const activeCompositeMeta = compositeMeta;
+        const registry = compositeRuntime.registry;
+        const existing = registry.get(instanceId);
+        if (existing && existing.widgetKey !== compositeMeta.widgetKey) {
+            registry.incrementGeneration(instanceId);
+            registry.delete(instanceId);
+        }
+        if (!registry.get(instanceId)) {
+            try {
+                registry.create(instanceId, compositeMeta.widgetKey);
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_USER_CODE_THROW",
+                        detail: describeThrown(e),
+                    },
+                };
+            }
+        }
+        const state = registry.get(instanceId);
+        if (!state) {
+            return {
+                ok: false,
+                fatal: {
+                    code: "ZRUI_INVALID_PROPS",
+                    detail: `composite state missing for instanceId=${String(instanceId)}`,
+                },
+            };
+        }
+        const invalidateInstance = () => {
+            registry.invalidate(instanceId);
+            ctx.composite?.onInvalidate(instanceId);
+        };
+        const prevMeta = prev ? getCompositeMeta(prev.vnode) : null;
+        const prevChild = prev?.children[0] ?? null;
+        const previousSelections = registry.getAppStateSelections(instanceId);
+        const skipRenderEligible = !state.needsRender &&
+            previousSelections.length > 0 &&
+            prevMeta !== null &&
+            prevChild !== null &&
+            prevMeta.widgetKey === activeCompositeMeta.widgetKey &&
+            compositePropsEqual(prevMeta.props, activeCompositeMeta.props);
+        let canSkipCompositeRender = false;
+        if (skipRenderEligible) {
+            const evalRes = evaluateAppStateSelections(previousSelections, compositeRuntime.appState);
+            if (evalRes.threw !== null) {
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_USER_CODE_THROW",
+                        detail: describeThrown(evalRes.threw),
+                    },
+                };
+            }
+            canSkipCompositeRender = !evalRes.changed;
+        }
+        if (canSkipCompositeRender && prevChild !== null) {
+            compositeChild = prevChild.vnode;
+        }
+        else {
+            let colorTokens;
+            try {
+                colorTokens = readCompositeColorTokens(ctx);
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_USER_CODE_THROW",
+                        detail: describeThrown(e),
+                    },
+                };
+            }
+            const compositeDepth = ctx.compositeRenderStack.length + 1;
+            if (compositeDepth > MAX_COMPOSITE_RENDER_DEPTH) {
+                const chain = ctx.compositeRenderStack
+                    .map((entry) => entry.widgetKey)
+                    .concat(activeCompositeMeta.widgetKey)
+                    .join(" -> ");
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_INVALID_PROPS",
+                        detail: `ZRUI_MAX_DEPTH: composite render depth ${String(compositeDepth)} exceeds max ${String(MAX_COMPOSITE_RENDER_DEPTH)}. Chain: ${chain}`,
+                    },
+                };
+            }
+            registry.beginRender(instanceId);
+            const hookCtx = createHookContext(state, invalidateInstance);
+            const nextSelections = [];
+            const widgetCtx = Object.freeze({
+                id: (suffix) => scopedId(activeCompositeMeta.widgetKey, instanceId, suffix),
+                useState: hookCtx.useState,
+                useReducer: hookCtx.useReducer,
+                useRef: hookCtx.useRef,
+                useEffect: hookCtx.useEffect,
+                useMemo: hookCtx.useMemo,
+                useCallback: hookCtx.useCallback,
+                useAppState: (selector) => {
+                    const selected = selector(compositeRuntime.appState);
+                    nextSelections.push({
+                        selector: selector,
+                        value: selected,
+                    });
+                    return selected;
+                },
+                useTheme: () => colorTokens,
+                useViewport: () => {
+                    compositeRuntime.onUseViewport?.();
+                    return compositeRuntime.viewport ?? DEFAULT_VIEWPORT_SNAPSHOT;
+                },
+                invalidate: invalidateInstance,
+            });
+            ctx.compositeRenderStack.push({
+                widgetKey: activeCompositeMeta.widgetKey,
+                instanceId,
+            });
+            popCompositeStack = true;
+            try {
+                compositeChild = activeCompositeMeta.render(widgetCtx);
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_USER_CODE_THROW",
+                        detail: describeThrown(e),
+                    },
+                };
+            }
+            try {
+                const pending = registry.endRender(instanceId);
+                const pendingCleanups = registry.getPendingCleanups(instanceId);
+                for (const cleanup of pendingCleanups)
+                    ctx.pendingCleanups.push(cleanup);
+                for (const eff of pending)
+                    ctx.pendingEffects.push(eff);
+                registry.setAppStateSelections(instanceId, nextSelections);
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_USER_CODE_THROW",
+                        detail: describeThrown(e),
+                    },
+                };
+            }
+        }
+        if (isContainerVNode(vnode)) {
+            const childOverride = compositeChild ? [compositeChild] : null;
+            if (childOverride) {
+                ctx.containerChildOverrides.set(instanceId, childOverride);
+            }
+            try {
+                return commitContainer(instanceId, vnode, prev, ctx, nodePath, depth);
+            }
+            finally {
+                if (childOverride) {
+                    ctx.containerChildOverrides.delete(instanceId);
+                }
+            }
+        }
+        return {
+            ok: true,
+            value: {
+                root: {
+                    instanceId,
+                    vnode,
+                    children: EMPTY_CHILDREN,
+                    dirty: true,
+                    selfDirty: true,
+                    renderPacketKey: 0,
+                    renderPacket: null,
+                },
+            },
+        };
+    }
+    finally {
+        if (popCompositeStack) {
+            ctx.compositeRenderStack.pop();
+        }
+    }
+}
+//# sourceMappingURL=composite.js.map

package/dist/runtime/commit/composite.js.map

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

package/dist/runtime/commit/container.d.ts

@@ -0,0 +1,7 @@
+import type { VNode } from "../../widgets/types.js";
+import type { InstanceId } from "../instance.js";
+import type { CommitCtx, CommitNodeFn, CommitNodeResult, RuntimeInstance } from "./shared.js";
+export declare function appendNodePath(nodePath: readonly string[], segment: string): string[];
+export declare function formatNodePath(nodePath: readonly string[]): string;
+export declare function commitContainer(instanceId: InstanceId, vnode: VNode, prev: RuntimeInstance | null, ctx: CommitCtx, nodePath: string[], depth: number, commitNode: CommitNodeFn): CommitNodeResult;
+//# sourceMappingURL=container.d.ts.map