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

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

@@ -1,188 +1,43 @@
 /**
- * Components contributed by PROVIDERS, keyed by the capability each fills.
- *
- * ## Why this is a sibling of `ComponentRegistryService` and not an extension
- *
- * The two index different vocabularies, and merging them would put an open one
- * into a key built for a closed one:
- *
- *   - `ComponentRegistryService` keys `componentType:preset[:category]`, where
- *     `FrontendComponentType` is a CLOSED enum the engine owns. Exactly one
- *     component answers a key, resolution is synchronous, and a missing
- *     registration is a startup refusal.
- *   - This registry keys `capability:providerRef`, where `ProviderCapability`
- *     is OPEN — an application extends it by TypeScript module augmentation.
- *     SEVERAL providers may answer one capability, the component arrives
- *     asynchronously, and none of it is required for the app to mount.
- *
- * Forcing provider components through the closed enum would mean an engine edit
- * for every new provider capability — precisely what the open vocabulary exists
- * to avoid — and would make "which component answers this key" ambiguous in a
- * registry whose whole contract is that it is not.
- *
- * It also keeps the blast radius honest. `ComponentRegistryService` has sixteen
- * consumers across four packages (re-measured 2026-09-06; the plan's figure of
- * eleven predates several of them), most of them outside this slice's territory.
- * A sibling registry touches none of them.
- *
- * ## Several providers, and no silent winner
- *
- * `listProviders` returns every provider offering a component for a capability,
- * in registration order, and nothing here picks one. That is deliberate: the
- * defect being fixed is that resolution WAS first-match, so a Drive picker and
- * a Dropbox picker could not coexist and the winner depended on map order. A
- * surface with two providers has a choice to present; a registry that answered
- * it would be making a product decision in a lookup table.
+ * The APPLICATION's half of the provider-component registry.
+ *
+ * The registry itself — keyed `capability:providerRef`, consent-gated, script-before-component,
+ * browser-only — lives in `@wildo-ai/external-connectors-public` since #1703, because the website
+ * and the documentation site have to build the same registry from the same `components`
+ * declaration and neither may import this package. Read its module header
+ * (`createProviderComponentRegistry`) for why it is a sibling of `ComponentRegistryService` and why
+ * it never picks a provider.
+ *
+ * What stays here is what only the application has:
+ *
+ *   - the component TYPE the application renders (`ProviderComponent`), which fills the shared
+ *     registry's type parameter;
+ *   - the application's facet-library door, `contributeProviderComponentLoaders`, through which
+ *     `presets-components` supplies loaders for engine-shipped components (#394). It is module-level
+ *     state on purpose: `registerDefaultPresets` runs before `startApplication` builds the registry,
+ *     the same ordering `ComponentRegistryService.register` relies on. The website and the
+ *     documentation site take the same contributions as an explicit input instead, because their
+ *     wiring has a single construction site that can carry it.
  */
 import type React from 'react';
-import type { ProviderCapability } from '@wildo-ai/saas-models';
-import type { ProviderFrontendComponentDescriptor } from '@wildo-ai/saas-models/public-runtime';
-/** A loader as a provider module declares it: on demand, returning the component. */
-export type ProviderComponentLoader = () => Promise<unknown>;
-/** Why a provider component could not be registered or loaded. */
-export declare enum ProviderComponentDiagnosticKind {
-    /**
-     * A second registration arrived for one capability AND provider. The first is
-     * kept: a duplicate is a wiring mistake, and swapping the live component
-     * under a mounted surface would be worse than ignoring it.
-     */
-    DUPLICATE_REGISTRATION = "DUPLICATE_REGISTRATION",
-    /** The loader threw or rejected. That provider's component is unavailable; others are not affected. */
-    LOAD_FAILED = "LOAD_FAILED",
-    /**
-     * The loader resolved something that is not a component. Almost always a
-     * 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",
-    /**
-     * 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;
-    readonly capability: string;
-    readonly providerRef: string;
-    readonly message: string;
-    readonly cause?: unknown;
-}
-export interface ProviderComponentRegistration {
-    readonly capability: ProviderCapability;
-    readonly providerRef: string;
-    readonly load: ProviderComponentLoader;
-    /**
-     * What the provider DECLARED about this component — today, what a selection
-     * from it contains. Kept beside the loader rather than looked up from the
-     * DATA entry at the use site, because a surface needs it BEFORE it decides to
-     * load anything, and because the two would then be two sources for one fact.
-     */
-    readonly descriptor: ProviderFrontendComponentDescriptor;
-}
-/** A component type this registry will hand back once loaded. */
+import type { ProviderComponentLoaderContribution, ProviderComponentRegistry } from '@wildo-ai/external-connectors-public/app';
+/** A component type the application's registry hands back once loaded. */
 export type ProviderComponent = React.ComponentType<never>;
-export interface ProviderComponentRegistry {
-    /**
-     * Every provider offering a component for this capability, in registration
-     * order. Synchronous ON PURPOSE: a surface has to render its chooser before
-     * any component is loaded, and awaiting here would make an empty frame.
-     */
-    listProviders(capability: ProviderCapability): ReadonlyArray<string>;
-    /** Whether this exact provider offers a component for this capability. */
-    has(capability: ProviderCapability, providerRef: string): boolean;
-    /**
-     * What the provider declared about its component, without loading it —
-     * `undefined` when this provider offers none for this capability.
-     *
-     * Synchronous and separate from `resolve` on purpose: the framework routes a
-     * selection according to what was DECLARED, and a routing decision that had to
-     * await a download would mean downloading a picker to find out whether the
-     * surface can use it.
-     */
-    describe(capability: ProviderCapability, providerRef: string): ProviderFrontendComponentDescriptor | undefined;
-    /**
-     * Loads one provider's component. The loader runs at most once per pair —
-     * a chooser that mounts and unmounts must not re-download a picker — and a
-     * failure is reported and returns `null` rather than throwing into a render.
-     */
-    resolve(capability: ProviderCapability, providerRef: string): Promise<ProviderComponent | null>;
-}
-export declare function createProviderComponentRegistry(input?: {
-    readonly registrations?: Iterable<ProviderComponentRegistration>;
-    readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;
-}): ProviderComponentRegistry;
-/** The shape this derivation needs off a hydrated provider module. */
-interface ComponentBearingProviderModule {
-    metadata: {
-        ref: string;
-    };
-    components?: Readonly<Record<string, ProviderFrontendComponentDescriptor & {
-        load?: ProviderComponentLoader;
-    }>>;
-}
+/** The application's provider-component registry: the shared registry, holding React components. */
+export type AppProviderComponentRegistry = ProviderComponentRegistry<ProviderComponent>;
 /**
- * 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 —
+ * 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.
+ * 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>, 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":"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"}
+{"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;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,mCAAmC,EACnC,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAGlD,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAE3D,oGAAoG;AACpG,MAAM,MAAM,4BAA4B,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;AAIxF;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,QAAQ,CAAC,mCAAmC,CAAC,GAAG,IAAI,CAE/G;AAED,+FAA+F;AAC/F,wBAAgB,uCAAuC,IAAI,WAAW,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAElH;AAED,mDAAmD;AACnD,wBAAgB,yCAAyC,IAAI,IAAI,CAEhE"}

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

@@ -1,193 +1,38 @@
 /**
- * Components contributed by PROVIDERS, keyed by the capability each fills.
- *
- * ## Why this is a sibling of `ComponentRegistryService` and not an extension
- *
- * The two index different vocabularies, and merging them would put an open one
- * into a key built for a closed one:
- *
- *   - `ComponentRegistryService` keys `componentType:preset[:category]`, where
- *     `FrontendComponentType` is a CLOSED enum the engine owns. Exactly one
- *     component answers a key, resolution is synchronous, and a missing
- *     registration is a startup refusal.
- *   - This registry keys `capability:providerRef`, where `ProviderCapability`
- *     is OPEN — an application extends it by TypeScript module augmentation.
- *     SEVERAL providers may answer one capability, the component arrives
- *     asynchronously, and none of it is required for the app to mount.
- *
- * Forcing provider components through the closed enum would mean an engine edit
- * for every new provider capability — precisely what the open vocabulary exists
- * to avoid — and would make "which component answers this key" ambiguous in a
- * registry whose whole contract is that it is not.
- *
- * It also keeps the blast radius honest. `ComponentRegistryService` has sixteen
- * consumers across four packages (re-measured 2026-09-06; the plan's figure of
- * eleven predates several of them), most of them outside this slice's territory.
- * A sibling registry touches none of them.
- *
- * ## Several providers, and no silent winner
- *
- * `listProviders` returns every provider offering a component for a capability,
- * in registration order, and nothing here picks one. That is deliberate: the
- * defect being fixed is that resolution WAS first-match, so a Drive picker and
- * a Dropbox picker could not coexist and the winner depended on map order. A
- * surface with two providers has a choice to present; a registry that answered
- * it would be making a product decision in a lookup table.
+ * The APPLICATION's half of the provider-component registry.
+ *
+ * The registry itself — keyed `capability:providerRef`, consent-gated, script-before-component,
+ * browser-only — lives in `@wildo-ai/external-connectors-public` since #1703, because the website
+ * and the documentation site have to build the same registry from the same `components`
+ * declaration and neither may import this package. Read its module header
+ * (`createProviderComponentRegistry`) for why it is a sibling of `ComponentRegistryService` and why
+ * it never picks a provider.
+ *
+ * What stays here is what only the application has:
+ *
+ *   - the component TYPE the application renders (`ProviderComponent`), which fills the shared
+ *     registry's type parameter;
+ *   - the application's facet-library door, `contributeProviderComponentLoaders`, through which
+ *     `presets-components` supplies loaders for engine-shipped components (#394). It is module-level
+ *     state on purpose: `registerDefaultPresets` runs before `startApplication` builds the registry,
+ *     the same ordering `ComponentRegistryService.register` relies on. The website and the
+ *     documentation site take the same contributions as an explicit input instead, because their
+ *     wiring has a single construction site that can carry it.
  */
-/** Why a provider component could not be registered or loaded. */
-export var ProviderComponentDiagnosticKind;
-(function (ProviderComponentDiagnosticKind) {
-    /**
-     * A second registration arrived for one capability AND provider. The first is
-     * kept: a duplicate is a wiring mistake, and swapping the live component
-     * under a mounted surface would be worse than ignoring it.
-     */
-    ProviderComponentDiagnosticKind["DUPLICATE_REGISTRATION"] = "DUPLICATE_REGISTRATION";
-    /** The loader threw or rejected. That provider's component is unavailable; others are not affected. */
-    ProviderComponentDiagnosticKind["LOAD_FAILED"] = "LOAD_FAILED";
-    /**
-     * The loader resolved something that is not a component. Almost always a
-     * loader returning a MODULE NAMESPACE — `() => import('./Picker.js')` — where it
-     * 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'
-        && value !== null
-        && value[Symbol.toStringTag] === 'Module');
-}
+import { indexProviderComponentLoaderContributions } from '@wildo-ai/external-connectors-public/app';
+let contributedLoaders = new Map();
 /**
- * A React component is a function, or an object for `memo` / `forwardRef` /
- * `lazy`. Anything else — a namespace, a string, a plain data object — cannot
- * be rendered, and finding out at render time means a blank surface with a
- * stack trace pointing at React rather than at the provider.
- */
-function looksLikeComponent(value) {
-    return typeof value === 'function' || (typeof value === 'object' && value !== null);
-}
-export function createProviderComponentRegistry(input) {
-    const raise = (diagnostic) => {
-        input?.onDiagnostic?.(diagnostic);
-    };
-    const loaders = new Map();
-    const descriptors = new Map();
-    const byCapability = new Map();
-    const loaded = new Map();
-    const keyOf = (capability, providerRef) => `${capability}:${providerRef}`;
-    for (const registration of input?.registrations ?? []) {
-        const key = keyOf(registration.capability, registration.providerRef);
-        if (loaders.has(key)) {
-            raise({
-                kind: ProviderComponentDiagnosticKind.DUPLICATE_REGISTRATION,
-                capability: registration.capability,
-                providerRef: registration.providerRef,
-                message: `Provider "${registration.providerRef}" registered a component for "${registration.capability}" `
-                    + 'more than once. The first registration is kept.',
-            });
-            continue;
-        }
-        loaders.set(key, registration.load);
-        descriptors.set(key, registration.descriptor);
-        const providers = byCapability.get(registration.capability) ?? [];
-        providers.push(registration.providerRef);
-        byCapability.set(registration.capability, providers);
-    }
-    return {
-        listProviders(capability) {
-            return byCapability.get(capability) ?? [];
-        },
-        has(capability, providerRef) {
-            return loaders.has(keyOf(capability, providerRef));
-        },
-        describe(capability, providerRef) {
-            return descriptors.get(keyOf(capability, providerRef));
-        },
-        resolve(capability, providerRef) {
-            const key = keyOf(capability, providerRef);
-            const cached = loaded.get(key);
-            if (cached !== undefined)
-                return cached;
-            const load = loaders.get(key);
-            if (load === undefined)
-                return Promise.resolve(null);
-            const pending = (async () => {
-                let value;
-                try {
-                    value = await load();
-                }
-                catch (cause) {
-                    raise({
-                        kind: ProviderComponentDiagnosticKind.LOAD_FAILED,
-                        capability,
-                        providerRef,
-                        message: `Provider "${providerRef}" failed to load its "${capability}" component.`,
-                        cause,
-                    });
-                    return null;
-                }
-                if (isModuleNamespace(value)) {
-                    raise({
-                        kind: ProviderComponentDiagnosticKind.LOADED_VALUE_IS_NOT_A_COMPONENT,
-                        capability,
-                        providerRef,
-                        message: `Provider "${providerRef}" returned a MODULE for its "${capability}" component instead of the `
-                            + "component itself. Write `async () => (await import('./Picker.js')).Picker` rather than "
-                            + "`() => import('./Picker.js')`.",
-                    });
-                    return null;
-                }
-                if (!looksLikeComponent(value)) {
-                    raise({
-                        kind: ProviderComponentDiagnosticKind.LOADED_VALUE_IS_NOT_A_COMPONENT,
-                        capability,
-                        providerRef,
-                        message: `Provider "${providerRef}" returned a ${typeof value} for its "${capability}" component. A React `
-                            + 'component is a function, or an object for memo / forwardRef / lazy.',
-                    });
-                    return null;
-                }
-                return value;
-            })();
-            // Cached even when it resolves to null: a loader that failed once must not
-            // be retried on every render of a chooser that lists it.
-            loaded.set(key, pending);
-            return pending;
-        },
-    };
-}
-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 —
+ * 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.
+ * 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);
-    }
+    contributedLoaders = indexProviderComponentLoaderContributions([...contributedLoaders.values(), ...loaders]);
 }
 /** Every contributed loader, keyed `capability:providerRef`. Read at registry construction. */
 export function listContributedProviderComponentLoaders() {
@@ -195,61 +40,6 @@ export function listContributedProviderComponentLoaders() {
 }
 /** Tests only: forget every contributed loader. */
 export function _clearContributedProviderComponentLoaders() {
-    contributedLoaders.clear();
-}
-/**
- * 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, 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,
-                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.
-                descriptor: { selectionDelivery: declaration.selectionDelivery },
-            });
-        }
-    }
-    return registrations;
+    contributedLoaders = new Map();
 }
 //# sourceMappingURL=provider-component-registry.frontend.service.js.map

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   * 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"]}
+{"version":3,"file":"provider-component-registry.frontend.service.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/provider-component-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH,OAAO,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AAQrG,IAAI,kBAAkB,GAA6D,IAAI,GAAG,EAAE,CAAC;AAE7F;;;;;;;;;GASG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAAsD;IACvG,kBAAkB,GAAG,yCAAyC,CAAC,CAAC,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;AAC/G,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,uCAAuC;IACrD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,yCAAyC;IACvD,kBAAkB,GAAG,IAAI,GAAG,EAAE,CAAC;AACjC,CAAC","sourcesContent":["/**\n * The APPLICATION's half of the provider-component registry.\n *\n * The registry itself — keyed `capability:providerRef`, consent-gated, script-before-component,\n * browser-only — lives in `@wildo-ai/external-connectors-public` since #1703, because the website\n * and the documentation site have to build the same registry from the same `components`\n * declaration and neither may import this package. Read its module header\n * (`createProviderComponentRegistry`) for why it is a sibling of `ComponentRegistryService` and why\n * it never picks a provider.\n *\n * What stays here is what only the application has:\n *\n *   - the component TYPE the application renders (`ProviderComponent`), which fills the shared\n *     registry's type parameter;\n *   - the application's facet-library door, `contributeProviderComponentLoaders`, through which\n *     `presets-components` supplies loaders for engine-shipped components (#394). It is module-level\n *     state on purpose: `registerDefaultPresets` runs before `startApplication` builds the registry,\n *     the same ordering `ComponentRegistryService.register` relies on. The website and the\n *     documentation site take the same contributions as an explicit input instead, because their\n *     wiring has a single construction site that can carry it.\n */\n\nimport type React from 'react';\nimport type {\n  ProviderComponentLoaderContribution,\n  ProviderComponentRegistry,\n} from '@wildo-ai/external-connectors-public/app';\nimport { indexProviderComponentLoaderContributions } from '@wildo-ai/external-connectors-public/app';\n\n/** A component type the application's registry hands back once loaded. */\nexport type ProviderComponent = React.ComponentType<never>;\n\n/** The application's provider-component registry: the shared registry, holding React components. */\nexport type AppProviderComponentRegistry = ProviderComponentRegistry<ProviderComponent>;\n\nlet contributedLoaders: ReadonlyMap<string, ProviderComponentLoaderContribution> = new Map();\n\n/**\n * Registers loaders for provider components a facet library ships. Module-level and idempotent per\n * key, like `ComponentRegistryService.register`: the app calls the library's registration entry once\n * at startup, and a second 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 SILENT, by the same rule\n * as code without data in `hydrateFrontendProviderModules`: a bundle legitimately ships a picker an\n * environment leaves off.\n */\nexport function contributeProviderComponentLoaders(loaders: Iterable<ProviderComponentLoaderContribution>): void {\n  contributedLoaders = indexProviderComponentLoaderContributions([...contributedLoaders.values(), ...loaders]);\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 = new Map();\n}\n"]}

package/dist/esm/core/components-registry/register-framework-layouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-framework-layouts.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/register-framework-layouts.ts"],"names":[],"mappings":"AAoGA,wBAAgB,wBAAwB,IAAI,IAAI,CAiF/C"}
+{"version":3,"file":"register-framework-layouts.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/register-framework-layouts.ts"],"names":[],"mappings":"AAsGA,wBAAgB,wBAAwB,IAAI,IAAI,CAmF/C"}

package/dist/esm/core/components-registry/register-framework-layouts.js

@@ -60,6 +60,7 @@ import { FormFieldFile_Preset_Default } from '../../components/form/fields/form-
 import { FormFieldMoney_Preset_Default } from '../../components/form/fields/form-field-money.js';
 import { FormFieldDuration_Preset_Default } from '../../components/form/fields/form-field-duration.js';
 import { FormFieldPhone_Preset_Default } from '../../components/form/fields/form-field-phone.js';
+import { FormFieldAddress_Preset_Default } from '../../components/form/fields/form-field-address.js';
 import { FormFieldNumber_Preset_Default } from '../../components/form/fields/form-field-number.js';
 import { FormFieldRangeBigDecimal_Preset_Default } from '../../components/form/fields/form-field-range-bigdecimal.js';
 import { FormFieldRangeMoney_Preset_Default } from '../../components/form/fields/form-field-range-money.js';
@@ -72,6 +73,7 @@ import { PublicLayoutPreset_FileUploadGrant_Default } from '../../components/fil
 import { PublicLayoutPreset_AuthCallback_Default } from '../../components/auth/Auth_AuthCallback.js';
 import { PublicLayoutPreset_MagicLinkVerify_Default } from '../../components/auth/Auth_MagicLinkVerify.js';
 import { PublicLayoutPreset_EnrollmentRequired_Default } from '../../components/auth/Auth_EnrollmentRequired.js';
+import { PublicLayoutPreset_OrganizationOnboarding_Default } from '../../components/auth/Auth_OrganizationOnboarding.js';
 import { PublicLayoutPreset_MfaChallenge_Default } from '../../components/auth/Auth_MfaChallenge.js';
 import { PublicLayoutPreset_UserInvitation_Default } from '../../components/auth/Auth_Invitation.js';
 import { PublicLayoutPreset_UserPasswordLost_Default } from '../../components/auth/Auth_PasswordLost.js';
@@ -102,6 +104,7 @@ export function registerFrameworkLayouts() {
     ComponentRegistryService.register(FrontendComponentType.PUBLIC_LAYOUTS_AUTH_CALLBACK, CorePresetNames.DEFAULT, PublicLayoutPreset_AuthCallback_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.PUBLIC_LAYOUTS_MAGIC_LINK_VERIFY, CorePresetNames.DEFAULT, PublicLayoutPreset_MagicLinkVerify_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.PUBLIC_LAYOUTS_ENROLLMENT_REQUIRED, CorePresetNames.DEFAULT, PublicLayoutPreset_EnrollmentRequired_Default, { isConfigurable: true });
+    ComponentRegistryService.register(FrontendComponentType.PUBLIC_LAYOUTS_ORGANIZATION_ONBOARDING, CorePresetNames.DEFAULT, PublicLayoutPreset_OrganizationOnboarding_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.PUBLIC_LAYOUTS_MFA_CHALLENGE, CorePresetNames.DEFAULT, PublicLayoutPreset_MfaChallenge_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.PUBLIC_LAYOUTS_OAUTH_CONSENT, CorePresetNames.DEFAULT, PublicLayoutPreset_OAuthConsent_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.PUBLIC_LAYOUTS_OAUTH_LOGGED_OUT, CorePresetNames.DEFAULT, PublicLayoutPreset_OAuthLoggedOut_Default, { isConfigurable: true });
@@ -138,6 +141,7 @@ export function registerFrameworkLayouts() {
     ComponentRegistryService.register(FrontendComponentType.LOW_LEVEL_FORM_FIELD_MONEY, CorePresetNames.DEFAULT, FormFieldMoney_Preset_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.LOW_LEVEL_FORM_FIELD_DURATION, CorePresetNames.DEFAULT, FormFieldDuration_Preset_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.LOW_LEVEL_FORM_FIELD_PHONE, CorePresetNames.DEFAULT, FormFieldPhone_Preset_Default, { isConfigurable: true });
+    ComponentRegistryService.register(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, CorePresetNames.DEFAULT, FormFieldAddress_Preset_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.LOW_LEVEL_FORM_FIELD_NUMBER, CorePresetNames.DEFAULT, FormFieldNumber_Preset_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.LOW_LEVEL_FORM_FIELD_RANGE_BIGDECIMAL, CorePresetNames.DEFAULT, FormFieldRangeBigDecimal_Preset_Default, { isConfigurable: true });
     ComponentRegistryService.register(FrontendComponentType.LOW_LEVEL_FORM_FIELD_RANGE_DATE, CorePresetNames.DEFAULT, FormFieldRangeDate_Preset_Default, { isConfigurable: true });