@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.7

package/dist/esm/components/resources/skeleton/SectionFieldsContext.d.ts

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 /**
  * Registry contract a form-hosted section exposes to its descendants.
  *
@@ -25,6 +26,22 @@ export interface SectionFieldsContextValue {
      * over wiring this manually.
      */
     subscribeToRegisteredFields: (listener: () => void) => () => void;
+    /**
+     * Records whether a field this section declares actually RENDERS a control here — its field is in
+     * the operation's schema and not hidden by a condition. A template places its `FormField` slots
+     * unconditionally and lets the operation's schema decide (a slot whose field the schema lacks
+     * renders nothing), so a section can declare fields and show none of them.
+     */
+    reportSlotPresence: (slot: object, present: boolean) => void;
+    clearSlotPresence: (slot: object) => void;
+    /**
+     * True when fields reported here and NONE of them renders. Measured on Wonder Todos, "Reset to
+     * defaults" showed the preferences template's four section cards, every one empty. This is a fact
+     * about FIELDS only: a section also holding other content (text, a custom control, a nested section)
+     * is not empty because of it — `Section` combines it with `holdsOnlyFieldSlots`. Notifies through
+     * `subscribeToRegisteredFields`.
+     */
+    showsNoField: () => boolean;
 }
 export declare const SectionFieldsContext: import("react").Context<SectionFieldsContextValue>;
 /**
@@ -68,4 +85,57 @@ export declare function useSectionFieldRegistration(fieldName: string): void;
  * stable empty array outside any section provider.
  */
 export declare function useRegisteredSectionFields(): string[];
+/**
+ * Hook for `FormField` to tell its section whether it renders a control. A LAYOUT effect, so the
+ * section knows before the browser paints and an empty section never flashes on screen.
+ */
+export declare function useSectionFieldPresence(present: boolean): void;
+/**
+ * Whether the section this registry backs has fields and shows none of them.
+ *
+ * Read in a LAYOUT effect rather than through `useSyncExternalStore`: the fields report in their own
+ * layout effects, which run before their section's, so the section settles before the browser paints.
+ * A store subscription is attached in a passive effect, after paint, and would let an empty frame show
+ * for a frame on the first mount and on every keyed remount of the form.
+ */
+export declare function useSectionShowsNoField(registry: SectionFieldsContextValue): boolean;
+/**
+ * What a component is to a section deciding whether it holds anything besides field slots.
+ *
+ * A section may hide when none of its fields renders only if fields are ALL it holds: text, a custom
+ * control or a nested section beside them is content of its own, which a field-presence count cannot see.
+ * Plain elements that wrap field slots (a layout `div`) are looked through. Components opt in by declaring
+ * their role; any undeclared component counts as other content, so an unknown component can only keep a
+ * section visible, never hide one. The role API is deliberately NOT exported from the package: an
+ * application's own wrapper component keeps its section visible, which is the safe answer, and an author
+ * who wants hiding places slots directly, in a plain element, or in `ObjectScope`.
+ */
+export declare enum SectionContentRole {
+    /** A slot that renders one field's control, or nothing when the operation's schema lacks it. */
+    FIELD_SLOT = "field_slot",
+    /** A wrapper whose children are judged in its place (it scopes field names and adds no content). */
+    FIELD_SLOT_CONTAINER = "field_slot_container"
+}
+/** The role a component declared, if any (read by the placement report as well as the hide decision). */
+export declare function sectionContentRoleOf(type: unknown): SectionContentRole | undefined;
+/** Declares what a component is to `holdsOnlyFieldSlots`. */
+export declare function declareSectionContentRole(component: object, role: SectionContentRole): void;
+/** Where a field slot writes, as `FormField` resolves it: the enclosing scopes' names joined to its own. */
+export interface PlacedFieldSlot {
+    path: string;
+    /** The slot was handed its own schema, so the form's schema does not decide whether it renders. */
+    hasOwnSchema: boolean;
+}
+/**
+ * True when `children` holds at least one field slot and nothing else. Fragments and declared containers
+ * are looked through, and so is a plain element that wraps field slots.
+ */
+export declare function holdsOnlyFieldSlots(children: ReactNode): boolean;
+/**
+ * The field slots `children` places, or `null` when it holds anything besides field slots. Paths are
+ * resolved the way `FormField` resolves them (scope names joined to the slot's `name`), starting from
+ * `pathPrefix`. Read STATICALLY, from the elements, so a host can decide about a section whose content
+ * is not mounted — an inactive tab's panel is not.
+ */
+export declare function listPlacedFieldSlots(children: ReactNode, pathPrefix?: string): PlacedFieldSlot[] | null;
 //# sourceMappingURL=SectionFieldsContext.d.ts.map

package/dist/esm/components/resources/skeleton/SectionFieldsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionFieldsContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACnE;AAED,eAAO,MAAM,oBAAoB,oDAAwD,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,IAAI,yBAAyB,CA6BpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQnE;AAKD;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAMrD"}
+{"version":3,"file":"SectionFieldsContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6H,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElK;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAClE;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7D,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,oBAAoB,oDAAwD,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,IAAI,yBAAyB,CAiDpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQnE;AAKD;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAMrD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa9D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAQnF;AAED;;;;;;;;;;GAUG;AACH,oBAAY,kBAAkB;IAC5B,gGAAgG;IAChG,UAAU,eAAe;IACzB,oGAAoG;IACpG,oBAAoB,yBAAyB;CAC9C;AAID,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAIlF;AAED,6DAA6D;AAC7D,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAE3F;AAYD,4GAA4G;AAC5G,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,YAAY,EAAE,OAAO,CAAC;CACvB;AAuCD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,eAAe,EAAE,GAAG,IAAI,CAGnG"}

package/dist/esm/components/resources/skeleton/SectionFieldsContext.js

@@ -1,4 +1,4 @@
-import { createContext, useContext, useEffect, useState, useSyncExternalStore } from 'react';
+import { Children, Fragment, createContext, isValidElement, useContext, useEffect, useLayoutEffect, useState, useSyncExternalStore } from 'react';
 export const SectionFieldsContext = createContext(null);
 /**
  * Builds the identity-stable registry backing `SectionFieldsContext`.
@@ -26,11 +26,23 @@ export function useSectionFieldsRegistry() {
     const [registry] = useState(() => {
         /** Immutable snapshot — swapped (never mutated) so subscribers can compare by identity. */
         let registeredFields = [];
+        // One entry per MOUNTED SLOT, keyed by that slot's own token rather than by field name: the same
+        // field placed twice is two slots, which may even disagree (one given a schema the other lacks), and
+        // one copy unmounting must not erase or overwrite the other's answer.
+        const slotPresence = new Map();
+        let showsNoField = false;
         const listeners = new Set();
         const notify = () => {
             for (const listener of listeners)
                 listener();
         };
+        const recomputePresence = () => {
+            const next = slotPresence.size > 0 && ![...slotPresence.values()].some(Boolean);
+            if (next === showsNoField)
+                return;
+            showsNoField = next;
+            notify();
+        };
         return {
             registerField: (name) => {
                 if (registeredFields.includes(name))
@@ -45,6 +57,16 @@ export function useSectionFieldsRegistry() {
                 notify();
             },
             getRegisteredFields: () => registeredFields,
+            reportSlotPresence: (slot, present) => {
+                slotPresence.set(slot, present);
+                recomputePresence();
+            },
+            clearSlotPresence: (slot) => {
+                if (!slotPresence.delete(slot))
+                    return;
+                recomputePresence();
+            },
+            showsNoField: () => showsNoField,
             subscribeToRegisteredFields: (listener) => {
                 listeners.add(listener);
                 return () => {
@@ -86,4 +108,138 @@ export function useRegisteredSectionFields() {
     const ctx = useContext(SectionFieldsContext);
     return useSyncExternalStore(ctx ? ctx.subscribeToRegisteredFields : subscribeToNothing, ctx ? ctx.getRegisteredFields : () => EMPTY_REGISTERED_FIELDS);
 }
+/**
+ * Hook for `FormField` to tell its section whether it renders a control. A LAYOUT effect, so the
+ * section knows before the browser paints and an empty section never flashes on screen.
+ */
+export function useSectionFieldPresence(present) {
+    // Two effects on purpose. The CLEAR runs only when the slot leaves this registry (unmount, or the
+    // section provider changing), so a slot whose `present` flips is updated in place rather than deleted
+    // and re-added; either way the section settles before paint. The REPORT runs on every change of
+    // `present`, and after a provider change it reports into the new registry.
+    const ctx = useContext(SectionFieldsContext);
+    const [slot] = useState(() => ({}));
+    useLayoutEffect(() => () => {
+        ctx?.clearSlotPresence(slot);
+    }, [ctx, slot]);
+    useLayoutEffect(() => {
+        ctx?.reportSlotPresence(slot, present);
+    }, [ctx, slot, present]);
+}
+/**
+ * Whether the section this registry backs has fields and shows none of them.
+ *
+ * Read in a LAYOUT effect rather than through `useSyncExternalStore`: the fields report in their own
+ * layout effects, which run before their section's, so the section settles before the browser paints.
+ * A store subscription is attached in a passive effect, after paint, and would let an empty frame show
+ * for a frame on the first mount and on every keyed remount of the form.
+ */
+export function useSectionShowsNoField(registry) {
+    const [showsNoField, setShowsNoField] = useState(false);
+    useLayoutEffect(() => {
+        const update = () => setShowsNoField(registry.showsNoField());
+        update();
+        return registry.subscribeToRegisteredFields(update);
+    }, [registry]);
+    return showsNoField;
+}
+/**
+ * What a component is to a section deciding whether it holds anything besides field slots.
+ *
+ * A section may hide when none of its fields renders only if fields are ALL it holds: text, a custom
+ * control or a nested section beside them is content of its own, which a field-presence count cannot see.
+ * Plain elements that wrap field slots (a layout `div`) are looked through. Components opt in by declaring
+ * their role; any undeclared component counts as other content, so an unknown component can only keep a
+ * section visible, never hide one. The role API is deliberately NOT exported from the package: an
+ * application's own wrapper component keeps its section visible, which is the safe answer, and an author
+ * who wants hiding places slots directly, in a plain element, or in `ObjectScope`.
+ */
+export var SectionContentRole;
+(function (SectionContentRole) {
+    /** A slot that renders one field's control, or nothing when the operation's schema lacks it. */
+    SectionContentRole["FIELD_SLOT"] = "field_slot";
+    /** A wrapper whose children are judged in its place (it scopes field names and adds no content). */
+    SectionContentRole["FIELD_SLOT_CONTAINER"] = "field_slot_container";
+})(SectionContentRole || (SectionContentRole = {}));
+const SECTION_CONTENT_ROLE = Symbol.for('wildo.sectionContentRole');
+/** The role a component declared, if any (read by the placement report as well as the hide decision). */
+export function sectionContentRoleOf(type) {
+    return (type !== null && (typeof type === 'function' || typeof type === 'object'))
+        ? type[SECTION_CONTENT_ROLE]
+        : undefined;
+}
+/** Declares what a component is to `holdsOnlyFieldSlots`. */
+export function declareSectionContentRole(component, role) {
+    Object.defineProperty(component, SECTION_CONTENT_ROLE, { value: role, enumerable: false });
+}
+/** What a subtree amounts to for `holdsOnlyFieldSlots`. */
+var SectionSubtreeKind;
+(function (SectionSubtreeKind) {
+    /** At least one field slot, and nothing else. */
+    SectionSubtreeKind["FIELD_SLOTS"] = "field_slots";
+    /** Nothing at all: no slot and no content (a falsy branch, an empty container). */
+    SectionSubtreeKind["NOTHING"] = "nothing";
+    /** Something a field-presence count cannot see: text, a component, a childless or custom element. */
+    SectionSubtreeKind["CONTENT"] = "content";
+})(SectionSubtreeKind || (SectionSubtreeKind = {}));
+function classifySectionSubtree(nodes, pathPrefix, placed) {
+    let sawFieldSlot = false;
+    for (const node of Children.toArray(nodes)) {
+        if (!isValidElement(node))
+            return SectionSubtreeKind.CONTENT;
+        const props = node.props;
+        let kind;
+        if (node.type === Fragment) {
+            kind = classifySectionSubtree(props.children, pathPrefix, placed);
+        }
+        else if (typeof node.type === 'string') {
+            // A plain element is a WRAPPER only when it wraps field slots (a layout `<div className="grid">`).
+            // Anything else is content: a childless element (an image, a rule, a spacer), one whose only child
+            // is a falsy branch (it may be drawn by CSS), and a custom element (it may render shadow content).
+            kind = !node.type.includes('-') && classifySectionSubtree(props.children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS
+                ? SectionSubtreeKind.FIELD_SLOTS
+                : SectionSubtreeKind.CONTENT;
+        }
+        else {
+            const role = node.type[SECTION_CONTENT_ROLE];
+            const name = typeof props.name === 'string' ? props.name : undefined;
+            const scopedPath = name ? (pathPrefix ? `${pathPrefix}.${name}` : name) : pathPrefix;
+            if (role === SectionContentRole.FIELD_SLOT) {
+                placed.push({ path: scopedPath, hasOwnSchema: props.schema !== undefined });
+                kind = SectionSubtreeKind.FIELD_SLOTS;
+            }
+            else if (role === SectionContentRole.FIELD_SLOT_CONTAINER) {
+                // A declared container holding nothing adds nothing, even an `ObjectScope` given a `className`
+                // (which renders a styled div). Unlike a bare styled div it scopes names rather than decorating,
+                // and when a section's slots are all absent the whole frame hides anyway.
+                kind = classifySectionSubtree(props.children, scopedPath, placed);
+            }
+            else {
+                kind = SectionSubtreeKind.CONTENT;
+            }
+        }
+        if (kind === SectionSubtreeKind.CONTENT)
+            return SectionSubtreeKind.CONTENT;
+        if (kind === SectionSubtreeKind.FIELD_SLOTS)
+            sawFieldSlot = true;
+    }
+    return sawFieldSlot ? SectionSubtreeKind.FIELD_SLOTS : SectionSubtreeKind.NOTHING;
+}
+/**
+ * True when `children` holds at least one field slot and nothing else. Fragments and declared containers
+ * are looked through, and so is a plain element that wraps field slots.
+ */
+export function holdsOnlyFieldSlots(children) {
+    return classifySectionSubtree(children, '', []) === SectionSubtreeKind.FIELD_SLOTS;
+}
+/**
+ * The field slots `children` places, or `null` when it holds anything besides field slots. Paths are
+ * resolved the way `FormField` resolves them (scope names joined to the slot's `name`), starting from
+ * `pathPrefix`. Read STATICALLY, from the elements, so a host can decide about a section whose content
+ * is not mounted — an inactive tab's panel is not.
+ */
+export function listPlacedFieldSlots(children, pathPrefix = '') {
+    const placed = [];
+    return classifySectionSubtree(children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS ? placed : null;
+}
 //# sourceMappingURL=SectionFieldsContext.js.map

package/dist/esm/components/resources/skeleton/SectionFieldsContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"SectionFieldsContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AA+B7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAA8B,EAAE;QAC1D,2FAA2F;QAC3F,IAAI,gBAAgB,GAAa,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;QACxC,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,EAAE,CAAC;QAC/C,CAAC,CAAC;QACF,OAAO;YACL,aAAa,EAAE,CAAC,IAAY,EAAQ,EAAE;gBACpC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAC5C,gBAAgB,GAAG,CAAC,GAAG,gBAAgB,EAAE,IAAI,CAAC,CAAC;gBAC/C,MAAM,EAAE,CAAC;YACX,CAAC;YACD,eAAe,EAAE,CAAC,IAAY,EAAQ,EAAE;gBACtC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAC7C,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;gBAC1E,MAAM,EAAE,CAAC;YACX,CAAC;YACD,mBAAmB,EAAE,GAAa,EAAE,CAAC,gBAAgB;YACrD,2BAA2B,EAAE,CAAC,QAAoB,EAAgB,EAAE;gBAClE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,GAAG,EAAE;oBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7B,CAAC,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAC3D,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,GAAG,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,uBAAuB,GAAa,EAAE,CAAC;AAC7C,MAAM,kBAAkB,GAAG,GAAiB,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,OAAO,oBAAoB,CACzB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAC1D,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAa,EAAE,CAAC,uBAAuB,CACxE,CAAC;AACJ,CAAC","sourcesContent":["import { createContext, useContext, useEffect, useState, useSyncExternalStore } from 'react';\n\n/**\n * Registry contract a form-hosted section exposes to its descendants.\n *\n * IDENTITY CONTRACT: providers MUST keep the context value identity-stable for\n * the lifetime of the section (see `useSectionFieldsRegistry`). Every\n * `FormField` registers itself through an effect that depends on this value;\n * a value whose identity tracks the registry contents re-fires every field's\n * registration effect on each mutation (unregister + register → new contents\n * → new value → …), which loops until React throws \"Maximum update depth\n * exceeded\" (recovered 2026-06-10 on the Wonder Todos todoLists create form).\n */\nexport interface SectionFieldsContextValue {\n  registerField: (name: string) => void;\n  unregisterField: (name: string) => void;\n  /**\n   * Current registered field names (insertion-ordered, deduplicated).\n   * Returns the live immutable snapshot — a new array identity is produced\n   * only when the contents actually change, so it is safe to use as a\n   * `useSyncExternalStore` snapshot.\n   */\n  getRegisteredFields: () => string[];\n  /**\n   * Subscribe to registry mutations. Returns the unsubscribe function.\n   * Render-reactive consumers should prefer `useRegisteredSectionFields`\n   * over wiring this manually.\n   */\n  subscribeToRegisteredFields: (listener: () => void) => () => void;\n}\n\nexport const SectionFieldsContext = createContext<SectionFieldsContextValue | null>(null);\n\n/**\n * Builds the identity-stable registry backing `SectionFieldsContext`.\n * Used by both section form hosts (`Section` solo modes and\n * `GroupedSectionBody` for grouped container panels) — keep them on this\n * single implementation so the identity contract cannot drift between hosts.\n *\n * Why the registry lives OUTSIDE React state: registrations arrive from\n * descendant effects. If the registered names were `useState` data baked into\n * the provider value (e.g. a `useMemo` with the names in its deps), every\n * registration would change the value identity, re-fire every field's\n * registration effect (cleanup unregister + register), change the state\n * again, and re-render forever — register/unregister pairs always transition\n * through fresh array identities, so any state-derived value loops by\n * construction. Instead the store is created once per section; mutations swap\n * an immutable snapshot and notify subscribers, so registry churn re-renders\n * only the components that opted in via `useRegisteredSectionFields` — never\n * the provider, never the registrants.\n *\n * Same family as the `WizardStep` field registry (stable mutable container),\n * extended with subscription because section save buttons render from the\n * registry contents (disabled-when-empty) and need to observe changes.\n */\nexport function useSectionFieldsRegistry(): SectionFieldsContextValue {\n  const [registry] = useState((): SectionFieldsContextValue => {\n    /** Immutable snapshot — swapped (never mutated) so subscribers can compare by identity. */\n    let registeredFields: string[] = [];\n    const listeners = new Set<() => void>();\n    const notify = (): void => {\n      for (const listener of listeners) listener();\n    };\n    return {\n      registerField: (name: string): void => {\n        if (registeredFields.includes(name)) return;\n        registeredFields = [...registeredFields, name];\n        notify();\n      },\n      unregisterField: (name: string): void => {\n        if (!registeredFields.includes(name)) return;\n        registeredFields = registeredFields.filter((current) => current !== name);\n        notify();\n      },\n      getRegisteredFields: (): string[] => registeredFields,\n      subscribeToRegisteredFields: (listener: () => void): (() => void) => {\n        listeners.add(listener);\n        return () => {\n          listeners.delete(listener);\n        };\n      },\n    };\n  });\n  return registry;\n}\n\n/**\n * Hook for `FormField` to register with the enclosing saveable section so the\n * section save action can validate and submit only the fields it actually\n * owns. No-op outside a section provider.\n *\n * Depends on the context value identity on purpose (React contract: re-bind\n * if the provider genuinely changes). This is safe only because providers\n * honor the identity contract documented on `SectionFieldsContextValue` —\n * the effect then runs once per field mount.\n */\nexport function useSectionFieldRegistration(fieldName: string): void {\n  const ctx = useContext(SectionFieldsContext);\n  useEffect(() => {\n    ctx?.registerField(fieldName);\n    return () => {\n      ctx?.unregisterField(fieldName);\n    };\n  }, [ctx, fieldName]);\n}\n\nconst EMPTY_REGISTERED_FIELDS: string[] = [];\nconst subscribeToNothing = (): (() => void) => () => {};\n\n/**\n * Render-reactive view of the enclosing section's registered field names.\n * Re-renders the caller when fields register/unregister (e.g. conditionally\n * shown fields), without ever invalidating the provider value. Returns a\n * stable empty array outside any section provider.\n */\nexport function useRegisteredSectionFields(): string[] {\n  const ctx = useContext(SectionFieldsContext);\n  return useSyncExternalStore(\n    ctx ? ctx.subscribeToRegisteredFields : subscribeToNothing,\n    ctx ? ctx.getRegisteredFields : (): string[] => EMPTY_REGISTERED_FIELDS,\n  );\n}\n"]}
+{"version":3,"file":"SectionFieldsContext.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Children, Fragment, createContext, isValidElement, useContext, useEffect, useLayoutEffect, useState, useSyncExternalStore, type ReactNode } from 'react';\n\n/**\n * Registry contract a form-hosted section exposes to its descendants.\n *\n * IDENTITY CONTRACT: providers MUST keep the context value identity-stable for\n * the lifetime of the section (see `useSectionFieldsRegistry`). Every\n * `FormField` registers itself through an effect that depends on this value;\n * a value whose identity tracks the registry contents re-fires every field's\n * registration effect on each mutation (unregister + register → new contents\n * → new value → …), which loops until React throws \"Maximum update depth\n * exceeded\" (recovered 2026-06-10 on the Wonder Todos todoLists create form).\n */\nexport interface SectionFieldsContextValue {\n  registerField: (name: string) => void;\n  unregisterField: (name: string) => void;\n  /**\n   * Current registered field names (insertion-ordered, deduplicated).\n   * Returns the live immutable snapshot — a new array identity is produced\n   * only when the contents actually change, so it is safe to use as a\n   * `useSyncExternalStore` snapshot.\n   */\n  getRegisteredFields: () => string[];\n  /**\n   * Subscribe to registry mutations. Returns the unsubscribe function.\n   * Render-reactive consumers should prefer `useRegisteredSectionFields`\n   * over wiring this manually.\n   */\n  subscribeToRegisteredFields: (listener: () => void) => () => void;\n  /**\n   * Records whether a field this section declares actually RENDERS a control here — its field is in\n   * the operation's schema and not hidden by a condition. A template places its `FormField` slots\n   * unconditionally and lets the operation's schema decide (a slot whose field the schema lacks\n   * renders nothing), so a section can declare fields and show none of them.\n   */\n  reportSlotPresence: (slot: object, present: boolean) => void;\n  clearSlotPresence: (slot: object) => void;\n  /**\n   * True when fields reported here and NONE of them renders. Measured on Wonder Todos, \"Reset to\n   * defaults\" showed the preferences template's four section cards, every one empty. This is a fact\n   * about FIELDS only: a section also holding other content (text, a custom control, a nested section)\n   * is not empty because of it — `Section` combines it with `holdsOnlyFieldSlots`. Notifies through\n   * `subscribeToRegisteredFields`.\n   */\n  showsNoField: () => boolean;\n}\n\nexport const SectionFieldsContext = createContext<SectionFieldsContextValue | null>(null);\n\n/**\n * Builds the identity-stable registry backing `SectionFieldsContext`.\n * Used by both section form hosts (`Section` solo modes and\n * `GroupedSectionBody` for grouped container panels) — keep them on this\n * single implementation so the identity contract cannot drift between hosts.\n *\n * Why the registry lives OUTSIDE React state: registrations arrive from\n * descendant effects. If the registered names were `useState` data baked into\n * the provider value (e.g. a `useMemo` with the names in its deps), every\n * registration would change the value identity, re-fire every field's\n * registration effect (cleanup unregister + register), change the state\n * again, and re-render forever — register/unregister pairs always transition\n * through fresh array identities, so any state-derived value loops by\n * construction. Instead the store is created once per section; mutations swap\n * an immutable snapshot and notify subscribers, so registry churn re-renders\n * only the components that opted in via `useRegisteredSectionFields` — never\n * the provider, never the registrants.\n *\n * Same family as the `WizardStep` field registry (stable mutable container),\n * extended with subscription because section save buttons render from the\n * registry contents (disabled-when-empty) and need to observe changes.\n */\nexport function useSectionFieldsRegistry(): SectionFieldsContextValue {\n  const [registry] = useState((): SectionFieldsContextValue => {\n    /** Immutable snapshot — swapped (never mutated) so subscribers can compare by identity. */\n    let registeredFields: string[] = [];\n    // One entry per MOUNTED SLOT, keyed by that slot's own token rather than by field name: the same\n    // field placed twice is two slots, which may even disagree (one given a schema the other lacks), and\n    // one copy unmounting must not erase or overwrite the other's answer.\n    const slotPresence = new Map<object, boolean>();\n    let showsNoField = false;\n    const listeners = new Set<() => void>();\n    const notify = (): void => {\n      for (const listener of listeners) listener();\n    };\n    const recomputePresence = (): void => {\n      const next = slotPresence.size > 0 && ![...slotPresence.values()].some(Boolean);\n      if (next === showsNoField) return;\n      showsNoField = next;\n      notify();\n    };\n    return {\n      registerField: (name: string): void => {\n        if (registeredFields.includes(name)) return;\n        registeredFields = [...registeredFields, name];\n        notify();\n      },\n      unregisterField: (name: string): void => {\n        if (!registeredFields.includes(name)) return;\n        registeredFields = registeredFields.filter((current) => current !== name);\n        notify();\n      },\n      getRegisteredFields: (): string[] => registeredFields,\n      reportSlotPresence: (slot: object, present: boolean): void => {\n        slotPresence.set(slot, present);\n        recomputePresence();\n      },\n      clearSlotPresence: (slot: object): void => {\n        if (!slotPresence.delete(slot)) return;\n        recomputePresence();\n      },\n      showsNoField: (): boolean => showsNoField,\n      subscribeToRegisteredFields: (listener: () => void): (() => void) => {\n        listeners.add(listener);\n        return () => {\n          listeners.delete(listener);\n        };\n      },\n    };\n  });\n  return registry;\n}\n\n/**\n * Hook for `FormField` to register with the enclosing saveable section so the\n * section save action can validate and submit only the fields it actually\n * owns. No-op outside a section provider.\n *\n * Depends on the context value identity on purpose (React contract: re-bind\n * if the provider genuinely changes). This is safe only because providers\n * honor the identity contract documented on `SectionFieldsContextValue` —\n * the effect then runs once per field mount.\n */\nexport function useSectionFieldRegistration(fieldName: string): void {\n  const ctx = useContext(SectionFieldsContext);\n  useEffect(() => {\n    ctx?.registerField(fieldName);\n    return () => {\n      ctx?.unregisterField(fieldName);\n    };\n  }, [ctx, fieldName]);\n}\n\nconst EMPTY_REGISTERED_FIELDS: string[] = [];\nconst subscribeToNothing = (): (() => void) => () => {};\n\n/**\n * Render-reactive view of the enclosing section's registered field names.\n * Re-renders the caller when fields register/unregister (e.g. conditionally\n * shown fields), without ever invalidating the provider value. Returns a\n * stable empty array outside any section provider.\n */\nexport function useRegisteredSectionFields(): string[] {\n  const ctx = useContext(SectionFieldsContext);\n  return useSyncExternalStore(\n    ctx ? ctx.subscribeToRegisteredFields : subscribeToNothing,\n    ctx ? ctx.getRegisteredFields : (): string[] => EMPTY_REGISTERED_FIELDS,\n  );\n}\n\n/**\n * Hook for `FormField` to tell its section whether it renders a control. A LAYOUT effect, so the\n * section knows before the browser paints and an empty section never flashes on screen.\n */\nexport function useSectionFieldPresence(present: boolean): void {\n  // Two effects on purpose. The CLEAR runs only when the slot leaves this registry (unmount, or the\n  // section provider changing), so a slot whose `present` flips is updated in place rather than deleted\n  // and re-added; either way the section settles before paint. The REPORT runs on every change of\n  // `present`, and after a provider change it reports into the new registry.\n  const ctx = useContext(SectionFieldsContext);\n  const [slot] = useState(() => ({}));\n  useLayoutEffect(() => () => {\n    ctx?.clearSlotPresence(slot);\n  }, [ctx, slot]);\n  useLayoutEffect(() => {\n    ctx?.reportSlotPresence(slot, present);\n  }, [ctx, slot, present]);\n}\n\n/**\n * Whether the section this registry backs has fields and shows none of them.\n *\n * Read in a LAYOUT effect rather than through `useSyncExternalStore`: the fields report in their own\n * layout effects, which run before their section's, so the section settles before the browser paints.\n * A store subscription is attached in a passive effect, after paint, and would let an empty frame show\n * for a frame on the first mount and on every keyed remount of the form.\n */\nexport function useSectionShowsNoField(registry: SectionFieldsContextValue): boolean {\n  const [showsNoField, setShowsNoField] = useState(false);\n  useLayoutEffect(() => {\n    const update = (): void => setShowsNoField(registry.showsNoField());\n    update();\n    return registry.subscribeToRegisteredFields(update);\n  }, [registry]);\n  return showsNoField;\n}\n\n/**\n * What a component is to a section deciding whether it holds anything besides field slots.\n *\n * A section may hide when none of its fields renders only if fields are ALL it holds: text, a custom\n * control or a nested section beside them is content of its own, which a field-presence count cannot see.\n * Plain elements that wrap field slots (a layout `div`) are looked through. Components opt in by declaring\n * their role; any undeclared component counts as other content, so an unknown component can only keep a\n * section visible, never hide one. The role API is deliberately NOT exported from the package: an\n * application's own wrapper component keeps its section visible, which is the safe answer, and an author\n * who wants hiding places slots directly, in a plain element, or in `ObjectScope`.\n */\nexport enum SectionContentRole {\n  /** A slot that renders one field's control, or nothing when the operation's schema lacks it. */\n  FIELD_SLOT = 'field_slot',\n  /** A wrapper whose children are judged in its place (it scopes field names and adds no content). */\n  FIELD_SLOT_CONTAINER = 'field_slot_container',\n}\n\nconst SECTION_CONTENT_ROLE = Symbol.for('wildo.sectionContentRole');\n\n/** The role a component declared, if any (read by the placement report as well as the hide decision). */\nexport function sectionContentRoleOf(type: unknown): SectionContentRole | undefined {\n  return (type !== null && (typeof type === 'function' || typeof type === 'object'))\n    ? (type as { [SECTION_CONTENT_ROLE]?: SectionContentRole })[SECTION_CONTENT_ROLE]\n    : undefined;\n}\n\n/** Declares what a component is to `holdsOnlyFieldSlots`. */\nexport function declareSectionContentRole(component: object, role: SectionContentRole): void {\n  Object.defineProperty(component, SECTION_CONTENT_ROLE, { value: role, enumerable: false });\n}\n\n/** What a subtree amounts to for `holdsOnlyFieldSlots`. */\nenum SectionSubtreeKind {\n  /** At least one field slot, and nothing else. */\n  FIELD_SLOTS = 'field_slots',\n  /** Nothing at all: no slot and no content (a falsy branch, an empty container). */\n  NOTHING = 'nothing',\n  /** Something a field-presence count cannot see: text, a component, a childless or custom element. */\n  CONTENT = 'content',\n}\n\n/** Where a field slot writes, as `FormField` resolves it: the enclosing scopes' names joined to its own. */\nexport interface PlacedFieldSlot {\n  path: string;\n  /** The slot was handed its own schema, so the form's schema does not decide whether it renders. */\n  hasOwnSchema: boolean;\n}\n\nfunction classifySectionSubtree(nodes: ReactNode, pathPrefix: string, placed: PlacedFieldSlot[]): SectionSubtreeKind {\n  let sawFieldSlot = false;\n  for (const node of Children.toArray(nodes)) {\n    if (!isValidElement(node)) return SectionSubtreeKind.CONTENT;\n    const props = node.props as { children?: ReactNode; name?: unknown; schema?: unknown };\n    let kind: SectionSubtreeKind;\n    if (node.type === Fragment) {\n      kind = classifySectionSubtree(props.children, pathPrefix, placed);\n    } else if (typeof node.type === 'string') {\n      // A plain element is a WRAPPER only when it wraps field slots (a layout `<div className=\"grid\">`).\n      // Anything else is content: a childless element (an image, a rule, a spacer), one whose only child\n      // is a falsy branch (it may be drawn by CSS), and a custom element (it may render shadow content).\n      kind = !node.type.includes('-') && classifySectionSubtree(props.children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS\n        ? SectionSubtreeKind.FIELD_SLOTS\n        : SectionSubtreeKind.CONTENT;\n    } else {\n      const role = (node.type as { [SECTION_CONTENT_ROLE]?: SectionContentRole })[SECTION_CONTENT_ROLE];\n      const name = typeof props.name === 'string' ? props.name : undefined;\n      const scopedPath = name ? (pathPrefix ? `${pathPrefix}.${name}` : name) : pathPrefix;\n      if (role === SectionContentRole.FIELD_SLOT) {\n        placed.push({ path: scopedPath, hasOwnSchema: props.schema !== undefined });\n        kind = SectionSubtreeKind.FIELD_SLOTS;\n      } else if (role === SectionContentRole.FIELD_SLOT_CONTAINER) {\n        // A declared container holding nothing adds nothing, even an `ObjectScope` given a `className`\n        // (which renders a styled div). Unlike a bare styled div it scopes names rather than decorating,\n        // and when a section's slots are all absent the whole frame hides anyway.\n        kind = classifySectionSubtree(props.children, scopedPath, placed);\n      } else {\n        kind = SectionSubtreeKind.CONTENT;\n      }\n    }\n    if (kind === SectionSubtreeKind.CONTENT) return SectionSubtreeKind.CONTENT;\n    if (kind === SectionSubtreeKind.FIELD_SLOTS) sawFieldSlot = true;\n  }\n  return sawFieldSlot ? SectionSubtreeKind.FIELD_SLOTS : SectionSubtreeKind.NOTHING;\n}\n\n/**\n * True when `children` holds at least one field slot and nothing else. Fragments and declared containers\n * are looked through, and so is a plain element that wraps field slots.\n */\nexport function holdsOnlyFieldSlots(children: ReactNode): boolean {\n  return classifySectionSubtree(children, '', []) === SectionSubtreeKind.FIELD_SLOTS;\n}\n\n/**\n * The field slots `children` places, or `null` when it holds anything besides field slots. Paths are\n * resolved the way `FormField` resolves them (scope names joined to the slot's `name`), starting from\n * `pathPrefix`. Read STATICALLY, from the elements, so a host can decide about a section whose content\n * is not mounted — an inactive tab's panel is not.\n */\nexport function listPlacedFieldSlots(children: ReactNode, pathPrefix = ''): PlacedFieldSlot[] | null {\n  const placed: PlacedFieldSlot[] = [];\n  return classifySectionSubtree(children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS ? placed : null;\n}\n"]}

package/dist/esm/components/resources/skeleton/SectionHostHeadingContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionHostHeadingContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionHostHeadingContext.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,yBAAyB,kCAAgC,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD"}
+{"version":3,"file":"SectionHostHeadingContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionHostHeadingContext.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,yBAAyB,kCAAgC,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD"}

package/dist/esm/components/resources/skeleton/SectionHostHeadingContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"SectionHostHeadingContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionHostHeadingContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAU,KAAK,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["'use client';\n\nimport { createContext, useContext } from 'react';\n\n/**\n * Signals that the nearest enclosing section host already renders a visible\n * heading (a `<Section>` legend / title) for the region a descendant occupies.\n *\n * A resource operation surface embedded inside a titled section (e.g. a LIST\n * embedded in a composite `<Section name=\"todoLists\">`) would otherwise render\n * its OWN generic resource heading directly under the section's heading — two\n * headings naming the same thing (\"To-Do Lists\" then \"Todo Lists\"). The\n * embedded header reads this context (via {@link useSectionHostProvidesHeading})\n * and suppresses its generic title so the host section owns the heading.\n *\n * This is the heading analogue of the surface frame de-duplication: the host\n * owns the chrome, the embedded content does not duplicate it. It is scoped to\n * GENERIC titles only — a record-specific `displayLabel` (a READ view showing\n * an instance's name) is data, not a duplicate heading, and is never\n * suppressed (the consumer gates on the absence of a displayLabel).\n *\n * Default `false`: with no titled section ancestor (a standalone list/read\n * page), the embedded header renders its heading normally.\n */\nexport const SectionHostHeadingContext = createContext<boolean>(false);\n\n/**\n * `true` when an ancestor `<Section>` already renders a heading for this region.\n * Resource headers use it to avoid emitting a duplicate generic heading when\n * embedded inside a titled section host.\n */\nexport function useSectionHostProvidesHeading(): boolean {\n  return useContext(SectionHostHeadingContext);\n}\n"]}
+{"version":3,"file":"SectionHostHeadingContext.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionHostHeadingContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAU,KAAK,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["'use client';\n\nimport { createContext, useContext } from 'react';\n\n/**\n * Signals that the nearest enclosing section host already renders a visible\n * heading (a `<Section>` legend / title) for the region a descendant occupies.\n *\n * A resource operation surface embedded inside a titled section (e.g. a LIST\n * embedded in a composite `<Section name=\"todoLists\">`) would otherwise render\n * its OWN generic resource heading directly under the section's heading — two\n * headings naming the same thing (\"To-Do Lists\" then \"Todo Lists\"). The\n * embedded header reads this context (via {@link useSectionHostProvidesHeading})\n * and suppresses its generic title so the host section owns the heading.\n *\n * This is the heading analogue of the surface frame de-duplication: the host\n * owns the chrome, the embedded content does not duplicate it. It is scoped to\n * GENERIC titles only — a record-specific `displayLabel` (a READ view showing\n * an instance's name) is data, not a duplicate heading, and is never\n * suppressed (the consumer gates on the absence of a displayLabel).\n *\n * Default `false`: with no titled section ancestor (a standalone list/read\n * page), the embedded header renders its heading normally.\n */\nexport const SectionHostHeadingContext = createContext<boolean>(false);\n\n/**\n * `true` when an ancestor `<Section>` already renders a heading for this region.\n * Resource headers use it to avoid emitting a duplicate generic heading when\n * embedded inside a titled section host.\n */\nexport function useSectionHostProvidesHeading(): boolean {\n  return useContext(SectionHostHeadingContext);\n}\n"]}

package/dist/esm/components/resources/skeleton/SectionPresentationContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionPresentationContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAC3D;AAID,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,+BAA+B,CAAC;IACvC,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQpB;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,GAAG,IAAI,CAE9F"}
+{"version":3,"file":"SectionPresentationContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAC3D;AAID,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,+BAA+B,CAAC;IACvC,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQpB;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,GAAG,IAAI,CAE9F"}

package/dist/esm/components/resources/skeleton/SectionPresentationContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"SectionPresentationContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAmBlF,MAAM,0BAA0B,GAAG,aAAa,CAAyC,IAAI,CAAC,CAAC;AAE/F,MAAM,UAAU,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GAIT;IACC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YACrD,QAAQ,GAC2B,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,OAAO,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAChD,CAAC","sourcesContent":["'use client';\n\nimport type { IndicatorVariant } from '@wildo-ai/presets-components-models';\nimport React, { createContext, useContext, useMemo, type ReactNode } from 'react';\n\nexport interface SectionPresentationEntry {\n  title?: ReactNode;\n  description?: ReactNode;\n  icon?: ReactNode;\n  /**\n   * A COUNT the section's tab carries beside its title — how many things wait inside it — in the\n   * tone the number reads in (#1325). Rendered by the tab trigger's own `count` slot, so it joins\n   * the accessible name correctly instead of being folded into the title as prose.\n   */\n  count?: number;\n  countTone?: IndicatorVariant;\n}\n\nexport interface SectionPresentationContextValue {\n  sectionEntries?: Record<string, SectionPresentationEntry>;\n}\n\nconst SectionPresentationContext = createContext<SectionPresentationContextValue | null>(null);\n\nexport function SectionPresentationProvider({\n  value,\n  children,\n}: {\n  value: SectionPresentationContextValue;\n  children: ReactNode;\n}): React.JSX.Element {\n  const contextValue = useMemo(() => value, [value]);\n\n  return (\n    <SectionPresentationContext.Provider value={contextValue}>\n      {children}\n    </SectionPresentationContext.Provider>\n  );\n}\n\nexport function useOptionalSectionPresentationContext(): SectionPresentationContextValue | null {\n  return useContext(SectionPresentationContext);\n}\n"]}
+{"version":3,"file":"SectionPresentationContext.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAmBlF,MAAM,0BAA0B,GAAG,aAAa,CAAyC,IAAI,CAAC,CAAC;AAE/F,MAAM,UAAU,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GAIT;IACC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YACrD,QAAQ,GAC2B,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,OAAO,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAChD,CAAC","sourcesContent":["'use client';\n\nimport type { IndicatorVariant } from '@wildo-ai/presets-components-models';\nimport React, { createContext, useContext, useMemo, type ReactNode } from 'react';\n\nexport interface SectionPresentationEntry {\n  title?: ReactNode;\n  description?: ReactNode;\n  icon?: ReactNode;\n  /**\n   * A COUNT the section's tab carries beside its title — how many things wait inside it — in the\n   * tone the number reads in (#1325). Rendered by the tab trigger's own `count` slot, so it joins\n   * the accessible name correctly instead of being folded into the title as prose.\n   */\n  count?: number;\n  countTone?: IndicatorVariant;\n}\n\nexport interface SectionPresentationContextValue {\n  sectionEntries?: Record<string, SectionPresentationEntry>;\n}\n\nconst SectionPresentationContext = createContext<SectionPresentationContextValue | null>(null);\n\nexport function SectionPresentationProvider({\n  value,\n  children,\n}: {\n  value: SectionPresentationContextValue;\n  children: ReactNode;\n}): React.JSX.Element {\n  const contextValue = useMemo(() => value, [value]);\n\n  return (\n    <SectionPresentationContext.Provider value={contextValue}>\n      {children}\n    </SectionPresentationContext.Provider>\n  );\n}\n\nexport function useOptionalSectionPresentationContext(): SectionPresentationContextValue | null {\n  return useContext(SectionPresentationContext);\n}\n"]}

package/dist/esm/components/resources/skeleton/SubmitButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubmitButton.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SubmitButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAmCrH;yBAnCe,YAAY"}
+{"version":3,"file":"SubmitButton.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SubmitButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAmCrH;yBAnCe,YAAY"}

package/dist/esm/components/resources/skeleton/SubmitButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubmitButton.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SubmitButton.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,+CAA+C,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,uDAAuD,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,8BAA8B,EAAE,MAAM,mEAAmE,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAwB9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAqB;IACxG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAEpC,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,8BAA8B,EAAE,CAAC;IACrD,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACtC,SAAS,EAAE,qBAAqB,CAAC,sBAAsB;KACxD,CAAC,CAAC;IAEH,8EAA8E;IAC9E,6EAA6E;IAC7E,2EAA2E;IAC3E,+EAA+E;IAC/E,oBAAoB;IACpB,MAAM,gBAAgB,GAAG,KAAK,KAAK,SAAS,CAAC;IAC7C,MAAM,YAAY,GAAG,gBAAgB,IAAI,CAAC,OAAO,CAAC;IAElD,MAAM,aAAa,GAAG,KAAK;WACtB,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEpG,4EAA4E;IAC5E,gCAAgC;IAChC,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,IAAI,YAAY,IAAI,QAAQ,KAAK,IAAI,CAAC;IAE1G,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,IAAI,eAAe;QAC5D,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,aAAa,CAAC;IAElB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,YACvB,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,YACrF,KAAC,YAAY,IAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAC,KAAK,YAAE,YAAY,GAAgB,GACvE,GACL,CACP,CAAC;AACJ,CAAC;AAED,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { useFormContext } from 'react-hook-form';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { Button } from '~wildo-frontend-lib/components/actions/button';\nimport { SkeletonText } from '~wildo-frontend-lib/components/feedback/skeleton-text';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useOptionalFormTemplateContext } from '~wildo-frontend-lib/components/form/automated/FormTemplateContext';\nimport { useSlotRegistration } from './FormLayoutSlotContext';\n\nexport interface SubmitButtonProps {\n  /** Label for the submit button. Falls back to i18n default (\"Save\"). */\n  label?: string;\n  /** Label shown while the form is submitting. Falls back to `label` (no visual change). */\n  submittingLabel?: string;\n  /** Additional CSS classes for the button container. */\n  className?: string;\n  /** When true, the button stretches to full container width. */\n  fullWidth?: boolean;\n  /**\n   * A template-level precondition that is not a field: the form is valid and submitting is still not\n   * allowed yet.\n   *\n   * ORed with the existing reasons, never replacing them — passing `false` cannot re-enable a button\n   * the form is already disabling because it is submitting, because the template context says so, or\n   * because the label has not resolved. Added for the registration consent control (issue #54),\n   * where what must be true is a checkbox outside the form schema: the set of governed documents is\n   * per-application runtime configuration, so no static Zod schema can declare a field for it.\n   */\n  disabled?: boolean;\n}\n\n/**\n * Form submit action slot — placed by the template author where desired.\n *\n * Labels are resolved from explicit props, falling back to i18n (\"Save\").\n * Templates pass labels directly — no context dependency for label text.\n *\n * Disabled when `formState.isSubmitting` or `FormTemplateContext.disabled` is true.\n * (FormTemplateContext is used only for the disabled flag — a skeleton-layer concern.)\n *\n * In wizard mode, the wizard layout manages its own submit/next buttons,\n * so this component is only used in non-wizard templates.\n *\n * @example\n * ```tsx\n * <FormLayout>\n *   <Section name=\"general\">\n *     <FormField name=\"title\" />\n *   </Section>\n *   <SubmitButton label=\"Create\" submittingLabel=\"Creating...\" fullWidth />\n * </FormLayout>\n * ```\n */\nexport function SubmitButton({ className, label, submittingLabel, fullWidth, disabled }: SubmitButtonProps): ReactNode {\n  useSlotRegistration('submitButton');\n\n  const { formState } = useFormContext();\n  const templateCtx = useOptionalFormTemplateContext();\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  // An explicit `label` needs no i18n; only the default (\"Save\") fallback waits\n  // on the form-message bundle. Render the button structure immediately either\n  // way (no `return null`, which would unmount the slot and stall the form's\n  // single-wave reveal) and skeleton ONLY the label text while a needed fallback\n  // is still loading.\n  const usesI18nFallback = label === undefined;\n  const labelLoading = usesI18nFallback && !isReady;\n\n  const resolvedLabel = label\n    ?? (isReady ? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'submitSave') : undefined);\n\n  // Disabled while the label is still resolving — can't submit a button whose\n  // action label isn't known yet.\n  const isDisabled = formState.isSubmitting || !!templateCtx?.disabled || labelLoading || disabled === true;\n\n  const displayLabel = formState.isSubmitting && submittingLabel\n    ? submittingLabel\n    : resolvedLabel;\n\n  return (\n    <div className={className}>\n      <Button type=\"submit\" disabled={isDisabled} className={fullWidth ? 'w-full' : undefined}>\n        <SkeletonText loading={labelLoading} width=\"5em\">{displayLabel}</SkeletonText>\n      </Button>\n    </div>\n  );\n}\n\nSubmitButton.displayName = 'SubmitButton';\n"]}
+{"version":3,"file":"SubmitButton.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SubmitButton.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,+CAA+C,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,uDAAuD,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,8BAA8B,EAAE,MAAM,mEAAmE,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAwB9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAqB;IACxG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAEpC,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,8BAA8B,EAAE,CAAC;IACrD,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACtC,SAAS,EAAE,qBAAqB,CAAC,sBAAsB;KACxD,CAAC,CAAC;IAEH,8EAA8E;IAC9E,6EAA6E;IAC7E,2EAA2E;IAC3E,+EAA+E;IAC/E,oBAAoB;IACpB,MAAM,gBAAgB,GAAG,KAAK,KAAK,SAAS,CAAC;IAC7C,MAAM,YAAY,GAAG,gBAAgB,IAAI,CAAC,OAAO,CAAC;IAElD,MAAM,aAAa,GAAG,KAAK;WACtB,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEpG,4EAA4E;IAC5E,gCAAgC;IAChC,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,IAAI,YAAY,IAAI,QAAQ,KAAK,IAAI,CAAC;IAE1G,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,IAAI,eAAe;QAC5D,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,aAAa,CAAC;IAElB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,YACvB,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,YACrF,KAAC,YAAY,IAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAC,KAAK,YAAE,YAAY,GAAgB,GACvE,GACL,CACP,CAAC;AACJ,CAAC;AAED,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { useFormContext } from 'react-hook-form';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { Button } from '~wildo-frontend-lib/components/actions/button';\nimport { SkeletonText } from '~wildo-frontend-lib/components/feedback/skeleton-text';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useOptionalFormTemplateContext } from '~wildo-frontend-lib/components/form/automated/FormTemplateContext';\nimport { useSlotRegistration } from './FormLayoutSlotContext';\n\nexport interface SubmitButtonProps {\n  /** Label for the submit button. Falls back to i18n default (\"Save\"). */\n  label?: string;\n  /** Label shown while the form is submitting. Falls back to `label` (no visual change). */\n  submittingLabel?: string;\n  /** Additional CSS classes for the button container. */\n  className?: string;\n  /** When true, the button stretches to full container width. */\n  fullWidth?: boolean;\n  /**\n   * A template-level precondition that is not a field: the form is valid and submitting is still not\n   * allowed yet.\n   *\n   * ORed with the existing reasons, never replacing them — passing `false` cannot re-enable a button\n   * the form is already disabling because it is submitting, because the template context says so, or\n   * because the label has not resolved. Added for the registration consent control (issue #54),\n   * where what must be true is a checkbox outside the form schema: the set of governed documents is\n   * per-application runtime configuration, so no static Zod schema can declare a field for it.\n   */\n  disabled?: boolean;\n}\n\n/**\n * Form submit action slot — placed by the template author where desired.\n *\n * Labels are resolved from explicit props, falling back to i18n (\"Save\").\n * Templates pass labels directly — no context dependency for label text.\n *\n * Disabled when `formState.isSubmitting` or `FormTemplateContext.disabled` is true.\n * (FormTemplateContext is used only for the disabled flag — a skeleton-layer concern.)\n *\n * In wizard mode, the wizard layout manages its own submit/next buttons,\n * so this component is only used in non-wizard templates.\n *\n * @example\n * ```tsx\n * <FormLayout>\n *   <Section name=\"general\">\n *     <FormField name=\"title\" />\n *   </Section>\n *   <SubmitButton label=\"Create\" submittingLabel=\"Creating...\" fullWidth />\n * </FormLayout>\n * ```\n */\nexport function SubmitButton({ className, label, submittingLabel, fullWidth, disabled }: SubmitButtonProps): ReactNode {\n  useSlotRegistration('submitButton');\n\n  const { formState } = useFormContext();\n  const templateCtx = useOptionalFormTemplateContext();\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  // An explicit `label` needs no i18n; only the default (\"Save\") fallback waits\n  // on the form-message bundle. Render the button structure immediately either\n  // way (no `return null`, which would unmount the slot and stall the form's\n  // single-wave reveal) and skeleton ONLY the label text while a needed fallback\n  // is still loading.\n  const usesI18nFallback = label === undefined;\n  const labelLoading = usesI18nFallback && !isReady;\n\n  const resolvedLabel = label\n    ?? (isReady ? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'submitSave') : undefined);\n\n  // Disabled while the label is still resolving — can't submit a button whose\n  // action label isn't known yet.\n  const isDisabled = formState.isSubmitting || !!templateCtx?.disabled || labelLoading || disabled === true;\n\n  const displayLabel = formState.isSubmitting && submittingLabel\n    ? submittingLabel\n    : resolvedLabel;\n\n  return (\n    <div className={className}>\n      <Button type=\"submit\" disabled={isDisabled} className={fullWidth ? 'w-full' : undefined}>\n        <SkeletonText loading={labelLoading} width=\"5em\">{displayLabel}</SkeletonText>\n      </Button>\n    </div>\n  );\n}\n\nSubmitButton.displayName = 'SubmitButton';\n"]}

package/dist/esm/components/resources/skeleton/SummaryHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryHeader.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryHeader.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAoBpF"}
+{"version":3,"file":"SummaryHeader.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryHeader.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAoBpF"}

package/dist/esm/components/resources/skeleton/SummaryHeader.js.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryHeader.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryHeader.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AA6Bb,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AASpD,MAAM,UAAU,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAsB;IACvE,OAAO;IACL,+EAA+E;IAC/E,6EAA6E;IAC7E,6EAA6E;IAC7E,iFAAiF;IACjF,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,qCAAqC;IACrC,cACE,SAAS,EAAE,EAAE,CACX,0CAA0C,EAC1C,iEAAiE,EACjE,SAAS,CACV,YAEA,QAAQ,GACL,CACP,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * SummaryHeader — a single-line header row for summary templates: the primary\n * title plus one or more inline accessories (a status badge, a marker) on the\n * same line.\n *\n * Replaces the old `layout.summaryTitleAccessory` bolt-on. Where authors used to\n * declare a SECOND template just to place a badge beside the host-owned title,\n * they now compose it directly in the template flow:\n *\n * ```tsx\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n *   <SummaryHeader>\n *     <SummaryTitle />\n *     <DisplayField name=\"status\" hideLabel />\n *   </SummaryHeader>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * ```\n *\n * The title (first child, typically `<SummaryTitle />`) truncates and shrinks;\n * trailing accessories keep their intrinsic size (`shrink-0`). This is the same\n * geometry the list-card host used to hand-roll for the accessory slot, now owned\n * once here so every summary surface (list card AND FK popover) renders it\n * identically.\n */\n\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\nexport interface SummaryHeaderProps {\n  /** Extra classes merged over the default flex-row layout. */\n  className?: string;\n  /** Title element (usually `<SummaryTitle />`) followed by inline accessories. */\n  children?: ReactNode;\n}\n\nexport function SummaryHeader({ className, children }: SummaryHeaderProps): ReactNode {\n  return (\n    // The title (`<SummaryTitle />`) grows + truncates via `flex-1 min-w-0` on the\n    // title element ITSELF (not a `:first-child` selector here — that would hand\n    // the grow to a trailing accessory when the title renders null). Accessories\n    // keep intrinsic size: `shrink-0` stops them shrinking, and `w-auto` NEUTRALISES\n    // the `w-full` field-chrome root a `<DisplayField>` accessory renders with —\n    // without it, a `w-full` badge claims the whole row and squashes the title to\n    // zero width (title text present but invisible). Higher specificity than the\n    // field's own `.w-full`, so it wins.\n    <div\n      className={cn(\n        'flex min-w-0 items-center gap-element-sm',\n        '[&>*:not(:first-child)]:shrink-0 [&>*:not(:first-child)]:w-auto',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"SummaryHeader.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryHeader.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AA6Bb,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AASpD,MAAM,UAAU,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAsB;IACvE,OAAO;IACL,+EAA+E;IAC/E,6EAA6E;IAC7E,6EAA6E;IAC7E,iFAAiF;IACjF,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,qCAAqC;IACrC,cACE,SAAS,EAAE,EAAE,CACX,0CAA0C,EAC1C,iEAAiE,EACjE,SAAS,CACV,YAEA,QAAQ,GACL,CACP,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * SummaryHeader — a single-line header row for summary templates: the primary\n * title plus one or more inline accessories (a status badge, a marker) on the\n * same line.\n *\n * Replaces the old `layout.summaryTitleAccessory` bolt-on. Where authors used to\n * declare a SECOND template just to place a badge beside the host-owned title,\n * they now compose it directly in the template flow:\n *\n * ```tsx\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n *   <SummaryHeader>\n *     <SummaryTitle />\n *     <DisplayField name=\"status\" hideLabel />\n *   </SummaryHeader>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * ```\n *\n * The title (first child, typically `<SummaryTitle />`) truncates and shrinks;\n * trailing accessories keep their intrinsic size (`shrink-0`). This is the same\n * geometry the list-card host used to hand-roll for the accessory slot, now owned\n * once here so every summary surface (list card AND FK popover) renders it\n * identically.\n */\n\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\nexport interface SummaryHeaderProps {\n  /** Extra classes merged over the default flex-row layout. */\n  className?: string;\n  /** Title element (usually `<SummaryTitle />`) followed by inline accessories. */\n  children?: ReactNode;\n}\n\nexport function SummaryHeader({ className, children }: SummaryHeaderProps): ReactNode {\n  return (\n    // The title (`<SummaryTitle />`) grows + truncates via `flex-1 min-w-0` on the\n    // title element ITSELF (not a `:first-child` selector here — that would hand\n    // the grow to a trailing accessory when the title renders null). Accessories\n    // keep intrinsic size: `shrink-0` stops them shrinking, and `w-auto` NEUTRALISES\n    // the `w-full` field-chrome root a `<DisplayField>` accessory renders with —\n    // without it, a `w-full` badge claims the whole row and squashes the title to\n    // zero width (title text present but invisible). Higher specificity than the\n    // field's own `.w-full`, so it wins.\n    <div\n      className={cn(\n        'flex min-w-0 items-center gap-element-sm',\n        '[&>*:not(:first-child)]:shrink-0 [&>*:not(:first-child)]:w-auto',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n"]}

package/dist/esm/components/resources/skeleton/SummaryLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryLayout.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC;;;;GAIG;AACH,oBAAY,qBAAqB;IAC/B;;;;OAIG;IACH,IAAI,SAAS;IACb;;;;;OAKG;IACH,cAAc,mBAAmB;CAClC;AAED;;;;;GAKG;AACH,oBAAY,WAAW;IACrB,kFAAkF;IAClF,KAAK,UAAU;IACf,gGAAgG;IAChG,GAAG,QAAQ;CACZ;AAQD,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAwB,EACxB,SAAS,EACT,cAA2C,EAC3C,QAAQ,GACT,EAAE,kBAAkB,GAAG,SAAS,CAiChC"}
+{"version":3,"file":"SummaryLayout.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC;;;;GAIG;AACH,oBAAY,qBAAqB;IAC/B;;;;OAIG;IACH,IAAI,SAAS;IACb;;;;;OAKG;IACH,cAAc,mBAAmB;CAClC;AAED;;;;;GAKG;AACH,oBAAY,WAAW;IACrB,kFAAkF;IAClF,KAAK,UAAU;IACf,gGAAgG;IAChG,GAAG,QAAQ;CACZ;AAQD,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAwB,EACxB,SAAS,EACT,cAA2C,EAC3C,QAAQ,GACT,EAAE,kBAAkB,GAAG,SAAS,CAiChC"}

package/dist/esm/components/resources/skeleton/SummaryLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryLayout.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAcX;AAdD,WAAY,qBAAqB;IAC/B;;;;OAIG;IACH,sCAAa,CAAA;IACb;;;;;OAKG;IACH,0DAAiC,CAAA;AACnC,CAAC,EAdW,qBAAqB,KAArB,qBAAqB,QAchC;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,kFAAkF;IAClF,8BAAe,CAAA;IACf,gGAAgG;IAChG,0BAAW,CAAA;AACb,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,2FAA2F;AAC3F,MAAM,oBAAoB,GAAgC;IACxD,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,mCAAmC;IACxD,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,4DAA4D;CAChF,CAAC;AAgBF;;;;;;;;;;;;GAYG;AACH,SAAS,yBAAyB,CAAC,QAAmB;IACpD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACnC,IAAI,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,KAAK,GAAG,IAAI,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAI,KAAK,CAAC,KAA8C,EAAE,QAAQ,CAAC;QAC/E,IAAI,MAAM,KAAK,SAAS,IAAI,yBAAyB,CAAC,MAAM,CAAC;YAAE,KAAK,GAAG,IAAI,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,GAAG,WAAW,CAAC,KAAK,EACxB,SAAS,EACT,cAAc,GAAG,qBAAqB,CAAC,IAAI,EAC3C,QAAQ,GACW;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,SAAS,GAAG,cAAc,KAAK,qBAAqB,CAAC,IAAI;WAC1D,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAE1C,OAAO,CACL,KAAC,kBAAkB,IAAC,UAAU,EAAC,EAAE,YAC/B,eAAK,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,aACtD,SAAS,IAAI,KAAC,YAAY,KAAG,EAC7B,QAAQ,IACL,GACa,CACtB,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { Children, isValidElement } from 'react';\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { FieldScopeProvider } from './FieldScopeContext';\nimport { SummaryTitle } from './SummaryTitle';\n\n/**\n * Where the primary title (`<SummaryTitle />`) is placed within a summary\n * template. The placement decision lives HERE, in the template markup that\n * governs it — not in a parallel `layout.*` config field.\n */\nexport enum SummaryTitlePlacement {\n  /**\n   * Framework places the title automatically at the top of the template, above\n   * the authored children. The zero-boilerplate, title-above-body default —\n   * matches the classic list/card summary look.\n   */\n  AUTO = 'auto',\n  /**\n   * The author owns title placement: `SummaryLayout` renders only its children,\n   * and the author drops `<SummaryTitle />` wherever it belongs (e.g. inside a\n   * `<SummaryHeader>` beside a status badge). Required whenever the title must\n   * share a line with other content.\n   */\n  TEMPLATE_OWNED = 'template-owned',\n}\n\n/**\n * How a summary's own children are arranged.\n *\n * A behavior, not a style: the caller says which of the two summaries this is, and the classes each\n * resolves to stay here where a theme can reach them.\n */\nexport enum SummaryFlow {\n  /** Title above a short body — the ordinary card, list-row and popover summary. */\n  STACK = 'stack',\n  /** One wrapping line of values — for a summary that IS its meta row, with no title above it. */\n  ROW = 'row',\n}\n\n/** The geometry each flow resolves to. Tokens, not raw steps: `gap-element` IS `gap-2`. */\nconst SUMMARY_FLOW_CLASSES: Record<SummaryFlow, string> = {\n  [SummaryFlow.STACK]: 'flex flex-col gap-element text-sm',\n  [SummaryFlow.ROW]: 'flex flex-wrap items-center gap-x-group gap-y-item text-sm',\n};\n\nexport interface SummaryLayoutProps {\n  /** How the children are arranged. Defaults to {@link SummaryFlow.STACK}. */\n  flow?: SummaryFlow;\n  /** Additional CSS classes for the root container. */\n  className?: string;\n  /**\n   * Title placement. Defaults to {@link SummaryTitlePlacement.AUTO} (title\n   * rendered at the top). Switch to `TEMPLATE_OWNED` to place `<SummaryTitle />`\n   * yourself within the flow.\n   */\n  titlePlacement?: SummaryTitlePlacement;\n  children?: ReactNode;\n}\n\n/**\n * Does this template place its OWN title?\n *\n * Walks the statically-composed children for a `<SummaryTitle>` element, at any depth — the\n * documented inline-title shape nests it inside `<SummaryHeader>`, so a shallow check would miss\n * exactly the arrangement `TEMPLATE_OWNED` exists for.\n *\n * RESIDUAL, stated rather than hidden: a title rendered by a nested COMPONENT of the author's own\n * (rather than as JSX in the template) is invisible here, and that template would still double its\n * title. Every summary template in the repository composes its children inline, so the population\n * this cannot see is currently empty; a `React.Children` walk is the honest limit of what a parent\n * can know before its children render.\n */\nfunction templatePlacesItsOwnTitle(children: ReactNode): boolean {\n  let found = false;\n  Children.forEach(children, (child) => {\n    if (found || !isValidElement(child)) return;\n    if (child.type === SummaryTitle) {\n      found = true;\n      return;\n    }\n    const nested = (child.props as { children?: ReactNode } | undefined)?.children;\n    if (nested !== undefined && templatePlacesItsOwnTitle(nested)) found = true;\n  });\n  return found;\n}\n\n/**\n * Root wrapper for summary layout templates (cards, list items, FK references).\n *\n * Owns TITLE PLACEMENT for the template: under `AUTO` (default) it renders\n * `<SummaryTitle />` at the top, then the children body — so an author who just\n * wants \"title above a couple of fields\" writes nothing about the title. Under\n * `TEMPLATE_OWNED` it renders only the children, and the author composes\n * `<SummaryTitle />` into the flow (see {@link SummaryHeader}).\n *\n * The title resolves its text from `SummaryContext` (provided by\n * `ResourceSummaryDisplayer`); on body-only surfaces with no title (inline\n * FK-field references) `<SummaryTitle />` renders nothing, so `AUTO` shows no\n * empty title slot.\n *\n * ## It owns its own root chrome, and the FLOW is declared rather than drawn\n *\n * The geometry used to be passed in by every caller, and enumerating those callers is what settled\n * the shape of this prop. Across the engine's own resource presets there are exactly two summaries:\n *\n * - **39 stacked** — `className=\"flex flex-col gap-2 text-sm\"` (22) or a bare `text-sm` (4), plus\n *   the workbench's own; a title with a short body beneath it.\n * - **13 in a single wrapping row** — `className=\"flex flex-wrap items-center gap-x-3 gap-y-1\n *   text-sm\"`; a summary that IS its meta line, with no title above it.\n *\n * So the honest default is not one geometry but a CHOICE of two, and shipping only the stack would\n * have been actively wrong: `flex-wrap` and `flex-col` are different conflict groups, so a caller\n * passing the row geometry over a `flex-col` default gets a wrapping COLUMN — thirteen surfaces\n * silently rearranged. Naming the two lets a caller say which one it is and lets the theme own what\n * each looks like.\n *\n * `SummaryFlow.ROW` is deliberately the same geometry as {@link SummaryMeta}: a summary that is only\n * a meta line and a meta line inside a stacked summary are the same thing at different levels, and\n * they should not be able to drift apart.\n *\n * Provides a root `FieldScopeContext` with empty prefix.\n *\n * @example\n * ```tsx\n * // AUTO — title rendered above the body automatically:\n * <SummaryLayout>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n *\n * // TEMPLATE_OWNED — badge on the same line as the title:\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n *   <SummaryHeader>\n *     <SummaryTitle />\n *     <DisplayField name=\"status\" hideLabel />\n *   </SummaryHeader>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * ```\n */\nexport function SummaryLayout({\n  flow = SummaryFlow.STACK,\n  className,\n  titlePlacement = SummaryTitlePlacement.AUTO,\n  children,\n}: SummaryLayoutProps): ReactNode {\n  /*\n   * AUTO means \"the framework places the title\". A template that places one ITSELF has already\n   * discharged that, whatever it declared — so placing a second is not a stricter reading of the\n   * contract, it is the contract contradicting itself on screen.\n   *\n   * Measured 2026-09-20 across every summary template in `engine/presets-components`, `platform/`\n   * and `examples/`: of 72 `<SummaryLayout>` blocks, **20 mount their own `<SummaryTitle>` while\n   * leaving `titlePlacement` at AUTO** — organizations, billing, identity, security, application and\n   * a Wonder app's pipeline stage. Every one of them rendered two titles. The audit trail's is the\n   * clearest to read, showing `eventType — <ISO timestamp>` and then `eventType` again on the line\n   * below; `pipeline-stage.ui-behavior.tsx` is the purest, mounting the LABEL form under AUTO so the\n   * same string printed twice verbatim.\n   *\n   * Twenty of seventy-two is not twenty authoring slips. It is a default that asks to be\n   * countermanded by a declaration nobody has a reason to remember, and the framework is the only\n   * party that can see both halves — so it is the one that should reconcile them.\n   *\n   * The author's title WINS, deliberately. `<SummaryTitle name=\"x\" />` is a statement about what the\n   * title of this card IS; the framework's automatic one is a default standing in for the absence of\n   * such a statement. When both are present, only one of them was chosen.\n   */\n  const autoTitle = titlePlacement === SummaryTitlePlacement.AUTO\n    && !templatePlacesItsOwnTitle(children);\n\n  return (\n    <FieldScopeProvider pathPrefix=\"\">\n      <div className={cn(SUMMARY_FLOW_CLASSES[flow], className)}>\n        {autoTitle && <SummaryTitle />}\n        {children}\n      </div>\n    </FieldScopeProvider>\n  );\n}\n"]}
+{"version":3,"file":"SummaryLayout.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAcX;AAdD,WAAY,qBAAqB;IAC/B;;;;OAIG;IACH,sCAAa,CAAA;IACb;;;;;OAKG;IACH,0DAAiC,CAAA;AACnC,CAAC,EAdW,qBAAqB,KAArB,qBAAqB,QAchC;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,kFAAkF;IAClF,8BAAe,CAAA;IACf,gGAAgG;IAChG,0BAAW,CAAA;AACb,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,2FAA2F;AAC3F,MAAM,oBAAoB,GAAgC;IACxD,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,mCAAmC;IACxD,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,4DAA4D;CAChF,CAAC;AAgBF;;;;;;;;;;;;GAYG;AACH,SAAS,yBAAyB,CAAC,QAAmB;IACpD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACnC,IAAI,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,KAAK,GAAG,IAAI,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAI,KAAK,CAAC,KAA8C,EAAE,QAAQ,CAAC;QAC/E,IAAI,MAAM,KAAK,SAAS,IAAI,yBAAyB,CAAC,MAAM,CAAC;YAAE,KAAK,GAAG,IAAI,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,GAAG,WAAW,CAAC,KAAK,EACxB,SAAS,EACT,cAAc,GAAG,qBAAqB,CAAC,IAAI,EAC3C,QAAQ,GACW;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,SAAS,GAAG,cAAc,KAAK,qBAAqB,CAAC,IAAI;WAC1D,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAE1C,OAAO,CACL,KAAC,kBAAkB,IAAC,UAAU,EAAC,EAAE,YAC/B,eAAK,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,aACtD,SAAS,IAAI,KAAC,YAAY,KAAG,EAC7B,QAAQ,IACL,GACa,CACtB,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { Children, isValidElement } from 'react';\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { FieldScopeProvider } from './FieldScopeContext';\nimport { SummaryTitle } from './SummaryTitle';\n\n/**\n * Where the primary title (`<SummaryTitle />`) is placed within a summary\n * template. The placement decision lives HERE, in the template markup that\n * governs it — not in a parallel `layout.*` config field.\n */\nexport enum SummaryTitlePlacement {\n  /**\n   * Framework places the title automatically at the top of the template, above\n   * the authored children. The zero-boilerplate, title-above-body default —\n   * matches the classic list/card summary look.\n   */\n  AUTO = 'auto',\n  /**\n   * The author owns title placement: `SummaryLayout` renders only its children,\n   * and the author drops `<SummaryTitle />` wherever it belongs (e.g. inside a\n   * `<SummaryHeader>` beside a status badge). Required whenever the title must\n   * share a line with other content.\n   */\n  TEMPLATE_OWNED = 'template-owned',\n}\n\n/**\n * How a summary's own children are arranged.\n *\n * A behavior, not a style: the caller says which of the two summaries this is, and the classes each\n * resolves to stay here where a theme can reach them.\n */\nexport enum SummaryFlow {\n  /** Title above a short body — the ordinary card, list-row and popover summary. */\n  STACK = 'stack',\n  /** One wrapping line of values — for a summary that IS its meta row, with no title above it. */\n  ROW = 'row',\n}\n\n/** The geometry each flow resolves to. Tokens, not raw steps: `gap-element` IS `gap-2`. */\nconst SUMMARY_FLOW_CLASSES: Record<SummaryFlow, string> = {\n  [SummaryFlow.STACK]: 'flex flex-col gap-element text-sm',\n  [SummaryFlow.ROW]: 'flex flex-wrap items-center gap-x-group gap-y-item text-sm',\n};\n\nexport interface SummaryLayoutProps {\n  /** How the children are arranged. Defaults to {@link SummaryFlow.STACK}. */\n  flow?: SummaryFlow;\n  /** Additional CSS classes for the root container. */\n  className?: string;\n  /**\n   * Title placement. Defaults to {@link SummaryTitlePlacement.AUTO} (title\n   * rendered at the top). Switch to `TEMPLATE_OWNED` to place `<SummaryTitle />`\n   * yourself within the flow.\n   */\n  titlePlacement?: SummaryTitlePlacement;\n  children?: ReactNode;\n}\n\n/**\n * Does this template place its OWN title?\n *\n * Walks the statically-composed children for a `<SummaryTitle>` element, at any depth — the\n * documented inline-title shape nests it inside `<SummaryHeader>`, so a shallow check would miss\n * exactly the arrangement `TEMPLATE_OWNED` exists for.\n *\n * RESIDUAL, stated rather than hidden: a title rendered by a nested COMPONENT of the author's own\n * (rather than as JSX in the template) is invisible here, and that template would still double its\n * title. Every summary template in the repository composes its children inline, so the population\n * this cannot see is currently empty; a `React.Children` walk is the honest limit of what a parent\n * can know before its children render.\n */\nfunction templatePlacesItsOwnTitle(children: ReactNode): boolean {\n  let found = false;\n  Children.forEach(children, (child) => {\n    if (found || !isValidElement(child)) return;\n    if (child.type === SummaryTitle) {\n      found = true;\n      return;\n    }\n    const nested = (child.props as { children?: ReactNode } | undefined)?.children;\n    if (nested !== undefined && templatePlacesItsOwnTitle(nested)) found = true;\n  });\n  return found;\n}\n\n/**\n * Root wrapper for summary layout templates (cards, list items, FK references).\n *\n * Owns TITLE PLACEMENT for the template: under `AUTO` (default) it renders\n * `<SummaryTitle />` at the top, then the children body — so an author who just\n * wants \"title above a couple of fields\" writes nothing about the title. Under\n * `TEMPLATE_OWNED` it renders only the children, and the author composes\n * `<SummaryTitle />` into the flow (see {@link SummaryHeader}).\n *\n * The title resolves its text from `SummaryContext` (provided by\n * `ResourceSummaryDisplayer`); on body-only surfaces with no title (inline\n * FK-field references) `<SummaryTitle />` renders nothing, so `AUTO` shows no\n * empty title slot.\n *\n * ## It owns its own root chrome, and the FLOW is declared rather than drawn\n *\n * The geometry used to be passed in by every caller, and enumerating those callers is what settled\n * the shape of this prop. Across the engine's own resource presets there are exactly two summaries:\n *\n * - **39 stacked** — `className=\"flex flex-col gap-2 text-sm\"` (22) or a bare `text-sm` (4), plus\n *   the workbench's own; a title with a short body beneath it.\n * - **13 in a single wrapping row** — `className=\"flex flex-wrap items-center gap-x-3 gap-y-1\n *   text-sm\"`; a summary that IS its meta line, with no title above it.\n *\n * So the honest default is not one geometry but a CHOICE of two, and shipping only the stack would\n * have been actively wrong: `flex-wrap` and `flex-col` are different conflict groups, so a caller\n * passing the row geometry over a `flex-col` default gets a wrapping COLUMN — thirteen surfaces\n * silently rearranged. Naming the two lets a caller say which one it is and lets the theme own what\n * each looks like.\n *\n * `SummaryFlow.ROW` is deliberately the same geometry as {@link SummaryMeta}: a summary that is only\n * a meta line and a meta line inside a stacked summary are the same thing at different levels, and\n * they should not be able to drift apart.\n *\n * Provides a root `FieldScopeContext` with empty prefix.\n *\n * @example\n * ```tsx\n * // AUTO — title rendered above the body automatically:\n * <SummaryLayout>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n *\n * // TEMPLATE_OWNED — badge on the same line as the title:\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n *   <SummaryHeader>\n *     <SummaryTitle />\n *     <DisplayField name=\"status\" hideLabel />\n *   </SummaryHeader>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * ```\n */\nexport function SummaryLayout({\n  flow = SummaryFlow.STACK,\n  className,\n  titlePlacement = SummaryTitlePlacement.AUTO,\n  children,\n}: SummaryLayoutProps): ReactNode {\n  /*\n   * AUTO means \"the framework places the title\". A template that places one ITSELF has already\n   * discharged that, whatever it declared — so placing a second is not a stricter reading of the\n   * contract, it is the contract contradicting itself on screen.\n   *\n   * Measured 2026-09-20 across every summary template in `engine/presets-components`, `platform/`\n   * and `examples/`: of 72 `<SummaryLayout>` blocks, **20 mount their own `<SummaryTitle>` while\n   * leaving `titlePlacement` at AUTO** — organizations, billing, identity, security, application and\n   * a Wonder app's pipeline stage. Every one of them rendered two titles. The audit trail's is the\n   * clearest to read, showing `eventType — <ISO timestamp>` and then `eventType` again on the line\n   * below; `pipeline-stage.ui-behavior.tsx` is the purest, mounting the LABEL form under AUTO so the\n   * same string printed twice verbatim.\n   *\n   * Twenty of seventy-two is not twenty authoring slips. It is a default that asks to be\n   * countermanded by a declaration nobody has a reason to remember, and the framework is the only\n   * party that can see both halves — so it is the one that should reconcile them.\n   *\n   * The author's title WINS, deliberately. `<SummaryTitle name=\"x\" />` is a statement about what the\n   * title of this card IS; the framework's automatic one is a default standing in for the absence of\n   * such a statement. When both are present, only one of them was chosen.\n   */\n  const autoTitle = titlePlacement === SummaryTitlePlacement.AUTO\n    && !templatePlacesItsOwnTitle(children);\n\n  return (\n    <FieldScopeProvider pathPrefix=\"\">\n      <div className={cn(SUMMARY_FLOW_CLASSES[flow], className)}>\n        {autoTitle && <SummaryTitle />}\n        {children}\n      </div>\n    </FieldScopeProvider>\n  );\n}\n"]}

package/dist/esm/components/resources/skeleton/SummaryMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryMeta.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryMeta.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAahF"}
+{"version":3,"file":"SummaryMeta.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryMeta.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAahF"}

package/dist/esm/components/resources/skeleton/SummaryMeta.js.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryMeta.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryMeta.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AA+Cb,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AASpD,MAAM,UAAU,WAAW,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAoB;IACnE,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CACX,4DAA4D;QAC5D,gFAAgF;QAChF,cAAc,EACd,SAAS,CACV,YAEA,QAAQ,GACL,CACP,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * SummaryMeta — the row of QUALIFYING fields beneath a summary's headline.\n *\n * A summary answers two questions in order: *which one is this* (the headline) and *what do I need\n * to know about it at a glance* (this). The second is a wrapping row of short values — a status\n * badge, a date, an owner, a count — that reads as one line on a wide card and folds on a narrow\n * one.\n *\n * ## Why this exists as a component\n *\n * It was written out by hand **34 times** across the engine's own resource presets and the\n * workbench, always as the identical literal:\n *\n *     <div className=\"flex flex-wrap items-center gap-x-3 gap-y-1\">\n *\n * Three things follow from a concept having no name. No theme can change it, because it is a string\n * in a configuration file rather than a recipe. It uses raw Tailwind spacing while the design system\n * defines the `element / item / group / field` token ladder every other surface spends. And the\n * thirty-fifth author copies whichever of the thirty-four they happened to read, so the row drifts\n * a gap at a time with nothing able to notice.\n *\n * The geometry here is that literal expressed in TOKENS — `gap-x-group` is the same 0.75rem as\n * `gap-x-3`, `gap-y-item` the same 0.25rem as `gap-y-1` — so adopting it is pixel-neutral, and\n * moving the ladder afterwards moves every meta row at once.\n *\n * ## The `w-auto` on children is not cosmetic\n *\n * A `<DisplayField>` renders a field chrome whose root is `w-full`. In a wrapping flex row that\n * makes every value claim its own line, so the row silently renders as a stack — the same defect\n * `SummaryHeader` neutralises for its accessories, and the same one `objectUI displayMode:\n * HORIZONTAL` had until it was fixed. Neutralising it here is what makes the row a row.\n *\n * @example\n * ```tsx\n * <SummaryLayout>\n *   <SummaryTitle name=\"email\" />\n *   <SummaryMeta>\n *     <DisplayField name=\"status\" />\n *     <DisplayField name=\"createdAt\" />\n *   </SummaryMeta>\n * </SummaryLayout>\n * ```\n */\n\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\nexport interface SummaryMetaProps {\n  /** Extra classes merged over the default wrapping-row geometry. */\n  className?: string;\n  /** The qualifying fields — typically `<DisplayField>`s. */\n  children?: ReactNode;\n}\n\nexport function SummaryMeta({ className, children }: SummaryMetaProps): ReactNode {\n  return (\n    <div\n      className={cn(\n        'flex min-w-0 flex-wrap items-center gap-x-group gap-y-item',\n        // See the docstring: a `w-full` field chrome turns a wrapping row into a stack.\n        '[&>*]:w-auto',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"SummaryMeta.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryMeta.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AA+Cb,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AASpD,MAAM,UAAU,WAAW,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAoB;IACnE,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CACX,4DAA4D;QAC5D,gFAAgF;QAChF,cAAc,EACd,SAAS,CACV,YAEA,QAAQ,GACL,CACP,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * SummaryMeta — the row of QUALIFYING fields beneath a summary's headline.\n *\n * A summary answers two questions in order: *which one is this* (the headline) and *what do I need\n * to know about it at a glance* (this). The second is a wrapping row of short values — a status\n * badge, a date, an owner, a count — that reads as one line on a wide card and folds on a narrow\n * one.\n *\n * ## Why this exists as a component\n *\n * It was written out by hand **34 times** across the engine's own resource presets and the\n * workbench, always as the identical literal:\n *\n *     <div className=\"flex flex-wrap items-center gap-x-3 gap-y-1\">\n *\n * Three things follow from a concept having no name. No theme can change it, because it is a string\n * in a configuration file rather than a recipe. It uses raw Tailwind spacing while the design system\n * defines the `element / item / group / field` token ladder every other surface spends. And the\n * thirty-fifth author copies whichever of the thirty-four they happened to read, so the row drifts\n * a gap at a time with nothing able to notice.\n *\n * The geometry here is that literal expressed in TOKENS — `gap-x-group` is the same 0.75rem as\n * `gap-x-3`, `gap-y-item` the same 0.25rem as `gap-y-1` — so adopting it is pixel-neutral, and\n * moving the ladder afterwards moves every meta row at once.\n *\n * ## The `w-auto` on children is not cosmetic\n *\n * A `<DisplayField>` renders a field chrome whose root is `w-full`. In a wrapping flex row that\n * makes every value claim its own line, so the row silently renders as a stack — the same defect\n * `SummaryHeader` neutralises for its accessories, and the same one `objectUI displayMode:\n * HORIZONTAL` had until it was fixed. Neutralising it here is what makes the row a row.\n *\n * @example\n * ```tsx\n * <SummaryLayout>\n *   <SummaryTitle name=\"email\" />\n *   <SummaryMeta>\n *     <DisplayField name=\"status\" />\n *     <DisplayField name=\"createdAt\" />\n *   </SummaryMeta>\n * </SummaryLayout>\n * ```\n */\n\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\nexport interface SummaryMetaProps {\n  /** Extra classes merged over the default wrapping-row geometry. */\n  className?: string;\n  /** The qualifying fields — typically `<DisplayField>`s. */\n  children?: ReactNode;\n}\n\nexport function SummaryMeta({ className, children }: SummaryMetaProps): ReactNode {\n  return (\n    <div\n      className={cn(\n        'flex min-w-0 flex-wrap items-center gap-x-group gap-y-item',\n        // See the docstring: a `w-full` field chrome turns a wrapping row into a stack.\n        '[&>*]:w-auto',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n"]}

package/dist/esm/components/resources/skeleton/SummaryTitle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryTitle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryTitle.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,2FAA2F;IAC3F,OAAO,YAAY;IACnB,mFAAmF;IACnF,KAAK,UAAU;IACf,qCAAqC;IACrC,OAAO,YAAY;IACnB,+BAA+B;IAC/B,QAAQ,aAAa;CACtB;AAUD,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,KAAiC,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,SAAS,CA4DjH"}
+{"version":3,"file":"SummaryTitle.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryTitle.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,2FAA2F;IAC3F,OAAO,YAAY;IACnB,mFAAmF;IACnF,KAAK,UAAU;IACf,qCAAqC;IACrC,OAAO,YAAY;IACnB,+BAA+B;IAC/B,QAAQ,aAAa;CACtB;AAUD,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,KAAiC,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,SAAS,CA4DjH"}

package/dist/esm/components/resources/skeleton/SummaryTitle.js.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryTitle.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryTitle.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAiDb,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,gDAAgD,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,0DAA0D,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4DAA4D,CAAC;AAEvG;;;;;GAKG;AACH,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,2FAA2F;IAC3F,wCAAmB,CAAA;IACnB,mFAAmF;IACnF,oCAAe,CAAA;IACf,qCAAqC;IACrC,wCAAmB,CAAA;IACnB,+BAA+B;IAC/B,0CAAqB,CAAA;AACvB,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B;AAED,oGAAoG;AACpG,MAAM,gBAAgB,GAAkD;IACtE,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,SAAS;IACtC,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,IAAI;IAC/B,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,IAAI;IACjC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,IAAI;CACnC,CAAC;AAgBF,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAqB;IACpG,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAC;IAC5C,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAClF;;;;OAIG;IACH,MAAM,gBAAgB,GAAG,SAAS;QAChC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IACd,gFAAgF;IAChF,+EAA+E;IAC/E,8EAA8E;IAC9E,8EAA8E;IAC9E,8CAA8C;IAC9C,IAAI,OAAO,EAAE,iBAAiB;QAAE,OAAO,CAAC,iBAAiB,CAAC,YAAY,GAAG,IAAI,CAAC;IAE9E,IAAI,IAAI,EAAE,CAAC;QACT;;;;;;;WAOG;QACH,OAAO,CACL,KAAC,eAAe,IAAC,SAAS,EAAE,gBAAgB,YAC1C,cACE,SAAS,EAAE,EAAE,CACX,gCAAgC;gBAChC,sFAAsF;gBACtF,sFAAsF;gBACtF,4EAA4E;gBAC5E,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,2BAA2B,EAChE,SAAS,CACV,YAED,KAAC,YAAY,IAAC,IAAI,EAAE,IAAI,EAAE,SAAS,SAAG,GAClC,GACU,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;IACL,oEAAoE;IACpE,2EAA2E;IAC3E,6EAA6E;IAC7E,0EAA0E;IAC1E,8EAA8E;IAC9E,yBAAyB;IACzB,KAAC,IAAI,IAAC,EAAE,EAAC,GAAG,EAAC,SAAS,EAAE,EAAE,CAAC,4CAA4C,EAAE,SAAS,CAAC,EAAE,QAAQ,kBAC1F,YAAY,GACR,CACR,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * SummaryTitle — the value that NAMES the record, as a first-class element of the summary flow.\n *\n * It answers \"which one is this\" in two ways, and which one you want depends on who computed the\n * name:\n *\n * - **No `name`** — the resource's resolved PRIMARY LABEL, read from {@link SummaryContext} (the\n *   card / list / popover host computed it with the right `t`, junction forwarding and so on). This\n *   is what `<SummaryLayout>`'s `AUTO` placement renders, so an author who wants \"title above a\n *   couple of fields\" writes nothing at all.\n * - **With `name`** — a FIELD of the record, rendered through the display pipeline. Use it when the\n *   title is a particular authored value (`email`, `oneSentence`, `statement`) rather than whatever\n *   the host resolved as the label.\n *\n * ## Why the `name` form exists\n *\n * The second form was written out by hand **18 times** across the engine's own resource presets,\n * always as the identical literal:\n *\n *     <div className=\"font-medium leading-tight\">\n *       <DisplayField name=\"email\" hideLabel />\n *     </div>\n *\n * Eighteen copies of a treatment this component already owns, sitting next to eighteen calls to\n * this component that could not express it. No theme can reach those literals, and each new author\n * copies whichever one they happened to read.\n *\n * ## Scale — declared as a ROLE, resolved by the theme\n *\n * A title that must read larger than its surroundings says WHICH TITLE IT IS, not how big. The four\n * roles below are the four levels the repository actually had, each previously written as a literal\n * step: a card title at `font-medium`, an entry headline at `text-base`, a section's at `text-lg`, a\n * document's own lead at `text-xl`. They now resolve through the theme's HEADING ladder, which the\n * eight themes each define differently — editorial runs large, trading and terminal run dense — so\n * the same declaration reads correctly in all of them and in the next one.\n *\n * The mechanism is a {@link TypographyScope} rather than a class on this element, and the reason is\n * worth keeping: font WEIGHT and LINE-HEIGHT inherit — which is why the wrapper idiom worked at all\n * — but font SIZE does not, because the formatter's `<Text>` sets its own. A class here would lose\n * to it, and mirroring one through `[&_p]:` cannot work either, since a Tailwind variant composed\n * at runtime from a theme value is never generated. The scope reaches the `<Text>` itself.\n *\n * Renders nothing when there is no title to show: the no-`name` form on a body-only surface (an\n * inline FK reference passes a `null` label), so `AUTO` shows no empty title slot.\n */\n\nimport type { ReactNode } from 'react';\nimport { TypographyVariant, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { TypographyScope } from '~wildo-frontend-lib/core/ui/TypographyScopeContext';\nimport { Text } from '~wildo-frontend-lib/components/typography/text';\nimport { DisplayField } from '~wildo-frontend-lib/components/data-display/DisplayField';\nimport { useOptionalSummaryContext } from '~wildo-frontend-lib/components/data-display/SummaryContext';\n\n/**\n * WHICH title this is — a role, never a size.\n *\n * Each maps to a step of the theme's HEADING ladder, so what a role looks like is the theme's answer\n * and the same declaration holds across all eight.\n */\nexport enum SummaryTitleScale {\n  /** The ordinary card / list-row / popover title: medium weight at the surrounding size. */\n  DEFAULT = 'default',\n  /** Names ONE ENTRY inside a collection — the ladder's smallest in-content step. */\n  ENTRY = 'entry',\n  /** Leads a SECTION of a document. */\n  SECTION = 'section',\n  /** The DOCUMENT's own lead. */\n  DOCUMENT = 'document',\n}\n\n/** Which rung of the heading ladder each role reads. `DEFAULT` takes none — it is not a heading. */\nconst SCALE_LADDER_KEY: Record<SummaryTitleScale, string | undefined> = {\n  [SummaryTitleScale.DEFAULT]: undefined,\n  [SummaryTitleScale.ENTRY]: 'h5',\n  [SummaryTitleScale.SECTION]: 'h4',\n  [SummaryTitleScale.DOCUMENT]: 'h3',\n};\n\nexport interface SummaryTitleProps {\n  /**\n   * Render THIS FIELD as the title instead of the host-resolved primary label.\n   *\n   * The field renders through the ordinary display pipeline with its label hidden — the title IS\n   * the value, and a label reading \"Email\" above an email address is a row that says nothing.\n   */\n  name?: string;\n  /** Which title this is. Defaults to {@link SummaryTitleScale.DEFAULT}. */\n  scale?: SummaryTitleScale;\n  /** Extra classes merged over the default `font-medium text-foreground` title styling. */\n  className?: string;\n}\n\nexport function SummaryTitle({ name, scale = SummaryTitleScale.DEFAULT, className }: SummaryTitleProps): ReactNode {\n  const summary = useOptionalSummaryContext();\n  const { getRecipe } = useUI();\n  const ladderKey = SCALE_LADDER_KEY[scale];\n  const headingRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.HEADING);\n  /*\n   * Resolved HERE, where the theme's recipe is in hand, and handed to the scope as classes. The\n   * scope stays a transport — a second place that decided type scale would be the thing this\n   * component exists to remove.\n   */\n  const headingClassName = ladderKey\n    ? cn(headingRecipe.base, headingRecipe.sizes?.[ladderKey])\n    : undefined;\n  // Register with the displayer's missing-title diagnostic BEFORE the empty-label\n  // early return: mounting `<SummaryTitle />` discharges the template's contract\n  // even when the current record resolves no label (that is data-driven, not an\n  // authoring bug). Render-time ref mutation on purpose — the flag is read only\n  // after render and must not schedule updates.\n  if (summary?.titleMountTracker) summary.titleMountTracker.titleMounted = true;\n\n  if (name) {\n    /*\n     * The FIELD form. `leading-tight` joins the weight because both INHERIT — that is the whole\n     * reason the eighteen hand-written wrappers worked, and the reason this replacement is exact.\n     *\n     * No `truncate` here, unlike the label form below: a field's own display params decide whether\n     * its value truncates (`StringDisplayMode.TRUNCATE`), and forcing it from the outside would\n     * overrule an author who chose to wrap.\n     */\n    return (\n      <TypographyScope className={headingClassName}>\n        <div\n          className={cn(\n            'min-w-0 flex-1 text-foreground',\n            // At DEFAULT there is no heading recipe, so the weight has to come from here — and it\n            // reaches the value because weight INHERITS. At the heading scales the recipe carries\n            // its own weight and tracking, and applies them to the text element itself.\n            headingClassName ? 'leading-tight' : 'font-medium leading-tight',\n            className,\n          )}\n        >\n          <DisplayField name={name} hideLabel />\n        </div>\n      </TypographyScope>\n    );\n  }\n\n  const primaryLabel = summary?.primaryLabel;\n  if (!primaryLabel) return null;\n  return (\n    // `flex-1 min-w-0` lives HERE (not via a `:first-child` selector on\n    // SummaryHeader): when the title renders inside a flex header it grows and\n    // truncates; when it renders null (no label / body-only FK surface) there is\n    // simply no growing element, so a lone accessory keeps its intrinsic size\n    // instead of inheriting the grow. In a block context (SummaryLayout AUTO) the\n    // flex utility is inert.\n    <Text as=\"p\" className={cn('min-w-0 flex-1 font-medium text-foreground', className)} truncate>\n      {primaryLabel}\n    </Text>\n  );\n}\n"]}
+{"version":3,"file":"SummaryTitle.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryTitle.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAiDb,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,gDAAgD,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,0DAA0D,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4DAA4D,CAAC;AAEvG;;;;;GAKG;AACH,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,2FAA2F;IAC3F,wCAAmB,CAAA;IACnB,mFAAmF;IACnF,oCAAe,CAAA;IACf,qCAAqC;IACrC,wCAAmB,CAAA;IACnB,+BAA+B;IAC/B,0CAAqB,CAAA;AACvB,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B;AAED,oGAAoG;AACpG,MAAM,gBAAgB,GAAkD;IACtE,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,SAAS;IACtC,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,IAAI;IAC/B,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,IAAI;IACjC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,IAAI;CACnC,CAAC;AAgBF,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAqB;IACpG,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAC;IAC5C,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAClF;;;;OAIG;IACH,MAAM,gBAAgB,GAAG,SAAS;QAChC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IACd,gFAAgF;IAChF,+EAA+E;IAC/E,8EAA8E;IAC9E,8EAA8E;IAC9E,8CAA8C;IAC9C,IAAI,OAAO,EAAE,iBAAiB;QAAE,OAAO,CAAC,iBAAiB,CAAC,YAAY,GAAG,IAAI,CAAC;IAE9E,IAAI,IAAI,EAAE,CAAC;QACT;;;;;;;WAOG;QACH,OAAO,CACL,KAAC,eAAe,IAAC,SAAS,EAAE,gBAAgB,YAC1C,cACE,SAAS,EAAE,EAAE,CACX,gCAAgC;gBAChC,sFAAsF;gBACtF,sFAAsF;gBACtF,4EAA4E;gBAC5E,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,2BAA2B,EAChE,SAAS,CACV,YAED,KAAC,YAAY,IAAC,IAAI,EAAE,IAAI,EAAE,SAAS,SAAG,GAClC,GACU,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;IACL,oEAAoE;IACpE,2EAA2E;IAC3E,6EAA6E;IAC7E,0EAA0E;IAC1E,8EAA8E;IAC9E,yBAAyB;IACzB,KAAC,IAAI,IAAC,EAAE,EAAC,GAAG,EAAC,SAAS,EAAE,EAAE,CAAC,4CAA4C,EAAE,SAAS,CAAC,EAAE,QAAQ,kBAC1F,YAAY,GACR,CACR,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * SummaryTitle — the value that NAMES the record, as a first-class element of the summary flow.\n *\n * It answers \"which one is this\" in two ways, and which one you want depends on who computed the\n * name:\n *\n * - **No `name`** — the resource's resolved PRIMARY LABEL, read from {@link SummaryContext} (the\n *   card / list / popover host computed it with the right `t`, junction forwarding and so on). This\n *   is what `<SummaryLayout>`'s `AUTO` placement renders, so an author who wants \"title above a\n *   couple of fields\" writes nothing at all.\n * - **With `name`** — a FIELD of the record, rendered through the display pipeline. Use it when the\n *   title is a particular authored value (`email`, `oneSentence`, `statement`) rather than whatever\n *   the host resolved as the label.\n *\n * ## Why the `name` form exists\n *\n * The second form was written out by hand **18 times** across the engine's own resource presets,\n * always as the identical literal:\n *\n *     <div className=\"font-medium leading-tight\">\n *       <DisplayField name=\"email\" hideLabel />\n *     </div>\n *\n * Eighteen copies of a treatment this component already owns, sitting next to eighteen calls to\n * this component that could not express it. No theme can reach those literals, and each new author\n * copies whichever one they happened to read.\n *\n * ## Scale — declared as a ROLE, resolved by the theme\n *\n * A title that must read larger than its surroundings says WHICH TITLE IT IS, not how big. The four\n * roles below are the four levels the repository actually had, each previously written as a literal\n * step: a card title at `font-medium`, an entry headline at `text-base`, a section's at `text-lg`, a\n * document's own lead at `text-xl`. They now resolve through the theme's HEADING ladder, which the\n * eight themes each define differently — editorial runs large, trading and terminal run dense — so\n * the same declaration reads correctly in all of them and in the next one.\n *\n * The mechanism is a {@link TypographyScope} rather than a class on this element, and the reason is\n * worth keeping: font WEIGHT and LINE-HEIGHT inherit — which is why the wrapper idiom worked at all\n * — but font SIZE does not, because the formatter's `<Text>` sets its own. A class here would lose\n * to it, and mirroring one through `[&_p]:` cannot work either, since a Tailwind variant composed\n * at runtime from a theme value is never generated. The scope reaches the `<Text>` itself.\n *\n * Renders nothing when there is no title to show: the no-`name` form on a body-only surface (an\n * inline FK reference passes a `null` label), so `AUTO` shows no empty title slot.\n */\n\nimport type { ReactNode } from 'react';\nimport { TypographyVariant, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { TypographyScope } from '~wildo-frontend-lib/core/ui/TypographyScopeContext';\nimport { Text } from '~wildo-frontend-lib/components/typography/text';\nimport { DisplayField } from '~wildo-frontend-lib/components/data-display/DisplayField';\nimport { useOptionalSummaryContext } from '~wildo-frontend-lib/components/data-display/SummaryContext';\n\n/**\n * WHICH title this is — a role, never a size.\n *\n * Each maps to a step of the theme's HEADING ladder, so what a role looks like is the theme's answer\n * and the same declaration holds across all eight.\n */\nexport enum SummaryTitleScale {\n  /** The ordinary card / list-row / popover title: medium weight at the surrounding size. */\n  DEFAULT = 'default',\n  /** Names ONE ENTRY inside a collection — the ladder's smallest in-content step. */\n  ENTRY = 'entry',\n  /** Leads a SECTION of a document. */\n  SECTION = 'section',\n  /** The DOCUMENT's own lead. */\n  DOCUMENT = 'document',\n}\n\n/** Which rung of the heading ladder each role reads. `DEFAULT` takes none — it is not a heading. */\nconst SCALE_LADDER_KEY: Record<SummaryTitleScale, string | undefined> = {\n  [SummaryTitleScale.DEFAULT]: undefined,\n  [SummaryTitleScale.ENTRY]: 'h5',\n  [SummaryTitleScale.SECTION]: 'h4',\n  [SummaryTitleScale.DOCUMENT]: 'h3',\n};\n\nexport interface SummaryTitleProps {\n  /**\n   * Render THIS FIELD as the title instead of the host-resolved primary label.\n   *\n   * The field renders through the ordinary display pipeline with its label hidden — the title IS\n   * the value, and a label reading \"Email\" above an email address is a row that says nothing.\n   */\n  name?: string;\n  /** Which title this is. Defaults to {@link SummaryTitleScale.DEFAULT}. */\n  scale?: SummaryTitleScale;\n  /** Extra classes merged over the default `font-medium text-foreground` title styling. */\n  className?: string;\n}\n\nexport function SummaryTitle({ name, scale = SummaryTitleScale.DEFAULT, className }: SummaryTitleProps): ReactNode {\n  const summary = useOptionalSummaryContext();\n  const { getRecipe } = useUI();\n  const ladderKey = SCALE_LADDER_KEY[scale];\n  const headingRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.HEADING);\n  /*\n   * Resolved HERE, where the theme's recipe is in hand, and handed to the scope as classes. The\n   * scope stays a transport — a second place that decided type scale would be the thing this\n   * component exists to remove.\n   */\n  const headingClassName = ladderKey\n    ? cn(headingRecipe.base, headingRecipe.sizes?.[ladderKey])\n    : undefined;\n  // Register with the displayer's missing-title diagnostic BEFORE the empty-label\n  // early return: mounting `<SummaryTitle />` discharges the template's contract\n  // even when the current record resolves no label (that is data-driven, not an\n  // authoring bug). Render-time ref mutation on purpose — the flag is read only\n  // after render and must not schedule updates.\n  if (summary?.titleMountTracker) summary.titleMountTracker.titleMounted = true;\n\n  if (name) {\n    /*\n     * The FIELD form. `leading-tight` joins the weight because both INHERIT — that is the whole\n     * reason the eighteen hand-written wrappers worked, and the reason this replacement is exact.\n     *\n     * No `truncate` here, unlike the label form below: a field's own display params decide whether\n     * its value truncates (`StringDisplayMode.TRUNCATE`), and forcing it from the outside would\n     * overrule an author who chose to wrap.\n     */\n    return (\n      <TypographyScope className={headingClassName}>\n        <div\n          className={cn(\n            'min-w-0 flex-1 text-foreground',\n            // At DEFAULT there is no heading recipe, so the weight has to come from here — and it\n            // reaches the value because weight INHERITS. At the heading scales the recipe carries\n            // its own weight and tracking, and applies them to the text element itself.\n            headingClassName ? 'leading-tight' : 'font-medium leading-tight',\n            className,\n          )}\n        >\n          <DisplayField name={name} hideLabel />\n        </div>\n      </TypographyScope>\n    );\n  }\n\n  const primaryLabel = summary?.primaryLabel;\n  if (!primaryLabel) return null;\n  return (\n    // `flex-1 min-w-0` lives HERE (not via a `:first-child` selector on\n    // SummaryHeader): when the title renders inside a flex header it grows and\n    // truncates; when it renders null (no label / body-only FK surface) there is\n    // simply no growing element, so a lone accessory keeps its intrinsic size\n    // instead of inheriting the grow. In a block context (SummaryLayout AUTO) the\n    // flex utility is inert.\n    <Text as=\"p\" className={cn('min-w-0 flex-1 font-medium text-foreground', className)} truncate>\n      {primaryLabel}\n    </Text>\n  );\n}\n"]}