@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

package/dist/esm/core/ui/SurfacePolicyContext.js

@@ -0,0 +1,252 @@
+import { createContext, useContext } from 'react';
+import { FRAMEWORK_DEFAULT_SURFACE_POLICIES, SurfaceVariant, } from '@wildo-ai/presets-components-models';
+export const SurfacePolicyContext = createContext(null);
+const SURFACE_POLICY_FAMILIES = [
+    'containment',
+    'nesting',
+    'content',
+    'autoRender',
+    'interactiveState',
+    'a11y',
+    'geometry',
+    'stacking',
+    'skeleton',
+    'composition',
+];
+const POLICY_VALUE_INHERIT_SLOTS = new Set([
+    'content.textTruncation',
+    'content.wrapStrategy',
+    'content.numericAlignment',
+    'content.overlongTokenStrategy',
+    'autoRender.autoFieldChrome',
+    'autoRender.autoFieldDensity',
+    'autoRender.autoErrorPlacement',
+    'interactiveState.loadingDisplay',
+    'interactiveState.errorBoundary',
+    'geometry.actionAlignment',
+    'skeleton.skeletonTemplate',
+    'skeleton.skeletonDensity',
+    'composition.selectionColumnAware',
+]);
+const warnedMissingParentInherit = new Set();
+const erroredMissingFrameworkReset = new Set();
+const objectIds = new WeakMap();
+const mergeCache = new Map();
+const MAX_MERGE_CACHE_ENTRIES = 500;
+let nextObjectId = 1;
+function getInputId(value) {
+    if (!value) {
+        return 'u';
+    }
+    let id = objectIds.get(value);
+    if (!id) {
+        id = nextObjectId;
+        nextObjectId += 1;
+        objectIds.set(value, id);
+    }
+    return `o${id}`;
+}
+function getMergeCacheKey(variant, frameworkDefault, themeDefault, appConfigOverride, callSiteOverride, parentPolicy) {
+    return [
+        variant,
+        getInputId(frameworkDefault),
+        getInputId(themeDefault),
+        getInputId(appConfigOverride),
+        getInputId(callSiteOverride),
+        getInputId(parentPolicy),
+    ].join('|');
+}
+function mergePolicyLayer(base, override) {
+    if (!override) {
+        return base;
+    }
+    const merged = { ...base };
+    for (const family of SURFACE_POLICY_FAMILIES) {
+        const familyOverride = override[family];
+        if (familyOverride) {
+            merged[family] = {
+                ...base[family],
+                ...familyOverride,
+                ...(family === 'containment' && 'slotGap' in familyOverride
+                    ? mergeContainmentSlotGap(base, familyOverride)
+                    : {}),
+            };
+        }
+    }
+    return merged;
+}
+function mergeContainmentSlotGap(base, familyOverride) {
+    if (familyOverride.slotGap === undefined) {
+        return { slotGap: undefined };
+    }
+    return {
+        slotGap: {
+            ...base.containment?.slotGap,
+            ...familyOverride.slotGap,
+        },
+    };
+}
+function shouldResolvePolicyValueInherit(family, slot) {
+    return POLICY_VALUE_INHERIT_SLOTS.has(`${family}.${slot}`);
+}
+function resolveResetAndInheritValues(policy, frameworkDefault, options) {
+    const resolved = { ...policy };
+    for (const family of SURFACE_POLICY_FAMILIES) {
+        const familyPolicy = policy[family];
+        if (!familyPolicy) {
+            continue;
+        }
+        const familyResolved = { ...familyPolicy };
+        const frameworkFamily = frameworkDefault[family];
+        const parentFamily = options.parentPolicy?.[family];
+        for (const [slot, value] of Object.entries(familyPolicy)) {
+            if (family === 'containment' && slot === 'slotGap' && value && typeof value === 'object') {
+                const frameworkSlotGap = frameworkDefault.containment?.slotGap;
+                const resolvedSlotGap = { ...value };
+                for (const [slotName, slotValue] of Object.entries(resolvedSlotGap)) {
+                    if (slotValue !== 'reset') {
+                        continue;
+                    }
+                    const slotGapKey = slotName;
+                    const frameworkValue = frameworkSlotGap?.[slotGapKey];
+                    resolvedSlotGap[slotName] = frameworkValue;
+                    if (frameworkValue === undefined) {
+                        const key = `${options.variant}.${family}.${slot}.${slotName}`;
+                        if (!erroredMissingFrameworkReset.has(key)) {
+                            erroredMissingFrameworkReset.add(key);
+                            options.logger?.error('[SurfacePolicy] reset resolved to an undefined framework default', {
+                                variant: options.variant,
+                                family,
+                                slot: `${slot}.${slotName}`,
+                            });
+                        }
+                    }
+                }
+                familyResolved[slot] = resolvedSlotGap;
+                continue;
+            }
+            if (value === 'reset') {
+                const frameworkValue = frameworkFamily?.[slot];
+                familyResolved[slot] = frameworkValue;
+                if (frameworkValue === undefined) {
+                    const key = `${options.variant}.${family}.${slot}`;
+                    if (!erroredMissingFrameworkReset.has(key)) {
+                        erroredMissingFrameworkReset.add(key);
+                        options.logger?.error('[SurfacePolicy] reset resolved to an undefined framework default', {
+                            variant: options.variant,
+                            family,
+                            slot,
+                        });
+                    }
+                }
+                continue;
+            }
+            if (value === 'inherit' && shouldResolvePolicyValueInherit(family, slot)) {
+                const parentValue = parentFamily?.[slot];
+                if (parentValue !== undefined) {
+                    familyResolved[slot] = parentValue;
+                    continue;
+                }
+                const frameworkSlotValue = frameworkFamily?.[slot];
+                familyResolved[slot] = frameworkSlotValue;
+                // Only warn when the framework default would actually substitute a
+                // DIFFERENT concrete value than the `'inherit'` the call-site provided.
+                // If the variant's own framework default for this slot is ITSELF
+                // `'inherit'` (as is the case for root variants like SHELL and OVERLAY
+                // on `content.numericAlignment`), then the resolver's fallback simply
+                // re-emits the same `'inherit'` keyword the author asked for — CSS
+                // then handles DOM-level inheritance natively. That is the framework's
+                // intentional design for root-level variants which by definition have
+                // no parent Surface, and is NOT an authoring mistake to flag.
+                //
+                // The warning is reserved for the case where the framework default
+                // would substitute a concrete value — that's the case worth surfacing
+                // because the resolved policy then quietly differs from what the
+                // author wrote.
+                if (frameworkSlotValue !== 'inherit') {
+                    const key = `${options.variant}.${family}.${slot}`;
+                    if (!warnedMissingParentInherit.has(key)) {
+                        warnedMissingParentInherit.add(key);
+                        options.logger?.warn('[SurfacePolicy] inherit had no parent surface; falling back to the framework default', {
+                            variant: options.variant,
+                            family,
+                            slot,
+                        });
+                    }
+                }
+            }
+        }
+        resolved[family] = familyResolved;
+    }
+    return resolved;
+}
+/**
+ * Merge the four Surface Policy layers into a concrete `SurfacePolicy`.
+ *
+ * Order is fixed by KD-4: framework fallback → theme recipe policy → app
+ * configuration override → call-site override. The function is memoized by
+ * shallow identity of those inputs so repeated renders with stable config
+ * objects reuse the same policy reference.
+ */
+export function mergeSurfacePolicy(frameworkDefault, themeDefault, appConfigOverride, callSiteOverride, options) {
+    const cacheKey = getMergeCacheKey(options.variant, frameworkDefault, themeDefault, appConfigOverride, callSiteOverride, options.parentPolicy);
+    const cached = mergeCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const mergedTheme = mergePolicyLayer(frameworkDefault, themeDefault);
+    const mergedApp = mergePolicyLayer(mergedTheme, appConfigOverride);
+    const mergedCallSite = mergePolicyLayer(mergedApp, callSiteOverride);
+    const resolved = resolveResetAndInheritValues(mergedCallSite, frameworkDefault, options);
+    if (mergeCache.size >= MAX_MERGE_CACHE_ENTRIES) {
+        mergeCache.clear();
+    }
+    mergeCache.set(cacheKey, resolved);
+    return resolved;
+}
+export function computeSurfacePolicyContextValue(variant, policy, parentContext, headerRegistration) {
+    const framingMode = policy.nesting?.framingMode ?? 'always';
+    const rendersOwnFrame = framingMode === 'always' || (framingMode === 'when-orphan' && !parentContext?.isInFramedAncestor);
+    const nearestFramedAncestorVariant = rendersOwnFrame
+        ? variant
+        : parentContext?.nearestFramedAncestorVariant ?? null;
+    return {
+        variant,
+        policy,
+        isInFramedAncestor: Boolean(parentContext?.isInFramedAncestor || rendersOwnFrame),
+        rendersOwnFrame,
+        nearestFramedAncestorVariant,
+        headerId: headerRegistration?.headerId,
+        registerHeaderId: headerRegistration?.registerHeaderId,
+        unregisterHeaderId: headerRegistration?.unregisterHeaderId,
+    };
+}
+export function useSurfacePolicy(hint = SurfaceVariant.BASE) {
+    return useContext(SurfacePolicyContext)?.policy ?? FRAMEWORK_DEFAULT_SURFACE_POLICIES[hint];
+}
+export function useSurfaceVariant() {
+    return useContext(SurfacePolicyContext)?.variant ?? null;
+}
+/**
+ * `true` when the current React subtree is already inside a surface that paints
+ * its own visual frame (border + shadow). Section/card chrome reads this to
+ * activate the `when-orphan` framing semantic: a framed section nested inside an
+ * already-framed ancestor (card-in-card, card-in-dialog, card-in-composite)
+ * suppresses its OWN frame to avoid "border soup", because the outer frame
+ * already delineates the region.
+ *
+ * Returns `false` at the top of the tree (no surface ancestor). The value is
+ * precomputed by each `<Surface>` provider (see
+ * {@link computeSurfacePolicyContextValue}), so this read is O(1) and never
+ * walks the ancestor chain.
+ *
+ * IMPORTANT: this signal is only reliable when every surface's
+ * `nesting.framingMode` truthfully reflects whether it paints a frame. A surface
+ * that renders FLAT but declares `framingMode: 'always'` would falsely report
+ * `true` to its descendants — so flat chrome must declare `framingMode: 'never'`
+ * and `when-orphan` chrome must paint its frame iff this hook returns `false`.
+ */
+export function useIsInFramedAncestor() {
+    return useContext(SurfacePolicyContext)?.isInFramedAncestor ?? false;
+}
+//# sourceMappingURL=SurfacePolicyContext.js.map

package/dist/esm/core/ui/SurfacePolicyContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfacePolicyContext.js","sourceRoot":"","sources":["../../../../../src/core/ui/SurfacePolicyContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EACL,kCAAkC,EAClC,cAAc,GAGf,MAAM,qCAAqC,CAAC;AAmC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAE1F,MAAM,uBAAuB,GAAmC;IAC9D,aAAa;IACb,SAAS;IACT,SAAS;IACT,YAAY;IACZ,kBAAkB;IAClB,MAAM;IACN,UAAU;IACV,UAAU;IACV,UAAU;IACV,aAAa;CACd,CAAC;AAEF,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC;IAC9D,wBAAwB;IACxB,sBAAsB;IACtB,0BAA0B;IAC1B,+BAA+B;IAC/B,4BAA4B;IAC5B,6BAA6B;IAC7B,+BAA+B;IAC/B,iCAAiC;IACjC,gCAAgC;IAChC,0BAA0B;IAC1B,2BAA2B;IAC3B,0BAA0B;IAC1B,kCAAkC;CACnC,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,IAAI,GAAG,EAAU,CAAC;AACrD,MAAM,4BAA4B,GAAG,IAAI,GAAG,EAAU,CAAC;AACvD,MAAM,SAAS,GAAG,IAAI,OAAO,EAAkB,CAAC;AAChD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;AACpD,MAAM,uBAAuB,GAAG,GAAG,CAAC;AACpC,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,SAAS,UAAU,CAAC,KAAyB;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,GAAG,YAAY,CAAC;QAClB,YAAY,IAAI,CAAC,CAAC;QAClB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,EAAE,EAAE,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAuB,EACvB,gBAA+B,EAC/B,YAAkD,EAClD,iBAAuD,EACvD,gBAAsD,EACtD,YAAuC;IAEvC,OAAO;QACL,OAAO;QACP,UAAU,CAAC,gBAAgB,CAAC;QAC5B,UAAU,CAAC,YAAY,CAAC;QACxB,UAAU,CAAC,iBAAiB,CAAC;QAC7B,UAAU,CAAC,gBAAgB,CAAC;QAC5B,UAAU,CAAC,YAAY,CAAC;KACzB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CACvB,IAAmB,EACnB,QAA8C;IAE9C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAkB,EAAE,GAAG,IAAI,EAAE,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,uBAAuB,EAAE,CAAC;QAC7C,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,GAAG;gBACf,GAAG,IAAI,CAAC,MAAM,CAAC;gBACf,GAAG,cAAc;gBACjB,GAAG,CAAC,MAAM,KAAK,aAAa,IAAI,SAAS,IAAI,cAAc;oBACzD,CAAC,CAAC,uBAAuB,CAAC,IAAI,EAAE,cAAc,CAAC;oBAC/C,CAAC,CAAC,EAAE,CAAC;aACwB,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,uBAAuB,CAC9B,IAAmB,EACnB,cAAoE;IAEpE,IAAI,cAAc,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO;YAC5B,GAAG,cAAc,CAAC,OAAO;SAC1B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CAAC,MAA2B,EAAE,IAAuB;IAC3F,OAAO,0BAA0B,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,4BAA4B,CACnC,MAAqB,EACrB,gBAA+B,EAC/B,OAAkC;IAElC,MAAM,QAAQ,GAAkB,EAAE,GAAG,MAAM,EAAE,CAAC;IAE9C,KAAK,MAAM,MAAM,IAAI,uBAAuB,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,cAAc,GAAG,EAAE,GAAG,YAAY,EAA6B,CAAC;QACtE,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAAwC,CAAC;QACxF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,MAAM,CAAwC,CAAC;QAE3F,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAuC,CAAC,EAAE,CAAC;YACpF,IAAI,MAAM,KAAK,aAAa,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACzF,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC;gBAC/D,MAAM,eAAe,GAAG,EAAE,GAAI,KAAiC,EAAE,CAAC;gBAElE,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;oBACpE,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;wBAC1B,SAAS;oBACX,CAAC;oBAED,MAAM,UAAU,GAAG,QAAmF,CAAC;oBACvG,MAAM,cAAc,GAAG,gBAAgB,EAAE,CAAC,UAAU,CAAC,CAAC;oBACtD,eAAe,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC;oBAE3C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;wBACjC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;wBAC/D,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;4BAC3C,4BAA4B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;4BACtC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,kEAAkE,EAAE;gCACxF,OAAO,EAAE,OAAO,CAAC,OAAO;gCACxB,MAAM;gCACN,IAAI,EAAE,GAAG,IAAI,IAAI,QAAQ,EAAE;6BAC5B,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,cAAc,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC;gBACvC,SAAS;YACX,CAAC;YAED,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,MAAM,cAAc,GAAG,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC/C,cAAc,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC;gBAEtC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;oBACjC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;oBACnD,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC3C,4BAA4B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBACtC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,kEAAkE,EAAE;4BACxF,OAAO,EAAE,OAAO,CAAC,OAAO;4BACxB,MAAM;4BACN,IAAI;yBACL,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBACD,SAAS;YACX,CAAC;YAED,IAAI,KAAK,KAAK,SAAS,IAAI,+BAA+B,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;gBACzE,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,cAAc,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;oBACnC,SAAS;gBACX,CAAC;gBAED,MAAM,kBAAkB,GAAG,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC;gBACnD,cAAc,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC;gBAE1C,mEAAmE;gBACnE,wEAAwE;gBACxE,iEAAiE;gBACjE,uEAAuE;gBACvE,sEAAsE;gBACtE,mEAAmE;gBACnE,uEAAuE;gBACvE,sEAAsE;gBACtE,8DAA8D;gBAC9D,EAAE;gBACF,mEAAmE;gBACnE,sEAAsE;gBACtE,iEAAiE;gBACjE,gBAAgB;gBAChB,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;oBACnD,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACzC,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBACpC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,sFAAsF,EAAE;4BAC3G,OAAO,EAAE,OAAO,CAAC,OAAO;4BACxB,MAAM;4BACN,IAAI;yBACL,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,GAAG,cAA8C,CAAC;IACpE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,gBAA+B,EAC/B,YAAkD,EAClD,iBAAuD,EACvD,gBAAsD,EACtD,OAAkC;IAElC,MAAM,QAAQ,GAAG,gBAAgB,CAC/B,OAAO,CAAC,OAAO,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,CAAC,YAAY,CACrB,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,4BAA4B,CAAC,cAAc,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAEzF,IAAI,UAAU,CAAC,IAAI,IAAI,uBAAuB,EAAE,CAAC;QAC/C,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAAuB,EACvB,MAAqB,EACrB,aAA+C,EAC/C,kBAA4G;IAE5G,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,WAAW,IAAI,QAAQ,CAAC;IAC5D,MAAM,eAAe,GAAG,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,KAAK,aAAa,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IAC1H,MAAM,4BAA4B,GAAG,eAAe;QAClD,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,aAAa,EAAE,4BAA4B,IAAI,IAAI,CAAC;IAExD,OAAO;QACL,OAAO;QACP,MAAM;QACN,kBAAkB,EAAE,OAAO,CAAC,aAAa,EAAE,kBAAkB,IAAI,eAAe,CAAC;QACjF,eAAe;QACf,4BAA4B;QAC5B,QAAQ,EAAE,kBAAkB,EAAE,QAAQ;QACtC,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB;QACtD,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB;KAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAuB,cAAc,CAAC,IAAI;IACzE,OAAO,UAAU,CAAC,oBAAoB,CAAC,EAAE,MAAM,IAAI,kCAAkC,CAAC,IAAI,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,oBAAoB,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,oBAAoB,CAAC,EAAE,kBAAkB,IAAI,KAAK,CAAC;AACvE,CAAC","sourcesContent":["import { createContext, useContext } from 'react';\nimport {\n  FRAMEWORK_DEFAULT_SURFACE_POLICIES,\n  SurfaceVariant,\n  type DeepPartialSurfacePolicy,\n  type SurfacePolicy,\n} from '@wildo-ai/presets-components-models';\n\ntype SurfacePolicyFamily = keyof SurfacePolicy;\ntype SurfacePolicySlot = string;\n\nexport interface SurfacePolicyContextValue {\n  variant: SurfaceVariant;\n  policy: SurfacePolicy;\n  /**\n   * True when the current context chain already contains a rendered frame.\n   *\n   * The value is intentionally precomputed by each `<Surface>` provider so a\n   * nested surface can decide `framingMode: 'when-orphan'` in O(1), without\n   * walking the whole React ancestor chain on every render.\n   */\n  isInFramedAncestor: boolean;\n  /** True when this exact surface resolves to rendering its own visual frame. */\n  rendersOwnFrame: boolean;\n  nearestFramedAncestorVariant: SurfaceVariant | null;\n  headerId: string | undefined;\n  registerHeaderId: ((id: string) => void) | undefined;\n  unregisterHeaderId: ((id: string) => void) | undefined;\n}\n\nexport interface SurfacePolicyLogger {\n  warn: (message: string, context?: Record<string, unknown>) => void;\n  error: (message: string, context?: Record<string, unknown>) => void;\n}\n\nexport interface MergeSurfacePolicyOptions {\n  variant: SurfaceVariant;\n  parentPolicy?: SurfacePolicy;\n  logger?: SurfacePolicyLogger;\n}\n\nexport const SurfacePolicyContext = createContext<SurfacePolicyContextValue | null>(null);\n\nconst SURFACE_POLICY_FAMILIES: readonly SurfacePolicyFamily[] = [\n  'containment',\n  'nesting',\n  'content',\n  'autoRender',\n  'interactiveState',\n  'a11y',\n  'geometry',\n  'stacking',\n  'skeleton',\n  'composition',\n];\n\nconst POLICY_VALUE_INHERIT_SLOTS: ReadonlySet<string> = new Set([\n  'content.textTruncation',\n  'content.wrapStrategy',\n  'content.numericAlignment',\n  'content.overlongTokenStrategy',\n  'autoRender.autoFieldChrome',\n  'autoRender.autoFieldDensity',\n  'autoRender.autoErrorPlacement',\n  'interactiveState.loadingDisplay',\n  'interactiveState.errorBoundary',\n  'geometry.actionAlignment',\n  'skeleton.skeletonTemplate',\n  'skeleton.skeletonDensity',\n  'composition.selectionColumnAware',\n]);\n\nconst warnedMissingParentInherit = new Set<string>();\nconst erroredMissingFrameworkReset = new Set<string>();\nconst objectIds = new WeakMap<object, number>();\nconst mergeCache = new Map<string, SurfacePolicy>();\nconst MAX_MERGE_CACHE_ENTRIES = 500;\nlet nextObjectId = 1;\n\nfunction getInputId(value: object | undefined): string {\n  if (!value) {\n    return 'u';\n  }\n\n  let id = objectIds.get(value);\n  if (!id) {\n    id = nextObjectId;\n    nextObjectId += 1;\n    objectIds.set(value, id);\n  }\n\n  return `o${id}`;\n}\n\nfunction getMergeCacheKey(\n  variant: SurfaceVariant,\n  frameworkDefault: SurfacePolicy,\n  themeDefault: DeepPartialSurfacePolicy | undefined,\n  appConfigOverride: DeepPartialSurfacePolicy | undefined,\n  callSiteOverride: DeepPartialSurfacePolicy | undefined,\n  parentPolicy: SurfacePolicy | undefined,\n): string {\n  return [\n    variant,\n    getInputId(frameworkDefault),\n    getInputId(themeDefault),\n    getInputId(appConfigOverride),\n    getInputId(callSiteOverride),\n    getInputId(parentPolicy),\n  ].join('|');\n}\n\nfunction mergePolicyLayer(\n  base: SurfacePolicy,\n  override: DeepPartialSurfacePolicy | undefined,\n): SurfacePolicy {\n  if (!override) {\n    return base;\n  }\n\n  const merged: SurfacePolicy = { ...base };\n\n  for (const family of SURFACE_POLICY_FAMILIES) {\n    const familyOverride = override[family];\n    if (familyOverride) {\n      merged[family] = {\n        ...base[family],\n        ...familyOverride,\n        ...(family === 'containment' && 'slotGap' in familyOverride\n          ? mergeContainmentSlotGap(base, familyOverride)\n          : {}),\n      } as SurfacePolicy[typeof family];\n    }\n  }\n\n  return merged;\n}\n\nfunction mergeContainmentSlotGap(\n  base: SurfacePolicy,\n  familyOverride: NonNullable<DeepPartialSurfacePolicy['containment']>,\n): Pick<NonNullable<SurfacePolicy['containment']>, 'slotGap'> {\n  if (familyOverride.slotGap === undefined) {\n    return { slotGap: undefined };\n  }\n\n  return {\n    slotGap: {\n      ...base.containment?.slotGap,\n      ...familyOverride.slotGap,\n    },\n  };\n}\n\nfunction shouldResolvePolicyValueInherit(family: SurfacePolicyFamily, slot: SurfacePolicySlot): boolean {\n  return POLICY_VALUE_INHERIT_SLOTS.has(`${family}.${slot}`);\n}\n\nfunction resolveResetAndInheritValues(\n  policy: SurfacePolicy,\n  frameworkDefault: SurfacePolicy,\n  options: MergeSurfacePolicyOptions,\n): SurfacePolicy {\n  const resolved: SurfacePolicy = { ...policy };\n\n  for (const family of SURFACE_POLICY_FAMILIES) {\n    const familyPolicy = policy[family];\n    if (!familyPolicy) {\n      continue;\n    }\n\n    const familyResolved = { ...familyPolicy } as Record<string, unknown>;\n    const frameworkFamily = frameworkDefault[family] as Record<string, unknown> | undefined;\n    const parentFamily = options.parentPolicy?.[family] as Record<string, unknown> | undefined;\n\n    for (const [slot, value] of Object.entries(familyPolicy as Record<string, unknown>)) {\n      if (family === 'containment' && slot === 'slotGap' && value && typeof value === 'object') {\n        const frameworkSlotGap = frameworkDefault.containment?.slotGap;\n        const resolvedSlotGap = { ...(value as Record<string, unknown>) };\n\n        for (const [slotName, slotValue] of Object.entries(resolvedSlotGap)) {\n          if (slotValue !== 'reset') {\n            continue;\n          }\n\n          const slotGapKey = slotName as keyof NonNullable<NonNullable<SurfacePolicy['containment']>['slotGap']>;\n          const frameworkValue = frameworkSlotGap?.[slotGapKey];\n          resolvedSlotGap[slotName] = frameworkValue;\n\n          if (frameworkValue === undefined) {\n            const key = `${options.variant}.${family}.${slot}.${slotName}`;\n            if (!erroredMissingFrameworkReset.has(key)) {\n              erroredMissingFrameworkReset.add(key);\n              options.logger?.error('[SurfacePolicy] reset resolved to an undefined framework default', {\n                variant: options.variant,\n                family,\n                slot: `${slot}.${slotName}`,\n              });\n            }\n          }\n        }\n\n        familyResolved[slot] = resolvedSlotGap;\n        continue;\n      }\n\n      if (value === 'reset') {\n        const frameworkValue = frameworkFamily?.[slot];\n        familyResolved[slot] = frameworkValue;\n\n        if (frameworkValue === undefined) {\n          const key = `${options.variant}.${family}.${slot}`;\n          if (!erroredMissingFrameworkReset.has(key)) {\n            erroredMissingFrameworkReset.add(key);\n            options.logger?.error('[SurfacePolicy] reset resolved to an undefined framework default', {\n              variant: options.variant,\n              family,\n              slot,\n            });\n          }\n        }\n        continue;\n      }\n\n      if (value === 'inherit' && shouldResolvePolicyValueInherit(family, slot)) {\n        const parentValue = parentFamily?.[slot];\n        if (parentValue !== undefined) {\n          familyResolved[slot] = parentValue;\n          continue;\n        }\n\n        const frameworkSlotValue = frameworkFamily?.[slot];\n        familyResolved[slot] = frameworkSlotValue;\n\n        // Only warn when the framework default would actually substitute a\n        // DIFFERENT concrete value than the `'inherit'` the call-site provided.\n        // If the variant's own framework default for this slot is ITSELF\n        // `'inherit'` (as is the case for root variants like SHELL and OVERLAY\n        // on `content.numericAlignment`), then the resolver's fallback simply\n        // re-emits the same `'inherit'` keyword the author asked for — CSS\n        // then handles DOM-level inheritance natively. That is the framework's\n        // intentional design for root-level variants which by definition have\n        // no parent Surface, and is NOT an authoring mistake to flag.\n        //\n        // The warning is reserved for the case where the framework default\n        // would substitute a concrete value — that's the case worth surfacing\n        // because the resolved policy then quietly differs from what the\n        // author wrote.\n        if (frameworkSlotValue !== 'inherit') {\n          const key = `${options.variant}.${family}.${slot}`;\n          if (!warnedMissingParentInherit.has(key)) {\n            warnedMissingParentInherit.add(key);\n            options.logger?.warn('[SurfacePolicy] inherit had no parent surface; falling back to the framework default', {\n              variant: options.variant,\n              family,\n              slot,\n            });\n          }\n        }\n      }\n    }\n\n    resolved[family] = familyResolved as SurfacePolicy[typeof family];\n  }\n\n  return resolved;\n}\n\n/**\n * Merge the four Surface Policy layers into a concrete `SurfacePolicy`.\n *\n * Order is fixed by KD-4: framework fallback → theme recipe policy → app\n * configuration override → call-site override. The function is memoized by\n * shallow identity of those inputs so repeated renders with stable config\n * objects reuse the same policy reference.\n */\nexport function mergeSurfacePolicy(\n  frameworkDefault: SurfacePolicy,\n  themeDefault: DeepPartialSurfacePolicy | undefined,\n  appConfigOverride: DeepPartialSurfacePolicy | undefined,\n  callSiteOverride: DeepPartialSurfacePolicy | undefined,\n  options: MergeSurfacePolicyOptions,\n): SurfacePolicy {\n  const cacheKey = getMergeCacheKey(\n    options.variant,\n    frameworkDefault,\n    themeDefault,\n    appConfigOverride,\n    callSiteOverride,\n    options.parentPolicy,\n  );\n  const cached = mergeCache.get(cacheKey);\n  if (cached) {\n    return cached;\n  }\n\n  const mergedTheme = mergePolicyLayer(frameworkDefault, themeDefault);\n  const mergedApp = mergePolicyLayer(mergedTheme, appConfigOverride);\n  const mergedCallSite = mergePolicyLayer(mergedApp, callSiteOverride);\n  const resolved = resolveResetAndInheritValues(mergedCallSite, frameworkDefault, options);\n\n  if (mergeCache.size >= MAX_MERGE_CACHE_ENTRIES) {\n    mergeCache.clear();\n  }\n  mergeCache.set(cacheKey, resolved);\n  return resolved;\n}\n\nexport function computeSurfacePolicyContextValue(\n  variant: SurfaceVariant,\n  policy: SurfacePolicy,\n  parentContext: SurfacePolicyContextValue | null,\n  headerRegistration?: Pick<SurfacePolicyContextValue, 'headerId' | 'registerHeaderId' | 'unregisterHeaderId'>,\n): SurfacePolicyContextValue {\n  const framingMode = policy.nesting?.framingMode ?? 'always';\n  const rendersOwnFrame = framingMode === 'always' || (framingMode === 'when-orphan' && !parentContext?.isInFramedAncestor);\n  const nearestFramedAncestorVariant = rendersOwnFrame\n    ? variant\n    : parentContext?.nearestFramedAncestorVariant ?? null;\n\n  return {\n    variant,\n    policy,\n    isInFramedAncestor: Boolean(parentContext?.isInFramedAncestor || rendersOwnFrame),\n    rendersOwnFrame,\n    nearestFramedAncestorVariant,\n    headerId: headerRegistration?.headerId,\n    registerHeaderId: headerRegistration?.registerHeaderId,\n    unregisterHeaderId: headerRegistration?.unregisterHeaderId,\n  };\n}\n\nexport function useSurfacePolicy(hint: SurfaceVariant = SurfaceVariant.BASE): SurfacePolicy {\n  return useContext(SurfacePolicyContext)?.policy ?? FRAMEWORK_DEFAULT_SURFACE_POLICIES[hint];\n}\n\nexport function useSurfaceVariant(): SurfaceVariant | null {\n  return useContext(SurfacePolicyContext)?.variant ?? null;\n}\n\n/**\n * `true` when the current React subtree is already inside a surface that paints\n * its own visual frame (border + shadow). Section/card chrome reads this to\n * activate the `when-orphan` framing semantic: a framed section nested inside an\n * already-framed ancestor (card-in-card, card-in-dialog, card-in-composite)\n * suppresses its OWN frame to avoid \"border soup\", because the outer frame\n * already delineates the region.\n *\n * Returns `false` at the top of the tree (no surface ancestor). The value is\n * precomputed by each `<Surface>` provider (see\n * {@link computeSurfacePolicyContextValue}), so this read is O(1) and never\n * walks the ancestor chain.\n *\n * IMPORTANT: this signal is only reliable when every surface's\n * `nesting.framingMode` truthfully reflects whether it paints a frame. A surface\n * that renders FLAT but declares `framingMode: 'always'` would falsely report\n * `true` to its descendants — so flat chrome must declare `framingMode: 'never'`\n * and `when-orphan` chrome must paint its frame iff this hook returns `false`.\n */\nexport function useIsInFramedAncestor(): boolean {\n  return useContext(SurfacePolicyContext)?.isInFramedAncestor ?? false;\n}\n"]}

package/dist/esm/core/ui/UIContext.d.ts

@@ -3,17 +3,19 @@
  * Provides simplified UI configuration with abstracted breakpoints
  */
 import React, { ReactNode } from 'react';
+import type { AppConfiguration_Frontend } from '../../core/config/app-configuration-frontend.schemas';
+import type { SettingsHubConfig } from '../../core/config/settings-hub.frontend.schemas';
 import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
-import { UserPreferences } from '@wildo-ai/saas-models';
+import { UserTheme, UserPreferences } from '@wildo-ai/saas-models';
 import { type NavigationLayout } from '@wildo-ai/saas-models';
-import type { CompositeViewDefinition } from '../../core/config/composite-view.schemas.js';
-import type { OnboardingViewDefinition } from '../../core/config/onboarding-view.frontend.schemas.js';
-import type { FullCustomViewDefinition } from '../../core/config/full-custom-view.schemas.js';
-import type { FlowsActorsViewDefinition } from '../../core/config/flows-actors-view.schemas.js';
-import type { HomeDefinition } from '../../core/config/app-configuration-frontend.schemas.js';
-import { DesignSystemToken, UIBehavior } from '@wildo-ai/presets-components-models';
-import type { ChartStylePreset, UIBehaviorRecipe } from '@wildo-ai/presets-components-models';
-import { UIConfiguration } from '../../core/ui/ui.frontend.schemas.js';
+import type { CompositeViewDefinition } from '../../core/config/composite-view.schemas';
+import type { OnboardingViewDefinition } from '../../core/config/onboarding-view.frontend.schemas';
+import type { FullCustomViewDefinition } from '../../core/config/full-custom-view.schemas';
+import type { FlowsActorsViewDefinition } from '../../core/config/flows-actors-view.schemas';
+import type { HomeDefinition } from '../../core/config/app-configuration-frontend.schemas';
+import { DesignSystemToken, UIBehavior, SurfaceVariant, ShellAppearance, SidebarCompactLabelMode, ActionLabelDisplayMode, MaterialProfileRole } from '@wildo-ai/presets-components-models';
+import type { ChartStylePreset, DeepPartialSurfacePolicy, SurfacePolicy, UIBehaviorRecipe, MaterialProfile } from '@wildo-ai/presets-components-models';
+import { UIConfiguration } from '../../core/ui/ui.frontend.schemas';
 export interface ComponentsViewportContextType {
     currentBreakpoint: ViewportBreakpoint;
     isMobile: boolean;
@@ -48,9 +50,27 @@ export interface UIContextType {
     fullCustomViews?: FullCustomViewDefinition[];
     flowsActorsViews?: FlowsActorsViewDefinition[];
     homeDefinition?: HomeDefinition;
+    /**
+     * The application's authored settings rail. Exposed here so
+     * `useSettingsHubConfig` reads the SAME frontend configuration every other
+     * sub-config comes from, rather than reaching for a framework default.
+     */
+    settingsHub?: SettingsHubConfig;
     isDark: boolean;
     setDark: (enabled: boolean) => void;
     toggleDark: () => void;
+    /**
+     * The user's chosen theme PREFERENCE (`LIGHT` / `DARK` / `AUTO`), distinct
+     * from `isDark` (the resolved boolean). `AUTO` follows the OS scheme. Read this
+     * to drive a 3-way theme selector; `isDark` only tells you the resolved value.
+     */
+    themePreference: UserTheme;
+    /**
+     * Set the theme preference and apply it. Unlike `setDark` (LIGHT/DARK only),
+     * this handles all three `UserTheme` values — `AUTO` resolves against the OS
+     * scheme — and keeps `isDark` + `themePreference` in sync.
+     */
+    setTheme: (theme: UserTheme) => void;
     uiPreferences: UserPreferences['ui'] | null;
     getUiPreferences: () => UserPreferences['ui'] | null;
     currentBreakpoint: ViewportBreakpoint;
@@ -63,6 +83,9 @@ export interface UIContextType {
     isMac: boolean;
     getRecipe: (behavior: UIBehavior, variant?: string) => UIBehaviorRecipe;
     getComposedClasses: (behavior: UIBehavior, variant?: string, size?: string) => string;
+    /** Resolve a recipe-selected material role through the active theme. */
+    getMaterialProfile?: (role: MaterialProfileRole | undefined) => MaterialProfile | undefined;
+    getSurfacePolicy?: (variant: SurfaceVariant, callSiteOverride?: DeepPartialSurfacePolicy, parentPolicy?: SurfacePolicy) => SurfacePolicy;
     getTokenValue: (token: DesignSystemToken) => string;
     getCssVariable: (token: DesignSystemToken) => string;
     getChartStylePreset: () => ChartStylePreset;
@@ -70,6 +93,26 @@ export interface UIContextType {
         id: string;
         name: string;
     };
+    /**
+     * Resolved theme-level shell chrome policy (defaulted to `SEPARATED` when the
+     * active theme doesn't declare one). App-shell region presets (sidebar,
+     * menubar, toolbar, activity/status bars) and the navigation content zones
+     * branch on this to render transparent regions in `CONTINUOUS` mode.
+     */
+    shellAppearance: ShellAppearance;
+    /**
+     * Resolved theme-level collapsed-sidebar label policy (defaulted to
+     * `ICON_ONLY`). Consumed by the sidebar preset (item layout) and
+     * `useSidebarBehavior` (default collapsed width).
+     */
+    sidebarCompactLabelMode: SidebarCompactLabelMode;
+    /**
+     * Resolved app-wide default for how action buttons render their label
+     * (defaulted to `TOOLTIP`). `ActionBar` reads this whenever a caller doesn't
+     * pass an explicit `labelDisplayMode`, so every action cluster honors the
+     * app policy; per-resource-view overrides pass an explicit value instead.
+     */
+    actionLabelDisplayMode: ActionLabelDisplayMode;
 }
 /**
  * UI Context
@@ -77,8 +120,29 @@ export interface UIContextType {
  * @internal - Use useUI() hook instead of accessing this directly
  */
 export declare const UIContext: React.Context<UIContextType | undefined>;
+/**
+ * The UI runtime's inputs are PROPS, not an ambient context.
+ *
+ * `UIProvider` deliberately does not call `useApplication()`/`useEventBus()` itself: keeping it
+ * independent of the application runtime is what lets the focused UI tests (theme tokens, dark-mode
+ * preference, isolate layering) mount it with synthetic values instead of a whole provider tree.
+ *
+ * That independence used to be bought with a context — `FrontendHostUIRuntimeBindingProvider` plus a
+ * hook, a type and a throw — extracted so a non-SaaS browser host could supply a different
+ * implementation. That host was the application-creation workbench; it was deleted 2026-08-23, and
+ * the seam was then measured to have ZERO polymorphism: one consumer, and two "different" suppliers
+ * (`SaaSUIRuntimeProvider`, `TestUIProvider`) that were the same `useApplication()` + `useEventBus()`
+ * code written twice. Every mount site had the provider as this component's IMMEDIATE parent, so the
+ * context was carrying values one level. Props buy the same independence for three lines.
+ */
 export interface UIProviderProps {
     children: ReactNode;
+    /** Resolved, schema-validated frontend configuration. */
+    frontendConfiguration: AppConfiguration_Frontend | undefined;
+    /** Subscribe to user-preference changes; returns an unsubscribe. */
+    subscribeToUserPreferences: (listener: (preferences: UserPreferences['ui'] | null) => void) => () => void;
+    /** Acknowledge that the UI runtime has completed startup. */
+    markInitialized: () => void;
 }
-export declare function UIProvider({ children }: UIProviderProps): React.ReactElement;
+export declare function UIProvider({ children, frontendConfiguration, subscribeToUserPreferences, markInitialized, }: UIProviderProps): React.ReactElement;
 //# sourceMappingURL=UIContext.d.ts.map

package/dist/esm/core/ui/UIContext.d.ts.map

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