@xtyle/core 0.5.0

package/dist/elements/fragment-host.d.ts

@@ -0,0 +1,166 @@
+import { type XriptRuntime, type ModInstance } from "@xriptjs/runtime";
+/** A DOM event flattened to the JSON the sandbox handler receives. */
+export interface SerializedEvent {
+    tagName: string;
+    dataset: Record<string, string | undefined>;
+    value?: string;
+    checked?: boolean;
+    text: string;
+    key?: string;
+    disabled?: boolean;
+    ariaDisabled?: string;
+}
+/** What a handler export returns; the trusted host applies it. */
+export interface FragmentIntent {
+    select?: string;
+    focus?: string;
+    preventDefault?: boolean;
+    emit?: {
+        type: string;
+        detail?: unknown;
+    };
+    /** Accordion: the full set of open section keys after a toggle. */
+    open?: string[];
+    toggledKey?: string;
+    isOpen?: boolean;
+    /** Switch: flip the checked state. */
+    toggleChecked?: boolean;
+    setChecked?: boolean;
+    dismiss?: boolean;
+    requestClose?: boolean;
+    toggleReveal?: boolean;
+    clearValue?: boolean;
+    focusInput?: boolean;
+    inputValue?: string;
+    stopPropagation?: boolean;
+    openMenu?: "first" | "last";
+    focusValue?: string;
+    activateValue?: string;
+    activateLabel?: string;
+    activateIndex?: number;
+    closeMenu?: boolean;
+    returnFocus?: boolean;
+    selectRadio?: string;
+    toggleOpen?: boolean;
+    nudge?: number;
+    forceAlt?: boolean;
+    commit?: string;
+    expand?: boolean;
+    expandKey?: string;
+    activate?: string;
+    value?: string;
+    commitValue?: boolean;
+    reset?: boolean;
+    jump?: string;
+    setValue?: number;
+}
+export interface FragmentBinding {
+    /** Extra context passed to a handler after the serialized event (e.g. nav state). */
+    context?(handler: string, event: Event): unknown;
+    /** Apply the intent a handler returned. */
+    applyIntent(intent: FragmentIntent, event: Event): void;
+    /**
+     * Run after every fragment apply (mount and update), once the hook's ops have hit the
+     * live DOM — the seam for imperative post-render work (e.g. painting live colors onto
+     * the freshly-built nodes) that must outlast a deferred first-load mount rebuild.
+     */
+    afterApply?(): void;
+}
+interface LoadedFill {
+    runtime: XriptRuntime;
+    mod: ModInstance;
+}
+export declare function loadFill(manifest: unknown, fragmentSources: Record<string, string>): Promise<LoadedFill>;
+/**
+ * Surface a fill / component-runtime load failure. A client-only (bare-shadow) element has
+ * only its empty scaffold when the fill can't load, so it collapses to 0×0 with no other
+ * signal; an SSR-composed element keeps its server-rendered content but loses live updates.
+ * Marks the host `data-xtyle-fill-error` (inspectable, and a CSS hook for a consumer fallback)
+ * and logs one attributed diagnostic per page, so a silently-blank client-only UI can't cost a
+ * consumer a debugging session chasing an invisible runtime-init failure.
+ */
+export declare function markFillFailure(host: Element, error: unknown): void;
+/**
+ * Drives a component fill against one element's shadow root: resolves the runtime,
+ * paints the inert scaffold once, applies the update hook's ops on every render, and
+ * routes shadow DOM events to the fill's sandboxed handlers — applying whatever intent
+ * they return. The runtime and each fill load once and serve every instance; per-element
+ * state stays in the host element, passed in as `bindings`.
+ */
+export declare class FragmentHost {
+    private root;
+    private manifest;
+    private fragmentSources;
+    private fragmentId;
+    private binding;
+    private handlers;
+    private template;
+    private wired;
+    private mounted;
+    private pendingBindings;
+    private loadKicked;
+    private scaffoldDone;
+    private readonly lightDom;
+    /** Consumer-provided children grouped by slot name (`""` = the default slot), held across
+     * rebuilds. In light DOM there is no `<slot>` to re-project them, so the host relocates each
+     * group into its matching `[data-slot]` / `[data-slot="name"]` region after every (re)mount.
+     * `null` until first captured. */
+    private slotted;
+    constructor(root: ShadowRoot | HTMLElement, manifest: unknown, fragmentSources: Record<string, string>, fragmentId: string, binding: FragmentBinding);
+    /** Force the next `update` to rebuild the structure (a `mount`) — for a change ops can't express, like a tag switch. */
+    remount(): void;
+    private lastShape;
+    /** Rebuild on the next `update` when an element's structure-signature changed — a shape
+     * change (tag switch, an added boolean attr) the patch ops can't express. The first call
+     * only records the baseline; it never forces a rebuild of a freshly-mounted scaffold. */
+    reshapeIfChanged(signature: string): void;
+    /**
+     * Sync: paint the inert scaffold unless the root already holds it (DSD / SSR). Shadow roots
+     * carry the host css inline; light DOM leans on the already-global component sheet, so it
+     * writes no `<style>`. For a client-created light element the consumer's children are captured
+     * here (the scaffold paint would otherwise wipe them) for relocation after mount; for an
+     * SSR-composed light element the children already sit in `[data-slot]`, so the scaffold is
+     * left intact and the first apply runs as an `update`, not a structure-destroying `mount`.
+     */
+    ensureScaffold(hostCss: string): void;
+    /** The consumer's content grouped by slot name. In light DOM it's the map captured at scaffold
+     * time (the scaffold paint relocates the children out of the element, so they must be read from
+     * the held map). In shadow DOM the children stay in the host element's light tree — projected
+     * by native `<slot>` — so they're read live off the host, never captured. */
+    private slottedMap;
+    /** The trimmed text of the consumer's default-slot content — what a `<slot>`'s text would
+     * have been in the shadow build. Read it instead of the host element's `textContent`, which
+     * in light DOM now also includes the fill's own rendered chrome. */
+    slottedText(): string;
+    /** Whether the consumer filled a given slot (`""` = default). Read this instead of querying
+     * the live DOM for `[slot="name"]` — in light DOM the host has already captured those children
+     * out of the element by the time an element computes its bindings. */
+    hasSlotted(name?: string): boolean;
+    /** The consumer's captured nodes for a slot (`""` = default). For an element that reads
+     * structured config children — progress's `<threshold>` elements — light DOM's scaffold wipe
+     * detaches them, so they must be read here rather than off the live tree. */
+    slottedNodes(name?: string): Node[];
+    /**
+     * Apply the update hook's ops to the live scaffold and wire handlers once. Runs
+     * synchronously once the runtime is warm (the first call kicks off the async load),
+     * so a re-render triggered from a handler completes before the host applies focus.
+     */
+    update(bindings: Record<string, unknown>): void;
+    /** The light-DOM host element or the shadow root's host — where a fill-load failure is marked. */
+    private hostElement;
+    private apply;
+    /**
+     * Resolve a delegated handler target across the shadow boundary. `target.closest(selector)` walks
+     * the clicked node's own-tree ancestors, so a click that lands on *projected* (slotted) light-DOM
+     * content — an icon inside a segment — never reaches the shadow control that owns the handler: the
+     * slotted node's light-DOM ancestors are the host element, not the shadow button. Walking the
+     * composed path instead crosses the boundary and finds the first matching element inside this
+     * host's own subtree, so a click on slotted content selects the same as a click on the control's
+     * own chrome. The subtree guard keeps a nested component's matching element from being claimed here.
+     */
+    private matchInPath;
+    private wire;
+}
+export declare function fillSource(manifest: unknown, fragmentId: string): string;
+export {};
+//# sourceMappingURL=fragment-host.d.ts.map

package/dist/elements/fragment-host.d.ts.map

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

package/dist/elements/fragment-host.js

@@ -0,0 +1,363 @@
+import { initXript } from "@xriptjs/runtime";
+import componentHost from "./fragments/component-host.json" with { type: "json" };
+const grantedCapabilities = Object.keys(componentHost.capabilities ?? {});
+let runtimePromise;
+function componentRuntime() {
+    if (!runtimePromise) {
+        runtimePromise = initXript().then((factory) => factory.createRuntime(componentHost, {
+            hostBindings: {},
+            capabilities: grantedCapabilities,
+        }));
+    }
+    return runtimePromise;
+}
+const fillCache = new Map();
+const loadedFills = new Map();
+export function loadFill(manifest, fragmentSources) {
+    const key = manifest.name;
+    let entry = fillCache.get(key);
+    if (!entry) {
+        entry = componentRuntime().then((runtime) => {
+            const loaded = { runtime, mod: runtime.loadMod(manifest, { fragmentSources }) };
+            loadedFills.set(key, loaded);
+            return loaded;
+        });
+        fillCache.set(key, entry);
+    }
+    return entry;
+}
+let fillFailureWarned = false;
+/**
+ * Surface a fill / component-runtime load failure. A client-only (bare-shadow) element has
+ * only its empty scaffold when the fill can't load, so it collapses to 0×0 with no other
+ * signal; an SSR-composed element keeps its server-rendered content but loses live updates.
+ * Marks the host `data-xtyle-fill-error` (inspectable, and a CSS hook for a consumer fallback)
+ * and logs one attributed diagnostic per page, so a silently-blank client-only UI can't cost a
+ * consumer a debugging session chasing an invisible runtime-init failure.
+ */
+export function markFillFailure(host, error) {
+    host.setAttribute("data-xtyle-fill-error", "");
+    if (fillFailureWarned)
+        return;
+    fillFailureWarned = true;
+    const tag = host.tagName.toLowerCase();
+    console.error(`xtyle: the component fragment runtime failed to load, so client-rendered elements ` +
+        `(starting with <${tag}>) cannot paint their content and will appear empty. This usually ` +
+        `means the xript runtime's WebAssembly could not initialize in this environment ` +
+        `(e.g. a Content-Security-Policy blocking wasm, or a blocked asset fetch). Server-rendered ` +
+        `content is unaffected; only the client-only render path needs the runtime.`, error);
+}
+function serializeEvent(el, event) {
+    const input = el;
+    return {
+        tagName: el.tagName,
+        dataset: { ...el.dataset },
+        value: typeof input.value === "string" ? input.value : undefined,
+        checked: typeof input.checked === "boolean" ? input.checked : undefined,
+        text: (el.textContent ?? "").trim(),
+        key: event instanceof KeyboardEvent ? event.key : undefined,
+        disabled: input.disabled === true || undefined,
+        ariaDisabled: el.getAttribute("aria-disabled") ?? undefined,
+    };
+}
+function applyOps(root, ops) {
+    for (const op of ops) {
+        const el = root.querySelector(op.selector);
+        if (!el)
+            continue;
+        switch (op.op) {
+            case "replaceChildren":
+                el.innerHTML = String(op.value ?? "");
+                break;
+            case "setAttr":
+                // An empty value removes the attribute, so a naming/state op can clear itself
+                // without a separate removeAttr verb. Set boolean attrs with a non-empty value
+                // (`setAttr(sel, "hidden", "hidden")`), never `""`.
+                if (op.attr) {
+                    const value = String(op.value ?? "");
+                    if (value === "")
+                        el.removeAttribute(op.attr);
+                    else
+                        el.setAttribute(op.attr, value);
+                }
+                break;
+            case "toggle":
+                el.hidden = !op.value;
+                break;
+            case "addClass":
+                el.classList.add(String(op.value));
+                break;
+            case "removeClass":
+                el.classList.remove(String(op.value));
+                break;
+            case "setText":
+                el.textContent = String(op.value ?? "");
+                break;
+        }
+    }
+}
+/** A region's consumer-provided nodes: its captured children minus the fill's own fallback
+ * (`[data-slot-fallback]`) and the `<!--xtyle:slot-->` composition marker comment. So `hasSlotted`
+ * reflects whether the consumer actually filled the slot, not whether the region merely renders a
+ * default — the distinction a fallback-bearing slot (alert's icon, progress's value) turns on. */
+function consumerNodes(region) {
+    return [...region.childNodes].filter((node) => node.nodeType !== 8 && !(node instanceof Element && node.hasAttribute("data-slot-fallback")));
+}
+/** Group nodes by their `slot` attribute (`""` for unslotted elements and text nodes) — the
+ * light-DOM stand-in for shadow `<slot name>` projection. */
+function groupBySlot(nodes) {
+    const map = new Map();
+    for (const node of nodes) {
+        const name = node instanceof Element ? (node.getAttribute("slot") ?? "") : "";
+        const group = map.get(name);
+        if (group)
+            group.push(node);
+        else
+            map.set(name, [node]);
+    }
+    return map;
+}
+/**
+ * Drives a component fill against one element's shadow root: resolves the runtime,
+ * paints the inert scaffold once, applies the update hook's ops on every render, and
+ * routes shadow DOM events to the fill's sandboxed handlers — applying whatever intent
+ * they return. The runtime and each fill load once and serve every instance; per-element
+ * state stays in the host element, passed in as `bindings`.
+ */
+export class FragmentHost {
+    root;
+    manifest;
+    fragmentSources;
+    fragmentId;
+    binding;
+    handlers;
+    template;
+    wired = false;
+    mounted = false;
+    pendingBindings = null;
+    loadKicked = false;
+    scaffoldDone = false;
+    lightDom;
+    /** Consumer-provided children grouped by slot name (`""` = the default slot), held across
+     * rebuilds. In light DOM there is no `<slot>` to re-project them, so the host relocates each
+     * group into its matching `[data-slot]` / `[data-slot="name"]` region after every (re)mount.
+     * `null` until first captured. */
+    slotted = null;
+    constructor(root, manifest, fragmentSources, fragmentId, binding) {
+        this.root = root;
+        this.manifest = manifest;
+        this.fragmentSources = fragmentSources;
+        this.fragmentId = fragmentId;
+        this.binding = binding;
+        this.handlers = collectHandlers(manifest);
+        this.template = this.fragmentSources[fillSource(manifest, fragmentId)] ?? "";
+        this.lightDom = !(typeof ShadowRoot !== "undefined" && root instanceof ShadowRoot);
+    }
+    /** Force the next `update` to rebuild the structure (a `mount`) — for a change ops can't express, like a tag switch. */
+    remount() {
+        this.mounted = false;
+    }
+    lastShape = "";
+    /** Rebuild on the next `update` when an element's structure-signature changed — a shape
+     * change (tag switch, an added boolean attr) the patch ops can't express. The first call
+     * only records the baseline; it never forces a rebuild of a freshly-mounted scaffold. */
+    reshapeIfChanged(signature) {
+        if (this.lastShape && signature !== this.lastShape)
+            this.remount();
+        this.lastShape = signature;
+    }
+    /**
+     * Sync: paint the inert scaffold unless the root already holds it (DSD / SSR). Shadow roots
+     * carry the host css inline; light DOM leans on the already-global component sheet, so it
+     * writes no `<style>`. For a client-created light element the consumer's children are captured
+     * here (the scaffold paint would otherwise wipe them) for relocation after mount; for an
+     * SSR-composed light element the children already sit in `[data-slot]`, so the scaffold is
+     * left intact and the first apply runs as an `update`, not a structure-destroying `mount`.
+     */
+    ensureScaffold(hostCss) {
+        if (this.scaffoldDone)
+            return;
+        this.scaffoldDone = true;
+        const existing = this.root.querySelector("[data-root]");
+        if (this.lightDom) {
+            if (existing) {
+                // SSR-composed: each region already holds its slot's content. Capture the consumer's
+                // nodes per region (excluding any rendered fallback) so a later remount can re-place
+                // them and `hasSlotted` stays honest, and skip the structure-destroying mount.
+                this.slotted = new Map();
+                for (const region of this.root.querySelectorAll("[data-slot]")) {
+                    this.slotted.set(region.getAttribute("data-slot") ?? "", consumerNodes(region));
+                }
+                this.mounted = true;
+                return;
+            }
+            this.slotted = groupBySlot(this.root.childNodes);
+            this.root.innerHTML = this.template;
+            return;
+        }
+        if (existing)
+            return;
+        this.root.innerHTML = `<style>${hostCss}</style>${this.template}`;
+    }
+    /** The consumer's content grouped by slot name. In light DOM it's the map captured at scaffold
+     * time (the scaffold paint relocates the children out of the element, so they must be read from
+     * the held map). In shadow DOM the children stay in the host element's light tree — projected
+     * by native `<slot>` — so they're read live off the host, never captured. */
+    slottedMap() {
+        if (this.slotted)
+            return this.slotted;
+        if (typeof ShadowRoot !== "undefined" && this.root instanceof ShadowRoot) {
+            return groupBySlot(this.root.host.childNodes);
+        }
+        return new Map();
+    }
+    /** The trimmed text of the consumer's default-slot content — what a `<slot>`'s text would
+     * have been in the shadow build. Read it instead of the host element's `textContent`, which
+     * in light DOM now also includes the fill's own rendered chrome. */
+    slottedText() {
+        return (this.slottedMap().get("") ?? [])
+            .map((node) => node.textContent ?? "")
+            .join("")
+            .trim();
+    }
+    /** Whether the consumer filled a given slot (`""` = default). Read this instead of querying
+     * the live DOM for `[slot="name"]` — in light DOM the host has already captured those children
+     * out of the element by the time an element computes its bindings. */
+    hasSlotted(name = "") {
+        return (this.slottedMap().get(name)?.length ?? 0) > 0;
+    }
+    /** The consumer's captured nodes for a slot (`""` = default). For an element that reads
+     * structured config children — progress's `<threshold>` elements — light DOM's scaffold wipe
+     * detaches them, so they must be read here rather than off the live tree. */
+    slottedNodes(name = "") {
+        return this.slottedMap().get(name) ?? [];
+    }
+    /**
+     * Apply the update hook's ops to the live scaffold and wire handlers once. Runs
+     * synchronously once the runtime is warm (the first call kicks off the async load),
+     * so a re-render triggered from a handler completes before the host applies focus.
+     */
+    update(bindings) {
+        const key = this.manifest.name;
+        const loaded = loadedFills.get(key);
+        if (loaded) {
+            this.apply(loaded, bindings);
+            return;
+        }
+        this.pendingBindings = bindings;
+        if (this.loadKicked)
+            return;
+        this.loadKicked = true;
+        void loadFill(this.manifest, this.fragmentSources).then((l) => {
+            const latest = this.pendingBindings;
+            this.pendingBindings = null;
+            if (latest)
+                this.apply(l, latest);
+        }, (error) => markFillFailure(this.hostElement(), error));
+    }
+    /** The light-DOM host element or the shadow root's host — where a fill-load failure is marked. */
+    hostElement() {
+        return this.lightDom ? this.root : this.root.host;
+    }
+    apply(loaded, bindings) {
+        const lifecycle = this.mounted ? "update" : "mount";
+        applyOps(this.root, loaded.runtime.fireFragmentHook(this.fragmentId, lifecycle, bindings));
+        // A `mount` rebuilds the scaffold's inner structure, so in light DOM each region must be
+        // refilled. When the consumer filled the slot, its held nodes *replace* the region's
+        // contents — clearing any fallback the fill rendered (and the `[data-slot-fallback]` node
+        // the refill ops target, so they then no-op against the consumer's content). When unfilled,
+        // the fallback stays and only the `<!--xtyle:slot-->` composition marker is stripped (so an
+        // unfilled, fallback-free region is truly `:empty`, matching the SSR path).
+        if (lifecycle === "mount" && this.lightDom) {
+            for (const region of this.root.querySelectorAll("[data-slot]")) {
+                const nodes = this.slotted?.get(region.getAttribute("data-slot") ?? "");
+                if (nodes?.length) {
+                    region.replaceChildren(...nodes);
+                }
+                else {
+                    for (const node of [...region.childNodes]) {
+                        if (node.nodeType === 8 && /^xtyle:slot/.test(node.textContent ?? ""))
+                            region.removeChild(node);
+                    }
+                }
+            }
+        }
+        this.mounted = true;
+        if (!this.wired) {
+            this.wire(loaded.runtime);
+            this.wired = true;
+        }
+        this.binding.afterApply?.();
+    }
+    /**
+     * Resolve a delegated handler target across the shadow boundary. `target.closest(selector)` walks
+     * the clicked node's own-tree ancestors, so a click that lands on *projected* (slotted) light-DOM
+     * content — an icon inside a segment — never reaches the shadow control that owns the handler: the
+     * slotted node's light-DOM ancestors are the host element, not the shadow button. Walking the
+     * composed path instead crosses the boundary and finds the first matching element inside this
+     * host's own subtree, so a click on slotted content selects the same as a click on the control's
+     * own chrome. The subtree guard keeps a nested component's matching element from being claimed here.
+     */
+    matchInPath(path, selector) {
+        for (const node of path) {
+            if (node === this.root)
+                break;
+            if (node instanceof HTMLElement && node.matches(selector) && this.root.contains(node))
+                return node;
+        }
+        return null;
+    }
+    wire(runtime) {
+        const eventTypes = [...new Set(this.handlers.map((h) => h.on))];
+        for (const type of eventTypes) {
+            this.root.addEventListener(type, (event) => {
+                const path = event.composedPath();
+                if (path.length === 0)
+                    return;
+                for (const decl of this.handlers) {
+                    if (decl.on !== type)
+                        continue;
+                    const match = this.matchInPath(path, decl.selector);
+                    if (!match)
+                        continue;
+                    const payload = serializeEvent(match, event);
+                    // Handlers are namespaced by fragment id (`tabs__navKeydown`) so the shared
+                    // sandbox export table can't collide across components. The element's own
+                    // `context` callback still keys on the bare handler name, so strip the prefix
+                    // before asking it for per-handler context.
+                    const bareHandler = decl.handler.startsWith(`${this.fragmentId}__`)
+                        ? decl.handler.slice(this.fragmentId.length + 2)
+                        : decl.handler;
+                    const context = this.binding.context?.(bareHandler, event);
+                    const intent = runtime.invokeExport(decl.handler, [payload, context]);
+                    if (intent)
+                        this.binding.applyIntent(intent, event);
+                    if (event.cancelBubble)
+                        break;
+                }
+            });
+        }
+    }
+}
+export function fillSource(manifest, fragmentId) {
+    const fills = manifest.fills ?? {};
+    for (const list of Object.values(fills)) {
+        for (const fill of list) {
+            if (fill.id === fragmentId || fill.source)
+                return fill.source;
+        }
+    }
+    return "";
+}
+function collectHandlers(manifest) {
+    const fills = manifest.fills ?? {};
+    const out = [];
+    for (const list of Object.values(fills)) {
+        for (const fill of list) {
+            if (fill.handlers)
+                out.push(...fill.handlers);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=fragment-host.js.map

package/dist/elements/fragment-host.js.map

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

package/dist/elements/fragment-ssr.d.ts

@@ -0,0 +1,39 @@
+import type { FragmentOp } from "@xriptjs/runtime";
+/** The component ids that have a built-in SSR fill registered, so a parity test can guard the set. */
+export declare function ssrFragments(): string[];
+/**
+ * Applies a fill's `FragmentOp` command buffer to its scaffold HTML in Node, where
+ * there is no live DOM — the build-time counterpart of the browser op-applier. It
+ * targets attribute-marker selectors (`[data-x]`) against the inert scaffolds xtyle
+ * authors for its built-in fills; arbitrary app-fill structures are a runtime concern,
+ * served by the live-DOM path.
+ */
+export declare function applyOpsToHtml(html: string, ops: FragmentOp[]): string;
+/**
+ * Renders a component fill to a declarative-shadow-root string at build time: drives the
+ * runtime in Node, fires the `update` hook, and applies the returned ops to the scaffold.
+ * The output is byte-identical to the browser's first render, so hydration re-applies onto
+ * it without a wipe.
+ */
+export declare function renderFragment(component: string, bindings: Record<string, unknown>, styles: string): Promise<string>;
+/**
+ * Compose a fallback-bearing slot region in a light-DOM SSR string. A fill marks such a region with
+ * a native `<slot name="…">…</slot>` whose children are the fallback (alert's severity glyph,
+ * progress's computed readout) — the same markup shadow projection uses directly. When the consumer
+ * filled the slot (`rendered` is a string), the whole slot element is replaced by the consumer's
+ * render; when they didn't (`rendered` is `null`), the slot tags are stripped and the fallback
+ * (already populated by the mount hook's ops) stands. Empty-fallback regions keep using a bare
+ * `<slot name="…"></slot>` `.replace`.
+ */
+export declare function composeFallbackSlot(html: string, name: string, rendered: string | null): string;
+/**
+ * Light-DOM SSR: emit the resolved scaffold with the mount hook's ops applied, but no
+ * `<style>` — an element rendering into light DOM leans on the already-global component
+ * sheet instead of an inlined-per-instance copy. The result still carries any native
+ * `<slot>` the fill places where consumer content belongs; the binding replaces that slot
+ * with the slot's rendered HTML so the static (zero-JS) render is correct without the
+ * runtime ever loading. The same `<slot>` markup drives shadow projection in the framework
+ * path, so structure stays single-sourced across both modes.
+ */
+export declare function renderFragmentLight(component: string, bindings: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=fragment-ssr.d.ts.map

package/dist/elements/fragment-ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-ssr.d.ts","sourceRoot":"","sources":["../../src/elements/fragment-ssr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmInD,sGAAsG;AACtG,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAkBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,MAAM,CAoCtE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI/F;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAOjB"}