@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/companion-exports.d.ts

@@ -53,7 +53,8 @@ export { buildFrontendCompanionResourceUIBehavior, } from './core/runtime/fronte
 export type { FrontendCompanionExports, } from './core/companion/companion-exports.frontend.definitions';
 export type { FrontendModule } from './core/runtime/domain-module.frontend.definitions';
 export { defaultTheme } from './core/ui/themes/default.theme';
-export { FRONTEND_SCHEMA_KEY, } from './core/resources/resources.frontend.schemas';
+export { FRONTEND_DECLARED_SCHEMA_KEY, FRONTEND_SCHEMA_KEY, } from './core/resources/resources.frontend.schemas';
+export * from './core/resources/ui-behavior-presentation.frontend.utils';
 export type { LayoutRefManifest, ObjectShape, ResourceConfigLike, ResourceOperationFrontendConfig, ResourceUIBehaviorConfig, ResourceUIBehavior_EmptyState, ResourceUIBehavior_GuidanceFlow, } from './core/resources/resources.frontend.schemas';
 export { collectExecutionViewSurfaceRefsByOperation, collectOperationLikeViewRefs, } from './core/config/execution-view.schemas';
 export { collectFrontendChartRegistrationRefs, collectFrontendChartRegistrationRefsFromUIBehavior, } from './core/config/chart-view.frontend.schemas';

package/dist/esm/companion-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companion-exports.d.ts","sourceRoot":"","sources":["../../../src/companion-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AAEpG;;;;;;;;;GASG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,cAAc,GACf,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,YAAY,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACzF,YAAY,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,YAAY,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC/F,OAAO,EACL,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EAAE,oCAAoC,EAAE,MAAM,0DAA0D,CAAC;AACrH,OAAO,EACL,wCAAwC,GACzC,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EACV,wBAAwB,GACzB,MAAM,yDAAyD,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAc9D,OAAO,EACL,mBAAmB,GACpB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,0CAA0C,EAC1C,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oCAAoC,EACpC,kDAAkD,GACnD,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"companion-exports.d.ts","sourceRoot":"","sources":["../../../src/companion-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AAEpG;;;;;;;;;GASG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,cAAc,GACf,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,YAAY,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACzF,YAAY,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,YAAY,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC/F,OAAO,EACL,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EAAE,oCAAoC,EAAE,MAAM,0DAA0D,CAAC;AACrH,OAAO,EACL,wCAAwC,GACzC,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EACV,wBAAwB,GACzB,MAAM,yDAAyD,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAc9D,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,6CAA6C,CAAC;AACrD,cAAc,0DAA0D,CAAC;AACzE,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,0CAA0C,EAC1C,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oCAAoC,EACpC,kDAAkD,GACnD,MAAM,2CAA2C,CAAC"}

package/dist/esm/companion-exports.js

@@ -54,7 +54,8 @@ export { defaultTheme } from './core/ui/themes/default.theme.js';
  * repair documented as residual risk). See
  * `.cursor/plans/non-view-specification-coverage-step9-spec-infrastructure-hardening.md`.
  */
-export { FRONTEND_SCHEMA_KEY, } from './core/resources/resources.frontend.schemas.js';
+export { FRONTEND_DECLARED_SCHEMA_KEY, FRONTEND_SCHEMA_KEY, } from './core/resources/resources.frontend.schemas.js';
+export * from './core/resources/ui-behavior-presentation.frontend.utils.js';
 export { collectExecutionViewSurfaceRefsByOperation, collectOperationLikeViewRefs, } from './core/config/execution-view.schemas.js';
 export { collectFrontendChartRegistrationRefs, collectFrontendChartRegistrationRefsFromUIBehavior, } from './core/config/chart-view.frontend.schemas.js';
 //# sourceMappingURL=companion-exports.js.map

package/dist/esm/companion-exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"companion-exports.js","sourceRoot":"","sources":["../../../src/companion-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAQH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AAEpG;;;;;;;;;GASG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAYxF,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AAKvD,OAAO,EACL,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EACL,wCAAwC,GACzC,MAAM,mDAAmD,CAAC;AAK3D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,OAAO,EACL,mBAAmB,GACpB,MAAM,6CAA6C,CAAC;AAUrD,OAAO,EACL,0CAA0C,EAC1C,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oCAAoC,EACpC,kDAAkD,GACnD,MAAM,2CAA2C,CAAC","sourcesContent":["/**\n * Public companion surface for authored frontend configuration and module\n * definitions.\n *\n * Narrow entry point for config files, module definitions, and companion\n * tooling — keeps authored app code off the broad runtime/UI barrel.\n *\n * # Authoring / typing only — no runtime services\n *\n * Symbols in this barrel are companion-safe by construction: zero\n * React, zero `axios`, zero runtime services. Concretely, this means\n * Zod schemas, type aliases, enums, factory builders, and the small\n * handful of pure utilities the spec package + module-definition\n * files need at authoring time.\n *\n * Runtime services a companion subprocess needs to materialise the\n * authored configuration at runtime (HTTP client, repositories,\n * event bus, logger) live in the dedicated `/companion-runtime`\n * subpath (`companion-runtime-exports.ts`) — see that file's\n * top-level JSDoc for the rationale. Mixing the two surfaces would\n * collapse two semantically distinct concepts (authoring vs.\n * subprocess bootstrap) into one, and silently invite future\n * runtime helpers to land here too — exactly the framework-mindset\n * failure mode `design-philosophy.mdc` warns against.\n */\n\nexport type {\n  AppConfiguration_Frontend,\n  ErrorPageConfig,\n  QuickSwitcherScopeField,\n  ShellModuleContributions,\n} from './core/config/app-configuration-frontend.schemas';\nexport {\n  CommandBarPolicy,\n  ErrorPageActionType,\n  QuickSwitcherFieldPresentation,\n  UserDropdownAvatarDisplay,\n  UserDropdownSection,\n} from './core/config/app-configuration-frontend.schemas';\nexport { ApplicationLevelComponentType } from './core/config/app-level-components.frontend.schemas';\n\n/**\n * The settings destination catalog, for companion tooling that has to reason\n * about what an application PLACED.\n *\n * Companion-safe by construction: a pure const array, an enum and interfaces —\n * no React, no axios, no runtime services. Needed here because a placement names\n * only a `destinationRef`; anything that must walk what that destination\n * CONTAINS (its sub-tabs, for label generation) has to resolve the ref against\n * this catalog.\n */\nexport { ENGINE_SETTINGS_DESTINATIONS } from './core/config/engine-settings-destinations';\nexport { SettingsSectionTargetKind } from './core/config/settings-hub.frontend.schemas';\nexport type {\n  SettingsDestination,\n  SettingsPlacement,\n  SettingsHubConfig,\n} from './core/config/settings-hub.frontend.schemas';\nexport type {\n  CommandMenuCommand,\n  MenubarLauncherItem,\n  SidebarItem,\n  SidebarSection,\n} from './core/config/launcher-items.frontend.schemas';\nexport {\n  ENGINE_PAGE_METADATA,\n  EnginePageRef,\n  LauncherItemTargetKind,\n  SidebarHomeDisplayMode,\n  SidebarResponsivePolicy,\n  SidebarSectionBehavior,\n  SidebarSectionContentKind,\n  SidebarSectionInlineCreate,\n  HostedTriggerAppearance,\n} from './core/config/launcher-items.frontend.schemas';\nexport type { AppCompositeViewsConfig } from './core/config/composite-view.schemas';\nexport type { FlowsActorsViewDefinition } from './core/config/flows-actors-view.schemas';\nexport type { FullCustomViewDefinition } from './core/config/full-custom-view.schemas';\nexport type { OnboardingViewDefinition } from './core/config/onboarding-view.frontend.schemas';\nexport {\n  FrontendView_ScopeMode,\n} from './core/config/views-frontend.schemas';\nexport {\n  BILLING_COMMAND_MENU_ITEM,\n  BILLING_SETTINGS_SECTION_REF,\n} from './core/billing/billing-launcher';\nexport type {\n  AnyFrontendResourceConfiguration,\n  ResourceUIBehavior,\n} from './core/resources/resources.frontend.schemas';\nexport type { FrontendConfigFactory_HomeDefinition } from './core/runtime/app-config-overrides.frontend.definitions';\nexport {\n  buildFrontendCompanionResourceUIBehavior,\n} from './core/runtime/frontend-companion-resource-inputs';\nexport type {\n  FrontendCompanionExports,\n} from './core/companion/companion-exports.frontend.definitions';\nexport type { FrontendModule } from './core/runtime/domain-module.frontend.definitions';\nexport { defaultTheme } from './core/ui/themes/default.theme';\n\n/*\n * ── Schema-authoring surface consumed by `@wildo-ai/saas-specifications` ────\n *\n * Companion-safe symbols (Zod schemas + framework type aliases, no React /\n * runtime UI deps) re-exported so the spec package can narrow its import\n * surface from the broad `@wildo-ai/saas-frontend-lib` root barrel to this\n * dedicated `/companion` subpath. Adding a symbol to the root barrel that\n * transitively pulls React / runtime UI deps would otherwise silently\n * widen the spec package's dependency footprint (the failure mode the SSO\n * repair documented as residual risk). See\n * `.cursor/plans/non-view-specification-coverage-step9-spec-infrastructure-hardening.md`.\n */\nexport {\n  FRONTEND_SCHEMA_KEY,\n} from './core/resources/resources.frontend.schemas';\nexport type {\n  LayoutRefManifest,\n  ObjectShape,\n  ResourceConfigLike,\n  ResourceOperationFrontendConfig,\n  ResourceUIBehaviorConfig,\n  ResourceUIBehavior_EmptyState,\n  ResourceUIBehavior_GuidanceFlow,\n} from './core/resources/resources.frontend.schemas';\nexport {\n  collectExecutionViewSurfaceRefsByOperation,\n  collectOperationLikeViewRefs,\n} from './core/config/execution-view.schemas';\nexport {\n  collectFrontendChartRegistrationRefs,\n  collectFrontendChartRegistrationRefsFromUIBehavior,\n} from './core/config/chart-view.frontend.schemas';\n"]}
+{"version":3,"file":"companion-exports.js","sourceRoot":"","sources":["../../../src/companion-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAQH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AAEpG;;;;;;;;;GASG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAYxF,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AAKvD,OAAO,EACL,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EACL,wCAAwC,GACzC,MAAM,mDAAmD,CAAC;AAK3D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,6CAA6C,CAAC;AACrD,cAAc,0DAA0D,CAAC;AAUzE,OAAO,EACL,0CAA0C,EAC1C,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oCAAoC,EACpC,kDAAkD,GACnD,MAAM,2CAA2C,CAAC","sourcesContent":["/**\n * Public companion surface for authored frontend configuration and module\n * definitions.\n *\n * Narrow entry point for config files, module definitions, and companion\n * tooling — keeps authored app code off the broad runtime/UI barrel.\n *\n * # Authoring / typing only — no runtime services\n *\n * Symbols in this barrel are companion-safe by construction: zero\n * React, zero `axios`, zero runtime services. Concretely, this means\n * Zod schemas, type aliases, enums, factory builders, and the small\n * handful of pure utilities the spec package + module-definition\n * files need at authoring time.\n *\n * Runtime services a companion subprocess needs to materialise the\n * authored configuration at runtime (HTTP client, repositories,\n * event bus, logger) live in the dedicated `/companion-runtime`\n * subpath (`companion-runtime-exports.ts`) — see that file's\n * top-level JSDoc for the rationale. Mixing the two surfaces would\n * collapse two semantically distinct concepts (authoring vs.\n * subprocess bootstrap) into one, and silently invite future\n * runtime helpers to land here too — exactly the framework-mindset\n * failure mode `design-philosophy.mdc` warns against.\n */\n\nexport type {\n  AppConfiguration_Frontend,\n  ErrorPageConfig,\n  QuickSwitcherScopeField,\n  ShellModuleContributions,\n} from './core/config/app-configuration-frontend.schemas';\nexport {\n  CommandBarPolicy,\n  ErrorPageActionType,\n  QuickSwitcherFieldPresentation,\n  UserDropdownAvatarDisplay,\n  UserDropdownSection,\n} from './core/config/app-configuration-frontend.schemas';\nexport { ApplicationLevelComponentType } from './core/config/app-level-components.frontend.schemas';\n\n/**\n * The settings destination catalog, for companion tooling that has to reason\n * about what an application PLACED.\n *\n * Companion-safe by construction: a pure const array, an enum and interfaces —\n * no React, no axios, no runtime services. Needed here because a placement names\n * only a `destinationRef`; anything that must walk what that destination\n * CONTAINS (its sub-tabs, for label generation) has to resolve the ref against\n * this catalog.\n */\nexport { ENGINE_SETTINGS_DESTINATIONS } from './core/config/engine-settings-destinations';\nexport { SettingsSectionTargetKind } from './core/config/settings-hub.frontend.schemas';\nexport type {\n  SettingsDestination,\n  SettingsPlacement,\n  SettingsHubConfig,\n} from './core/config/settings-hub.frontend.schemas';\nexport type {\n  CommandMenuCommand,\n  MenubarLauncherItem,\n  SidebarItem,\n  SidebarSection,\n} from './core/config/launcher-items.frontend.schemas';\nexport {\n  ENGINE_PAGE_METADATA,\n  EnginePageRef,\n  LauncherItemTargetKind,\n  SidebarHomeDisplayMode,\n  SidebarResponsivePolicy,\n  SidebarSectionBehavior,\n  SidebarSectionContentKind,\n  SidebarSectionInlineCreate,\n  HostedTriggerAppearance,\n} from './core/config/launcher-items.frontend.schemas';\nexport type { AppCompositeViewsConfig } from './core/config/composite-view.schemas';\nexport type { FlowsActorsViewDefinition } from './core/config/flows-actors-view.schemas';\nexport type { FullCustomViewDefinition } from './core/config/full-custom-view.schemas';\nexport type { OnboardingViewDefinition } from './core/config/onboarding-view.frontend.schemas';\nexport {\n  FrontendView_ScopeMode,\n} from './core/config/views-frontend.schemas';\nexport {\n  BILLING_COMMAND_MENU_ITEM,\n  BILLING_SETTINGS_SECTION_REF,\n} from './core/billing/billing-launcher';\nexport type {\n  AnyFrontendResourceConfiguration,\n  ResourceUIBehavior,\n} from './core/resources/resources.frontend.schemas';\nexport type { FrontendConfigFactory_HomeDefinition } from './core/runtime/app-config-overrides.frontend.definitions';\nexport {\n  buildFrontendCompanionResourceUIBehavior,\n} from './core/runtime/frontend-companion-resource-inputs';\nexport type {\n  FrontendCompanionExports,\n} from './core/companion/companion-exports.frontend.definitions';\nexport type { FrontendModule } from './core/runtime/domain-module.frontend.definitions';\nexport { defaultTheme } from './core/ui/themes/default.theme';\n\n/*\n * ── Schema-authoring surface consumed by `@wildo-ai/saas-specifications` ────\n *\n * Companion-safe symbols (Zod schemas + framework type aliases, no React /\n * runtime UI deps) re-exported so the spec package can narrow its import\n * surface from the broad `@wildo-ai/saas-frontend-lib` root barrel to this\n * dedicated `/companion` subpath. Adding a symbol to the root barrel that\n * transitively pulls React / runtime UI deps would otherwise silently\n * widen the spec package's dependency footprint (the failure mode the SSO\n * repair documented as residual risk). See\n * `.cursor/plans/non-view-specification-coverage-step9-spec-infrastructure-hardening.md`.\n */\nexport {\n  FRONTEND_DECLARED_SCHEMA_KEY,\n  FRONTEND_SCHEMA_KEY,\n} from './core/resources/resources.frontend.schemas';\nexport * from './core/resources/ui-behavior-presentation.frontend.utils';\nexport type {\n  LayoutRefManifest,\n  ObjectShape,\n  ResourceConfigLike,\n  ResourceOperationFrontendConfig,\n  ResourceUIBehaviorConfig,\n  ResourceUIBehavior_EmptyState,\n  ResourceUIBehavior_GuidanceFlow,\n} from './core/resources/resources.frontend.schemas';\nexport {\n  collectExecutionViewSurfaceRefsByOperation,\n  collectOperationLikeViewRefs,\n} from './core/config/execution-view.schemas';\nexport {\n  collectFrontendChartRegistrationRefs,\n  collectFrontendChartRegistrationRefsFromUIBehavior,\n} from './core/config/chart-view.frontend.schemas';\n"]}

package/dist/esm/components/actions/action-bar.d.ts

@@ -35,7 +35,11 @@ export interface ActionBarButtonPopover {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     content: React.ReactNode;
-    /** Accessible name for the panel. Falls back to the action's own label. */
+    /**
+     * The panel's title: shown as its heading and used as its accessible name, so a form opened from an icon button
+     * still says on screen which action it performs (#2058). A LIST panel, a menu named by its trigger, uses it as the
+     * accessible name only. Falls back to the action's own label.
+     */
     title?: string;
     /** What the body is — see {@link ActionBarPopoverChrome}. Omitted means PANEL. */
     chrome?: ActionBarPopoverChrome;
@@ -107,6 +111,40 @@ export interface ActionBarSubGroup {
     operationIdentifier?: string;
 }
 export type ActionBarItem = ActionBarButton | ActionBarSeparator | ActionBarSubGroup;
+/**
+ * Is this item an action that cannot run right now: refused (`unavailability`) or disabled?
+ *
+ * A RUNNING action (`busy`) is not refused: it is the action in progress, and it keeps its place and its look. A
+ * separator is not an action. The bar asks this twice, with one answer: whether to draw the item's authored emphasis
+ * (`resolveDrawnActionVariant`), and which items get the bar's direct slots when it overflows
+ * (`allocateActionBarSlots`).
+ */
+export declare function actionBarItemCannotRun(item: ActionBarItem): boolean;
+/**
+ * Which items a bar with `maxDisplayed` slots shows directly, and which go into its `…` menu.
+ *
+ * Priority alone used to decide (`items.slice(0, max)`), so an action that could not run kept a direct slot while
+ * one that could was pushed into the menu. Measured on Wonder Todos (2026-10-10): on a completed todo the header
+ * (3 slots) showed Edit, Set as one-time and a refused Change status, and hid Reopen, the one status verb that
+ * could run, behind `…`. Slots are the bar's scarce room, and an action someone can use should not have to be
+ * looked for behind one they cannot.
+ *
+ * So inside each GROUP (the runs of actions between separators), the slots that group held in the priority slice go
+ * first to its actions that can run, then to its refused ones, each in priority order; what is shown keeps the
+ * items' own order. A refused action in the menu still says why under its label.
+ *
+ * Reallocation never crosses a separator. A separator fences a group off on purpose, the action builder's
+ * PRIMARY | DANGER_ZONE split above all, and promoting a runnable Delete over a refused primary action would put the
+ * danger zone in the bar's direct slots without its fence. Because every group keeps exactly the number of slots it
+ * had, the separators stay where the priority slice put them and no slot is left empty.
+ *
+ * In both lists a separator that would lead, trail or follow another one is dropped: with nothing on one side it
+ * divides nothing. That applies whether or not anything was reallocated, so the two paths draw the same way.
+ */
+export declare function allocateActionBarSlots(items: ActionBarItem[], maxDisplayed: number): {
+    displayedItems: ActionBarItem[];
+    overflowItems: ActionBarItem[];
+};
 export interface ActionBarProps {
     items: ActionBarItem[];
     maxDisplayed?: number;
@@ -130,4 +168,10 @@ export interface ActionBarProps {
     className?: string;
 }
 export declare function ActionBar({ preset, ...props }: ActionBarProps & ComponentPresetProps): React.JSX.Element;
+/** Show emphasised items' words in the action bars inside (the record header's action cluster). */
+export declare function EmphasisedActionLabelsProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+/** True inside an {@link EmphasisedActionLabelsProvider}. */
+export declare function useEmphasisedActionLabels(): boolean;
 //# sourceMappingURL=action-bar.d.ts.map

package/dist/esm/components/actions/action-bar.d.ts.map

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

package/dist/esm/components/actions/action-bar.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
 import { createComponentResolver } from '../../core/components-registry/component-resolver.frontend.helper.js';
 import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
 // --- Contract ---
@@ -16,9 +17,92 @@ export var ActionBarPopoverChrome;
     /** An unpadded, menu-width panel for a list of options (a DROPDOWN action). */
     ActionBarPopoverChrome["LIST"] = "list";
 })(ActionBarPopoverChrome || (ActionBarPopoverChrome = {}));
+/**
+ * Is this item an action that cannot run right now: refused (`unavailability`) or disabled?
+ *
+ * A RUNNING action (`busy`) is not refused: it is the action in progress, and it keeps its place and its look. A
+ * separator is not an action. The bar asks this twice, with one answer: whether to draw the item's authored emphasis
+ * (`resolveDrawnActionVariant`), and which items get the bar's direct slots when it overflows
+ * (`allocateActionBarSlots`).
+ */
+export function actionBarItemCannotRun(item) {
+    if (item.type === "separator")
+        return false;
+    if (item.type === "subgroup")
+        return item.disabled === true;
+    return item.disabled === true || item.unavailability !== undefined;
+}
+/**
+ * Which items a bar with `maxDisplayed` slots shows directly, and which go into its `…` menu.
+ *
+ * Priority alone used to decide (`items.slice(0, max)`), so an action that could not run kept a direct slot while
+ * one that could was pushed into the menu. Measured on Wonder Todos (2026-10-10): on a completed todo the header
+ * (3 slots) showed Edit, Set as one-time and a refused Change status, and hid Reopen, the one status verb that
+ * could run, behind `…`. Slots are the bar's scarce room, and an action someone can use should not have to be
+ * looked for behind one they cannot.
+ *
+ * So inside each GROUP (the runs of actions between separators), the slots that group held in the priority slice go
+ * first to its actions that can run, then to its refused ones, each in priority order; what is shown keeps the
+ * items' own order. A refused action in the menu still says why under its label.
+ *
+ * Reallocation never crosses a separator. A separator fences a group off on purpose, the action builder's
+ * PRIMARY | DANGER_ZONE split above all, and promoting a runnable Delete over a refused primary action would put the
+ * danger zone in the bar's direct slots without its fence. Because every group keeps exactly the number of slots it
+ * had, the separators stay where the priority slice put them and no slot is left empty.
+ *
+ * In both lists a separator that would lead, trail or follow another one is dropped: with nothing on one side it
+ * divides nothing. That applies whether or not anything was reallocated, so the two paths draw the same way.
+ */
+export function allocateActionBarSlots(items, maxDisplayed) {
+    const inPrioritySlice = new Set(items.slice(0, maxDisplayed));
+    const shown = new Set();
+    let group = [];
+    const allocateGroup = () => {
+        const slots = group.filter((item) => inPrioritySlice.has(item)).length;
+        for (const item of [...group.filter((g) => !actionBarItemCannotRun(g)), ...group.filter(actionBarItemCannotRun)].slice(0, slots)) {
+            shown.add(item);
+        }
+        group = [];
+    };
+    for (const item of items) {
+        if (item.type === "separator") {
+            allocateGroup();
+            if (inPrioritySlice.has(item))
+                shown.add(item);
+        }
+        else {
+            group.push(item);
+        }
+    }
+    allocateGroup();
+    const tidy = (list) => list.filter((item, index) => item.type !== "separator"
+        || (index > 0 && index < list.length - 1 && list[index - 1].type !== "separator"));
+    return {
+        displayedItems: tidy(items.filter((item) => shown.has(item))),
+        overflowItems: tidy(items.filter((item) => !shown.has(item))),
+    };
+}
 // --- Wrapper ---
 export function ActionBar({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_ACTION_BAR, 'ActionBar')(preset);
     return _jsx(Component, { ...props });
 }
+/**
+ * Whether the action bars inside show an EMPHASISED item's words even in an icon-only (TOOLTIP) label mode.
+ *
+ * Scoped by a provider rather than applied to every bar, because it was decided for ONE place: the record
+ * header, where the main verb sits on the title line beside the record's name (Paul, 2026-09-30). There an
+ * emphasised bare icon — Wonder Todos' ACCENT "Change status" — read as a pressed toggle rather than as the
+ * thing a person came to do. Whether every icon-only bar should do the same is not decided; rows and bulk
+ * bars keep their authored label mode. See `isEmphasisButtonVariant` for what counts as emphasis.
+ */
+const EmphasisedActionLabelsContext = createContext(false);
+/** Show emphasised items' words in the action bars inside (the record header's action cluster). */
+export function EmphasisedActionLabelsProvider({ children }) {
+    return _jsx(EmphasisedActionLabelsContext.Provider, { value: true, children: children });
+}
+/** True inside an {@link EmphasisedActionLabelsProvider}. */
+export function useEmphasisedActionLabels() {
+    return useContext(EmphasisedActionLabelsContext);
+}
 //# sourceMappingURL=action-bar.js.map

package/dist/esm/components/actions/action-bar.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-bar.js","sourceRoot":"","sources":["../../../../../src/components/actions/action-bar.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAA0B,MAAM,qCAAqC,CAAA;AAOpH,mBAAmB;AAEnB;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,oEAAoE;IACpE,yCAAe,CAAA;IACf,+EAA+E;IAC/E,uCAAa,CAAA;AACf,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC;AAqHD,kBAAkB;AAClB,MAAM,UAAU,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAyC;IAC7G,MAAM,SAAS,GAAG,uBAAuB,CAAiB,qBAAqB,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1H,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames, ActionLabelDisplayMode } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { type ButtonVariants_Variant } from './button'\nimport { type ActionButtonSize } from './action-button'\nimport type { ResourceOperationRiskLevel } from '@wildo-ai/saas-models'\nimport type { DisplayDirection } from '@wildo-ai/zod-decorators'\n\n// --- Contract ---\n\n/**\n * What an anchored panel's BODY is, which decides the panel's own chrome.\n *\n * A form wants the panel's padding around it; a list of options wants none — a menu runs its rows\n * edge to edge, and padding around a command list draws a second frame inside the first. The body\n * knows which it is, so it says so rather than each renderer guessing from the content.\n */\nexport enum ActionBarPopoverChrome {\n  /** A padded panel for a form or other free content. The default. */\n  PANEL = 'panel',\n  /** An unpadded, menu-width panel for a list of options (a DROPDOWN action). */\n  LIST = 'list',\n}\n\n/**\n * An anchored panel this action opens instead of firing `onClick`.\n *\n * The bar owns the ANCHORING and nothing else: what goes in the panel is the caller's, which keeps\n * the bar free of any knowledge of resources, forms or operations.\n *\n * **A host that cannot anchor must fall back to `onClick`.** An item collapsed into the `…` overflow\n * menu or nested in a subgroup is already inside an open dropdown, and anchoring a second floating\n * layer to a row of the first is a nested-overlay problem with no good answer — the panel traps\n * focus the dropdown is still holding, and dismissing either one is ambiguous. Both are therefore\n * rendered as ordinary items, and `onClick` is expected to reach a host that CAN present the same\n * input (an overlay). An item carrying `popover` must always carry `onClick` too.\n */\nexport interface ActionBarButtonPopover {\n  open: boolean\n  onOpenChange: (open: boolean) => void\n  content: React.ReactNode\n  /** Accessible name for the panel. Falls back to the action's own label. */\n  title?: string\n  /** What the body is — see {@link ActionBarPopoverChrome}. Omitted means PANEL. */\n  chrome?: ActionBarPopoverChrome\n}\n\n/**\n * Why an action cannot run right now, and — when there is one — the single step that makes it\n * runnable.\n *\n * An unavailable action stays FOCUSABLE (`aria-disabled`, not the native `disabled`, which removes it\n * from the tab order and swallows the click), and activating it opens a panel that says why. A greyed\n * button that explains nothing is the pattern this replaces: the person cannot tell \"not allowed\"\n * from \"not applicable to these rows\" from \"broken\", and a keyboard or screen-reader user cannot even\n * reach it to wonder.\n *\n * `resolve` exists for the case where the fix is one click away — a bulk action that 2 of 5 selected\n * rows do not qualify for offers \"Keep only the 3 eligible\". It never runs the action itself: the\n * person narrows, looks, and then acts.\n */\nexport interface ActionBarUnavailability {\n  /** Localized, specific reason — never a generic \"not available\". */\n  reason: string\n  resolve?: { label: string; onSelect: () => void }\n}\n\nexport interface ActionBarButton {\n  type?: \"button\"\n  icon: React.ReactNode\n  label: string\n  onClick?: () => void\n  variant?: ButtonVariants_Variant\n  disabled?: boolean\n  /**\n   * Set instead of `disabled` when the host can say WHY — see {@link ActionBarUnavailability}.\n   * `disabled` without a reason remains for states that genuinely have none to give (an action\n   * already running).\n   */\n  unavailability?: ActionBarUnavailability\n  /** This action is RUNNING — shown in progress and not pressable again until it ends. */\n  busy?: boolean\n  className?: string\n  featureLocked?: boolean\n  featureAvailability?: Record<string, unknown>\n  /** Backend risk classification of the operation; lets a host (e.g. the danger\n   *  zone) pick risk-specific copy. Carried through, never rendered by ActionBar. */\n  riskLevel?: ResourceOperationRiskLevel\n  /** Operation identifier — lets a host resolve per-operation i18n, e.g.\n   *  `tResourceOperation(resourceType, operationIdentifier, 'description')`. */\n  operationIdentifier?: string\n  /**\n   * Render this action as an anchored panel rather than a plain button — see\n   * {@link ActionBarButtonPopover}, including when a host must ignore it.\n   */\n  popover?: ActionBarButtonPopover\n}\n\nexport interface ActionBarSeparator {\n  type: \"separator\"\n}\n\nexport interface ActionBarSubGroup {\n  type: \"subgroup\"\n  icon: React.ReactNode\n  label: string\n  items: ActionBarItem[]\n  variant?: ButtonVariants_Variant\n  disabled?: boolean\n  className?: string\n  riskLevel?: ResourceOperationRiskLevel\n  operationIdentifier?: string\n}\n\nexport type ActionBarItem = ActionBarButton | ActionBarSeparator | ActionBarSubGroup\n\nexport interface ActionBarProps {\n  items: ActionBarItem[]\n  maxDisplayed?: number\n  size?: ActionButtonSize\n  /**\n   * How the bar's actions render their labels. When omitted, the bar falls\n   * back to the app-wide default (`ComponentStyleTheme.actionLabelDisplayMode`\n   * via `useUI()`). `INLINE` renders label text inside each button; `TOOLTIP`\n   * keeps buttons icon-only with tooltip labels; `DROPDOWN` collapses every\n   * action into the `…` overflow menu (icon + label per row).\n   */\n  labelDisplayMode?: ActionLabelDisplayMode\n  /**\n   * Lay the buttons out as a horizontal row (default) or a vertical stack.\n   * Drives the toolbar's flex direction, `aria-orientation`, the inter-item\n   * separator axis, and the arrow-key navigation axis. Used e.g. by a card whose\n   * `cardActionPlacement.orientation` is `VERTICAL`.\n   */\n  orientation?: DisplayDirection\n  'aria-label'?: string\n  className?: string\n}\n\n// --- Wrapper ---\nexport function ActionBar({ preset = CorePresetNames.DEFAULT, ...props }: ActionBarProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ActionBarProps>(FrontendComponentType.LOW_LEVEL_ACTION_BAR, 'ActionBar')(preset)\n  return <Component {...props} />\n}\n"]}
+{"version":3,"file":"action-bar.js","sourceRoot":"","sources":["../../../../../src/components/actions/action-bar.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { createContext, useContext } from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames, ActionLabelDisplayMode } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { type ButtonVariants_Variant } from './button'\nimport { type ActionButtonSize } from './action-button'\nimport type { ResourceOperationRiskLevel } from '@wildo-ai/saas-models'\nimport type { DisplayDirection } from '@wildo-ai/zod-decorators'\n\n// --- Contract ---\n\n/**\n * What an anchored panel's BODY is, which decides the panel's own chrome.\n *\n * A form wants the panel's padding around it; a list of options wants none — a menu runs its rows\n * edge to edge, and padding around a command list draws a second frame inside the first. The body\n * knows which it is, so it says so rather than each renderer guessing from the content.\n */\nexport enum ActionBarPopoverChrome {\n  /** A padded panel for a form or other free content. The default. */\n  PANEL = 'panel',\n  /** An unpadded, menu-width panel for a list of options (a DROPDOWN action). */\n  LIST = 'list',\n}\n\n/**\n * An anchored panel this action opens instead of firing `onClick`.\n *\n * The bar owns the ANCHORING and nothing else: what goes in the panel is the caller's, which keeps\n * the bar free of any knowledge of resources, forms or operations.\n *\n * **A host that cannot anchor must fall back to `onClick`.** An item collapsed into the `…` overflow\n * menu or nested in a subgroup is already inside an open dropdown, and anchoring a second floating\n * layer to a row of the first is a nested-overlay problem with no good answer — the panel traps\n * focus the dropdown is still holding, and dismissing either one is ambiguous. Both are therefore\n * rendered as ordinary items, and `onClick` is expected to reach a host that CAN present the same\n * input (an overlay). An item carrying `popover` must always carry `onClick` too.\n */\nexport interface ActionBarButtonPopover {\n  open: boolean\n  onOpenChange: (open: boolean) => void\n  content: React.ReactNode\n  /**\n   * The panel's title: shown as its heading and used as its accessible name, so a form opened from an icon button\n   * still says on screen which action it performs (#2058). A LIST panel, a menu named by its trigger, uses it as the\n   * accessible name only. Falls back to the action's own label.\n   */\n  title?: string\n  /** What the body is — see {@link ActionBarPopoverChrome}. Omitted means PANEL. */\n  chrome?: ActionBarPopoverChrome\n}\n\n/**\n * Why an action cannot run right now, and — when there is one — the single step that makes it\n * runnable.\n *\n * An unavailable action stays FOCUSABLE (`aria-disabled`, not the native `disabled`, which removes it\n * from the tab order and swallows the click), and activating it opens a panel that says why. A greyed\n * button that explains nothing is the pattern this replaces: the person cannot tell \"not allowed\"\n * from \"not applicable to these rows\" from \"broken\", and a keyboard or screen-reader user cannot even\n * reach it to wonder.\n *\n * `resolve` exists for the case where the fix is one click away — a bulk action that 2 of 5 selected\n * rows do not qualify for offers \"Keep only the 3 eligible\". It never runs the action itself: the\n * person narrows, looks, and then acts.\n */\nexport interface ActionBarUnavailability {\n  /** Localized, specific reason — never a generic \"not available\". */\n  reason: string\n  resolve?: { label: string; onSelect: () => void }\n}\n\nexport interface ActionBarButton {\n  type?: \"button\"\n  icon: React.ReactNode\n  label: string\n  onClick?: () => void\n  variant?: ButtonVariants_Variant\n  disabled?: boolean\n  /**\n   * Set instead of `disabled` when the host can say WHY — see {@link ActionBarUnavailability}.\n   * `disabled` without a reason remains for states that genuinely have none to give (an action\n   * already running).\n   */\n  unavailability?: ActionBarUnavailability\n  /** This action is RUNNING — shown in progress and not pressable again until it ends. */\n  busy?: boolean\n  className?: string\n  featureLocked?: boolean\n  featureAvailability?: Record<string, unknown>\n  /** Backend risk classification of the operation; lets a host (e.g. the danger\n   *  zone) pick risk-specific copy. Carried through, never rendered by ActionBar. */\n  riskLevel?: ResourceOperationRiskLevel\n  /** Operation identifier — lets a host resolve per-operation i18n, e.g.\n   *  `tResourceOperation(resourceType, operationIdentifier, 'description')`. */\n  operationIdentifier?: string\n  /**\n   * Render this action as an anchored panel rather than a plain button — see\n   * {@link ActionBarButtonPopover}, including when a host must ignore it.\n   */\n  popover?: ActionBarButtonPopover\n}\n\nexport interface ActionBarSeparator {\n  type: \"separator\"\n}\n\nexport interface ActionBarSubGroup {\n  type: \"subgroup\"\n  icon: React.ReactNode\n  label: string\n  items: ActionBarItem[]\n  variant?: ButtonVariants_Variant\n  disabled?: boolean\n  className?: string\n  riskLevel?: ResourceOperationRiskLevel\n  operationIdentifier?: string\n}\n\nexport type ActionBarItem = ActionBarButton | ActionBarSeparator | ActionBarSubGroup\n\n/**\n * Is this item an action that cannot run right now: refused (`unavailability`) or disabled?\n *\n * A RUNNING action (`busy`) is not refused: it is the action in progress, and it keeps its place and its look. A\n * separator is not an action. The bar asks this twice, with one answer: whether to draw the item's authored emphasis\n * (`resolveDrawnActionVariant`), and which items get the bar's direct slots when it overflows\n * (`allocateActionBarSlots`).\n */\nexport function actionBarItemCannotRun(item: ActionBarItem): boolean {\n  if (item.type === \"separator\") return false\n  if (item.type === \"subgroup\") return item.disabled === true\n  return item.disabled === true || item.unavailability !== undefined\n}\n\n/**\n * Which items a bar with `maxDisplayed` slots shows directly, and which go into its `…` menu.\n *\n * Priority alone used to decide (`items.slice(0, max)`), so an action that could not run kept a direct slot while\n * one that could was pushed into the menu. Measured on Wonder Todos (2026-10-10): on a completed todo the header\n * (3 slots) showed Edit, Set as one-time and a refused Change status, and hid Reopen, the one status verb that\n * could run, behind `…`. Slots are the bar's scarce room, and an action someone can use should not have to be\n * looked for behind one they cannot.\n *\n * So inside each GROUP (the runs of actions between separators), the slots that group held in the priority slice go\n * first to its actions that can run, then to its refused ones, each in priority order; what is shown keeps the\n * items' own order. A refused action in the menu still says why under its label.\n *\n * Reallocation never crosses a separator. A separator fences a group off on purpose, the action builder's\n * PRIMARY | DANGER_ZONE split above all, and promoting a runnable Delete over a refused primary action would put the\n * danger zone in the bar's direct slots without its fence. Because every group keeps exactly the number of slots it\n * had, the separators stay where the priority slice put them and no slot is left empty.\n *\n * In both lists a separator that would lead, trail or follow another one is dropped: with nothing on one side it\n * divides nothing. That applies whether or not anything was reallocated, so the two paths draw the same way.\n */\nexport function allocateActionBarSlots(\n  items: ActionBarItem[],\n  maxDisplayed: number,\n): { displayedItems: ActionBarItem[]; overflowItems: ActionBarItem[] } {\n  const inPrioritySlice = new Set(items.slice(0, maxDisplayed))\n  const shown = new Set<ActionBarItem>()\n  let group: ActionBarItem[] = []\n  const allocateGroup = (): void => {\n    const slots = group.filter((item) => inPrioritySlice.has(item)).length\n    for (const item of [...group.filter((g) => !actionBarItemCannotRun(g)), ...group.filter(actionBarItemCannotRun)].slice(0, slots)) {\n      shown.add(item)\n    }\n    group = []\n  }\n  for (const item of items) {\n    if (item.type === \"separator\") {\n      allocateGroup()\n      if (inPrioritySlice.has(item)) shown.add(item)\n    } else {\n      group.push(item)\n    }\n  }\n  allocateGroup()\n\n  const tidy = (list: ActionBarItem[]): ActionBarItem[] => list.filter((item, index) => item.type !== \"separator\"\n    || (index > 0 && index < list.length - 1 && list[index - 1]!.type !== \"separator\"))\n  return {\n    displayedItems: tidy(items.filter((item) => shown.has(item))),\n    overflowItems: tidy(items.filter((item) => !shown.has(item))),\n  }\n}\n\nexport interface ActionBarProps {\n  items: ActionBarItem[]\n  maxDisplayed?: number\n  size?: ActionButtonSize\n  /**\n   * How the bar's actions render their labels. When omitted, the bar falls\n   * back to the app-wide default (`ComponentStyleTheme.actionLabelDisplayMode`\n   * via `useUI()`). `INLINE` renders label text inside each button; `TOOLTIP`\n   * keeps buttons icon-only with tooltip labels; `DROPDOWN` collapses every\n   * action into the `…` overflow menu (icon + label per row).\n   */\n  labelDisplayMode?: ActionLabelDisplayMode\n  /**\n   * Lay the buttons out as a horizontal row (default) or a vertical stack.\n   * Drives the toolbar's flex direction, `aria-orientation`, the inter-item\n   * separator axis, and the arrow-key navigation axis. Used e.g. by a card whose\n   * `cardActionPlacement.orientation` is `VERTICAL`.\n   */\n  orientation?: DisplayDirection\n  'aria-label'?: string\n  className?: string\n}\n\n// --- Wrapper ---\nexport function ActionBar({ preset = CorePresetNames.DEFAULT, ...props }: ActionBarProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ActionBarProps>(FrontendComponentType.LOW_LEVEL_ACTION_BAR, 'ActionBar')(preset)\n  return <Component {...props} />\n}\n\n/**\n * Whether the action bars inside show an EMPHASISED item's words even in an icon-only (TOOLTIP) label mode.\n *\n * Scoped by a provider rather than applied to every bar, because it was decided for ONE place: the record\n * header, where the main verb sits on the title line beside the record's name (Paul, 2026-09-30). There an\n * emphasised bare icon — Wonder Todos' ACCENT \"Change status\" — read as a pressed toggle rather than as the\n * thing a person came to do. Whether every icon-only bar should do the same is not decided; rows and bulk\n * bars keep their authored label mode. See `isEmphasisButtonVariant` for what counts as emphasis.\n */\nconst EmphasisedActionLabelsContext = createContext(false)\n\n/** Show emphasised items' words in the action bars inside (the record header's action cluster). */\nexport function EmphasisedActionLabelsProvider({ children }: { children: React.ReactNode }): React.JSX.Element {\n  return <EmphasisedActionLabelsContext.Provider value>{children}</EmphasisedActionLabelsContext.Provider>\n}\n\n/** True inside an {@link EmphasisedActionLabelsProvider}. */\nexport function useEmphasisedActionLabels(): boolean {\n  return useContext(EmphasisedActionLabelsContext)\n}\n"]}

package/dist/esm/components/actions/button.d.ts

@@ -11,6 +11,28 @@ export declare enum ButtonVariants_Variant {
     LINK = "link",
     ACCENT = "accent"
 }
+/** Is this variant one an author picks to make an action stand out? See {@link EMPHASIS_BUTTON_VARIANTS}. */
+export declare function isEmphasisButtonVariant(variant: ButtonVariants_Variant | string | null | undefined): boolean;
+/**
+ * The variant an action is DRAWN with: its authored one, unless it is emphasis on an action that cannot run.
+ *
+ * Emphasis says "this is the verb you came for", and an action that cannot run cannot be that verb. Measured on
+ * Wonder Todos (2026-10-10): on a completed todo the header's ACCENT "Change status" kept its fill, gradient and
+ * glow at half opacity. It still looked like the main button and was refused on click, and the faded gradient
+ * under a dark label read as a rendering fault rather than as "not available". A refused emphasised action is
+ * therefore drawn as an ordinary (GHOST) one: Material 3 and Apple's HIG both show a disabled filled button with a
+ * neutral fill rather than a faded brand colour.
+ *
+ * Only EMPHASIS is withdrawn. DESTRUCTIVE is a risk colour the bar derives on its own, and it stays: a dangerous
+ * action that cannot run now is still dangerous. A RUNNING action (`busy`) is not refused, so callers pass
+ * `cannotRun` only for a refusal (a condition not met, a feature locked, a selection too large) and never for
+ * "in progress".
+ *
+ * The WORDS are a separate decision. The record header labels an emphasised item by its AUTHORED variant
+ * (`EmphasisedActionLabelsProvider`), so a refused main verb keeps its label: the header does not reflow when the
+ * record changes state under it, and the person can still read what is refused and open the reason.
+ */
+export declare function resolveDrawnActionVariant(variant: ButtonVariants_Variant | undefined, cannotRun: boolean): ButtonVariants_Variant | undefined;
 /**
  * What a button does with a label longer than one line.
  */

package/dist/esm/components/actions/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../../../src/components/actions/button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AAC1H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAoC,MAAM,oEAAoE,CAAA;AAGhJ,oBAAY,sBAAsB;IAChC,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,4GAA4G;IAC5G,MAAM,WAAW;IACjB;;;;OAIG;IACH,IAAI,SAAS;CACd;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG;IACzD,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gDAAgD;IAChD,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC,CAAA;AACD,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAA;AAEzC,4EAA4E;AAC5E,eAAO,MAAM,oCAAoC;;;CAGI,CAAA;AAGrD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,oBAAoB,CAAA;AAEnE,eAAO,MAAM,MAAM,2GAKlB,CAAA"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../../../src/components/actions/button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AAC1H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAoC,MAAM,oEAAoE,CAAA;AAGhJ,oBAAY,sBAAsB;IAChC,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAsBD,6GAA6G;AAC7G,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5G;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,GAAG,SAAS,EAC3C,SAAS,EAAE,OAAO,GACjB,sBAAsB,GAAG,SAAS,CAEpC;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,4GAA4G;IAC5G,MAAM,WAAW;IACjB;;;;OAIG;IACH,IAAI,SAAS;CACd;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG;IACzD,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gDAAgD;IAChD,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC,CAAA;AACD,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAA;AAEzC,4EAA4E;AAC5E,eAAO,MAAM,oCAAoC;;;CAGI,CAAA;AAGrD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,oBAAoB,CAAA;AAEnE,eAAO,MAAM,MAAM,2GAKlB,CAAA"}

package/dist/esm/components/actions/button.js

@@ -13,6 +13,51 @@ export var ButtonVariants_Variant;
     ButtonVariants_Variant["LINK"] = "link";
     ButtonVariants_Variant["ACCENT"] = "accent";
 })(ButtonVariants_Variant || (ButtonVariants_Variant = {}));
+/**
+ * The variants an author picks to make ONE action stand out from its neighbours: the filled primary,
+ * the filled secondary, and the accent.
+ *
+ * Emphasis is a claim that this is the verb a person came for, and a claim needs words. An
+ * emphasised button drawn as a bare icon reads as a STATE — a pressed toggle, an active mode —
+ * rather than as the main action: measured on Wonder Todos (2026-09-30), the todo header's ACCENT
+ * "Change status" rendered as a glowing circle beside plain icons and read as "something is on".
+ * So in the record header's action cluster an emphasised item shows its label whatever the bar's icon-only
+ * label mode says (`EmphasisedActionLabelsProvider`); elsewhere the authored mode stands.
+ *
+ * GHOST and OUTLINE are the ordinary, quiet looks; DESTRUCTIVE is a warning colour, not emphasis
+ * (a bar derives it from risk on its own); LINK is prose.
+ */
+const EMPHASIS_BUTTON_VARIANTS = new Set([
+    ButtonVariants_Variant.DEFAULT,
+    ButtonVariants_Variant.SECONDARY,
+    ButtonVariants_Variant.ACCENT,
+]);
+/** Is this variant one an author picks to make an action stand out? See {@link EMPHASIS_BUTTON_VARIANTS}. */
+export function isEmphasisButtonVariant(variant) {
+    return !!variant && EMPHASIS_BUTTON_VARIANTS.has(variant);
+}
+/**
+ * The variant an action is DRAWN with: its authored one, unless it is emphasis on an action that cannot run.
+ *
+ * Emphasis says "this is the verb you came for", and an action that cannot run cannot be that verb. Measured on
+ * Wonder Todos (2026-10-10): on a completed todo the header's ACCENT "Change status" kept its fill, gradient and
+ * glow at half opacity. It still looked like the main button and was refused on click, and the faded gradient
+ * under a dark label read as a rendering fault rather than as "not available". A refused emphasised action is
+ * therefore drawn as an ordinary (GHOST) one: Material 3 and Apple's HIG both show a disabled filled button with a
+ * neutral fill rather than a faded brand colour.
+ *
+ * Only EMPHASIS is withdrawn. DESTRUCTIVE is a risk colour the bar derives on its own, and it stays: a dangerous
+ * action that cannot run now is still dangerous. A RUNNING action (`busy`) is not refused, so callers pass
+ * `cannotRun` only for a refusal (a condition not met, a feature locked, a selection too large) and never for
+ * "in progress".
+ *
+ * The WORDS are a separate decision. The record header labels an emphasised item by its AUTHORED variant
+ * (`EmphasisedActionLabelsProvider`), so a refused main verb keeps its label: the header does not reflow when the
+ * record changes state under it, and the person can still read what is refused and open the reason.
+ */
+export function resolveDrawnActionVariant(variant, cannotRun) {
+    return cannotRun && isEmphasisButtonVariant(variant) ? ButtonVariants_Variant.GHOST : variant;
+}
 /**
  * What a button does with a label longer than one line.
  */

package/dist/esm/components/actions/button.js.map

@@ -1 +1 @@
-{"version":3,"file":"button.js","sourceRoot":"","sources":["../../../../../src/components/actions/button.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mEAAmE,CAAA;AAC3G,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AAI1H,mBAAmB;AACnB,MAAM,CAAN,IAAY,sBAQX;AARD,WAAY,sBAAsB;IAChC,6CAAmB,CAAA;IACnB,qDAA2B,CAAA;IAC3B,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,yCAAe,CAAA;IACf,uCAAa,CAAA;IACb,2CAAiB,CAAA;AACnB,CAAC,EARW,sBAAsB,KAAtB,sBAAsB,QAQjC;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,4GAA4G;IAC5G,wCAAiB,CAAA;IACjB;;;;OAIG;IACH,oCAAa,CAAA;AACf,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AAYD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,aAAa,EAAE,qBAAqB,CAAC,gBAAgB;IACrD,MAAM,EAAE,eAAe,CAAC,OAAO;CACoB,CAAA;AAKrD,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAC9B,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,uBAAuB,CAAc,qBAAqB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;IAChH,OAAO,KAAC,SAAS,IAAC,GAAG,EAAE,GAAG,KAAM,KAAK,GAAI,CAAA;AAC3C,CAAC,CACF,CAAA;AACD,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA","sourcesContent":["import React, { forwardRef } from 'react'\nimport { createComponentResolver } from '../../core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models/frontend-component-identities'\nimport type { ButtonSize } from '@wildo-ai/presets-components-models'\nimport type { ComponentPresetProps, ComponentRegistrationRequirement } from '../../core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\nexport enum ButtonVariants_Variant {\n  DEFAULT = 'default',\n  DESTRUCTIVE = 'destructive',\n  OUTLINE = 'outline',\n  SECONDARY = 'secondary',\n  GHOST = 'ghost',\n  LINK = 'link',\n  ACCENT = 'accent',\n}\n\n/**\n * What a button does with a label longer than one line.\n */\nexport enum ButtonLabelOverflow {\n  /** One line at the theme's fixed height — toolbars, dialogs, anything laid out around a known footprint. */\n  NOWRAP = 'nowrap',\n  /**\n   * The label wraps (breaking inside a long word when it must) and the button grows. The theme's height\n   * becomes a minimum, so a one-line label matches its siblings exactly. For choices whose TRANSLATED\n   * labels must never be cut, such as a sign-in method chooser.\n   */\n  WRAP = 'wrap',\n}\n\nexport type ButtonProps = React.ComponentProps<\"button\"> & {\n  variant?: ButtonVariants_Variant\n  size?: ButtonSize\n  asChild?: boolean\n  loading?: boolean\n  /** Defaults to `ButtonLabelOverflow.NOWRAP`. */\n  labelOverflow?: ButtonLabelOverflow\n}\nexport type ButtonRef = HTMLButtonElement\n\n/** Canonical default-button dependency declared by small frontend hosts. */\nexport const DEFAULT_BUTTON_COMPONENT_REQUIREMENT = {\n  componentType: FrontendComponentType.LOW_LEVEL_BUTTON,\n  preset: CorePresetNames.DEFAULT,\n} as const satisfies ComponentRegistrationRequirement\n\n// --- Wrapper ---\nexport type ButtonWrapperProps = ButtonProps & ComponentPresetProps\n\nexport const Button = forwardRef<HTMLButtonElement, ButtonWrapperProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n    const Component = createComponentResolver<ButtonProps>(FrontendComponentType.LOW_LEVEL_BUTTON, 'Button')(preset)\n    return <Component ref={ref} {...props} />\n  }\n)\nButton.displayName = 'Button'\n"]}
+{"version":3,"file":"button.js","sourceRoot":"","sources":["../../../../../src/components/actions/button.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mEAAmE,CAAA;AAC3G,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AAI1H,mBAAmB;AACnB,MAAM,CAAN,IAAY,sBAQX;AARD,WAAY,sBAAsB;IAChC,6CAAmB,CAAA;IACnB,qDAA2B,CAAA;IAC3B,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,yCAAe,CAAA;IACf,uCAAa,CAAA;IACb,2CAAiB,CAAA;AACnB,CAAC,EARW,sBAAsB,KAAtB,sBAAsB,QAQjC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAS;IACpE,sBAAsB,CAAC,OAAO;IAC9B,sBAAsB,CAAC,SAAS;IAChC,sBAAsB,CAAC,MAAM;CAC9B,CAAC,CAAC;AAEH,6GAA6G;AAC7G,MAAM,UAAU,uBAAuB,CAAC,OAA2D;IACjG,OAAO,CAAC,CAAC,OAAO,IAAI,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA2C,EAC3C,SAAkB;IAElB,OAAO,SAAS,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AAChG,CAAC;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,4GAA4G;IAC5G,wCAAiB,CAAA;IACjB;;;;OAIG;IACH,oCAAa,CAAA;AACf,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AAYD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,aAAa,EAAE,qBAAqB,CAAC,gBAAgB;IACrD,MAAM,EAAE,eAAe,CAAC,OAAO;CACoB,CAAA;AAKrD,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAC9B,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,uBAAuB,CAAc,qBAAqB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;IAChH,OAAO,KAAC,SAAS,IAAC,GAAG,EAAE,GAAG,KAAM,KAAK,GAAI,CAAA;AAC3C,CAAC,CACF,CAAA;AACD,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA","sourcesContent":["import React, { forwardRef } from 'react'\nimport { createComponentResolver } from '../../core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models/frontend-component-identities'\nimport type { ButtonSize } from '@wildo-ai/presets-components-models'\nimport type { ComponentPresetProps, ComponentRegistrationRequirement } from '../../core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\nexport enum ButtonVariants_Variant {\n  DEFAULT = 'default',\n  DESTRUCTIVE = 'destructive',\n  OUTLINE = 'outline',\n  SECONDARY = 'secondary',\n  GHOST = 'ghost',\n  LINK = 'link',\n  ACCENT = 'accent',\n}\n\n/**\n * The variants an author picks to make ONE action stand out from its neighbours: the filled primary,\n * the filled secondary, and the accent.\n *\n * Emphasis is a claim that this is the verb a person came for, and a claim needs words. An\n * emphasised button drawn as a bare icon reads as a STATE — a pressed toggle, an active mode —\n * rather than as the main action: measured on Wonder Todos (2026-09-30), the todo header's ACCENT\n * \"Change status\" rendered as a glowing circle beside plain icons and read as \"something is on\".\n * So in the record header's action cluster an emphasised item shows its label whatever the bar's icon-only\n * label mode says (`EmphasisedActionLabelsProvider`); elsewhere the authored mode stands.\n *\n * GHOST and OUTLINE are the ordinary, quiet looks; DESTRUCTIVE is a warning colour, not emphasis\n * (a bar derives it from risk on its own); LINK is prose.\n */\nconst EMPHASIS_BUTTON_VARIANTS: ReadonlySet<string> = new Set<string>([\n  ButtonVariants_Variant.DEFAULT,\n  ButtonVariants_Variant.SECONDARY,\n  ButtonVariants_Variant.ACCENT,\n]);\n\n/** Is this variant one an author picks to make an action stand out? See {@link EMPHASIS_BUTTON_VARIANTS}. */\nexport function isEmphasisButtonVariant(variant: ButtonVariants_Variant | string | null | undefined): boolean {\n  return !!variant && EMPHASIS_BUTTON_VARIANTS.has(variant);\n}\n\n/**\n * The variant an action is DRAWN with: its authored one, unless it is emphasis on an action that cannot run.\n *\n * Emphasis says \"this is the verb you came for\", and an action that cannot run cannot be that verb. Measured on\n * Wonder Todos (2026-10-10): on a completed todo the header's ACCENT \"Change status\" kept its fill, gradient and\n * glow at half opacity. It still looked like the main button and was refused on click, and the faded gradient\n * under a dark label read as a rendering fault rather than as \"not available\". A refused emphasised action is\n * therefore drawn as an ordinary (GHOST) one: Material 3 and Apple's HIG both show a disabled filled button with a\n * neutral fill rather than a faded brand colour.\n *\n * Only EMPHASIS is withdrawn. DESTRUCTIVE is a risk colour the bar derives on its own, and it stays: a dangerous\n * action that cannot run now is still dangerous. A RUNNING action (`busy`) is not refused, so callers pass\n * `cannotRun` only for a refusal (a condition not met, a feature locked, a selection too large) and never for\n * \"in progress\".\n *\n * The WORDS are a separate decision. The record header labels an emphasised item by its AUTHORED variant\n * (`EmphasisedActionLabelsProvider`), so a refused main verb keeps its label: the header does not reflow when the\n * record changes state under it, and the person can still read what is refused and open the reason.\n */\nexport function resolveDrawnActionVariant(\n  variant: ButtonVariants_Variant | undefined,\n  cannotRun: boolean,\n): ButtonVariants_Variant | undefined {\n  return cannotRun && isEmphasisButtonVariant(variant) ? ButtonVariants_Variant.GHOST : variant;\n}\n\n/**\n * What a button does with a label longer than one line.\n */\nexport enum ButtonLabelOverflow {\n  /** One line at the theme's fixed height — toolbars, dialogs, anything laid out around a known footprint. */\n  NOWRAP = 'nowrap',\n  /**\n   * The label wraps (breaking inside a long word when it must) and the button grows. The theme's height\n   * becomes a minimum, so a one-line label matches its siblings exactly. For choices whose TRANSLATED\n   * labels must never be cut, such as a sign-in method chooser.\n   */\n  WRAP = 'wrap',\n}\n\nexport type ButtonProps = React.ComponentProps<\"button\"> & {\n  variant?: ButtonVariants_Variant\n  size?: ButtonSize\n  asChild?: boolean\n  loading?: boolean\n  /** Defaults to `ButtonLabelOverflow.NOWRAP`. */\n  labelOverflow?: ButtonLabelOverflow\n}\nexport type ButtonRef = HTMLButtonElement\n\n/** Canonical default-button dependency declared by small frontend hosts. */\nexport const DEFAULT_BUTTON_COMPONENT_REQUIREMENT = {\n  componentType: FrontendComponentType.LOW_LEVEL_BUTTON,\n  preset: CorePresetNames.DEFAULT,\n} as const satisfies ComponentRegistrationRequirement\n\n// --- Wrapper ---\nexport type ButtonWrapperProps = ButtonProps & ComponentPresetProps\n\nexport const Button = forwardRef<HTMLButtonElement, ButtonWrapperProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n    const Component = createComponentResolver<ButtonProps>(FrontendComponentType.LOW_LEVEL_BUTTON, 'Button')(preset)\n    return <Component ref={ref} {...props} />\n  }\n)\nButton.displayName = 'Button'\n"]}

package/dist/esm/components/ai-elements/chat/conversation-thread.d.ts

@@ -0,0 +1,109 @@
+import React from 'react';
+import type { FlowsActors_ToolTraceData } from '@wildo-ai/saas-models';
+import type { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
+import type { ConversationThreadModel } from '../../../core/flows-actors/conversation-thread.model';
+/**
+ * The conversation THREAD (#2525): one registry-resolved surface that draws a conversation with an assistant for every
+ * host — the engine's `FlowsActorsView` and the creation workbench's stream — so a theme can replace it, not only
+ * recolour it, and the two hosts can no longer drift.
+ *
+ * It is PRESENTATIONAL. It draws a {@link ConversationThreadModel} the host derived with `conversationThreadModel`
+ * from the stored thread and the live turn; it reads no thread and sends nothing. What a host does that the engine
+ * does not — the workbench's run and coding-run cards, its interview, its own approval card — reaches it through the
+ * seams below, never through a second message renderer.
+ */
+export interface AI_ConversationThreadProps {
+    readonly model: ConversationThreadModel;
+    /** Shown when the thread has nothing to draw: no line, no turn in flight, no trailing content. */
+    readonly emptyState?: {
+        readonly title: string;
+        readonly description?: string;
+    };
+    /**
+     * Draws the decision a paused turn waits on. Default: the engine's approval card for that execution. A host with a
+     * richer card for its own tools (the workbench) supplies it here.
+     */
+    readonly renderApproval?: (executionId: string) => React.ReactNode;
+    /**
+     * The heading of a tool call's card, at any phase — what the call is ABOUT, never that it is running. Return
+     * `undefined` to keep the default: a resource read is named by the resource's authored title, a show-records call by
+     * what it is showing (while it runs) or tried to show (when it failed), any other tool by its name, an identifier no
+     * label tree words. A show-records call that SUCCEEDED is not a tool card at all: it is drawn as the records'
+     * cards, and this seam does not head it.
+     *
+     * Apart from {@link toolCallInProgress} on purpose (#2525 review M6): one seam for both handed a host's "Starting a
+     * step…" to every finished card, which then read as still running forever.
+     */
+    readonly toolCallTitle?: (trace: FlowsActors_ToolTraceData) => string | undefined;
+    /**
+     * The working line while a call is being made — what the turn is doing now. Return `undefined` to keep the default:
+     * "reading <resource>" for a resource read, "getting <resource> ready to show" for a show-records call, else a
+     * generic working line.
+     */
+    readonly toolCallInProgress?: (trace: FlowsActors_ToolTraceData) => string | undefined;
+    /**
+     * Replaces the line drawn for how the latest turn stands (stopped, failed, interrupted, working). Return `undefined`
+     * to keep the default for that state. For a host whose words for a turn's ending carry its own context.
+     */
+    readonly renderTurnState?: (model: ConversationThreadModel) => React.ReactNode | undefined;
+    /**
+     * The actions a host offers on an agent's STORED reply (#2842): drawn under each assistant line the conversation's
+     * record holds (`storedMessageId`), never under a reply still streaming, nor a person's message. The in-app view
+     * offers reporting the reply here. Absent, a reply carries no action.
+     */
+    readonly renderReplyActions?: (reply: {
+        readonly messageId: string;
+    }) => React.ReactNode;
+    /** Drawn after the latest turn: a host's own turn, such as the workbench's interview. */
+    readonly children?: React.ReactNode;
+    readonly className?: string;
+}
+/**
+ * The composer's own props, plus the form's attributes (a host's `data-*` hooks, its class). `onError` is omitted as
+ * the prompt input omits it: there it reports a refused attachment, not a DOM error event.
+ */
+export interface AI_ConversationThreadComposerProps extends Omit<React.HTMLAttributes<HTMLFormElement>, 'onSubmit' | 'onError' | 'children'> {
+    readonly placeholder: string;
+    /** A trimmed, non-blank message. The composer clears its field after it. */
+    readonly onSubmit: (text: string) => void;
+    /** Present while a turn can be stopped: Stop replaces Send. */
+    readonly onStop?: () => void;
+    /** Sending is not possible now (no assistant yet, a turn in flight). The field stays editable for the next message. */
+    readonly sendDisabled?: boolean;
+    /** The field itself takes no input (a host's own submission is being taken). */
+    readonly disabled?: boolean;
+    /** A submission is being taken: the send control shows it. */
+    readonly submitting?: boolean;
+    /** Drawn at the start of the composer's footer: a host's note, such as what an interview is asking about. */
+    readonly footerStart?: React.ReactNode;
+}
+/** One discussion in the list. An empty title is drawn as the untitled-discussion word, resolved at render. */
+export interface AI_ConversationThreadDiscussion {
+    readonly id: string;
+    readonly title: string;
+}
+export interface AI_ConversationThreadDiscussionsProps {
+    readonly discussions: readonly AI_ConversationThreadDiscussion[];
+    readonly currentId: string | null;
+    readonly onNew: () => void;
+    readonly onSelect: (id: string) => void;
+    /** Present when discussions can be deleted from the list. */
+    readonly onDelete?: (id: string) => void;
+    /** Present when older discussions remain to be read (#2528): the list offers to load them after its last row. */
+    readonly onLoadOlder?: () => void;
+    /** An older page is being read: the offer to load more shows it and waits. */
+    readonly loadingOlder?: boolean;
+    readonly className?: string;
+}
+export interface AI_ConversationThreadCompound {
+    (props: AI_ConversationThreadProps): React.JSX.Element;
+    Composer: React.FC<AI_ConversationThreadComposerProps>;
+    Discussions: React.FC<AI_ConversationThreadDiscussionsProps>;
+}
+/** The thread: its lines, how its latest turn stands, and scroll-to-latest. */
+export declare function AI_ConversationThread({ preset, ...props }: AI_ConversationThreadProps & ComponentPresetProps): React.JSX.Element;
+/** The composer, with Stop in place of Send while a turn can be stopped. */
+export declare function AI_ConversationThreadComposer({ preset, ...props }: AI_ConversationThreadComposerProps & ComponentPresetProps): React.JSX.Element;
+/** The list of discussions: start a new one, open one, delete one. */
+export declare function AI_ConversationThreadDiscussions({ preset, ...props }: AI_ConversationThreadDiscussionsProps & ComponentPresetProps): React.JSX.Element;
+//# sourceMappingURL=conversation-thread.d.ts.map

package/dist/esm/components/ai-elements/chat/conversation-thread.d.ts.map

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

package/dist/esm/components/ai-elements/chat/conversation-thread.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createCompoundComponentResolver } from '../../../core/components-registry/component-resolver.frontend.helper.js';
+import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
+// --- Resolver ---
+const resolve = createCompoundComponentResolver(FrontendComponentType.LOW_LEVEL_AI_CONVERSATION_THREAD, 'AI_ConversationThread', ['Composer', 'Discussions']);
+// --- Wrappers ---
+/** The thread: its lines, how its latest turn stands, and scroll-to-latest. */
+export function AI_ConversationThread({ preset = CorePresetNames.DEFAULT, ...props }) {
+    const C = resolve(preset);
+    return _jsx(C, { ...props });
+}
+/** The composer, with Stop in place of Send while a turn can be stopped. */
+export function AI_ConversationThreadComposer({ preset = CorePresetNames.DEFAULT, ...props }) {
+    const C = resolve(preset);
+    return _jsx(C.Composer, { ...props });
+}
+/** The list of discussions: start a new one, open one, delete one. */
+export function AI_ConversationThreadDiscussions({ preset = CorePresetNames.DEFAULT, ...props }) {
+    const C = resolve(preset);
+    return _jsx(C.Discussions, { ...props });
+}
+//# sourceMappingURL=conversation-thread.js.map

package/dist/esm/components/ai-elements/chat/conversation-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-thread.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/chat/conversation-thread.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,iFAAiF,CAAC;AAClI,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AA4G7F,mBAAmB;AAEnB,MAAM,OAAO,GAAG,+BAA+B,CAC7C,qBAAqB,CAAC,gCAAgC,EACtD,uBAAuB,EACvB,CAAC,UAAU,EAAE,aAAa,CAAC,CAC5B,CAAC;AAEF,mBAAmB;AAEnB,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAqD;IACrI,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,KAAC,CAAC,OAAK,KAAK,GAAI,CAAC;AAC1B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6D;IACrJ,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,KAAC,CAAC,CAAC,QAAQ,OAAK,KAAK,GAAI,CAAC;AACnC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gCAAgC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAgE;IAC3J,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,KAAC,CAAC,CAAC,WAAW,OAAK,KAAK,GAAI,CAAC;AACtC,CAAC","sourcesContent":["import React from 'react';\nimport { createCompoundComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper';\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\nimport type { FlowsActors_ToolTraceData } from '@wildo-ai/saas-models';\nimport type { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas';\nimport type { ConversationThreadModel } from '~wildo-frontend-lib/core/flows-actors/conversation-thread.model';\n\n/**\n * The conversation THREAD (#2525): one registry-resolved surface that draws a conversation with an assistant for every\n * host — the engine's `FlowsActorsView` and the creation workbench's stream — so a theme can replace it, not only\n * recolour it, and the two hosts can no longer drift.\n *\n * It is PRESENTATIONAL. It draws a {@link ConversationThreadModel} the host derived with `conversationThreadModel`\n * from the stored thread and the live turn; it reads no thread and sends nothing. What a host does that the engine\n * does not — the workbench's run and coding-run cards, its interview, its own approval card — reaches it through the\n * seams below, never through a second message renderer.\n */\n\n// --- Contract ---\n\nexport interface AI_ConversationThreadProps {\n  readonly model: ConversationThreadModel;\n  /** Shown when the thread has nothing to draw: no line, no turn in flight, no trailing content. */\n  readonly emptyState?: { readonly title: string; readonly description?: string };\n  /**\n   * Draws the decision a paused turn waits on. Default: the engine's approval card for that execution. A host with a\n   * richer card for its own tools (the workbench) supplies it here.\n   */\n  readonly renderApproval?: (executionId: string) => React.ReactNode;\n  /**\n   * The heading of a tool call's card, at any phase — what the call is ABOUT, never that it is running. Return\n   * `undefined` to keep the default: a resource read is named by the resource's authored title, a show-records call by\n   * what it is showing (while it runs) or tried to show (when it failed), any other tool by its name, an identifier no\n   * label tree words. A show-records call that SUCCEEDED is not a tool card at all: it is drawn as the records'\n   * cards, and this seam does not head it.\n   *\n   * Apart from {@link toolCallInProgress} on purpose (#2525 review M6): one seam for both handed a host's \"Starting a\n   * step…\" to every finished card, which then read as still running forever.\n   */\n  readonly toolCallTitle?: (trace: FlowsActors_ToolTraceData) => string | undefined;\n  /**\n   * The working line while a call is being made — what the turn is doing now. Return `undefined` to keep the default:\n   * \"reading <resource>\" for a resource read, \"getting <resource> ready to show\" for a show-records call, else a\n   * generic working line.\n   */\n  readonly toolCallInProgress?: (trace: FlowsActors_ToolTraceData) => string | undefined;\n  /**\n   * Replaces the line drawn for how the latest turn stands (stopped, failed, interrupted, working). Return `undefined`\n   * to keep the default for that state. For a host whose words for a turn's ending carry its own context.\n   */\n  readonly renderTurnState?: (model: ConversationThreadModel) => React.ReactNode | undefined;\n  /**\n   * The actions a host offers on an agent's STORED reply (#2842): drawn under each assistant line the conversation's\n   * record holds (`storedMessageId`), never under a reply still streaming, nor a person's message. The in-app view\n   * offers reporting the reply here. Absent, a reply carries no action.\n   */\n  readonly renderReplyActions?: (reply: { readonly messageId: string }) => React.ReactNode;\n  /** Drawn after the latest turn: a host's own turn, such as the workbench's interview. */\n  readonly children?: React.ReactNode;\n  readonly className?: string;\n}\n\n/**\n * The composer's own props, plus the form's attributes (a host's `data-*` hooks, its class). `onError` is omitted as\n * the prompt input omits it: there it reports a refused attachment, not a DOM error event.\n */\nexport interface AI_ConversationThreadComposerProps extends Omit<React.HTMLAttributes<HTMLFormElement>, 'onSubmit' | 'onError' | 'children'> {\n  readonly placeholder: string;\n  /** A trimmed, non-blank message. The composer clears its field after it. */\n  readonly onSubmit: (text: string) => void;\n  /** Present while a turn can be stopped: Stop replaces Send. */\n  readonly onStop?: () => void;\n  /** Sending is not possible now (no assistant yet, a turn in flight). The field stays editable for the next message. */\n  readonly sendDisabled?: boolean;\n  /** The field itself takes no input (a host's own submission is being taken). */\n  readonly disabled?: boolean;\n  /** A submission is being taken: the send control shows it. */\n  readonly submitting?: boolean;\n  /** Drawn at the start of the composer's footer: a host's note, such as what an interview is asking about. */\n  readonly footerStart?: React.ReactNode;\n}\n\n/** One discussion in the list. An empty title is drawn as the untitled-discussion word, resolved at render. */\nexport interface AI_ConversationThreadDiscussion {\n  readonly id: string;\n  readonly title: string;\n}\n\nexport interface AI_ConversationThreadDiscussionsProps {\n  readonly discussions: readonly AI_ConversationThreadDiscussion[];\n  readonly currentId: string | null;\n  readonly onNew: () => void;\n  readonly onSelect: (id: string) => void;\n  /** Present when discussions can be deleted from the list. */\n  readonly onDelete?: (id: string) => void;\n  /** Present when older discussions remain to be read (#2528): the list offers to load them after its last row. */\n  readonly onLoadOlder?: () => void;\n  /** An older page is being read: the offer to load more shows it and waits. */\n  readonly loadingOlder?: boolean;\n  readonly className?: string;\n}\n\n// --- Compound type ---\n\nexport interface AI_ConversationThreadCompound {\n  (props: AI_ConversationThreadProps): React.JSX.Element;\n  Composer: React.FC<AI_ConversationThreadComposerProps>;\n  Discussions: React.FC<AI_ConversationThreadDiscussionsProps>;\n}\n\n// --- Resolver ---\n\nconst resolve = createCompoundComponentResolver<AI_ConversationThreadCompound>(\n  FrontendComponentType.LOW_LEVEL_AI_CONVERSATION_THREAD,\n  'AI_ConversationThread',\n  ['Composer', 'Discussions'],\n);\n\n// --- Wrappers ---\n\n/** The thread: its lines, how its latest turn stands, and scroll-to-latest. */\nexport function AI_ConversationThread({ preset = CorePresetNames.DEFAULT, ...props }: AI_ConversationThreadProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset);\n  return <C {...props} />;\n}\n\n/** The composer, with Stop in place of Send while a turn can be stopped. */\nexport function AI_ConversationThreadComposer({ preset = CorePresetNames.DEFAULT, ...props }: AI_ConversationThreadComposerProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset);\n  return <C.Composer {...props} />;\n}\n\n/** The list of discussions: start a new one, open one, delete one. */\nexport function AI_ConversationThreadDiscussions({ preset = CorePresetNames.DEFAULT, ...props }: AI_ConversationThreadDiscussionsProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset);\n  return <C.Discussions {...props} />;\n}\n"]}