@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.4

package/dist/esm/core/components-registry/provider-component-registry.frontend.service.d.ts

@@ -54,7 +54,22 @@ export declare enum ProviderComponentDiagnosticKind {
      * loader returning a MODULE NAMESPACE — `() => import('./Picker')` — where it
      * should return the component itself.
      */
-    LOADED_VALUE_IS_NOT_A_COMPONENT = "LOADED_VALUE_IS_NOT_A_COMPONENT"
+    LOADED_VALUE_IS_NOT_A_COMPONENT = "LOADED_VALUE_IS_NOT_A_COMPONENT",
+    /**
+     * A live provider DECLARES a component for a capability and nothing supplies
+     * its loader — neither the module (`components[cap].load`) nor the facet
+     * library (`contributeProviderComponentLoaders`). The declaration is DATA a
+     * reviewer can read; without code behind it the chooser would offer a picker
+     * that cannot open. Not registered, and reported once at startup.
+     */
+    DECLARED_WITHOUT_LOADER = "DECLARED_WITHOUT_LOADER",
+    /**
+     * BOTH the module and the facet library supplied a loader for one
+     * `capability:providerRef`. The module's wins — it is the provider's own
+     * word — and the collision is reported, because the engine never authors both
+     * and two loaders for one declaration is the map-order ambiguity #380 removed.
+     */
+    LOADER_SUPPLIED_TWICE = "LOADER_SUPPLIED_TWICE"
 }
 export interface ProviderComponentDiagnostic {
     readonly kind: ProviderComponentDiagnosticKind;
@@ -113,16 +128,61 @@ interface ComponentBearingProviderModule {
         ref: string;
     };
     components?: Readonly<Record<string, ProviderFrontendComponentDescriptor & {
-        load: ProviderComponentLoader;
+        load?: ProviderComponentLoader;
     }>>;
 }
 /**
- * Turns the live provider modules into registrations.
+ * A loader the FACET LIBRARY supplies for a component a provider module
+ * declares — the second of the two doors, and the one every engine-shipped
+ * component uses (#394).
+ *
+ * The provider module, in `@wildo-ai/external-connectors-public`, declares the
+ * DATA half (`components[cap].selectionDelivery`) and cannot name a loader that
+ * reaches a React component: that package is deliberately renderer-free, and it
+ * sits BELOW the component libraries in the layering, so a dynamic import from
+ * it would close a package cycle. The library that owns the component
+ * (`presets-components` for the app facet) contributes the loader here instead,
+ * from the same place it registers its presets. A provider PACKAGE that ships
+ * its own component still uses `components[cap].load` — both doors exist, the
+ * engine authors exactly one per declaration, and a collision is reported.
+ */
+export interface ProviderComponentLoaderContribution {
+    readonly capability: ProviderCapability;
+    readonly providerRef: string;
+    readonly load: ProviderComponentLoader;
+}
+/**
+ * Registers loaders for provider components a facet library ships. Module-level
+ * and idempotent per key, like `ComponentRegistryService.register`: the app
+ * calls the library's registration entry once at startup, and a second
+ * contribution for one key replaces the first rather than duplicating it —
+ * the library is one author, and the last thing it said is what it means.
+ *
+ * A contribution for a provider the DATA channel does not declare live is
+ * SILENT, by the same rule as code without data in `hydrateFrontendProviderModules`:
+ * a bundle legitimately ships a picker an environment leaves off.
+ */
+export declare function contributeProviderComponentLoaders(loaders: Iterable<ProviderComponentLoaderContribution>): void;
+/** Every contributed loader, keyed `capability:providerRef`. Read at registry construction. */
+export declare function listContributedProviderComponentLoaders(): ReadonlyMap<string, ProviderComponentLoaderContribution>;
+/** Tests only: forget every contributed loader. */
+export declare function _clearContributedProviderComponentLoaders(): void;
+/**
+ * Turns the live provider modules into registrations, joining each declared
+ * component to its loader — from the module when it carries one, else from
+ * the facet library's contributions.
  *
  * Order follows the registry's iteration order, which is the order the service
  * declared its providers — so `listProviders` is stable across reloads and a
  * surface that shows a chooser does not reorder itself between renders.
+ *
+ * A declaration nothing can load is NOT registered: a chooser must offer only
+ * what can render. It is reported through `onDiagnostic` instead, once, at
+ * startup — which is the moment somebody can still fix it.
  */
-export declare function collectProviderComponentRegistrations(modules: Iterable<ComponentBearingProviderModule>): ProviderComponentRegistration[];
+export declare function collectProviderComponentRegistrations(modules: Iterable<ComponentBearingProviderModule>, input?: {
+    readonly contributedLoaders?: ReadonlyMap<string, ProviderComponentLoaderContribution>;
+    readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;
+}): ProviderComponentRegistration[];
 export {};
 //# sourceMappingURL=provider-component-registry.frontend.service.d.ts.map

package/dist/esm/core/components-registry/provider-component-registry.frontend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-component-registry.frontend.service.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/provider-component-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAEhG,qFAAqF;AACrF,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7D,kEAAkE;AAClE,oBAAY,+BAA+B;IACzC;;;;OAIG;IACH,sBAAsB,2BAA2B;IACjD,uGAAuG;IACvG,WAAW,gBAAgB;IAC3B;;;;OAIG;IACH,+BAA+B,oCAAoC;CACpE;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,mCAAmC,CAAC;CAC1D;AAED,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAE3D,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrE,0EAA0E;IAC1E,GAAG,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,mCAAmC,GAAG,SAAS,CAAC;IAC/G;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACjG;AAoBD,wBAAgB,+BAA+B,CAAC,KAAK,CAAC,EAAE;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,6BAA6B,CAAC,CAAC;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC3E,GAAG,yBAAyB,CAqG5B;AAED,sEAAsE;AACtE,UAAU,8BAA8B;IACtC,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mCAAmC,GAAG;QAAE,IAAI,EAAE,uBAAuB,CAAA;KAAE,CAAC,CAAC,CAAC;CAChH;AAED;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,QAAQ,CAAC,8BAA8B,CAAC,GAChD,6BAA6B,EAAE,CAkBjC"}
+{"version":3,"file":"provider-component-registry.frontend.service.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/provider-component-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAEhG,qFAAqF;AACrF,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7D,kEAAkE;AAClE,oBAAY,+BAA+B;IACzC;;;;OAIG;IACH,sBAAsB,2BAA2B;IACjD,uGAAuG;IACvG,WAAW,gBAAgB;IAC3B;;;;OAIG;IACH,+BAA+B,oCAAoC;IACnE;;;;;;OAMG;IACH,uBAAuB,4BAA4B;IACnD;;;;;OAKG;IACH,qBAAqB,0BAA0B;CAChD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,mCAAmC,CAAC;CAC1D;AAED,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAE3D,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrE,0EAA0E;IAC1E,GAAG,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,mCAAmC,GAAG,SAAS,CAAC;IAC/G;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACjG;AAoBD,wBAAgB,+BAA+B,CAAC,KAAK,CAAC,EAAE;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,6BAA6B,CAAC,CAAC;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC3E,GAAG,yBAAyB,CAqG5B;AAED,sEAAsE;AACtE,UAAU,8BAA8B;IACtC,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mCAAmC,GAAG;QAAE,IAAI,CAAC,EAAE,uBAAuB,CAAA;KAAE,CAAC,CAAC,CAAC;CACjH;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;CACxC;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,QAAQ,CAAC,mCAAmC,CAAC,GAAG,IAAI,CAI/G;AAED,+FAA+F;AAC/F,wBAAgB,uCAAuC,IAAI,WAAW,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAElH;AAED,mDAAmD;AACnD,wBAAgB,yCAAyC,IAAI,IAAI,CAEhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,QAAQ,CAAC,8BAA8B,CAAC,EACjD,KAAK,CAAC,EAAE;IACN,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC3E,GACA,6BAA6B,EAAE,CAgDjC"}

package/dist/esm/core/components-registry/provider-component-registry.frontend.service.js

@@ -51,6 +51,21 @@ export var ProviderComponentDiagnosticKind;
      * should return the component itself.
      */
     ProviderComponentDiagnosticKind["LOADED_VALUE_IS_NOT_A_COMPONENT"] = "LOADED_VALUE_IS_NOT_A_COMPONENT";
+    /**
+     * A live provider DECLARES a component for a capability and nothing supplies
+     * its loader — neither the module (`components[cap].load`) nor the facet
+     * library (`contributeProviderComponentLoaders`). The declaration is DATA a
+     * reviewer can read; without code behind it the chooser would offer a picker
+     * that cannot open. Not registered, and reported once at startup.
+     */
+    ProviderComponentDiagnosticKind["DECLARED_WITHOUT_LOADER"] = "DECLARED_WITHOUT_LOADER";
+    /**
+     * BOTH the module and the facet library supplied a loader for one
+     * `capability:providerRef`. The module's wins — it is the provider's own
+     * word — and the collision is reported, because the engine never authors both
+     * and two loaders for one declaration is the map-order ambiguity #380 removed.
+     */
+    ProviderComponentDiagnosticKind["LOADER_SUPPLIED_TWICE"] = "LOADER_SUPPLIED_TWICE";
 })(ProviderComponentDiagnosticKind || (ProviderComponentDiagnosticKind = {}));
 function isModuleNamespace(value) {
     return (typeof value === 'object'
@@ -156,21 +171,78 @@ export function createProviderComponentRegistry(input) {
         },
     };
 }
+const contributedLoaders = new Map();
+const loaderKeyOf = (capability, providerRef) => `${capability}:${providerRef}`;
+/**
+ * Registers loaders for provider components a facet library ships. Module-level
+ * and idempotent per key, like `ComponentRegistryService.register`: the app
+ * calls the library's registration entry once at startup, and a second
+ * contribution for one key replaces the first rather than duplicating it —
+ * the library is one author, and the last thing it said is what it means.
+ *
+ * A contribution for a provider the DATA channel does not declare live is
+ * SILENT, by the same rule as code without data in `hydrateFrontendProviderModules`:
+ * a bundle legitimately ships a picker an environment leaves off.
+ */
+export function contributeProviderComponentLoaders(loaders) {
+    for (const loader of loaders) {
+        contributedLoaders.set(loaderKeyOf(loader.capability, loader.providerRef), loader);
+    }
+}
+/** Every contributed loader, keyed `capability:providerRef`. Read at registry construction. */
+export function listContributedProviderComponentLoaders() {
+    return contributedLoaders;
+}
+/** Tests only: forget every contributed loader. */
+export function _clearContributedProviderComponentLoaders() {
+    contributedLoaders.clear();
+}
 /**
- * Turns the live provider modules into registrations.
+ * Turns the live provider modules into registrations, joining each declared
+ * component to its loader — from the module when it carries one, else from
+ * the facet library's contributions.
  *
  * Order follows the registry's iteration order, which is the order the service
  * declared its providers — so `listProviders` is stable across reloads and a
  * surface that shows a chooser does not reorder itself between renders.
+ *
+ * A declaration nothing can load is NOT registered: a chooser must offer only
+ * what can render. It is reported through `onDiagnostic` instead, once, at
+ * startup — which is the moment somebody can still fix it.
  */
-export function collectProviderComponentRegistrations(modules) {
+export function collectProviderComponentRegistrations(modules, input) {
     const registrations = [];
+    const contributed = input?.contributedLoaders ?? listContributedProviderComponentLoaders();
     for (const module of modules) {
         for (const [capability, declaration] of Object.entries(module.components ?? {})) {
+            const providerRef = module.metadata.ref;
+            const supplied = contributed.get(loaderKeyOf(capability, providerRef));
+            if (declaration.load !== undefined && supplied !== undefined) {
+                input?.onDiagnostic?.({
+                    kind: ProviderComponentDiagnosticKind.LOADER_SUPPLIED_TWICE,
+                    capability,
+                    providerRef,
+                    message: `Provider "${providerRef}" carries its own loader for "${capability}" AND the facet library contributed `
+                        + "one. The module's is used; remove one of the two.",
+                });
+            }
+            const load = declaration.load ?? supplied?.load;
+            if (load === undefined) {
+                input?.onDiagnostic?.({
+                    kind: ProviderComponentDiagnosticKind.DECLARED_WITHOUT_LOADER,
+                    capability,
+                    providerRef,
+                    message: `Provider "${providerRef}" declares a "${capability}" component and nothing supplies its loader — `
+                        + 'neither the module nor the facet library. It is not offered. An engine-shipped component is '
+                        + 'registered by the facet library (presets-components for the app); a provider package supplies '
+                        + '`components[capability].load`.',
+                });
+                continue;
+            }
             registrations.push({
                 capability: capability,
-                providerRef: module.metadata.ref,
-                load: declaration.load,
+                providerRef,
+                load,
                 // Only the declared half, never the whole declaration: `load` is already
                 // carried beside it, and a registration holding the same function twice
                 // is two places for one fact to go stale.

package/dist/esm/core/components-registry/provider-component-registry.frontend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-component-registry.frontend.service.js","sourceRoot":"","sources":["../../../../src/core/components-registry/provider-component-registry.frontend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Components contributed by PROVIDERS, keyed by the capability each fills.\n *\n * ## Why this is a sibling of `ComponentRegistryService` and not an extension\n *\n * The two index different vocabularies, and merging them would put an open one\n * into a key built for a closed one:\n *\n *   - `ComponentRegistryService` keys `componentType:preset[:category]`, where\n *     `FrontendComponentType` is a CLOSED enum the engine owns. Exactly one\n *     component answers a key, resolution is synchronous, and a missing\n *     registration is a startup refusal.\n *   - This registry keys `capability:providerRef`, where `ProviderCapability`\n *     is OPEN — an application extends it by TypeScript module augmentation.\n *     SEVERAL providers may answer one capability, the component arrives\n *     asynchronously, and none of it is required for the app to mount.\n *\n * Forcing provider components through the closed enum would mean an engine edit\n * for every new provider capability — precisely what the open vocabulary exists\n * to avoid — and would make \"which component answers this key\" ambiguous in a\n * registry whose whole contract is that it is not.\n *\n * It also keeps the blast radius honest. `ComponentRegistryService` has sixteen\n * consumers across four packages (re-measured 2026-09-06; the plan's figure of\n * eleven predates several of them), most of them outside this slice's territory.\n * A sibling registry touches none of them.\n *\n * ## Several providers, and no silent winner\n *\n * `listProviders` returns every provider offering a component for a capability,\n * in registration order, and nothing here picks one. That is deliberate: the\n * defect being fixed is that resolution WAS first-match, so a Drive picker and\n * a Dropbox picker could not coexist and the winner depended on map order. A\n * surface with two providers has a choice to present; a registry that answered\n * it would be making a product decision in a lookup table.\n */\n\nimport type React from 'react';\nimport type { ProviderCapability } from '@wildo-ai/saas-models';\nimport type { ProviderFrontendComponentDescriptor } from '@wildo-ai/saas-models/public-runtime';\n\n/** A loader as a provider module declares it: on demand, returning the component. */\nexport type ProviderComponentLoader = () => Promise<unknown>;\n\n/** Why a provider component could not be registered or loaded. */\nexport enum ProviderComponentDiagnosticKind {\n  /**\n   * A second registration arrived for one capability AND provider. The first is\n   * kept: a duplicate is a wiring mistake, and swapping the live component\n   * under a mounted surface would be worse than ignoring it.\n   */\n  DUPLICATE_REGISTRATION = 'DUPLICATE_REGISTRATION',\n  /** The loader threw or rejected. That provider's component is unavailable; others are not affected. */\n  LOAD_FAILED = 'LOAD_FAILED',\n  /**\n   * The loader resolved something that is not a component. Almost always a\n   * loader returning a MODULE NAMESPACE — `() => import('./Picker')` — where it\n   * should return the component itself.\n   */\n  LOADED_VALUE_IS_NOT_A_COMPONENT = 'LOADED_VALUE_IS_NOT_A_COMPONENT',\n}\n\nexport interface ProviderComponentDiagnostic {\n  readonly kind: ProviderComponentDiagnosticKind;\n  readonly capability: string;\n  readonly providerRef: string;\n  readonly message: string;\n  readonly cause?: unknown;\n}\n\nexport interface ProviderComponentRegistration {\n  readonly capability: ProviderCapability;\n  readonly providerRef: string;\n  readonly load: ProviderComponentLoader;\n  /**\n   * What the provider DECLARED about this component — today, what a selection\n   * from it contains. Kept beside the loader rather than looked up from the\n   * DATA entry at the use site, because a surface needs it BEFORE it decides to\n   * load anything, and because the two would then be two sources for one fact.\n   */\n  readonly descriptor: ProviderFrontendComponentDescriptor;\n}\n\n/** A component type this registry will hand back once loaded. */\nexport type ProviderComponent = React.ComponentType<never>;\n\nexport interface ProviderComponentRegistry {\n  /**\n   * Every provider offering a component for this capability, in registration\n   * order. Synchronous ON PURPOSE: a surface has to render its chooser before\n   * any component is loaded, and awaiting here would make an empty frame.\n   */\n  listProviders(capability: ProviderCapability): ReadonlyArray<string>;\n  /** Whether this exact provider offers a component for this capability. */\n  has(capability: ProviderCapability, providerRef: string): boolean;\n  /**\n   * What the provider declared about its component, without loading it —\n   * `undefined` when this provider offers none for this capability.\n   *\n   * Synchronous and separate from `resolve` on purpose: the framework routes a\n   * selection according to what was DECLARED, and a routing decision that had to\n   * await a download would mean downloading a picker to find out whether the\n   * surface can use it.\n   */\n  describe(capability: ProviderCapability, providerRef: string): ProviderFrontendComponentDescriptor | undefined;\n  /**\n   * Loads one provider's component. The loader runs at most once per pair —\n   * a chooser that mounts and unmounts must not re-download a picker — and a\n   * failure is reported and returns `null` rather than throwing into a render.\n   */\n  resolve(capability: ProviderCapability, providerRef: string): Promise<ProviderComponent | null>;\n}\n\nfunction isModuleNamespace(value: unknown): boolean {\n  return (\n    typeof value === 'object'\n    && value !== null\n    && (value as { [Symbol.toStringTag]?: unknown })[Symbol.toStringTag] === 'Module'\n  );\n}\n\n/**\n * A React component is a function, or an object for `memo` / `forwardRef` /\n * `lazy`. Anything else — a namespace, a string, a plain data object — cannot\n * be rendered, and finding out at render time means a blank surface with a\n * stack trace pointing at React rather than at the provider.\n */\nfunction looksLikeComponent(value: unknown): value is ProviderComponent {\n  return typeof value === 'function' || (typeof value === 'object' && value !== null);\n}\n\nexport function createProviderComponentRegistry(input?: {\n  readonly registrations?: Iterable<ProviderComponentRegistration>;\n  readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;\n}): ProviderComponentRegistry {\n  const raise = (diagnostic: ProviderComponentDiagnostic): void => {\n    input?.onDiagnostic?.(diagnostic);\n  };\n  const loaders = new Map<string, ProviderComponentLoader>();\n  const descriptors = new Map<string, ProviderFrontendComponentDescriptor>();\n  const byCapability = new Map<string, string[]>();\n  const loaded = new Map<string, Promise<ProviderComponent | null>>();\n  const keyOf = (capability: string, providerRef: string): string => `${capability}:${providerRef}`;\n\n  for (const registration of input?.registrations ?? []) {\n    const key = keyOf(registration.capability, registration.providerRef);\n    if (loaders.has(key)) {\n      raise({\n        kind: ProviderComponentDiagnosticKind.DUPLICATE_REGISTRATION,\n        capability: registration.capability,\n        providerRef: registration.providerRef,\n        message:\n          `Provider \"${registration.providerRef}\" registered a component for \"${registration.capability}\" `\n          + 'more than once. The first registration is kept.',\n      });\n      continue;\n    }\n\n    loaders.set(key, registration.load);\n    descriptors.set(key, registration.descriptor);\n    const providers = byCapability.get(registration.capability) ?? [];\n    providers.push(registration.providerRef);\n    byCapability.set(registration.capability, providers);\n  }\n\n  return {\n    listProviders(capability) {\n      return byCapability.get(capability) ?? [];\n    },\n\n    has(capability, providerRef) {\n      return loaders.has(keyOf(capability, providerRef));\n    },\n\n    describe(capability, providerRef) {\n      return descriptors.get(keyOf(capability, providerRef));\n    },\n\n    resolve(capability, providerRef) {\n      const key = keyOf(capability, providerRef);\n      const cached = loaded.get(key);\n      if (cached !== undefined) return cached;\n\n      const load = loaders.get(key);\n      if (load === undefined) return Promise.resolve(null);\n\n      const pending = (async (): Promise<ProviderComponent | null> => {\n        let value: unknown;\n        try {\n          value = await load();\n        } catch (cause) {\n          raise({\n            kind: ProviderComponentDiagnosticKind.LOAD_FAILED,\n            capability,\n            providerRef,\n            message: `Provider \"${providerRef}\" failed to load its \"${capability}\" component.`,\n            cause,\n          });\n          return null;\n        }\n\n        if (isModuleNamespace(value)) {\n          raise({\n            kind: ProviderComponentDiagnosticKind.LOADED_VALUE_IS_NOT_A_COMPONENT,\n            capability,\n            providerRef,\n            message:\n              `Provider \"${providerRef}\" returned a MODULE for its \"${capability}\" component instead of the `\n              + \"component itself. Write `async () => (await import('./Picker')).Picker` rather than \"\n              + \"`() => import('./Picker')`.\",\n          });\n          return null;\n        }\n\n        if (!looksLikeComponent(value)) {\n          raise({\n            kind: ProviderComponentDiagnosticKind.LOADED_VALUE_IS_NOT_A_COMPONENT,\n            capability,\n            providerRef,\n            message:\n              `Provider \"${providerRef}\" returned a ${typeof value} for its \"${capability}\" component. A React `\n              + 'component is a function, or an object for memo / forwardRef / lazy.',\n          });\n          return null;\n        }\n\n        return value;\n      })();\n\n      // Cached even when it resolves to null: a loader that failed once must not\n      // be retried on every render of a chooser that lists it.\n      loaded.set(key, pending);\n      return pending;\n    },\n  };\n}\n\n/** The shape this derivation needs off a hydrated provider module. */\ninterface ComponentBearingProviderModule {\n  metadata: { ref: string };\n  components?: Readonly<Record<string, ProviderFrontendComponentDescriptor & { load: ProviderComponentLoader }>>;\n}\n\n/**\n * Turns the live provider modules into registrations.\n *\n * Order follows the registry's iteration order, which is the order the service\n * declared its providers — so `listProviders` is stable across reloads and a\n * surface that shows a chooser does not reorder itself between renders.\n */\nexport function collectProviderComponentRegistrations(\n  modules: Iterable<ComponentBearingProviderModule>,\n): ProviderComponentRegistration[] {\n  const registrations: ProviderComponentRegistration[] = [];\n\n  for (const module of modules) {\n    for (const [capability, declaration] of Object.entries(module.components ?? {})) {\n      registrations.push({\n        capability: capability as ProviderCapability,\n        providerRef: module.metadata.ref,\n        load: declaration.load,\n        // Only the declared half, never the whole declaration: `load` is already\n        // carried beside it, and a registration holding the same function twice\n        // is two places for one fact to go stale.\n        descriptor: { selectionDelivery: declaration.selectionDelivery },\n      });\n    }\n  }\n\n  return registrations;\n}\n"]}
+{"version":3,"file":"provider-component-registry.frontend.service.js","sourceRoot":"","sources":["../../../../src/core/components-registry/provider-component-registry.frontend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Components contributed by PROVIDERS, keyed by the capability each fills.\n *\n * ## Why this is a sibling of `ComponentRegistryService` and not an extension\n *\n * The two index different vocabularies, and merging them would put an open one\n * into a key built for a closed one:\n *\n *   - `ComponentRegistryService` keys `componentType:preset[:category]`, where\n *     `FrontendComponentType` is a CLOSED enum the engine owns. Exactly one\n *     component answers a key, resolution is synchronous, and a missing\n *     registration is a startup refusal.\n *   - This registry keys `capability:providerRef`, where `ProviderCapability`\n *     is OPEN — an application extends it by TypeScript module augmentation.\n *     SEVERAL providers may answer one capability, the component arrives\n *     asynchronously, and none of it is required for the app to mount.\n *\n * Forcing provider components through the closed enum would mean an engine edit\n * for every new provider capability — precisely what the open vocabulary exists\n * to avoid — and would make \"which component answers this key\" ambiguous in a\n * registry whose whole contract is that it is not.\n *\n * It also keeps the blast radius honest. `ComponentRegistryService` has sixteen\n * consumers across four packages (re-measured 2026-09-06; the plan's figure of\n * eleven predates several of them), most of them outside this slice's territory.\n * A sibling registry touches none of them.\n *\n * ## Several providers, and no silent winner\n *\n * `listProviders` returns every provider offering a component for a capability,\n * in registration order, and nothing here picks one. That is deliberate: the\n * defect being fixed is that resolution WAS first-match, so a Drive picker and\n * a Dropbox picker could not coexist and the winner depended on map order. A\n * surface with two providers has a choice to present; a registry that answered\n * it would be making a product decision in a lookup table.\n */\n\nimport type React from 'react';\nimport type { ProviderCapability } from '@wildo-ai/saas-models';\nimport type { ProviderFrontendComponentDescriptor } from '@wildo-ai/saas-models/public-runtime';\n\n/** A loader as a provider module declares it: on demand, returning the component. */\nexport type ProviderComponentLoader = () => Promise<unknown>;\n\n/** Why a provider component could not be registered or loaded. */\nexport enum ProviderComponentDiagnosticKind {\n  /**\n   * A second registration arrived for one capability AND provider. The first is\n   * kept: a duplicate is a wiring mistake, and swapping the live component\n   * under a mounted surface would be worse than ignoring it.\n   */\n  DUPLICATE_REGISTRATION = 'DUPLICATE_REGISTRATION',\n  /** The loader threw or rejected. That provider's component is unavailable; others are not affected. */\n  LOAD_FAILED = 'LOAD_FAILED',\n  /**\n   * The loader resolved something that is not a component. Almost always a\n   * loader returning a MODULE NAMESPACE — `() => import('./Picker')` — where it\n   * should return the component itself.\n   */\n  LOADED_VALUE_IS_NOT_A_COMPONENT = 'LOADED_VALUE_IS_NOT_A_COMPONENT',\n  /**\n   * A live provider DECLARES a component for a capability and nothing supplies\n   * its loader — neither the module (`components[cap].load`) nor the facet\n   * library (`contributeProviderComponentLoaders`). The declaration is DATA a\n   * reviewer can read; without code behind it the chooser would offer a picker\n   * that cannot open. Not registered, and reported once at startup.\n   */\n  DECLARED_WITHOUT_LOADER = 'DECLARED_WITHOUT_LOADER',\n  /**\n   * BOTH the module and the facet library supplied a loader for one\n   * `capability:providerRef`. The module's wins — it is the provider's own\n   * word — and the collision is reported, because the engine never authors both\n   * and two loaders for one declaration is the map-order ambiguity #380 removed.\n   */\n  LOADER_SUPPLIED_TWICE = 'LOADER_SUPPLIED_TWICE',\n}\n\nexport interface ProviderComponentDiagnostic {\n  readonly kind: ProviderComponentDiagnosticKind;\n  readonly capability: string;\n  readonly providerRef: string;\n  readonly message: string;\n  readonly cause?: unknown;\n}\n\nexport interface ProviderComponentRegistration {\n  readonly capability: ProviderCapability;\n  readonly providerRef: string;\n  readonly load: ProviderComponentLoader;\n  /**\n   * What the provider DECLARED about this component — today, what a selection\n   * from it contains. Kept beside the loader rather than looked up from the\n   * DATA entry at the use site, because a surface needs it BEFORE it decides to\n   * load anything, and because the two would then be two sources for one fact.\n   */\n  readonly descriptor: ProviderFrontendComponentDescriptor;\n}\n\n/** A component type this registry will hand back once loaded. */\nexport type ProviderComponent = React.ComponentType<never>;\n\nexport interface ProviderComponentRegistry {\n  /**\n   * Every provider offering a component for this capability, in registration\n   * order. Synchronous ON PURPOSE: a surface has to render its chooser before\n   * any component is loaded, and awaiting here would make an empty frame.\n   */\n  listProviders(capability: ProviderCapability): ReadonlyArray<string>;\n  /** Whether this exact provider offers a component for this capability. */\n  has(capability: ProviderCapability, providerRef: string): boolean;\n  /**\n   * What the provider declared about its component, without loading it —\n   * `undefined` when this provider offers none for this capability.\n   *\n   * Synchronous and separate from `resolve` on purpose: the framework routes a\n   * selection according to what was DECLARED, and a routing decision that had to\n   * await a download would mean downloading a picker to find out whether the\n   * surface can use it.\n   */\n  describe(capability: ProviderCapability, providerRef: string): ProviderFrontendComponentDescriptor | undefined;\n  /**\n   * Loads one provider's component. The loader runs at most once per pair —\n   * a chooser that mounts and unmounts must not re-download a picker — and a\n   * failure is reported and returns `null` rather than throwing into a render.\n   */\n  resolve(capability: ProviderCapability, providerRef: string): Promise<ProviderComponent | null>;\n}\n\nfunction isModuleNamespace(value: unknown): boolean {\n  return (\n    typeof value === 'object'\n    && value !== null\n    && (value as { [Symbol.toStringTag]?: unknown })[Symbol.toStringTag] === 'Module'\n  );\n}\n\n/**\n * A React component is a function, or an object for `memo` / `forwardRef` /\n * `lazy`. Anything else — a namespace, a string, a plain data object — cannot\n * be rendered, and finding out at render time means a blank surface with a\n * stack trace pointing at React rather than at the provider.\n */\nfunction looksLikeComponent(value: unknown): value is ProviderComponent {\n  return typeof value === 'function' || (typeof value === 'object' && value !== null);\n}\n\nexport function createProviderComponentRegistry(input?: {\n  readonly registrations?: Iterable<ProviderComponentRegistration>;\n  readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;\n}): ProviderComponentRegistry {\n  const raise = (diagnostic: ProviderComponentDiagnostic): void => {\n    input?.onDiagnostic?.(diagnostic);\n  };\n  const loaders = new Map<string, ProviderComponentLoader>();\n  const descriptors = new Map<string, ProviderFrontendComponentDescriptor>();\n  const byCapability = new Map<string, string[]>();\n  const loaded = new Map<string, Promise<ProviderComponent | null>>();\n  const keyOf = (capability: string, providerRef: string): string => `${capability}:${providerRef}`;\n\n  for (const registration of input?.registrations ?? []) {\n    const key = keyOf(registration.capability, registration.providerRef);\n    if (loaders.has(key)) {\n      raise({\n        kind: ProviderComponentDiagnosticKind.DUPLICATE_REGISTRATION,\n        capability: registration.capability,\n        providerRef: registration.providerRef,\n        message:\n          `Provider \"${registration.providerRef}\" registered a component for \"${registration.capability}\" `\n          + 'more than once. The first registration is kept.',\n      });\n      continue;\n    }\n\n    loaders.set(key, registration.load);\n    descriptors.set(key, registration.descriptor);\n    const providers = byCapability.get(registration.capability) ?? [];\n    providers.push(registration.providerRef);\n    byCapability.set(registration.capability, providers);\n  }\n\n  return {\n    listProviders(capability) {\n      return byCapability.get(capability) ?? [];\n    },\n\n    has(capability, providerRef) {\n      return loaders.has(keyOf(capability, providerRef));\n    },\n\n    describe(capability, providerRef) {\n      return descriptors.get(keyOf(capability, providerRef));\n    },\n\n    resolve(capability, providerRef) {\n      const key = keyOf(capability, providerRef);\n      const cached = loaded.get(key);\n      if (cached !== undefined) return cached;\n\n      const load = loaders.get(key);\n      if (load === undefined) return Promise.resolve(null);\n\n      const pending = (async (): Promise<ProviderComponent | null> => {\n        let value: unknown;\n        try {\n          value = await load();\n        } catch (cause) {\n          raise({\n            kind: ProviderComponentDiagnosticKind.LOAD_FAILED,\n            capability,\n            providerRef,\n            message: `Provider \"${providerRef}\" failed to load its \"${capability}\" component.`,\n            cause,\n          });\n          return null;\n        }\n\n        if (isModuleNamespace(value)) {\n          raise({\n            kind: ProviderComponentDiagnosticKind.LOADED_VALUE_IS_NOT_A_COMPONENT,\n            capability,\n            providerRef,\n            message:\n              `Provider \"${providerRef}\" returned a MODULE for its \"${capability}\" component instead of the `\n              + \"component itself. Write `async () => (await import('./Picker')).Picker` rather than \"\n              + \"`() => import('./Picker')`.\",\n          });\n          return null;\n        }\n\n        if (!looksLikeComponent(value)) {\n          raise({\n            kind: ProviderComponentDiagnosticKind.LOADED_VALUE_IS_NOT_A_COMPONENT,\n            capability,\n            providerRef,\n            message:\n              `Provider \"${providerRef}\" returned a ${typeof value} for its \"${capability}\" component. A React `\n              + 'component is a function, or an object for memo / forwardRef / lazy.',\n          });\n          return null;\n        }\n\n        return value;\n      })();\n\n      // Cached even when it resolves to null: a loader that failed once must not\n      // be retried on every render of a chooser that lists it.\n      loaded.set(key, pending);\n      return pending;\n    },\n  };\n}\n\n/** The shape this derivation needs off a hydrated provider module. */\ninterface ComponentBearingProviderModule {\n  metadata: { ref: string };\n  components?: Readonly<Record<string, ProviderFrontendComponentDescriptor & { load?: ProviderComponentLoader }>>;\n}\n\n/**\n * A loader the FACET LIBRARY supplies for a component a provider module\n * declares — the second of the two doors, and the one every engine-shipped\n * component uses (#394).\n *\n * The provider module, in `@wildo-ai/external-connectors-public`, declares the\n * DATA half (`components[cap].selectionDelivery`) and cannot name a loader that\n * reaches a React component: that package is deliberately renderer-free, and it\n * sits BELOW the component libraries in the layering, so a dynamic import from\n * it would close a package cycle. The library that owns the component\n * (`presets-components` for the app facet) contributes the loader here instead,\n * from the same place it registers its presets. A provider PACKAGE that ships\n * its own component still uses `components[cap].load` — both doors exist, the\n * engine authors exactly one per declaration, and a collision is reported.\n */\nexport interface ProviderComponentLoaderContribution {\n  readonly capability: ProviderCapability;\n  readonly providerRef: string;\n  readonly load: ProviderComponentLoader;\n}\n\nconst contributedLoaders = new Map<string, ProviderComponentLoaderContribution>();\nconst loaderKeyOf = (capability: string, providerRef: string): string => `${capability}:${providerRef}`;\n\n/**\n * Registers loaders for provider components a facet library ships. Module-level\n * and idempotent per key, like `ComponentRegistryService.register`: the app\n * calls the library's registration entry once at startup, and a second\n * contribution for one key replaces the first rather than duplicating it —\n * the library is one author, and the last thing it said is what it means.\n *\n * A contribution for a provider the DATA channel does not declare live is\n * SILENT, by the same rule as code without data in `hydrateFrontendProviderModules`:\n * a bundle legitimately ships a picker an environment leaves off.\n */\nexport function contributeProviderComponentLoaders(loaders: Iterable<ProviderComponentLoaderContribution>): void {\n  for (const loader of loaders) {\n    contributedLoaders.set(loaderKeyOf(loader.capability, loader.providerRef), loader);\n  }\n}\n\n/** Every contributed loader, keyed `capability:providerRef`. Read at registry construction. */\nexport function listContributedProviderComponentLoaders(): ReadonlyMap<string, ProviderComponentLoaderContribution> {\n  return contributedLoaders;\n}\n\n/** Tests only: forget every contributed loader. */\nexport function _clearContributedProviderComponentLoaders(): void {\n  contributedLoaders.clear();\n}\n\n/**\n * Turns the live provider modules into registrations, joining each declared\n * component to its loader — from the module when it carries one, else from\n * the facet library's contributions.\n *\n * Order follows the registry's iteration order, which is the order the service\n * declared its providers — so `listProviders` is stable across reloads and a\n * surface that shows a chooser does not reorder itself between renders.\n *\n * A declaration nothing can load is NOT registered: a chooser must offer only\n * what can render. It is reported through `onDiagnostic` instead, once, at\n * startup — which is the moment somebody can still fix it.\n */\nexport function collectProviderComponentRegistrations(\n  modules: Iterable<ComponentBearingProviderModule>,\n  input?: {\n    readonly contributedLoaders?: ReadonlyMap<string, ProviderComponentLoaderContribution>;\n    readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;\n  },\n): ProviderComponentRegistration[] {\n  const registrations: ProviderComponentRegistration[] = [];\n  const contributed = input?.contributedLoaders ?? listContributedProviderComponentLoaders();\n\n  for (const module of modules) {\n    for (const [capability, declaration] of Object.entries(module.components ?? {})) {\n      const providerRef = module.metadata.ref;\n      const supplied = contributed.get(loaderKeyOf(capability, providerRef));\n\n      if (declaration.load !== undefined && supplied !== undefined) {\n        input?.onDiagnostic?.({\n          kind: ProviderComponentDiagnosticKind.LOADER_SUPPLIED_TWICE,\n          capability,\n          providerRef,\n          message:\n            `Provider \"${providerRef}\" carries its own loader for \"${capability}\" AND the facet library contributed `\n            + \"one. The module's is used; remove one of the two.\",\n        });\n      }\n\n      const load = declaration.load ?? supplied?.load;\n      if (load === undefined) {\n        input?.onDiagnostic?.({\n          kind: ProviderComponentDiagnosticKind.DECLARED_WITHOUT_LOADER,\n          capability,\n          providerRef,\n          message:\n            `Provider \"${providerRef}\" declares a \"${capability}\" component and nothing supplies its loader — `\n            + 'neither the module nor the facet library. It is not offered. An engine-shipped component is '\n            + 'registered by the facet library (presets-components for the app); a provider package supplies '\n            + '`components[capability].load`.',\n        });\n        continue;\n      }\n\n      registrations.push({\n        capability: capability as ProviderCapability,\n        providerRef,\n        load,\n        // Only the declared half, never the whole declaration: `load` is already\n        // carried beside it, and a registration holding the same function twice\n        // is two places for one fact to go stale.\n        descriptor: { selectionDelivery: declaration.selectionDelivery },\n      });\n    }\n  }\n\n  return registrations;\n}\n"]}

package/dist/esm/core/components-registry/useProviderComponent.frontend.hooks.d.ts

@@ -22,6 +22,7 @@
  * translation invisible.
  */
 import type { ProviderCapability } from '@wildo-ai/saas-models';
+import type { FileStorageAccepted } from '@wildo-ai/saas-models/public-runtime';
 import type { ProviderComponent } from './provider-component-registry.frontend.service';
 export interface ProviderComponentChoice {
     readonly providerRef: string;
@@ -29,6 +30,13 @@ export interface ProviderComponentChoice {
     readonly displayNameLabelKey: string;
     /** The provider's authored fallback, when it has one. Still not a translation. */
     readonly displayName?: string;
+    /**
+     * The z_file storage this provider's picker fronts, from the served entry
+     * (#394 P5). A file field offers the picker only when its `storageAccepted`
+     * names this storage; a provider declaring none delivers bytes and is offered
+     * to every field.
+     */
+    readonly fileStorage?: FileStorageAccepted;
 }
 /**
  * The providers that are BOTH live for this service and carry a component for

package/dist/esm/core/components-registry/useProviderComponent.frontend.hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useProviderComponent.frontend.hooks.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/useProviderComponent.frontend.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAExF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,GAC7B,aAAa,CAAC,uBAAuB,CAAC,CAcxC;AAED,qDAAqD;AACrD,oBAAY,uBAAuB;IACjC,8EAA8E;IAC9E,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf;;;;OAIG;IACH,WAAW,gBAAgB;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,kBAAkB,EAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,sBAAsB,CAiCxB"}
+{"version":3,"file":"useProviderComponent.frontend.hooks.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/useProviderComponent.frontend.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAGhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAExF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,GAC7B,aAAa,CAAC,uBAAuB,CAAC,CAexC;AAED,qDAAqD;AACrD,oBAAY,uBAAuB;IACjC,8EAA8E;IAC9E,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf;;;;OAIG;IACH,WAAW,gBAAgB;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,kBAAkB,EAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,sBAAsB,CAiCxB"}

package/dist/esm/core/components-registry/useProviderComponent.frontend.hooks.js

@@ -43,6 +43,7 @@ export function useProviderComponentChoices(capability) {
             providerRef,
             displayNameLabelKey: provider?.metadata.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(providerRef),
             displayName: provider?.metadata.displayName,
+            fileStorage: provider?.fileStorage,
         };
     });
 }

package/dist/esm/core/components-registry/useProviderComponent.frontend.hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"useProviderComponent.frontend.hooks.js","sourceRoot":"","sources":["../../../../src/core/components-registry/useProviderComponent.frontend.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAWjF;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA8B;IAE9B,MAAM,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEjF,IAAI,yBAAyB,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEvD,OAAO,yBAAyB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;QAC7E,MAAM,QAAQ,GAAG,wBAAwB,EAAE,gBAAgB,CAAC,WAAoB,CAAC,CAAC;QAClF,OAAO;YACL,WAAW;YACX,mBAAmB,EACjB,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,IAAI,gCAAgC,CAAC,WAAW,CAAC;YACzF,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW;SAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAN,IAAY,uBAWX;AAXD,WAAY,uBAAuB;IACjC,8EAA8E;IAC9E,wCAAa,CAAA;IACb,8CAAmB,CAAA;IACnB,0CAAe,CAAA;IACf;;;;OAIG;IACH,sDAA2B,CAAA;AAC7B,CAAC,EAXW,uBAAuB,KAAvB,uBAAuB,QAWlC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA8B,EAC9B,WAA+B;IAE/B,MAAM,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAyB;QACzD,MAAM,EAAE,uBAAuB,CAAC,IAAI;QACpC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,yBAAyB,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACzE,QAAQ,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,KAAK,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;YACjF,0EAA0E;YAC1E,sEAAsE;YACtE,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,QAAQ,CACN,SAAS,KAAK,IAAI;gBAChB,CAAC,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE;gBAClE,CAAC,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * Reading provider-contributed components from a React surface.\n *\n * Two hooks, split along the one line that matters: WHICH providers can fill a\n * capability is known synchronously and their component is not.\n *\n *   - `useProviderComponentChoices` — the live providers offering a component\n *     for a capability, in a stable order, with the label KEY each renders\n *     under. Synchronous, so a surface can draw its chooser on the first frame\n *     instead of flashing an empty one.\n *   - `useProviderComponent` — the chosen provider's component, loaded on\n *     demand, with an explicit status so a surface renders a pending state\n *     rather than nothing.\n *\n * Neither hook picks a provider. That is the defect being fixed: resolution was\n * first-match, so two pickers could not coexist and the winner depended on map\n * order. When there are several, choosing is the surface's job — and a user's.\n *\n * Labels are KEYS, never text. A provider's display name is resolved through\n * the app i18n service at render time by whatever surface shows it; returning a\n * string here would freeze locale-bound copy into a hook and make a missing\n * translation invisible.\n */\n\nimport { useEffect, useState } from 'react';\nimport type { ProviderCapability } from '@wildo-ai/saas-models';\nimport { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport type { ProviderComponent } from './provider-component-registry.frontend.service';\n\nexport interface ProviderComponentChoice {\n  readonly providerRef: string;\n  /** Resolve through the app i18n service; never render this key. */\n  readonly displayNameLabelKey: string;\n  /** The provider's authored fallback, when it has one. Still not a translation. */\n  readonly displayName?: string;\n}\n\n/**\n * The providers that are BOTH live for this service and carry a component for\n * this capability.\n *\n * Both halves are required and they come from different channels: a provider\n * can be live with no code (an older bundle) or have code and not be live (an\n * environment that left it off). A surface must offer only what can actually\n * render.\n */\nexport function useProviderComponentChoices(\n  capability: ProviderCapability,\n): ReadonlyArray<ProviderComponentChoice> {\n  const { frontendProviderRegistry, providerComponentRegistry } = useApplication();\n\n  if (providerComponentRegistry === undefined) return [];\n\n  return providerComponentRegistry.listProviders(capability).map((providerRef) => {\n    const provider = frontendProviderRegistry?.getProviderByRef(providerRef as never);\n    return {\n      providerRef,\n      displayNameLabelKey:\n        provider?.metadata.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(providerRef),\n      displayName: provider?.metadata.displayName,\n    };\n  });\n}\n\n/** Why a provider component is not on screen yet. */\nexport enum ProviderComponentStatus {\n  /** No provider was chosen, or none offers a component for this capability. */\n  NONE = 'NONE',\n  LOADING = 'LOADING',\n  READY = 'READY',\n  /**\n   * The loader failed or returned something unrenderable. The registry has\n   * already reported why; a surface should fall back rather than retry, because\n   * the registry will not run a failed loader again.\n   */\n  UNAVAILABLE = 'UNAVAILABLE',\n}\n\nexport interface ProviderComponentState {\n  readonly status: ProviderComponentStatus;\n  readonly Component: ProviderComponent | null;\n}\n\n/**\n * Loads one provider's component for a capability.\n *\n * Pass `undefined` for the ref while nothing is chosen — the hook does not\n * choose, and a surface with several providers must not load all of them\n * speculatively.\n */\nexport function useProviderComponent(\n  capability: ProviderCapability,\n  providerRef: string | undefined,\n): ProviderComponentState {\n  const { providerComponentRegistry } = useApplication();\n  const [state, setState] = useState<ProviderComponentState>({\n    status: ProviderComponentStatus.NONE,\n    Component: null,\n  });\n\n  useEffect(() => {\n    if (providerComponentRegistry === undefined || providerRef === undefined) {\n      setState({ status: ProviderComponentStatus.NONE, Component: null });\n      return;\n    }\n\n    let current = true;\n    setState({ status: ProviderComponentStatus.LOADING, Component: null });\n\n    void providerComponentRegistry.resolve(capability, providerRef).then((Component) => {\n      // A user can switch provider while one is still downloading. Without this\n      // the slower answer would arrive last and replace the one they chose.\n      if (!current) return;\n      setState(\n        Component === null\n          ? { status: ProviderComponentStatus.UNAVAILABLE, Component: null }\n          : { status: ProviderComponentStatus.READY, Component },\n      );\n    });\n\n    return () => {\n      current = false;\n    };\n  }, [capability, providerRef, providerComponentRegistry]);\n\n  return state;\n}\n"]}
+{"version":3,"file":"useProviderComponent.frontend.hooks.js","sourceRoot":"","sources":["../../../../src/core/components-registry/useProviderComponent.frontend.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAkBjF;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA8B;IAE9B,MAAM,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEjF,IAAI,yBAAyB,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEvD,OAAO,yBAAyB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;QAC7E,MAAM,QAAQ,GAAG,wBAAwB,EAAE,gBAAgB,CAAC,WAAoB,CAAC,CAAC;QAClF,OAAO;YACL,WAAW;YACX,mBAAmB,EACjB,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,IAAI,gCAAgC,CAAC,WAAW,CAAC;YACzF,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW;YAC3C,WAAW,EAAE,QAAQ,EAAE,WAAW;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAN,IAAY,uBAWX;AAXD,WAAY,uBAAuB;IACjC,8EAA8E;IAC9E,wCAAa,CAAA;IACb,8CAAmB,CAAA;IACnB,0CAAe,CAAA;IACf;;;;OAIG;IACH,sDAA2B,CAAA;AAC7B,CAAC,EAXW,uBAAuB,KAAvB,uBAAuB,QAWlC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA8B,EAC9B,WAA+B;IAE/B,MAAM,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAyB;QACzD,MAAM,EAAE,uBAAuB,CAAC,IAAI;QACpC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,yBAAyB,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACzE,QAAQ,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,KAAK,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;YACjF,0EAA0E;YAC1E,sEAAsE;YACtE,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,QAAQ,CACN,SAAS,KAAK,IAAI;gBAChB,CAAC,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE;gBAClE,CAAC,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * Reading provider-contributed components from a React surface.\n *\n * Two hooks, split along the one line that matters: WHICH providers can fill a\n * capability is known synchronously and their component is not.\n *\n *   - `useProviderComponentChoices` — the live providers offering a component\n *     for a capability, in a stable order, with the label KEY each renders\n *     under. Synchronous, so a surface can draw its chooser on the first frame\n *     instead of flashing an empty one.\n *   - `useProviderComponent` — the chosen provider's component, loaded on\n *     demand, with an explicit status so a surface renders a pending state\n *     rather than nothing.\n *\n * Neither hook picks a provider. That is the defect being fixed: resolution was\n * first-match, so two pickers could not coexist and the winner depended on map\n * order. When there are several, choosing is the surface's job — and a user's.\n *\n * Labels are KEYS, never text. A provider's display name is resolved through\n * the app i18n service at render time by whatever surface shows it; returning a\n * string here would freeze locale-bound copy into a hook and make a missing\n * translation invisible.\n */\n\nimport { useEffect, useState } from 'react';\nimport type { ProviderCapability } from '@wildo-ai/saas-models';\nimport type { FileStorageAccepted } from '@wildo-ai/saas-models/public-runtime';\nimport { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport type { ProviderComponent } from './provider-component-registry.frontend.service';\n\nexport interface ProviderComponentChoice {\n  readonly providerRef: string;\n  /** Resolve through the app i18n service; never render this key. */\n  readonly displayNameLabelKey: string;\n  /** The provider's authored fallback, when it has one. Still not a translation. */\n  readonly displayName?: string;\n  /**\n   * The z_file storage this provider's picker fronts, from the served entry\n   * (#394 P5). A file field offers the picker only when its `storageAccepted`\n   * names this storage; a provider declaring none delivers bytes and is offered\n   * to every field.\n   */\n  readonly fileStorage?: FileStorageAccepted;\n}\n\n/**\n * The providers that are BOTH live for this service and carry a component for\n * this capability.\n *\n * Both halves are required and they come from different channels: a provider\n * can be live with no code (an older bundle) or have code and not be live (an\n * environment that left it off). A surface must offer only what can actually\n * render.\n */\nexport function useProviderComponentChoices(\n  capability: ProviderCapability,\n): ReadonlyArray<ProviderComponentChoice> {\n  const { frontendProviderRegistry, providerComponentRegistry } = useApplication();\n\n  if (providerComponentRegistry === undefined) return [];\n\n  return providerComponentRegistry.listProviders(capability).map((providerRef) => {\n    const provider = frontendProviderRegistry?.getProviderByRef(providerRef as never);\n    return {\n      providerRef,\n      displayNameLabelKey:\n        provider?.metadata.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(providerRef),\n      displayName: provider?.metadata.displayName,\n      fileStorage: provider?.fileStorage,\n    };\n  });\n}\n\n/** Why a provider component is not on screen yet. */\nexport enum ProviderComponentStatus {\n  /** No provider was chosen, or none offers a component for this capability. */\n  NONE = 'NONE',\n  LOADING = 'LOADING',\n  READY = 'READY',\n  /**\n   * The loader failed or returned something unrenderable. The registry has\n   * already reported why; a surface should fall back rather than retry, because\n   * the registry will not run a failed loader again.\n   */\n  UNAVAILABLE = 'UNAVAILABLE',\n}\n\nexport interface ProviderComponentState {\n  readonly status: ProviderComponentStatus;\n  readonly Component: ProviderComponent | null;\n}\n\n/**\n * Loads one provider's component for a capability.\n *\n * Pass `undefined` for the ref while nothing is chosen — the hook does not\n * choose, and a surface with several providers must not load all of them\n * speculatively.\n */\nexport function useProviderComponent(\n  capability: ProviderCapability,\n  providerRef: string | undefined,\n): ProviderComponentState {\n  const { providerComponentRegistry } = useApplication();\n  const [state, setState] = useState<ProviderComponentState>({\n    status: ProviderComponentStatus.NONE,\n    Component: null,\n  });\n\n  useEffect(() => {\n    if (providerComponentRegistry === undefined || providerRef === undefined) {\n      setState({ status: ProviderComponentStatus.NONE, Component: null });\n      return;\n    }\n\n    let current = true;\n    setState({ status: ProviderComponentStatus.LOADING, Component: null });\n\n    void providerComponentRegistry.resolve(capability, providerRef).then((Component) => {\n      // A user can switch provider while one is still downloading. Without this\n      // the slower answer would arrive last and replace the one they chose.\n      if (!current) return;\n      setState(\n        Component === null\n          ? { status: ProviderComponentStatus.UNAVAILABLE, Component: null }\n          : { status: ProviderComponentStatus.READY, Component },\n      );\n    });\n\n    return () => {\n      current = false;\n    };\n  }, [capability, providerRef, providerComponentRegistry]);\n\n  return state;\n}\n"]}

package/dist/esm/core/config/chart-view.frontend.schemas.d.ts

@@ -161,11 +161,11 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 }>>;
                 showLabel: z.ZodOptional<z.ZodBoolean>;
                 labelPosition: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
                     top: "top";
                     bottom: "bottom";
-                    center: "center";
                     inside: "inside";
                     outside: "outside";
                 }>>;
@@ -268,10 +268,10 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 left: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 top: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 textAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     auto: "auto";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
             }, z.core.$strip>>;
             animationDuration: z.ZodOptional<z.ZodNumber>;
@@ -432,9 +432,9 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 rightTop: "rightTop";
             }>>;
             funnelAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
                 left: "left";
                 right: "right";
-                center: "center";
             }>>;
             showLabel: z.ZodOptional<z.ZodBoolean>;
             left: z.ZodOptional<z.ZodString>;
@@ -514,9 +514,9 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                     radial: "radial";
                 }>>;
                 level2LabelAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
                 level3LabelPosition: z.ZodOptional<z.ZodEnum<{
                     inside: "inside";
@@ -688,11 +688,11 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 }>>;
                 showLabel: z.ZodOptional<z.ZodBoolean>;
                 labelPosition: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
                     top: "top";
                     bottom: "bottom";
-                    center: "center";
                     inside: "inside";
                     outside: "outside";
                 }>>;
@@ -795,10 +795,10 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 left: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 top: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 textAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     auto: "auto";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
             }, z.core.$strip>>;
             animationDuration: z.ZodOptional<z.ZodNumber>;
@@ -959,9 +959,9 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 rightTop: "rightTop";
             }>>;
             funnelAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
                 left: "left";
                 right: "right";
-                center: "center";
             }>>;
             showLabel: z.ZodOptional<z.ZodBoolean>;
             left: z.ZodOptional<z.ZodString>;
@@ -1041,9 +1041,9 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                     radial: "radial";
                 }>>;
                 level2LabelAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
                 level3LabelPosition: z.ZodOptional<z.ZodEnum<{
                     inside: "inside";

package/dist/esm/core/config/composite-view.schemas.d.ts

@@ -212,8 +212,6 @@ export declare const CompositeView_BaseFieldsSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodCustom<IconLike, IconLike>>;
     adjacentZoneOnEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
     zoneContentMaxWidth: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        content: "content";
         full: "full";
         sm: "sm";
         md: "md";
@@ -221,6 +219,8 @@ export declare const CompositeView_BaseFieldsSchema: z.ZodObject<{
         xl: "xl";
         measure: "measure";
         "centered-readable": "centered-readable";
+        content: "content";
+        none: "none";
     }>>;
     zoneContentFillsHeight: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -278,8 +278,6 @@ export declare const CompositeViewDefinitionBaseSchema: z.ZodIntersection<z.ZodD
     icon: z.ZodOptional<z.ZodCustom<IconLike, IconLike>>;
     adjacentZoneOnEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
     zoneContentMaxWidth: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        content: "content";
         full: "full";
         sm: "sm";
         md: "md";
@@ -287,6 +285,8 @@ export declare const CompositeViewDefinitionBaseSchema: z.ZodIntersection<z.ZodD
         xl: "xl";
         measure: "measure";
         "centered-readable": "centered-readable";
+        content: "content";
+        none: "none";
     }>>;
     zoneContentFillsHeight: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;

package/dist/esm/core/config/engine-settings-destinations.d.ts

@@ -1,71 +1,4 @@
 import type { SettingsDestination, SettingsHubConfig } from './settings-hub.frontend.schemas';
-/** @wildo_source:part:start saas.frontend.settings-hub.engine-destinations facet:layer:frontend facet:family:config facet:audience:app-developer */
-/**
- * Every settings destination the engine ships, as a named vocabulary.
- *
- * Exists because these refs are a CLOSED vocabulary that engine code addresses
- * by name — the billing command-menu entry opens `/settings/billing`, and any
- * future engine launcher will do the same. Before this enum, `'billing'` was a
- * bare literal in `billing-launcher.ts` with nothing tying it to the catalog
- * entry it names: rename the destination and the command silently resolves to
- * the hub's DEFAULT section instead of failing, so a menu item labelled
- * "Billing" would open Profile.
- *
- * **Engine code must address a destination through this enum. Application
- * config addresses one by string**, deliberately: a placement is authored data,
- * an application should not import an engine enum to write its own rail, and a
- * typo there is caught at DEV startup by `verifySettingsHubContent`.
- */
-export declare enum EngineSettingsDestinationRef {
-    /** The signed-in user's own profile record. */
-    PROFILE = "profile",
-    /** Password, MFA, sessions — a bespoke engine panel. */
-    SECURITY = "security",
-    /** Theme and appearance preferences — a bespoke engine panel. */
-    APPEARANCE = "appearance",
-    /** The signed-in user's own preference record. */
-    PREFERENCES = "preferences",
-    /** Invitations addressed TO the signed-in user, across organizations they have not joined. */
-    MY_INVITATIONS = "my-invitations",
-    /** The current organization's own record. Org owner/admin only. */
-    ORGANIZATION_GENERAL = "organization-general",
-    /** Organization membership list, including INVITED rows. Org owner/admin only. */
-    MEMBERS = "members",
-    /** Billing home — subscription, plans, usage, invoices. Gated on the `billingEnabled` capability. */
-    BILLING = "billing",
-    /** Organization API keys. Org owner/admin only. */
-    API_KEYS = "api-keys",
-    /**
-     * The tenant's OWN credentials toward third parties — its Slack workspace token, its CRM key.
-     *
-     * The mirror image of {@link API_KEYS} and easy to confuse with it: an API key is a credential
-     * somebody uses to reach THIS application, and one of these is a credential this application uses
-     * to reach somebody else ON THIS TENANT'S BEHALF. Same administrator, opposite direction.
-     */
-    PROVIDER_CREDENTIALS = "provider-credentials",
-    /**
-     * The signed-in person's OWN credentials toward third parties — their personal API key, the
-     * account they connected themselves.
-     *
-     * Distinct from {@link PROVIDER_CREDENTIALS} by OWNER, not by feature, and the two must never be
-     * merged into one screen. A tenant's credential is a shared integration an administrator
-     * configures for everyone; this one is an individual's own account, which nobody else may see,
-     * spend or remove. Putting them on one page would put a colleague's personal vendor token in an
-     * administrator's view — and the resource's authorization refuses that, so the screen would show
-     * an empty list nobody could explain.
-     */
-    MY_PROVIDER_CREDENTIALS = "my-provider-credentials",
-    /** Single sign-on configuration and connections. */
-    SSO = "sso",
-    /** SCIM directory provisioning configuration and tokens. */
-    SCIM = "scim",
-    /** Audit-event streaming configuration and failed-delivery queue. */
-    SIEM = "siem",
-    /** Outbound webhook endpoints and delivery log. */
-    WEBHOOKS = "webhooks",
-    /** The organization's audit log. Org owner/admin only. */
-    AUDIT_LOGS = "audit-logs"
-}
 /**
  * Every settings destination the engine ships, keyed by `ref`.
  *
@@ -75,8 +8,6 @@ export declare enum EngineSettingsDestinationRef {
  * meant to remove.
  */
 export declare const ENGINE_SETTINGS_DESTINATIONS: readonly SettingsDestination[];
-/** Every destination ref the engine ships — the set a placement is validated against. */
-export declare const ENGINE_SETTINGS_DESTINATION_REFS: ReadonlySet<string>;
 /**
  * The full placement set `wildo init` scaffolds into a new application's config.
  *

package/dist/esm/core/config/engine-settings-destinations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-settings-destinations.d.ts","sourceRoot":"","sources":["../../../../src/core/config/engine-settings-destinations.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAE9F,oJAAoJ;AACpJ;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,4BAA4B;IACtC,+CAA+C;IAC/C,OAAO,YAAY;IACnB,wDAAwD;IACxD,QAAQ,aAAa;IACrB,iEAAiE;IACjE,UAAU,eAAe;IACzB,kDAAkD;IAClD,WAAW,gBAAgB;IAC3B,8FAA8F;IAC9F,cAAc,mBAAmB;IACjC,mEAAmE;IACnE,oBAAoB,yBAAyB;IAC7C,kFAAkF;IAClF,OAAO,YAAY;IACnB,qGAAqG;IACrG,OAAO,YAAY;IACnB,mDAAmD;IACnD,QAAQ,aAAa;IACrB;;;;;;OAMG;IACH,oBAAoB,yBAAyB;IAC7C;;;;;;;;;;OAUG;IACH,uBAAuB,4BAA4B;IACnD,oDAAoD;IACpD,GAAG,QAAQ;IACX,4DAA4D;IAC5D,IAAI,SAAS;IACb,qEAAqE;IACrE,IAAI,SAAS;IACb,mDAAmD;IACnD,QAAQ,aAAa;IACrB,0DAA0D;IAC1D,UAAU,eAAe;CAC1B;AA4BD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,mBAAmB,EA6QtE,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,gCAAgC,EAAE,WAAW,CAAC,MAAM,CAEhE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBA0B1C,CAAC"}
+{"version":3,"file":"engine-settings-destinations.d.ts","sourceRoot":"","sources":["../../../../src/core/config/engine-settings-destinations.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AA2B9F;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,mBAAmB,EA+RtE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBA0B1C,CAAC"}