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

package/dist/esm/core/app-shell/app-shell.utils.js

@@ -22,15 +22,6 @@ export function mapApplicationLevelToFrontendComponentType(type) {
             return FrontendComponentType.APPLICATION_LEVEL_CONTROL_PANEL;
         case ApplicationLevelComponentType.QUICK_SWITCHER:
             return FrontendComponentType.APPLICATION_LEVEL_QUICK_SWITCHER;
-        case ApplicationLevelComponentType.SETTINGS_DROPDOWN:
-            /**
-             * Intentional alias — SETTINGS_DROPDOWN renders via the USER_DROPDOWN component.
-             * The preset receives `containerType` as a prop and could branch behavior,
-             * but no separate hook or registration exists today. To support distinct UX,
-             * add `FrontendComponentType.APPLICATION_LEVEL_SETTINGS_DROPDOWN` and a
-             * separate case here.
-             */
-            return FrontendComponentType.APPLICATION_LEVEL_USER_DROPDOWN;
         case ApplicationLevelComponentType.NAVIGATION_CONTROL:
             return FrontendComponentType.APPLICATION_LEVEL_NAVIGATION_BACK;
         case ApplicationLevelComponentType.UTILITY_PANEL:
@@ -39,4 +30,4 @@ export function mapApplicationLevelToFrontendComponentType(type) {
             return null;
     }
 }
-//# sourceMappingURL=app-shell.utils.js.map
+//# sourceMappingURL=app-shell.utils.js.map

package/dist/esm/core/app-shell/app-shell.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.utils.js","sourceRoot":"","sources":["../../../../src/core/app-shell/app-shell.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,UAAU,0CAA0C,CACxD,IAAmC;IAEnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,6BAA6B,CAAC,YAAY;YAC7C,OAAO,qBAAqB,CAAC,8BAA8B,CAAC;QAC9D,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,cAAc;YAC/C,OAAO,qBAAqB,CAAC,gCAAgC,CAAC;QAChE,KAAK,6BAA6B,CAAC,iBAAiB;YAClD;;;;;;eAMG;YACH,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,kBAAkB;YACnD,OAAO,qBAAqB,CAAC,iCAAiC,CAAC;QACjE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"app-shell.utils.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/app-shell.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,UAAU,0CAA0C,CACxD,IAAmC;IAEnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,6BAA6B,CAAC,YAAY;YAC7C,OAAO,qBAAqB,CAAC,8BAA8B,CAAC;QAC9D,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,cAAc;YAC/C,OAAO,qBAAqB,CAAC,gCAAgC,CAAC;QAChE,KAAK,6BAA6B,CAAC,kBAAkB;YACnD,OAAO,qBAAqB,CAAC,iCAAiC,CAAC;QACjE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC","sourcesContent":["import { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\n\n/**\n * Maps an `ApplicationLevelComponentType` (config key) to the corresponding\n * `FrontendComponentType` (DI registry key).\n *\n * Single source of truth — consumed by `useMenuBarBehavior` and any future\n * code that needs to resolve an app-level config entry to a renderable\n * component.\n */\nexport function mapApplicationLevelToFrontendComponentType(\n  type: ApplicationLevelComponentType,\n): FrontendComponentType | null {\n  switch (type) {\n    case ApplicationLevelComponentType.COMMAND_MENU:\n      return FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU;\n    case ApplicationLevelComponentType.QUICK_ACTION_BUTTON:\n      return FrontendComponentType.APPLICATION_LEVEL_QUICK_ACTION_BUTTON;\n    case ApplicationLevelComponentType.NOTIFICATION_CENTER:\n      return FrontendComponentType.APPLICATION_LEVEL_NOTIFICATION_CENTER;\n    case ApplicationLevelComponentType.USER_DROPDOWN:\n      return FrontendComponentType.APPLICATION_LEVEL_USER_DROPDOWN;\n    case ApplicationLevelComponentType.CONTROL_PANEL:\n      return FrontendComponentType.APPLICATION_LEVEL_CONTROL_PANEL;\n    case ApplicationLevelComponentType.QUICK_SWITCHER:\n      return FrontendComponentType.APPLICATION_LEVEL_QUICK_SWITCHER;\n    case ApplicationLevelComponentType.NAVIGATION_CONTROL:\n      return FrontendComponentType.APPLICATION_LEVEL_NAVIGATION_BACK;\n    case ApplicationLevelComponentType.UTILITY_PANEL:\n      return FrontendComponentType.APPLICATION_LEVEL_UTILITY_PANEL;\n    default:\n      return null;\n  }\n}\n"]}

package/dist/esm/core/app-shell/hosted-components.utils.d.ts

@@ -0,0 +1,39 @@
+import type { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';
+import { type NavigationLayout } from '@wildo-ai/saas-models';
+import type { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import { ApplicationLevelComponentType } from '../../core/config/app-level-components.frontend.schemas';
+import type { MenubarHostedComponent, SidebarHostedComponent } from '../../core/config/launcher-items.frontend.schemas';
+import type { ResolvedHostedComponent } from '../../core/app-shell/app-shell.schemas';
+/** A hosted-component config entry from EITHER surface (menubar or sidebar). */
+type AnyHostedComponentConfig = MenubarHostedComponent | SidebarHostedComponent;
+/**
+ * Resolve a surface's raw `hostedComponents` config entries into renderable
+ * {@link ResolvedHostedComponent} descriptors.
+ *
+ * This is the SINGLE hosting pipeline shared by the menubar and the sidebar —
+ * container inversion, breakpoint gating, per-component enable/disable, registry
+ * type mapping, and per-placement `triggerWidth` all live here so the two
+ * surfaces never drift. The shell-level interaction owner
+ * (`HostedComponentInteractionsProvider`) calls it for BOTH surfaces to compute
+ * a single global open-state/hotkey owner across them.
+ *
+ * `surface` (MENUBAR or SIDEBAR) prefixes each `instanceId` so the same
+ * component hosted in both surfaces at once gets distinct, stable ids
+ * (`menubar:command_menu-0` vs `sidebar:command_menu-0`).
+ *
+ * Entries are dropped when: their `breakpoint` doesn't match the current
+ * breakpoint, the component is globally disabled (`config[type] === false`), or
+ * the component type has no registry mapping.
+ *
+ * `defaultPlacement` is the surface's documented default zone
+ * (menubar → `HorizontalPlacement.START`, sidebar → `VerticalPlacement.TOP`).
+ * It is REQUIRED — not optional — because the surface presets place components
+ * with a strict per-zone equality filter: before this normalization existed, an
+ * entry that omitted `placement` matched NO zone and silently vanished from the
+ * shell. Normalizing here (the single shared pipeline) rather than in each
+ * preset keeps the menubar and sidebar from drifting on that rule, and lets
+ * every resolved descriptor carry a concrete placement by construction.
+ */
+export declare function resolveHostedComponents(surface: ApplicationLevelComponentType, hostedComponents: AnyHostedComponentConfig[] | undefined, appComponentsConfiguration: Record<string, unknown> | undefined, currentBreakpoint: ViewportBreakpoint | string | undefined, defaultPlacement: HorizontalPlacement | VerticalPlacement, navigationLayout?: NavigationLayout): ResolvedHostedComponent[];
+export {};
+//# sourceMappingURL=hosted-components.utils.d.ts.map

package/dist/esm/core/app-shell/hosted-components.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-components.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/hosted-components.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,iEAAiE,CAAC;AAEzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAEpG,gFAAgF;AAChF,KAAK,wBAAwB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,6BAA6B,EACtC,gBAAgB,EAAE,wBAAwB,EAAE,GAAG,SAAS,EACxD,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/D,iBAAiB,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,EAC1D,gBAAgB,EAAE,mBAAmB,GAAG,iBAAiB,EACzD,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,uBAAuB,EAAE,CAmD3B"}

package/dist/esm/core/app-shell/hosted-components.utils.js

@@ -0,0 +1,75 @@
+import { navigationBackAffordanceAdmitsShell } from '@wildo-ai/saas-models';
+import { ApplicationLevelComponentType } from '../../core/config/app-level-components.frontend.schemas.js';
+import { mapApplicationLevelToFrontendComponentType } from '../../core/app-shell/app-shell.utils.js';
+/**
+ * Resolve a surface's raw `hostedComponents` config entries into renderable
+ * {@link ResolvedHostedComponent} descriptors.
+ *
+ * This is the SINGLE hosting pipeline shared by the menubar and the sidebar —
+ * container inversion, breakpoint gating, per-component enable/disable, registry
+ * type mapping, and per-placement `triggerWidth` all live here so the two
+ * surfaces never drift. The shell-level interaction owner
+ * (`HostedComponentInteractionsProvider`) calls it for BOTH surfaces to compute
+ * a single global open-state/hotkey owner across them.
+ *
+ * `surface` (MENUBAR or SIDEBAR) prefixes each `instanceId` so the same
+ * component hosted in both surfaces at once gets distinct, stable ids
+ * (`menubar:command_menu-0` vs `sidebar:command_menu-0`).
+ *
+ * Entries are dropped when: their `breakpoint` doesn't match the current
+ * breakpoint, the component is globally disabled (`config[type] === false`), or
+ * the component type has no registry mapping.
+ *
+ * `defaultPlacement` is the surface's documented default zone
+ * (menubar → `HorizontalPlacement.START`, sidebar → `VerticalPlacement.TOP`).
+ * It is REQUIRED — not optional — because the surface presets place components
+ * with a strict per-zone equality filter: before this normalization existed, an
+ * entry that omitted `placement` matched NO zone and silently vanished from the
+ * shell. Normalizing here (the single shared pipeline) rather than in each
+ * preset keeps the menubar and sidebar from drifting on that rule, and lets
+ * every resolved descriptor carry a concrete placement by construction.
+ */
+export function resolveHostedComponents(surface, hostedComponents, appComponentsConfiguration, currentBreakpoint, defaultPlacement, navigationLayout) {
+    if (!appComponentsConfiguration || !hostedComponents || hostedComponents.length === 0) {
+        return [];
+    }
+    const resolved = [];
+    const componentCounts = new Map();
+    for (const hc of hostedComponents) {
+        const compType = hc.componentType;
+        if (hc.breakpoint && hc.breakpoint !== currentBreakpoint) {
+            continue;
+        }
+        if (appComponentsConfiguration[compType] === false) {
+            continue;
+        }
+        // OWNERSHIP POLICY: the back affordance can be rendered by the app SHELL
+        // (this hosted control) or by the current SURFACE's own header, and both
+        // mount the same control — so an app that hosts it here without owning it
+        // would show two back arrows on every pushed page. The drop lives in this
+        // shared resolver, not in each surface preset, because the shell mounts
+        // hosted components through the generic component REGISTRY (which resolves
+        // the preset directly and never sees the wrapper's gate); one site here
+        // covers the menubar and the sidebar together.
+        if (compType === ApplicationLevelComponentType.NAVIGATION_CONTROL
+            && !navigationBackAffordanceAdmitsShell(navigationLayout?.backAffordanceOwner)) {
+            continue;
+        }
+        const frontendType = mapApplicationLevelToFrontendComponentType(compType);
+        if (!frontendType)
+            continue;
+        const instanceIndex = componentCounts.get(compType) ?? 0;
+        componentCounts.set(compType, instanceIndex + 1);
+        resolved.push({
+            instanceId: `${surface}:${compType}-${instanceIndex}`,
+            component: compType,
+            frontendComponentType: frontendType,
+            placement: hc.placement ?? defaultPlacement,
+            presetName: hc.presetName,
+            triggerWidth: hc.triggerWidth,
+            triggerAppearance: hc.triggerAppearance,
+        });
+    }
+    return resolved;
+}
+//# sourceMappingURL=hosted-components.utils.js.map

package/dist/esm/core/app-shell/hosted-components.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-components.utils.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/hosted-components.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mCAAmC,EAAyB,MAAM,uBAAuB,CAAC;AAGnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AAKtH,OAAO,EAAE,0CAA0C,EAAE,MAAM,oDAAoD,CAAC;AAMhH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAsC,EACtC,gBAAwD,EACxD,0BAA+D,EAC/D,iBAA0D,EAC1D,gBAAyD,EACzD,gBAAmC;IAEnC,IAAI,CAAC,0BAA0B,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEzE,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,EAAE,CAAC,aAA8C,CAAC;QAEnE,IAAI,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,KAAK,iBAAiB,EAAE,CAAC;YACzD,SAAS;QACX,CAAC;QACD,IAAI,0BAA0B,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YACnD,SAAS;QACX,CAAC;QAED,yEAAyE;QACzE,yEAAyE;QACzE,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,+CAA+C;QAC/C,IACE,QAAQ,KAAK,6BAA6B,CAAC,kBAAkB;eAC1D,CAAC,mCAAmC,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,EAC9E,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,0CAA0C,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,YAAY;YAAE,SAAS;QAE5B,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC;QAEjD,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,GAAG,OAAO,IAAI,QAAQ,IAAI,aAAa,EAAE;YACrD,SAAS,EAAE,QAAQ;YACnB,qBAAqB,EAAE,YAAY;YACnC,SAAS,EAAG,EAAE,CAAC,SAAiE,IAAI,gBAAgB;YACpG,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;SACxC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { navigationBackAffordanceAdmitsShell, type NavigationLayout } from '@wildo-ai/saas-models';\nimport type { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\n\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type {\n  MenubarHostedComponent,\n  SidebarHostedComponent,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { mapApplicationLevelToFrontendComponentType } from '~wildo-frontend-lib/core/app-shell/app-shell.utils';\nimport type { ResolvedHostedComponent } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\n/** A hosted-component config entry from EITHER surface (menubar or sidebar). */\ntype AnyHostedComponentConfig = MenubarHostedComponent | SidebarHostedComponent;\n\n/**\n * Resolve a surface's raw `hostedComponents` config entries into renderable\n * {@link ResolvedHostedComponent} descriptors.\n *\n * This is the SINGLE hosting pipeline shared by the menubar and the sidebar —\n * container inversion, breakpoint gating, per-component enable/disable, registry\n * type mapping, and per-placement `triggerWidth` all live here so the two\n * surfaces never drift. The shell-level interaction owner\n * (`HostedComponentInteractionsProvider`) calls it for BOTH surfaces to compute\n * a single global open-state/hotkey owner across them.\n *\n * `surface` (MENUBAR or SIDEBAR) prefixes each `instanceId` so the same\n * component hosted in both surfaces at once gets distinct, stable ids\n * (`menubar:command_menu-0` vs `sidebar:command_menu-0`).\n *\n * Entries are dropped when: their `breakpoint` doesn't match the current\n * breakpoint, the component is globally disabled (`config[type] === false`), or\n * the component type has no registry mapping.\n *\n * `defaultPlacement` is the surface's documented default zone\n * (menubar → `HorizontalPlacement.START`, sidebar → `VerticalPlacement.TOP`).\n * It is REQUIRED — not optional — because the surface presets place components\n * with a strict per-zone equality filter: before this normalization existed, an\n * entry that omitted `placement` matched NO zone and silently vanished from the\n * shell. Normalizing here (the single shared pipeline) rather than in each\n * preset keeps the menubar and sidebar from drifting on that rule, and lets\n * every resolved descriptor carry a concrete placement by construction.\n */\nexport function resolveHostedComponents(\n  surface: ApplicationLevelComponentType,\n  hostedComponents: AnyHostedComponentConfig[] | undefined,\n  appComponentsConfiguration: Record<string, unknown> | undefined,\n  currentBreakpoint: ViewportBreakpoint | string | undefined,\n  defaultPlacement: HorizontalPlacement | VerticalPlacement,\n  navigationLayout?: NavigationLayout,\n): ResolvedHostedComponent[] {\n  if (!appComponentsConfiguration || !hostedComponents || hostedComponents.length === 0) {\n    return [];\n  }\n\n  const resolved: ResolvedHostedComponent[] = [];\n  const componentCounts = new Map<ApplicationLevelComponentType, number>();\n\n  for (const hc of hostedComponents) {\n    const compType = hc.componentType as ApplicationLevelComponentType;\n\n    if (hc.breakpoint && hc.breakpoint !== currentBreakpoint) {\n      continue;\n    }\n    if (appComponentsConfiguration[compType] === false) {\n      continue;\n    }\n\n    // OWNERSHIP POLICY: the back affordance can be rendered by the app SHELL\n    // (this hosted control) or by the current SURFACE's own header, and both\n    // mount the same control — so an app that hosts it here without owning it\n    // would show two back arrows on every pushed page. The drop lives in this\n    // shared resolver, not in each surface preset, because the shell mounts\n    // hosted components through the generic component REGISTRY (which resolves\n    // the preset directly and never sees the wrapper's gate); one site here\n    // covers the menubar and the sidebar together.\n    if (\n      compType === ApplicationLevelComponentType.NAVIGATION_CONTROL\n      && !navigationBackAffordanceAdmitsShell(navigationLayout?.backAffordanceOwner)\n    ) {\n      continue;\n    }\n\n    const frontendType = mapApplicationLevelToFrontendComponentType(compType);\n    if (!frontendType) continue;\n\n    const instanceIndex = componentCounts.get(compType) ?? 0;\n    componentCounts.set(compType, instanceIndex + 1);\n\n    resolved.push({\n      instanceId: `${surface}:${compType}-${instanceIndex}`,\n      component: compType,\n      frontendComponentType: frontendType,\n      placement: (hc.placement as HorizontalPlacement | VerticalPlacement | undefined) ?? defaultPlacement,\n      presetName: hc.presetName,\n      triggerWidth: hc.triggerWidth,\n      triggerAppearance: hc.triggerAppearance,\n    });\n  }\n\n  return resolved;\n}\n"]}

package/dist/esm/core/app-shell/useAppShellLayout.d.ts

@@ -1,4 +1,4 @@
-import type { AppShellLayoutInfo } from './app-shell.schemas.js';
+import type { AppShellLayoutInfo } from './app-shell.schemas';
 /**
  * Pure behavior hook for the app shell layout — computes which app-level
  * components are present and their placement, and gates application

package/dist/esm/core/app-shell/useAppShellLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppShellLayout.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAyDtD"}
+{"version":3,"file":"useAppShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAyDtD"}

package/dist/esm/core/app-shell/useAppShellLayout.js

@@ -65,4 +65,4 @@ export function useAppShellLayout() {
         };
     }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);
 }
-//# sourceMappingURL=useAppShellLayout.js.map
+//# sourceMappingURL=useAppShellLayout.js.map

package/dist/esm/core/app-shell/useAppShellLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\n\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the app shell layout — computes which app-level\n * components are present and their placement, and gates application\n * initialization via `markComponentInitialized`.\n *\n * `has*` flags reflect *config presence*, not visibility (breakpoint-gated\n * visibility is the preset's responsibility).\n */\nexport function useAppShellLayout(): AppShellLayoutInfo {\n  const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();\n  const { markComponentInitialized } = useApplication();\n\n  const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);\n\n  useEffect(() => {\n    if (isLayoutReady) {\n      markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);\n    }\n  }, [isLayoutReady, markComponentInitialized]);\n\n  return useMemo((): AppShellLayoutInfo => {\n    if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {\n      return {\n        hasMenubar: false,\n        hasSidebar: false,\n        hasStatusBar: false,\n        hasToolbar: false,\n        hasActivityBar: false,\n        hasQuickActionButton: false,\n        hasUtilityPanel: false,\n        sidebarPlacement: HorizontalPlacement.START,\n        statusBarPlacement: VerticalPlacement.BOTTOM,\n        utilityPanelPlacement: HorizontalPlacement.END,\n        isLayoutReady: false,\n      };\n    }\n\n    const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR] as unknown;\n    const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];\n    const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];\n\n    const sidebarPlacement = isSidebarConfigObject(sidebarConfig)\n      ? sidebarConfig.placement\n      : HorizontalPlacement.START;\n\n    return {\n      hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),\n      hasSidebar: Boolean(sidebarConfig),\n      hasStatusBar: Boolean(statusBarConfig),\n      hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),\n      hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),\n      hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),\n      hasUtilityPanel: Boolean(utilityPanelConfig),\n      sidebarPlacement,\n      statusBarPlacement: typeof statusBarConfig === 'string'\n        ? statusBarConfig as VerticalPlacement\n        : isStatusBarConfigObject(statusBarConfig)\n          ? statusBarConfig.placement ?? VerticalPlacement.BOTTOM\n          : VerticalPlacement.BOTTOM,\n      utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)\n        ? utilityPanelConfig.position ?? HorizontalPlacement.END\n        : HorizontalPlacement.END,\n      isLayoutReady: true,\n    };\n  }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);\n}\n"]}

package/dist/esm/core/app-shell/usePublicShellLayout.d.ts

@@ -1,4 +1,4 @@
-import type { PublicShellLayoutInfo } from './app-shell.schemas.js';
+import type { PublicShellLayoutInfo } from './app-shell.schemas';
 /**
  * Pure behavior hook for the public shell layout.
  *

package/dist/esm/core/app-shell/usePublicShellLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,UAAQ,GAAG,qBAAqB,CAWjF"}
+{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,UAAQ,GAAG,qBAAqB,CAWjF"}

package/dist/esm/core/app-shell/usePublicShellLayout.js

@@ -17,4 +17,4 @@ export function usePublicShellLayout(useCardLayout = false) {
         isReady: true,
     };
 }
-//# sourceMappingURL=usePublicShellLayout.js.map
+//# sourceMappingURL=usePublicShellLayout.js.map

package/dist/esm/core/app-shell/usePublicShellLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePublicShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAItG;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAa,GAAG,KAAK;IACxD,MAAM,EAAE,wBAAwB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,wBAAwB,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/B,OAAO;QACL,aAAa;QACb,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"usePublicShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAItG;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAa,GAAG,KAAK;IACxD,MAAM,EAAE,wBAAwB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,wBAAwB,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/B,OAAO;QACL,aAAa;QACb,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC","sourcesContent":["import { useEffect } from 'react';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport type { PublicShellLayoutInfo } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the public shell layout.\n *\n * Gates application initialization via `markComponentInitialized` on mount\n * and exposes layout mode (`useCardLayout`).\n */\nexport function usePublicShellLayout(useCardLayout = false): PublicShellLayoutInfo {\n  const { markComponentInitialized } = useApplication();\n\n  useEffect(() => {\n    markComponentInitialized(MainContextInitComponents.PUBLIC_APP_CONTAINER);\n  }, [markComponentInitialized]);\n\n  return {\n    useCardLayout,\n    isReady: true,\n  };\n}\n"]}

package/dist/esm/core/automated-layout/automated-layout.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automated-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,OAAO,YAAY;IACnB,mCAAmC;IACnC,MAAM,WAAW;IACjB,+EAA+E;IAC/E,KAAK,UAAU;IACf,iCAAiC;IACjC,KAAK,UAAU;CAChB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAMlB;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,0CAA0C,CAAC,EAAE,MAAM,EAAE,CAAC;IACtD,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,+CAA+C;QAC/C,uBAAuB,EAAE,MAAM,CAAC;QAChC,2CAA2C;QAC3C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;QACrB,8DAA8D;QAC9D,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;KAC3D,CAAC,CAAC;CACJ"}
+{"version":3,"file":"automated-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,OAAO,YAAY;IACnB,mCAAmC;IACnC,MAAM,WAAW;IACjB,+EAA+E;IAC/E,KAAK,UAAU;IACf,iCAAiC;IACjC,KAAK,UAAU;CAChB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAMlB;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,0CAA0C,CAAC,EAAE,MAAM,EAAE,CAAC;IACtD,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,+CAA+C;QAC/C,uBAAuB,EAAE,MAAM,CAAC;QAChC,2CAA2C;QAC3C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;QACrB,8DAA8D;QAC9D,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;KAC3D,CAAC,CAAC;CACJ"}

package/dist/esm/core/automated-layout/automated-layout.frontend.schemas.js

@@ -27,4 +27,4 @@ export var InlineEditState;
     /** Save failed, showing error */
     InlineEditState["ERROR"] = "error";
 })(InlineEditState || (InlineEditState = {}));
-//# sourceMappingURL=automated-layout.frontend.schemas.js.map
+//# sourceMappingURL=automated-layout.frontend.schemas.js.map

package/dist/esm/core/automated-layout/automated-layout.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"automated-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GACf,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC;AAE9D,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,yCAAyC;IACzC,sCAAmB,CAAA;IACnB,gDAAgD;IAChD,sCAAmB,CAAA;IACnB,mCAAmC;IACnC,oCAAiB,CAAA;IACjB,+EAA+E;IAC/E,kCAAe,CAAA;IACf,iCAAiC;IACjC,kCAAe,CAAA;AACjB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B"}
+{"version":3,"file":"automated-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GACf,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC;AAE9D,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,yCAAyC;IACzC,sCAAmB,CAAA;IACnB,gDAAgD;IAChD,sCAAmB,CAAA;IACnB,mCAAmC;IACnC,oCAAiB,CAAA;IACjB,+EAA+E;IAC/E,kCAAe,CAAA;IACf,iCAAiC;IACjC,kCAAe,CAAA;AACjB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B","sourcesContent":["import {\n  ValidationMode,\n} from '@wildo-ai/zod-decorators';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\n\nimport type { z } from 'zod';\n\n\n// =============================================================================\n// VALIDATION CONSTANTS\n// =============================================================================\n\n/**\n * Default validation mode for all forms.\n * Centralized constant for consistent default behavior.\n */\nexport const DEFAULT_VALIDATION_MODE = ValidationMode.ON_BLUR;\n\n// =============================================================================\n// INLINE EDIT STATE\n// =============================================================================\n\n/**\n * State enum for inline field editing.\n * Represents the different states a field can be in during inline editing.\n */\nexport enum InlineEditState {\n  /** Displaying value, not in edit mode */\n  DISPLAY = 'display',\n  /** In edit mode, user is modifying the value */\n  EDITING = 'editing',\n  /** Saving changes to the server */\n  SAVING = 'saving',\n  /** Save completed successfully (brief feedback before returning to DISPLAY) */\n  SAVED = 'saved',\n  /** Save failed, showing error */\n  ERROR = 'error',\n}\n\n// =============================================================================\n// FORM OPERATION TYPE\n// =============================================================================\n\n/**\n * Operation type for controlling field visibility based on operation context.\n * Uses CoreResourceOperation enum values for type safety.\n * Used with excludeFromCreate, excludeFromUpdate, and isHidden(operations) decorators.\n * \n * Branded with `& {}` to allow custom string values through type assertion\n * without collapsing the entire union to `string` (which kills autocomplete).\n */\nexport type FormOperationType = \n  | CoreResourceOperation.CREATE \n  | CoreResourceOperation.UPDATE \n  | CoreResourceOperation.READ\n  | (string & {});\n\n// =============================================================================\n// INHERITANCE SCHEMA DEFINITION\n// =============================================================================\n\n/**\n * Inheritance schema definition for discriminated unions.\n * Used to track which fields belong to which variants for conditional visibility.\n * \n * This is a simplified, non-generic version of ResourceConfiguration_InheritanceSchemaDefinition\n * from @wildo-ai/saas-models, optimized for frontend use. It is structurally compatible\n * with the backend type but avoids complex generics that aren't needed for UI rendering.\n */\nexport interface InheritanceSchemaDefinition {\n  /** Field name used for discrimination (e.g., 'type', 'recurringType') */\n  discriminatorField: string;\n  /** Discriminator values that use base schema only (no variant extension) */\n  withoutInheritanceDiscriminatorFieldValues?: string[];\n  /** Variant schemas for each discriminator value */\n  inheritedSchemas?: Array<{\n    /** The discriminator value for this variant */\n    discriminatorFieldValue: string;\n    /** The extended schema for this variant */\n    schema: z.ZodTypeAny;\n    /** Nested inheritance for multi-level discriminated unions */\n    inheritenceSchemaDefinition?: InheritanceSchemaDefinition;\n  }>;\n}\n"]}

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas.js';
-import { FieldSchemaType, ValidationMode, type ShowWhenParams } from '@wildo-ai/zod-decorators';
+import type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas';
+import { FieldSchemaType, ArrayAddMode, ValidationMode, type ShowWhenParams } from '@wildo-ai/zod-decorators';
 export declare class AutomatedLayoutFrontendUtils {
     private static buildUnsupportedPlainUnionFileFieldMessage;
     private static normalizeFileMetadataForComparison;
@@ -84,6 +84,7 @@ export declare class AutomatedLayoutFrontendUtils {
      * `normalizeSchemaFieldPath()`.
      */
     static collectFileFieldPaths(schema: z.ZodTypeAny | undefined, pathPrefix?: string): string[];
+    static collectUploadableFileFieldPaths(schema: z.ZodTypeAny | undefined, pathPrefix?: string): string[];
     static resolveFieldSchemaPath(rootSchema: z.ZodTypeAny | undefined, path: string): z.ZodTypeAny | undefined;
     /**
      * Get default validation mode based on schema type.
@@ -101,13 +102,52 @@ export declare class AutomatedLayoutFrontendUtils {
     /**
      * Get a sensible default value for a given Zod schema type.
      *
-     * Used by form components (FormFieldArray, FormFieldRecord, etc.) when creating
+     * Used by form components (AutomatedArrayField, FormFieldRecord, etc.) when creating
      * new items/entries and a default value is needed.
      *
      * @param schema - The Zod schema to derive a default value from
      * @returns A default value appropriate for the schema type
      */
     static getDefaultValueForSchema(schema: z.ZodTypeAny): unknown;
+    /**
+     * Resolve the PRIMARY field of an array item — the single value a user types to
+     * quick-add an entry (e.g. a checklist item's `label`).
+     *
+     * - **Primitive item** (`z.array(z.string())`, `z.array(z.number())`): the value
+     *   itself is the primary input, so `name` is `null` and `schema` is the item.
+     * - **Object item** (`z.array(z.object({ label, done }))`): the first STRING field
+     *   (label-like, the natural thing to type), else the first NUMBER field, else the
+     *   first field. Returned `name` is the object key; `schema` is that field's schema.
+     *
+     * Used by the quick-add row (form + read-inline) to render the staging input and
+     * to validate-before-add. Secondary fields (e.g. a `done` boolean) are seeded from
+     * {@link getDefaultValueForSchema} when the item is committed.
+     *
+     * @returns `{ name, schema }` — `name === null` means the item itself is the value.
+     */
+    static getArrayItemPrimaryField(itemSchema: z.ZodTypeAny): {
+        name: string | null;
+        schema: z.ZodTypeAny;
+    };
+    /**
+     * Resolve the add-pattern ({@link ArrayAddMode}) for an array field.
+     *
+     * An explicit `arrayUI.edit.addMode` decorator wins. Otherwise the mode defaults
+     * **by item shape** — the framework's opinion about which add affordance fits:
+     *
+     * - **primitive** item → {@link ArrayAddMode.QUICK_ADD} (type-and-commit a value).
+     * - **object with ≤ 1 prominent field** (string/number; e.g. checklist
+     *   `{ label, done }` — `label` is the only typed field) → `QUICK_ADD`. The single
+     *   typed field is staged in the add-row; the rest (booleans, enums) seed defaults.
+     * - **object with ≥ 2 prominent fields** → {@link ArrayAddMode.APPEND_INLINE}
+     *   (append a blank card and fill it in place — no single field summarises the item).
+     *
+     * {@link ArrayAddMode.DIALOG} is never auto-selected; it is opt-in for heavy items.
+     *
+     * @param arraySchema - the `z.array(...)` field schema (carries `arrayUI`).
+     * @param itemSchema - the array's item schema (drives the shape default).
+     */
+    static resolveArrayAddMode(arraySchema: z.ZodTypeAny, itemSchema: z.ZodTypeAny): ArrayAddMode;
     /**
      * Compute field visibility based on discriminated union configuration.
      *

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.d.ts.map

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

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.js

@@ -1,4 +1,4 @@
-import { FieldSchemaType, getFileMetadata, getEnumValues, getSchemaType, getZodObjectShape, getDiscriminatorParams, getZodDefArrayProperty, getZodDefProperty, getZodDefStringProperty, getZodType, isOptional, isZodArray, isZodObject, ValidationMode, ShowWhenOperator, getShowWhenParams, isFileSchema, unwrapSchema, } from '@wildo-ai/zod-decorators';
+import { FieldSchemaType, getFileMetadata, getEnumValues, getSchemaType, getObjectShape, getArrayUI, ArrayAddMode, getZodObjectShape, getDiscriminatorParams, getZodDefArrayProperty, getZodDefProperty, getZodDefStringProperty, getZodType, isOptional, isZodArray, isZodObject, ValidationMode, ShowWhenOperator, getShowWhenParams, isFileSchema, unwrapSchema, FileGenerationSource, } from '@wildo-ai/zod-decorators';
 export class AutomatedLayoutFrontendUtils {
     static buildUnsupportedPlainUnionFileFieldMessage(pathPrefix) {
         return `Unsupported z.union() file field schema detected at "${pathPrefix || '<root>'}". File fields inside non-discriminated unions must use z.discriminatedUnion().`;
@@ -241,6 +241,11 @@ export class AutomatedLayoutFrontendUtils {
     static collectFileFieldPaths(schema, pathPrefix = '') {
         return this.collectFileFieldMetadata(schema, pathPrefix).map((entry) => entry.fieldName);
     }
+    static collectUploadableFileFieldPaths(schema, pathPrefix = '') {
+        return this.collectFileFieldMetadata(schema, pathPrefix)
+            .filter((entry) => entry.fileMetadata.generation?.source !== FileGenerationSource.PDF_TEMPLATE)
+            .map((entry) => entry.fieldName);
+    }
     static resolveFieldSchemaPath(rootSchema, path) {
         if (!rootSchema) {
             return undefined;
@@ -324,7 +329,7 @@ export class AutomatedLayoutFrontendUtils {
     /**
      * Get a sensible default value for a given Zod schema type.
      *
-     * Used by form components (FormFieldArray, FormFieldRecord, etc.) when creating
+     * Used by form components (AutomatedArrayField, FormFieldRecord, etc.) when creating
      * new items/entries and a default value is needed.
      *
      * @param schema - The Zod schema to derive a default value from
@@ -349,7 +354,40 @@ export class AutomatedLayoutFrontendUtils {
                 const values = getEnumValues(schema);
                 return values.length > 0 ? values[0] : '';
             }
-            case FieldSchemaType.OBJECT:
+            case FieldSchemaType.OBJECT: {
+                // An OPTIONAL object field must stay `undefined`, NOT a fabricated `{ nested defaults }`.
+                // `.optional()` means "may be omitted", and backend logic legitimately distinguishes
+                // `undefined` (not configured) from `{}`/`{ …defaults }` (explicitly configured). Only a
+                // REQUIRED object (e.g. an array's item TYPE, like the checklist item) recurses to a
+                // complete default below. A `.default(...)` object also returns `undefined` here — Zod
+                // re-applies its default at parse time, so the value is still correct on submit, without
+                // this helper pre-fabricating one. (`isOptional` is true for both `.optional()` and
+                // `.default()`; primitive fields like `done: z.boolean()` never reach this OBJECT case,
+                // so the array-item `done: false` seed is unaffected.)
+                if (isOptional(schema)) {
+                    return undefined;
+                }
+                // Recurse into the object's fields so callers get a COMPLETE item default, not an
+                // empty `{}`. An empty object omits required-but-defaulted fields (e.g.
+                // `done: z.boolean().default(false)` on a checklist item), which makes a freshly
+                // added array item fail server validation on the whole-array autosave. Defaults are
+                // type-based (matching the primitives above). RECORD/MAP have no fixed shape, so they
+                // stay `{}`. (Surfaced by the read-inline array editor — array-element-authoring Step 4.)
+                let shape;
+                try {
+                    shape = getZodObjectShape(unwrapSchema(schema));
+                }
+                catch {
+                    shape = undefined;
+                }
+                if (!shape)
+                    return {};
+                const result = {};
+                for (const [key, fieldSchema] of Object.entries(shape)) {
+                    result[key] = this.getDefaultValueForSchema(fieldSchema);
+                }
+                return result;
+            }
             case FieldSchemaType.RECORD:
             case FieldSchemaType.MAP:
                 return {};
@@ -360,6 +398,83 @@ export class AutomatedLayoutFrontendUtils {
         }
     }
     // =============================================================================
+    // ARRAY ADD-PATTERN RESOLUTION (quick-add primary field + add-mode default)
+    // =============================================================================
+    /**
+     * Resolve the PRIMARY field of an array item — the single value a user types to
+     * quick-add an entry (e.g. a checklist item's `label`).
+     *
+     * - **Primitive item** (`z.array(z.string())`, `z.array(z.number())`): the value
+     *   itself is the primary input, so `name` is `null` and `schema` is the item.
+     * - **Object item** (`z.array(z.object({ label, done }))`): the first STRING field
+     *   (label-like, the natural thing to type), else the first NUMBER field, else the
+     *   first field. Returned `name` is the object key; `schema` is that field's schema.
+     *
+     * Used by the quick-add row (form + read-inline) to render the staging input and
+     * to validate-before-add. Secondary fields (e.g. a `done` boolean) are seeded from
+     * {@link getDefaultValueForSchema} when the item is committed.
+     *
+     * @returns `{ name, schema }` — `name === null` means the item itself is the value.
+     */
+    static getArrayItemPrimaryField(itemSchema) {
+        const itemType = getSchemaType(itemSchema);
+        if (itemType !== FieldSchemaType.OBJECT) {
+            return { name: null, schema: itemSchema };
+        }
+        const shape = getObjectShape(itemSchema);
+        if (!shape) {
+            return { name: null, schema: itemSchema };
+        }
+        const entries = Object.entries(shape);
+        const stringEntry = entries.find(([, fieldSchema]) => getSchemaType(fieldSchema) === FieldSchemaType.STRING);
+        if (stringEntry) {
+            return { name: stringEntry[0], schema: stringEntry[1] };
+        }
+        const numberEntry = entries.find(([, fieldSchema]) => getSchemaType(fieldSchema) === FieldSchemaType.NUMBER);
+        if (numberEntry) {
+            return { name: numberEntry[0], schema: numberEntry[1] };
+        }
+        const first = entries[0];
+        return first ? { name: first[0], schema: first[1] } : { name: null, schema: itemSchema };
+    }
+    /**
+     * Resolve the add-pattern ({@link ArrayAddMode}) for an array field.
+     *
+     * An explicit `arrayUI.edit.addMode` decorator wins. Otherwise the mode defaults
+     * **by item shape** — the framework's opinion about which add affordance fits:
+     *
+     * - **primitive** item → {@link ArrayAddMode.QUICK_ADD} (type-and-commit a value).
+     * - **object with ≤ 1 prominent field** (string/number; e.g. checklist
+     *   `{ label, done }` — `label` is the only typed field) → `QUICK_ADD`. The single
+     *   typed field is staged in the add-row; the rest (booleans, enums) seed defaults.
+     * - **object with ≥ 2 prominent fields** → {@link ArrayAddMode.APPEND_INLINE}
+     *   (append a blank card and fill it in place — no single field summarises the item).
+     *
+     * {@link ArrayAddMode.DIALOG} is never auto-selected; it is opt-in for heavy items.
+     *
+     * @param arraySchema - the `z.array(...)` field schema (carries `arrayUI`).
+     * @param itemSchema - the array's item schema (drives the shape default).
+     */
+    static resolveArrayAddMode(arraySchema, itemSchema) {
+        const explicit = getArrayUI(arraySchema)?.edit?.addMode;
+        if (explicit) {
+            return explicit;
+        }
+        const itemType = getSchemaType(itemSchema);
+        if (itemType !== FieldSchemaType.OBJECT) {
+            return ArrayAddMode.QUICK_ADD;
+        }
+        const shape = getObjectShape(itemSchema);
+        if (!shape) {
+            return ArrayAddMode.APPEND_INLINE;
+        }
+        const prominentFieldCount = Object.values(shape).filter((fieldSchema) => {
+            const fieldType = getSchemaType(fieldSchema);
+            return fieldType === FieldSchemaType.STRING || fieldType === FieldSchemaType.NUMBER;
+        }).length;
+        return prominentFieldCount <= 1 ? ArrayAddMode.QUICK_ADD : ArrayAddMode.APPEND_INLINE;
+    }
+    // =============================================================================
     // CONDITIONAL VISIBILITY — DISCRIMINATED UNIONS
     // =============================================================================
     /**
@@ -468,7 +583,17 @@ export class AutomatedLayoutFrontendUtils {
         if (!inheritanceConfig.inheritedSchemas) {
             return variantOnlyFields;
         }
-        const baseShape = getZodObjectShape(formSchema);
+        // `formSchema` is the resource's ROOT form schema. For an inherited
+        // (discriminated-union) resource that root IS the union, and object-only
+        // `getZodObjectShape` returns `undefined` on a union — which would leave
+        // `baseFieldKeys` empty and (wrongly) classify EVERY field as variant-only.
+        // The fields then collapse: `computeFieldVisibility` hides any "variant-only"
+        // field whose discriminator is a base value (`withoutInheritance…`), so a
+        // freshly-seeded base variant (e.g. todos `recurringType: one_time`) renders
+        // ZERO fields. Use the union-aware common view (`commonOnly: true` = keys
+        // present in EVERY variant) so the true base fields are recognised and only
+        // genuinely variant-specific fields are gated by the discriminator.
+        const baseShape = this.getObjectLikeFieldShape(formSchema, { commonOnly: true });
         const baseFieldKeys = baseShape ? new Set(Object.keys(baseShape)) : new Set();
         for (const variant of inheritanceConfig.inheritedSchemas) {
             const variantShape = getZodObjectShape(variant.schema);
@@ -509,7 +634,9 @@ export class AutomatedLayoutFrontendUtils {
      * Get list of visible field names based on current form values.
      */
     static getVisibleFieldNames(formSchema, formValues, inheritanceConfig) {
-        const shape = getZodObjectShape(formSchema);
+        // Union-aware: a discriminated-union root has no object shape, so use the
+        // merged variant view (every candidate field across variants).
+        const shape = this.getObjectLikeFieldShape(formSchema);
         if (!shape)
             return [];
         const allFieldNames = Object.keys(shape);
@@ -540,7 +667,9 @@ export class AutomatedLayoutFrontendUtils {
      * Get field names to exclude from validation.
      */
     static getHiddenFieldNames(formSchema, formValues, inheritanceConfig) {
-        const shape = getZodObjectShape(formSchema);
+        // Union-aware: a discriminated-union root has no object shape, so use the
+        // merged variant view (every candidate field across variants).
+        const shape = this.getObjectLikeFieldShape(formSchema);
         if (!shape)
             return [];
         if (!inheritanceConfig) {
@@ -571,7 +700,9 @@ export class AutomatedLayoutFrontendUtils {
      * Get required state for all fields in a schema.
      */
     static computeAllRequiredStates(formSchema, formValues, inheritanceConfig) {
-        const shape = getZodObjectShape(formSchema);
+        // Union-aware: a discriminated-union root has no object shape, so use the
+        // merged variant view (every candidate field across variants).
+        const shape = this.getObjectLikeFieldShape(formSchema);
         if (!shape)
             return {};
         const result = {};
@@ -581,4 +712,4 @@ export class AutomatedLayoutFrontendUtils {
         return result;
     }
 }
-//# sourceMappingURL=automated-layout.frontend.utils.js.map
+//# sourceMappingURL=automated-layout.frontend.utils.js.map