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

package/dist/esm/components/settings/SettingsResourceOperationPanel.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SettingsResourceOperationPanel — renders an auto-generated resource surface
+ * inside a Settings Hub section.
+ *
+ * This is the `RESOURCE_OPERATION` target renderer. It produces the exact same
+ * `FrontendResourceOperationContext` a routed resource page would, but sources
+ * the scope identifiers from live `AppScope` instead of URL params — that is the
+ * whole reason org-scoped resources (members, API keys, billing) can render here
+ * without a `/organizations/:organizationId/...` route. The recipe mirrors
+ * `ResourcePageWrapper` (core/runtime/AppRouter.tsx) minus URL handling:
+ *
+ *   1. resolve the resource config + the operation object from the registry
+ *   2. build `contextResourceIdentifiers` via the SAME
+ *      `ScopeUtilsService.buildResourceOperationContextIdentifiers` routed pages
+ *      use — primary-scope defaults injected from `currentOrganizationId` /
+ *      `currentUserId`, so an `ORGANIZATIONS`-scoped resource gets
+ *      `{ organizations: <id> }` automatically
+ *   3. derive `parentResourcesRequirements` from those identifiers (the
+ *      context-identifier variant, since there are no route params to walk)
+ *   4. build the operation context and hand it to `SettingsSectionNavigationHost`
+ *      as the section's ROOT surface
+ *
+ * The host wraps the surface in a per-section navigation stack so related actions
+ * (view/edit/create + their back/post-action) drill WITHIN the panel instead of
+ * escaping the hub to the global zones. The hub is overlay content, so the
+ * surfaces run in the OVERLAY navigation zone, but the host's scoped controller
+ * intercepts their navigation — see `SettingsSectionNavigationHost`.
+ *
+ * @see SettingsSectionNavigationHost.tsx — the per-section navigation stack
+ * @see settings-hub.frontend.schemas.ts — `SettingsResourceOperationTarget`
+ * @see core/runtime/AppRouter.tsx — `ResourcePageWrapper`, the routed counterpart
+ */
+import React from 'react';
+export interface SettingsResourceOperationPanelProps {
+    /** Registry resource type (e.g. `organizationMembers`). */
+    resourceType: string;
+    /** Operation identifier to render (e.g. `list`, `read`). */
+    operation: string;
+    /** Disambiguates when several operations share the identifier (variant key). */
+    operationVariant?: string;
+}
+export declare function SettingsResourceOperationPanel({ resourceType, operation, operationVariant, }: SettingsResourceOperationPanelProps): React.JSX.Element;
+//# sourceMappingURL=SettingsResourceOperationPanel.d.ts.map

package/dist/esm/components/settings/SettingsResourceOperationPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsResourceOperationPanel.d.ts","sourceRoot":"","sources":["../../../../../src/components/settings/SettingsResourceOperationPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAkB,MAAM,OAAO,CAAC;AAYvC,MAAM,WAAW,mCAAmC;IAClD,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAiCD,wBAAgB,8BAA8B,CAAC,EAC7C,YAAY,EACZ,SAAS,EACT,gBAAgB,GACjB,EAAE,mCAAmC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuDzD"}

package/dist/esm/components/settings/SettingsResourceOperationPanel.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * SettingsResourceOperationPanel — renders an auto-generated resource surface
+ * inside a Settings Hub section.
+ *
+ * This is the `RESOURCE_OPERATION` target renderer. It produces the exact same
+ * `FrontendResourceOperationContext` a routed resource page would, but sources
+ * the scope identifiers from live `AppScope` instead of URL params — that is the
+ * whole reason org-scoped resources (members, API keys, billing) can render here
+ * without a `/organizations/:organizationId/...` route. The recipe mirrors
+ * `ResourcePageWrapper` (core/runtime/AppRouter.tsx) minus URL handling:
+ *
+ *   1. resolve the resource config + the operation object from the registry
+ *   2. build `contextResourceIdentifiers` via the SAME
+ *      `ScopeUtilsService.buildResourceOperationContextIdentifiers` routed pages
+ *      use — primary-scope defaults injected from `currentOrganizationId` /
+ *      `currentUserId`, so an `ORGANIZATIONS`-scoped resource gets
+ *      `{ organizations: <id> }` automatically
+ *   3. derive `parentResourcesRequirements` from those identifiers (the
+ *      context-identifier variant, since there are no route params to walk)
+ *   4. build the operation context and hand it to `SettingsSectionNavigationHost`
+ *      as the section's ROOT surface
+ *
+ * The host wraps the surface in a per-section navigation stack so related actions
+ * (view/edit/create + their back/post-action) drill WITHIN the panel instead of
+ * escaping the hub to the global zones. The hub is overlay content, so the
+ * surfaces run in the OVERLAY navigation zone, but the host's scoped controller
+ * intercepts their navigation — see `SettingsSectionNavigationHost`.
+ *
+ * @see SettingsSectionNavigationHost.tsx — the per-section navigation stack
+ * @see settings-hub.frontend.schemas.ts — `SettingsResourceOperationTarget`
+ * @see core/runtime/AppRouter.tsx — `ResourcePageWrapper`, the routed counterpart
+ */
+import { useMemo } from 'react';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+import { useAppScopeSafe } from '../../core/scope/useAppScope.js';
+import { ScopeUtilsService } from '../../core/scope/scope.utils.frontend.service.js';
+import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { SettingsSectionNavigationHost } from './SettingsSectionNavigationHost.js';
+/**
+ * Select the operation object matching `operationIdentifier` (+ optional
+ * `variantKey`) from a resource config. Mirrors the resolution in
+ * `launcher-resolution.ts` (`resolveResourceOperation`): an explicit variant key
+ * wins; otherwise prefer the single default, then the single match, else
+ * ambiguous → undefined.
+ */
+function findResourceConfigOperation(config, operationIdentifier, variantKey) {
+    const operations = Array.isArray(config.operations) ? config.operations : [];
+    const matching = operations.filter(op => String(op.operationIdentifier) === operationIdentifier);
+    if (matching.length === 0)
+        return undefined;
+    if (variantKey) {
+        return matching.find(op => op.variantKey === variantKey);
+    }
+    const defaults = matching.filter(op => op.isOperationDefault === true);
+    if (defaults.length === 1)
+        return defaults[0];
+    if (matching.length === 1)
+        return matching[0];
+    return undefined;
+}
+/** Boundary guard — a misconfigured section must not crash the whole hub. */
+function SettingsResourceUnavailable({ message }) {
+    return _jsx("div", { className: "p-card text-sm text-muted-foreground", children: message });
+}
+export function SettingsResourceOperationPanel({ resourceType, operation, operationVariant, }) {
+    const { registry } = useResourceRegistry();
+    const appScope = useAppScopeSafe();
+    const resourceContext = useMemo(() => {
+        const config = registry.resourceConfigurations[resourceType];
+        if (!config)
+            return undefined;
+        const resolvedOperation = findResourceConfigOperation(config, operation, operationVariant);
+        if (!resolvedOperation)
+            return undefined;
+        // Inject the live primary-scope identifiers (org/user/app) so an org-scoped
+        // resource resolves to the current organization without a URL param.
+        const contextResourceIdentifiers = ScopeUtilsService.buildResourceOperationContextIdentifiers({
+            currentUserId: appScope?.currentUserId,
+            currentOrganizationId: appScope?.currentOrganizationId,
+            currentApplicationId: appScope?.currentApplicationId,
+            currentAnonymousUserId: appScope?.currentAnonymousUserId,
+            primaryScope: config.resourcePrimaryScope,
+            liveAppScopeContextResourceIdentifiers: appScope?.buildContextResourceIdentifiers?.(),
+            explicitContextResourceIdentifiers: {},
+        });
+        // Derive parent requirements from the injected identifiers (no route params
+        // to walk here), so the scoped LIST/READ query carries its org parent edge.
+        const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(resourceType, contextResourceIdentifiers, registry);
+        return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+            resourceType,
+            operation: resolvedOperation,
+            contextResourceIdentifiers,
+            parentResourcesRequirements,
+        });
+    }, [registry, resourceType, operation, operationVariant, appScope]);
+    if (!resourceContext) {
+        return (_jsx(SettingsResourceUnavailable, { message: `Settings surface unavailable for ${resourceType} (${operation}).` }));
+    }
+    // Host the surface inside the section's own navigation stack, so related
+    // actions (view/edit/create + their back/post-action) drill WITHIN this panel
+    // instead of escaping the hub to the global zones (and 404-ing on org-scoped
+    // routes that aren't registered). The host installs a scoped navigation
+    // controller; the surface beneath renders the current stack level.
+    return _jsx(SettingsSectionNavigationHost, { rootContext: resourceContext });
+}
+//# sourceMappingURL=SettingsResourceOperationPanel.js.map

package/dist/esm/components/settings/SettingsResourceOperationPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsResourceOperationPanel.js","sourceRoot":"","sources":["../../../../../src/components/settings/SettingsResourceOperationPanel.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * SettingsResourceOperationPanel — renders an auto-generated resource surface\n * inside a Settings Hub section.\n *\n * This is the `RESOURCE_OPERATION` target renderer. It produces the exact same\n * `FrontendResourceOperationContext` a routed resource page would, but sources\n * the scope identifiers from live `AppScope` instead of URL params — that is the\n * whole reason org-scoped resources (members, API keys, billing) can render here\n * without a `/organizations/:organizationId/...` route. The recipe mirrors\n * `ResourcePageWrapper` (core/runtime/AppRouter.tsx) minus URL handling:\n *\n *   1. resolve the resource config + the operation object from the registry\n *   2. build `contextResourceIdentifiers` via the SAME\n *      `ScopeUtilsService.buildResourceOperationContextIdentifiers` routed pages\n *      use — primary-scope defaults injected from `currentOrganizationId` /\n *      `currentUserId`, so an `ORGANIZATIONS`-scoped resource gets\n *      `{ organizations: <id> }` automatically\n *   3. derive `parentResourcesRequirements` from those identifiers (the\n *      context-identifier variant, since there are no route params to walk)\n *   4. build the operation context and hand it to `SettingsSectionNavigationHost`\n *      as the section's ROOT surface\n *\n * The host wraps the surface in a per-section navigation stack so related actions\n * (view/edit/create + their back/post-action) drill WITHIN the panel instead of\n * escaping the hub to the global zones. The hub is overlay content, so the\n * surfaces run in the OVERLAY navigation zone, but the host's scoped controller\n * intercepts their navigation — see `SettingsSectionNavigationHost`.\n *\n * @see SettingsSectionNavigationHost.tsx — the per-section navigation stack\n * @see settings-hub.frontend.schemas.ts — `SettingsResourceOperationTarget`\n * @see core/runtime/AppRouter.tsx — `ResourcePageWrapper`, the routed counterpart\n */\nimport React, { useMemo } from 'react';\n\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { ScopeUtilsService } from '~wildo-frontend-lib/core/scope/scope.utils.frontend.service';\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { SettingsSectionNavigationHost } from './SettingsSectionNavigationHost';\n\nexport interface SettingsResourceOperationPanelProps {\n  /** Registry resource type (e.g. `organizationMembers`). */\n  resourceType: string;\n  /** Operation identifier to render (e.g. `list`, `read`). */\n  operation: string;\n  /** Disambiguates when several operations share the identifier (variant key). */\n  operationVariant?: string;\n}\n\n/**\n * Select the operation object matching `operationIdentifier` (+ optional\n * `variantKey`) from a resource config. Mirrors the resolution in\n * `launcher-resolution.ts` (`resolveResourceOperation`): an explicit variant key\n * wins; otherwise prefer the single default, then the single match, else\n * ambiguous → undefined.\n */\nfunction findResourceConfigOperation(\n  config: AnyFrontendResourceConfiguration,\n  operationIdentifier: string,\n  variantKey?: string,\n): FrontendResourceConfiguration_Operation | undefined {\n  const operations = Array.isArray(config.operations) ? config.operations : [];\n  const matching = operations.filter(op => String(op.operationIdentifier) === operationIdentifier);\n  if (matching.length === 0) return undefined;\n\n  if (variantKey) {\n    return matching.find(op => op.variantKey === variantKey);\n  }\n\n  const defaults = matching.filter(op => op.isOperationDefault === true);\n  if (defaults.length === 1) return defaults[0];\n  if (matching.length === 1) return matching[0];\n  return undefined;\n}\n\n/** Boundary guard — a misconfigured section must not crash the whole hub. */\nfunction SettingsResourceUnavailable({ message }: { message: string }): React.JSX.Element {\n  return <div className=\"p-card text-sm text-muted-foreground\">{message}</div>;\n}\n\nexport function SettingsResourceOperationPanel({\n  resourceType,\n  operation,\n  operationVariant,\n}: SettingsResourceOperationPanelProps): React.JSX.Element {\n  const { registry } = useResourceRegistry();\n  const appScope = useAppScopeSafe();\n\n  const resourceContext = useMemo(() => {\n    const config = registry.resourceConfigurations[resourceType] as\n      | AnyFrontendResourceConfiguration\n      | undefined;\n    if (!config) return undefined;\n\n    const resolvedOperation = findResourceConfigOperation(config, operation, operationVariant);\n    if (!resolvedOperation) return undefined;\n\n    // Inject the live primary-scope identifiers (org/user/app) so an org-scoped\n    // resource resolves to the current organization without a URL param.\n    const contextResourceIdentifiers = ScopeUtilsService.buildResourceOperationContextIdentifiers({\n      currentUserId: appScope?.currentUserId,\n      currentOrganizationId: appScope?.currentOrganizationId,\n      currentApplicationId: appScope?.currentApplicationId,\n      currentAnonymousUserId: appScope?.currentAnonymousUserId,\n      primaryScope: config.resourcePrimaryScope,\n      liveAppScopeContextResourceIdentifiers: appScope?.buildContextResourceIdentifiers?.(),\n      explicitContextResourceIdentifiers: {},\n    });\n\n    // Derive parent requirements from the injected identifiers (no route params\n    // to walk here), so the scoped LIST/READ query carries its org parent edge.\n    const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(\n      resourceType,\n      contextResourceIdentifiers,\n      registry,\n    );\n\n    return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType,\n      operation: resolvedOperation,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n    });\n  }, [registry, resourceType, operation, operationVariant, appScope]);\n\n  if (!resourceContext) {\n    return (\n      <SettingsResourceUnavailable\n        message={`Settings surface unavailable for ${resourceType} (${operation}).`}\n      />\n    );\n  }\n\n  // Host the surface inside the section's own navigation stack, so related\n  // actions (view/edit/create + their back/post-action) drill WITHIN this panel\n  // instead of escaping the hub to the global zones (and 404-ing on org-scoped\n  // routes that aren't registered). The host installs a scoped navigation\n  // controller; the surface beneath renders the current stack level.\n  return <SettingsSectionNavigationHost rootContext={resourceContext} />;\n}\n"]}

package/dist/esm/components/settings/SettingsSectionNavigationHost.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SettingsSectionNavigationHost — the per-section navigation stack for a Settings
+ * Hub data section.
+ *
+ * A resource surface (List/Read/…) is built around a per-zone navigation STACK:
+ * the list pushes an entry, a row "view"/"edit" pushes the next surface on top,
+ * and "back" / every post-action pops within that same stack. The structural
+ * zones (PRIMARY/SECONDARY/COMPANION) each ARE such a stack — but the Settings Hub
+ * lives in the OVERLAY zone, which holds a SINGLE entry (the hub). Handing a
+ * surface `navigationZone={OVERLAY}` therefore has nowhere to drill: the global
+ * policy maps overlay-sourced navigation to PRIMARY, which leaves the hub and
+ * 404s on org-scoped routes that aren't registered.
+ *
+ * This host gives the section its own stack. It installs a scoped
+ * {@link NavigationController} via {@link ScopedNavigationControllerContext}, so
+ * the surfaces rendered beneath it (which all reach navigation through
+ * `useNavigationController()`) drill / go back / run post-action navigation
+ * **inside this panel** instead of through the global zones. Because the scoped
+ * controller pushes a `FrontendResourceOperationContext` directly and ignores the
+ * `urlPath`, in-hub actions never touch the global router — so the route-
+ * registration 404 is structurally impossible here.
+ *
+ * Mapping (the four methods resource surfaces actually call):
+ * - `navigateToResource(ctx)` → push `ctx` (drill: view/edit/create).
+ * - `goBack()` → pop one level (cancel; post-update/post-delete return).
+ * - `closeOverlay()` → reset to the section root (post-quick-create returns to the
+ *   list instead of closing the whole hub).
+ * - `canGoBack()` → there is something to pop.
+ * `navigate()` for non-resource content delegates to the global controller (a
+ * genuine cross-type link legitimately leaves the section).
+ *
+ * @see core/navigation/useNavigationController.ts — `ScopedNavigationControllerContext`
+ * @see .claude/plans/settings-hub-related-action-navigation.md — design + edge cases
+ */
+import React from 'react';
+import { type NavigationController } from '../../core/navigation/useNavigationController';
+import type { FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
+export interface SectionStackEntry {
+    /** Stable React key + identity for this drill level. */
+    id: string;
+    context: FrontendResourceOperationContext;
+}
+export type SectionStackAction = {
+    type: 'push';
+    context: FrontendResourceOperationContext;
+} | {
+    type: 'pop';
+} | {
+    type: 'resetToRoot';
+};
+/** Pure reducer for the section drill stack. The root entry (index 0) is never popped. */
+export declare function sectionStackReducer(stack: SectionStackEntry[], action: SectionStackAction): SectionStackEntry[];
+/**
+ * Builds the scoped {@link NavigationController} that maps the surface navigation
+ * verbs onto the section drill stack. Pure (no hooks) so the contract is
+ * unit-testable without the global provider stack.
+ *
+ * - `navigateToResource` / resource-typed `navigate` → push (drill).
+ * - `goBack` → pop; `closeOverlay` → reset to the section root.
+ * - non-resource `navigate` → delegate to the global controller (a genuine
+ *   cross-type link leaves the section).
+ */
+export declare function createSectionScopedController(deps: {
+    dispatch: (action: SectionStackAction) => void;
+    getDepth: () => number;
+    globalController: NavigationController;
+}): NavigationController;
+export interface SettingsSectionNavigationHostProps {
+    /** The section's root surface context (its LIST/READ), built by the panel. */
+    rootContext: FrontendResourceOperationContext;
+}
+export declare function SettingsSectionNavigationHost({ rootContext, }: SettingsSectionNavigationHostProps): React.JSX.Element;
+//# sourceMappingURL=SettingsSectionNavigationHost.d.ts.map

package/dist/esm/components/settings/SettingsSectionNavigationHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsSectionNavigationHost.d.ts","sourceRoot":"","sources":["../../../../../src/components/settings/SettingsSectionNavigationHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,6DAA6D,CAAC;AACrE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAGtH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,gCAAgC,CAAC;CAC3C;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gCAAgC,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,EAAE,CAS/G;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,gBAAgB,EAAE,oBAAoB,CAAC;CACxC,GAAG,oBAAoB,CAevB;AAED,MAAM,WAAW,kCAAkC;IACjD,8EAA8E;IAC9E,WAAW,EAAE,gCAAgC,CAAC;CAC/C;AAED,wBAAgB,6BAA6B,CAAC,EAC5C,WAAW,GACZ,EAAE,kCAAkC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsCxD"}

package/dist/esm/components/settings/SettingsSectionNavigationHost.js

@@ -0,0 +1,96 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * SettingsSectionNavigationHost — the per-section navigation stack for a Settings
+ * Hub data section.
+ *
+ * A resource surface (List/Read/…) is built around a per-zone navigation STACK:
+ * the list pushes an entry, a row "view"/"edit" pushes the next surface on top,
+ * and "back" / every post-action pops within that same stack. The structural
+ * zones (PRIMARY/SECONDARY/COMPANION) each ARE such a stack — but the Settings Hub
+ * lives in the OVERLAY zone, which holds a SINGLE entry (the hub). Handing a
+ * surface `navigationZone={OVERLAY}` therefore has nowhere to drill: the global
+ * policy maps overlay-sourced navigation to PRIMARY, which leaves the hub and
+ * 404s on org-scoped routes that aren't registered.
+ *
+ * This host gives the section its own stack. It installs a scoped
+ * {@link NavigationController} via {@link ScopedNavigationControllerContext}, so
+ * the surfaces rendered beneath it (which all reach navigation through
+ * `useNavigationController()`) drill / go back / run post-action navigation
+ * **inside this panel** instead of through the global zones. Because the scoped
+ * controller pushes a `FrontendResourceOperationContext` directly and ignores the
+ * `urlPath`, in-hub actions never touch the global router — so the route-
+ * registration 404 is structurally impossible here.
+ *
+ * Mapping (the four methods resource surfaces actually call):
+ * - `navigateToResource(ctx)` → push `ctx` (drill: view/edit/create).
+ * - `goBack()` → pop one level (cancel; post-update/post-delete return).
+ * - `closeOverlay()` → reset to the section root (post-quick-create returns to the
+ *   list instead of closing the whole hub).
+ * - `canGoBack()` → there is something to pop.
+ * `navigate()` for non-resource content delegates to the global controller (a
+ * genuine cross-type link legitimately leaves the section).
+ *
+ * @see core/navigation/useNavigationController.ts — `ScopedNavigationControllerContext`
+ * @see .claude/plans/settings-hub-related-action-navigation.md — design + edge cases
+ */
+import { useMemo, useReducer, useRef } from 'react';
+import { NavigationZone } from '../../core/navigation/navigation.schemas.js';
+import { NavigationUtils } from '../../core/navigation/navigation.utils.js';
+import { ScopedNavigationControllerContext, useGlobalNavigationController, } from '../../core/navigation/useNavigationController.js';
+import { ResourceOperationSurface } from '../../components/resources/ResourceOperationSurface.js';
+/** Pure reducer for the section drill stack. The root entry (index 0) is never popped. */
+export function sectionStackReducer(stack, action) {
+    switch (action.type) {
+        case 'push':
+            return [...stack, { id: NavigationUtils.generateStackEntryId(), context: action.context }];
+        case 'pop':
+            return stack.length > 1 ? stack.slice(0, -1) : stack;
+        case 'resetToRoot':
+            return stack.length > 1 ? [stack[0]] : stack;
+    }
+}
+/**
+ * Builds the scoped {@link NavigationController} that maps the surface navigation
+ * verbs onto the section drill stack. Pure (no hooks) so the contract is
+ * unit-testable without the global provider stack.
+ *
+ * - `navigateToResource` / resource-typed `navigate` → push (drill).
+ * - `goBack` → pop; `closeOverlay` → reset to the section root.
+ * - non-resource `navigate` → delegate to the global controller (a genuine
+ *   cross-type link leaves the section).
+ */
+export function createSectionScopedController(deps) {
+    return {
+        navigate: (options) => {
+            if (NavigationUtils.isResourceOperationContent(options.content)) {
+                deps.dispatch({ type: 'push', context: options.content.resourceContext });
+                return;
+            }
+            deps.globalController.navigate(options);
+        },
+        navigateToResource: (context) => deps.dispatch({ type: 'push', context }),
+        goBack: () => deps.dispatch({ type: 'pop' }),
+        closeOverlay: () => deps.dispatch({ type: 'resetToRoot' }),
+        canGoBack: () => deps.getDepth() > 1,
+        resourceRelationshipDepth: deps.globalController.resourceRelationshipDepth,
+    };
+}
+export function SettingsSectionNavigationHost({ rootContext, }) {
+    const globalController = useGlobalNavigationController();
+    const [stack, dispatch] = useReducer(sectionStackReducer, rootContext, (context) => [{ id: NavigationUtils.generateStackEntryId(), context }]);
+    // `canGoBack` is read during a child's render; a ref keeps it reading the live
+    // depth without rebuilding the controller on every push/pop.
+    const stackRef = useRef(stack);
+    stackRef.current = stack;
+    const scopedController = useMemo(() => createSectionScopedController({
+        dispatch,
+        getDepth: () => stackRef.current.length,
+        globalController,
+    }), [globalController]);
+    const top = stack[stack.length - 1];
+    // No bespoke back chrome: each drilled surface (Read/Update/…) renders its own
+    // back affordance, which now works because the scoped controller gives it a
+    // real stack to pop. The root (list) has nothing to pop, so it shows none.
+    return (_jsx(ScopedNavigationControllerContext.Provider, { value: scopedController, children: _jsx(ResourceOperationSurface, { resourceContext: top.context, navigationZone: NavigationZone.OVERLAY, navigationInitiator: { sourceZone: NavigationZone.OVERLAY } }, top.id) }));
+}
+//# sourceMappingURL=SettingsSectionNavigationHost.js.map

package/dist/esm/components/settings/SettingsSectionNavigationHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsSectionNavigationHost.js","sourceRoot":"","sources":["../../../../../src/components/settings/SettingsSectionNavigationHost.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * SettingsSectionNavigationHost — the per-section navigation stack for a Settings\n * Hub data section.\n *\n * A resource surface (List/Read/…) is built around a per-zone navigation STACK:\n * the list pushes an entry, a row \"view\"/\"edit\" pushes the next surface on top,\n * and \"back\" / every post-action pops within that same stack. The structural\n * zones (PRIMARY/SECONDARY/COMPANION) each ARE such a stack — but the Settings Hub\n * lives in the OVERLAY zone, which holds a SINGLE entry (the hub). Handing a\n * surface `navigationZone={OVERLAY}` therefore has nowhere to drill: the global\n * policy maps overlay-sourced navigation to PRIMARY, which leaves the hub and\n * 404s on org-scoped routes that aren't registered.\n *\n * This host gives the section its own stack. It installs a scoped\n * {@link NavigationController} via {@link ScopedNavigationControllerContext}, so\n * the surfaces rendered beneath it (which all reach navigation through\n * `useNavigationController()`) drill / go back / run post-action navigation\n * **inside this panel** instead of through the global zones. Because the scoped\n * controller pushes a `FrontendResourceOperationContext` directly and ignores the\n * `urlPath`, in-hub actions never touch the global router — so the route-\n * registration 404 is structurally impossible here.\n *\n * Mapping (the four methods resource surfaces actually call):\n * - `navigateToResource(ctx)` → push `ctx` (drill: view/edit/create).\n * - `goBack()` → pop one level (cancel; post-update/post-delete return).\n * - `closeOverlay()` → reset to the section root (post-quick-create returns to the\n *   list instead of closing the whole hub).\n * - `canGoBack()` → there is something to pop.\n * `navigate()` for non-resource content delegates to the global controller (a\n * genuine cross-type link legitimately leaves the section).\n *\n * @see core/navigation/useNavigationController.ts — `ScopedNavigationControllerContext`\n * @see .claude/plans/settings-hub-related-action-navigation.md — design + edge cases\n */\nimport React, { useMemo, useReducer, useRef } from 'react';\n\nimport { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport {\n  ScopedNavigationControllerContext,\n  useGlobalNavigationController,\n  type NavigationController,\n} from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { ResourceOperationSurface } from '~wildo-frontend-lib/components/resources/ResourceOperationSurface';\n\nexport interface SectionStackEntry {\n  /** Stable React key + identity for this drill level. */\n  id: string;\n  context: FrontendResourceOperationContext;\n}\n\nexport type SectionStackAction =\n  | { type: 'push'; context: FrontendResourceOperationContext }\n  | { type: 'pop' }\n  | { type: 'resetToRoot' };\n\n/** Pure reducer for the section drill stack. The root entry (index 0) is never popped. */\nexport function sectionStackReducer(stack: SectionStackEntry[], action: SectionStackAction): SectionStackEntry[] {\n  switch (action.type) {\n    case 'push':\n      return [...stack, { id: NavigationUtils.generateStackEntryId(), context: action.context }];\n    case 'pop':\n      return stack.length > 1 ? stack.slice(0, -1) : stack;\n    case 'resetToRoot':\n      return stack.length > 1 ? [stack[0]] : stack;\n  }\n}\n\n/**\n * Builds the scoped {@link NavigationController} that maps the surface navigation\n * verbs onto the section drill stack. Pure (no hooks) so the contract is\n * unit-testable without the global provider stack.\n *\n * - `navigateToResource` / resource-typed `navigate` → push (drill).\n * - `goBack` → pop; `closeOverlay` → reset to the section root.\n * - non-resource `navigate` → delegate to the global controller (a genuine\n *   cross-type link leaves the section).\n */\nexport function createSectionScopedController(deps: {\n  dispatch: (action: SectionStackAction) => void;\n  getDepth: () => number;\n  globalController: NavigationController;\n}): NavigationController {\n  return {\n    navigate: (options) => {\n      if (NavigationUtils.isResourceOperationContent(options.content)) {\n        deps.dispatch({ type: 'push', context: options.content.resourceContext });\n        return;\n      }\n      deps.globalController.navigate(options);\n    },\n    navigateToResource: (context) => deps.dispatch({ type: 'push', context }),\n    goBack: () => deps.dispatch({ type: 'pop' }),\n    closeOverlay: () => deps.dispatch({ type: 'resetToRoot' }),\n    canGoBack: () => deps.getDepth() > 1,\n    resourceRelationshipDepth: deps.globalController.resourceRelationshipDepth,\n  };\n}\n\nexport interface SettingsSectionNavigationHostProps {\n  /** The section's root surface context (its LIST/READ), built by the panel. */\n  rootContext: FrontendResourceOperationContext;\n}\n\nexport function SettingsSectionNavigationHost({\n  rootContext,\n}: SettingsSectionNavigationHostProps): React.JSX.Element {\n  const globalController = useGlobalNavigationController();\n\n  const [stack, dispatch] = useReducer(\n    sectionStackReducer,\n    rootContext,\n    (context): SectionStackEntry[] => [{ id: NavigationUtils.generateStackEntryId(), context }],\n  );\n\n  // `canGoBack` is read during a child's render; a ref keeps it reading the live\n  // depth without rebuilding the controller on every push/pop.\n  const stackRef = useRef(stack);\n  stackRef.current = stack;\n\n  const scopedController = useMemo<NavigationController>(\n    () => createSectionScopedController({\n      dispatch,\n      getDepth: () => stackRef.current.length,\n      globalController,\n    }),\n    [globalController],\n  );\n\n  const top = stack[stack.length - 1];\n\n  // No bespoke back chrome: each drilled surface (Read/Update/…) renders its own\n  // back affordance, which now works because the scoped controller gives it a\n  // real stack to pop. The root (list) has nothing to pop, so it shows none.\n  return (\n    <ScopedNavigationControllerContext.Provider value={scopedController}>\n      <ResourceOperationSurface\n        key={top.id}\n        resourceContext={top.context}\n        navigationZone={NavigationZone.OVERLAY}\n        navigationInitiator={{ sourceZone: NavigationZone.OVERLAY }}\n      />\n    </ScopedNavigationControllerContext.Provider>\n  );\n}\n"]}

package/dist/esm/components/typography/heading.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas.js';
+import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas';
 export type HeadingProps = {
     level?: 1 | 2 | 3 | 4 | 5 | 6;
 } & React.ComponentPropsWithoutRef<'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6'>;

package/dist/esm/components/typography/heading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heading.d.ts","sourceRoot":"","sources":["../../../../src/components/typography/heading.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,KAAK,CAAC,wBAAwB,CAC3F,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CACxC,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,YAAY,CAAA;AAG1C,wBAAgB,OAAO,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG9H;AAED,wBAAgB,UAAU,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGpI"}
+{"version":3,"file":"heading.d.ts","sourceRoot":"","sources":["../../../../../src/components/typography/heading.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,KAAK,CAAC,wBAAwB,CAC3F,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CACxC,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,YAAY,CAAA;AAG1C,wBAAgB,OAAO,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG9H;AAED,wBAAgB,UAAU,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGpI"}

package/dist/esm/components/typography/heading.js

@@ -10,4 +10,4 @@ export function Subheading({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_SUBHEADING, 'Subheading')(preset);
     return _jsx(Component, { ...props });
 }
-//# sourceMappingURL=heading.js.map
+//# sourceMappingURL=heading.js.map

package/dist/esm/components/typography/heading.js.map

@@ -1 +1 @@
-{"version":3,"file":"heading.js","sourceRoot":"","sources":["../../../../src/components/typography/heading.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AASzH,kBAAkB;AAClB,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAuC;IACzG,MAAM,SAAS,GAAG,uBAAuB,CAAe,qBAAqB,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACnH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA0C;IAC/G,MAAM,SAAS,GAAG,uBAAuB,CAAkB,qBAAqB,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;IAC5H,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC"}
+{"version":3,"file":"heading.js","sourceRoot":"","sources":["../../../../../src/components/typography/heading.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AASzH,kBAAkB;AAClB,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAuC;IACzG,MAAM,SAAS,GAAG,uBAAuB,CAAe,qBAAqB,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACnH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA0C;IAC/G,MAAM,SAAS,GAAG,uBAAuB,CAAkB,qBAAqB,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;IAC5H,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\nexport type HeadingProps = { level?: 1 | 2 | 3 | 4 | 5 | 6 } & React.ComponentPropsWithoutRef<\n  'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6'\n>\nexport type SubheadingProps = HeadingProps\n\n// --- Wrapper ---\nexport function Heading({ preset = CorePresetNames.DEFAULT, ...props }: HeadingProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<HeadingProps>(FrontendComponentType.LOW_LEVEL_HEADING, 'Heading')(preset)\n  return <Component {...props} />\n}\n\nexport function Subheading({ preset = CorePresetNames.DEFAULT, ...props }: SubheadingProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<SubheadingProps>(FrontendComponentType.LOW_LEVEL_SUBHEADING, 'Subheading')(preset)\n  return <Component {...props} />\n}\n"]}

package/dist/esm/components/typography/label.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas.js';
+import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas';
 export type LabelProps = React.ComponentProps<"label">;
 export declare function Label({ preset, ...props }: LabelProps & ComponentPresetProps): React.JSX.Element;
 //# sourceMappingURL=label.d.ts.map

package/dist/esm/components/typography/label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../src/components/typography/label.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;AAGtD,wBAAgB,KAAK,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1H"}
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../../src/components/typography/label.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;AAGtD,wBAAgB,KAAK,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1H"}

package/dist/esm/components/typography/label.js

@@ -6,4 +6,4 @@ export function Label({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_LABEL, 'Label')(preset);
     return _jsx(Component, { ...props });
 }
-//# sourceMappingURL=label.js.map
+//# sourceMappingURL=label.js.map

package/dist/esm/components/typography/label.js.map

@@ -1 +1 @@
-{"version":3,"file":"label.js","sourceRoot":"","sources":["../../../../src/components/typography/label.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAM5F,kBAAkB;AAClB,MAAM,UAAU,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAqC;IACrG,MAAM,SAAS,GAAG,uBAAuB,CAAa,qBAAqB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;IAC7G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC"}
+{"version":3,"file":"label.js","sourceRoot":"","sources":["../../../../../src/components/typography/label.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAM5F,kBAAkB;AAClB,MAAM,UAAU,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAqC;IACrG,MAAM,SAAS,GAAG,uBAAuB,CAAa,qBAAqB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;IAC7G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\nexport type LabelProps = React.ComponentProps<\"label\">\n\n// --- Wrapper ---\nexport function Label({ preset = CorePresetNames.DEFAULT, ...props }: LabelProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<LabelProps>(FrontendComponentType.LOW_LEVEL_LABEL, 'Label')(preset)\n  return <Component {...props} />\n}\n"]}

package/dist/esm/components/typography/link.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { ButtonSize } from '@wildo-ai/presets-components-models';
-import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas.js';
+import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas';
 export declare enum LinkVariants_Variant {
     DEFAULT = "default",
     MUTED = "muted",

package/dist/esm/components/typography/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../../src/components/typography/link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAA0C,UAAU,EAAE,MAAM,qCAAqC,CAAA;AACxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,oBAAY,oBAAoB;IAC9B,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AACD,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AACD,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG;IAC1E,OAAO,CAAC,EAAE,oBAAoB,CAAA;IAC9B,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAClC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAGD,wBAAgB,IAAI,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxH"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../../../src/components/typography/link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAA0C,UAAU,EAAE,MAAM,qCAAqC,CAAA;AACxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,oBAAY,oBAAoB;IAC9B,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AACD,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AACD,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG;IAC1E,OAAO,CAAC,EAAE,oBAAoB,CAAA;IAC9B,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAClC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAGD,wBAAgB,IAAI,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxH"}

package/dist/esm/components/typography/link.js

@@ -28,4 +28,4 @@ export function Link({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_LINK, 'Link')(preset);
     return _jsx(Component, { ...props });
 }
-//# sourceMappingURL=link.js.map
+//# sourceMappingURL=link.js.map

package/dist/esm/components/typography/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../../src/components/typography/link.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAc,MAAM,qCAAqC,CAAA;AAGxG,mBAAmB;AACnB,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,2CAAmB,CAAA;IACnB,uCAAe,CAAA;IACf,6CAAqB,CAAA;IACrB,mDAA2B,CAAA;IAC3B,2CAAmB,CAAA;IACnB,2CAAmB,CAAA;AACrB,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AACD,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,2CAAiB,CAAA;IACjB,uCAAa,CAAA;AACf,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC;AACD,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;AACvB,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAgBD,kBAAkB;AAClB,MAAM,UAAU,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoC;IACnG,MAAM,SAAS,GAAG,uBAAuB,CAAY,qBAAqB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC"}
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../../../src/components/typography/link.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAc,MAAM,qCAAqC,CAAA;AAGxG,mBAAmB;AACnB,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,2CAAmB,CAAA;IACnB,uCAAe,CAAA;IACf,6CAAqB,CAAA;IACrB,mDAA2B,CAAA;IAC3B,2CAAmB,CAAA;IACnB,2CAAmB,CAAA;AACrB,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AACD,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,2CAAiB,CAAA;IACjB,uCAAa,CAAA;AACf,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC;AACD,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;AACvB,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAgBD,kBAAkB;AAClB,MAAM,UAAU,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoC;IACnG,MAAM,SAAS,GAAG,uBAAuB,CAAY,qBAAqB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames, ButtonSize } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\nexport enum LinkVariants_Variant {\n  DEFAULT = 'default',\n  MUTED = 'muted',\n  CONTRAST = 'contrast',\n  DESTRUCTIVE = 'destructive',\n  SUCCESS = 'success',\n  INHERIT = 'inherit',\n}\nexport enum LinkVariants_Underline {\n  HOVER = 'hover',\n  ALWAYS = 'always',\n  NONE = 'none',\n}\nexport enum LinkVariants_Weight {\n  NORMAL = 'normal',\n  MEDIUM = 'medium',\n  SEMIBOLD = 'semibold',\n}\n\nexport type LinkProps = Omit<React.ComponentPropsWithoutRef<\"a\">, \"href\"> & {\n  variant?: LinkVariants_Variant\n  underline?: LinkVariants_Underline\n  size?: ButtonSize\n  weight?: LinkVariants_Weight\n  asChild?: boolean\n  href?: string\n  external?: boolean\n  externalIcon?: React.ReactNode\n  leftIcon?: React.ReactNode\n  rightIcon?: React.ReactNode\n  disabled?: boolean\n}\n\n// --- Wrapper ---\nexport function Link({ preset = CorePresetNames.DEFAULT, ...props }: LinkProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<LinkProps>(FrontendComponentType.LOW_LEVEL_LINK, 'Link')(preset)\n  return <Component {...props} />\n}\n"]}

package/dist/esm/components/typography/text.d.ts

@@ -1,10 +1,21 @@
 import React from 'react';
-import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas.js';
-import { type LinkProps } from './link.js';
-import { TextVariant } from '@wildo-ai/presets-components-models';
-export { TextVariant };
-export type TextProps = React.ComponentPropsWithoutRef<'p'> & {
+import { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas';
+import { type LinkProps } from './link';
+import { TextVariant, TextSize, type TextTruncationStrategy } from '@wildo-ai/presets-components-models';
+export { TextVariant, TextSize };
+/**
+ * Note on the element shape: `Text` defaults to `<p>` (block-level), but
+ * accepts an `as` prop to render `<span>` for inline usage. This is the
+ * canonical way to migrate raw `<span className="text-xs ...">` clusters
+ * away from hardcoded Tailwind size utilities while preserving inline
+ * layout semantics.
+ */
+export type TextProps = Omit<React.HTMLAttributes<HTMLElement>, 'children'> & {
     variant?: TextVariant;
+    size?: TextSize;
+    as?: 'p' | 'span' | 'div';
+    truncate?: boolean | TextTruncationStrategy;
+    children?: React.ReactNode;
 };
 export type TextLinkProps = LinkProps;
 export type StrongProps = React.ComponentPropsWithoutRef<'strong'>;

package/dist/esm/components/typography/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/components/typography/text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAGjE,OAAO,EAAE,WAAW,EAAE,CAAA;AAEtB,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG;IAC5D,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,CAAA;AAErC,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAA;AAElE,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAA;AAG9D,wBAAgB,IAAI,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxH;AAED,wBAAgB,QAAQ,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGhI;AAED,wBAAgB,MAAM,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG5H;AAED,wBAAgB,IAAI,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxH"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../../src/components/typography/text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAGxG,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAA;AAEhC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,GAAG;IAC5E,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,KAAK,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;IAC3C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,CAAA;AAErC,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAA;AAElE,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAA;AAG9D,wBAAgB,IAAI,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxH;AAED,wBAAgB,QAAQ,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGhI;AAED,wBAAgB,MAAM,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG5H;AAED,wBAAgB,IAAI,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxH"}

package/dist/esm/components/typography/text.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createComponentResolver } from '../../core/components-registry/component-resolver.frontend.helper.js';
 import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
-import { TextVariant } from '@wildo-ai/presets-components-models';
+import { TextVariant, TextSize } from '@wildo-ai/presets-components-models';
 // --- Contract ---
-export { TextVariant };
+export { TextVariant, TextSize };
 // --- Wrappers ---
 export function Text({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_TEXT, 'Text')(preset);
@@ -21,4 +21,4 @@ export function Code({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_CODE, 'Code')(preset);
     return _jsx(Component, { ...props });
 }
-//# sourceMappingURL=text.js.map
+//# sourceMappingURL=text.js.map

package/dist/esm/components/typography/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../src/components/typography/text.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAG5F,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAEjE,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,CAAA;AAYtB,mBAAmB;AACnB,MAAM,UAAU,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoC;IACnG,MAAM,SAAS,GAAG,uBAAuB,CAAY,qBAAqB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAwC;IAC3G,MAAM,SAAS,GAAG,uBAAuB,CAAgB,qBAAqB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;IACvH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAsC;IACvG,MAAM,SAAS,GAAG,uBAAuB,CAAc,qBAAqB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;IAChH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoC;IACnG,MAAM,SAAS,GAAG,uBAAuB,CAAY,qBAAqB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../../src/components/typography/text.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAG5F,OAAO,EAAE,WAAW,EAAE,QAAQ,EAA+B,MAAM,qCAAqC,CAAA;AAExG,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAA;AAuBhC,mBAAmB;AACnB,MAAM,UAAU,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoC;IACnG,MAAM,SAAS,GAAG,uBAAuB,CAAY,qBAAqB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAwC;IAC3G,MAAM,SAAS,GAAG,uBAAuB,CAAgB,qBAAqB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;IACvH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAsC;IACvG,MAAM,SAAS,GAAG,uBAAuB,CAAc,qBAAqB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;IAChH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoC;IACnG,MAAM,SAAS,GAAG,uBAAuB,CAAY,qBAAqB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1G,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { type LinkProps } from './link'\nimport { TextVariant, TextSize, type TextTruncationStrategy } from '@wildo-ai/presets-components-models'\n\n// --- Contract ---\nexport { TextVariant, TextSize }\n\n/**\n * Note on the element shape: `Text` defaults to `<p>` (block-level), but\n * accepts an `as` prop to render `<span>` for inline usage. This is the\n * canonical way to migrate raw `<span className=\"text-xs ...\">` clusters\n * away from hardcoded Tailwind size utilities while preserving inline\n * layout semantics.\n */\nexport type TextProps = Omit<React.HTMLAttributes<HTMLElement>, 'children'> & {\n  variant?: TextVariant\n  size?: TextSize\n  as?: 'p' | 'span' | 'div'\n  truncate?: boolean | TextTruncationStrategy\n  children?: React.ReactNode\n}\n\nexport type TextLinkProps = LinkProps\n\nexport type StrongProps = React.ComponentPropsWithoutRef<'strong'>\n\nexport type CodeProps = React.ComponentPropsWithoutRef<'code'>\n\n// --- Wrappers ---\nexport function Text({ preset = CorePresetNames.DEFAULT, ...props }: TextProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<TextProps>(FrontendComponentType.LOW_LEVEL_TEXT, 'Text')(preset)\n  return <Component {...props} />\n}\n\nexport function TextLink({ preset = CorePresetNames.DEFAULT, ...props }: TextLinkProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<TextLinkProps>(FrontendComponentType.LOW_LEVEL_TEXT_LINK, 'TextLink')(preset)\n  return <Component {...props} />\n}\n\nexport function Strong({ preset = CorePresetNames.DEFAULT, ...props }: StrongProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<StrongProps>(FrontendComponentType.LOW_LEVEL_STRONG, 'Strong')(preset)\n  return <Component {...props} />\n}\n\nexport function Code({ preset = CorePresetNames.DEFAULT, ...props }: CodeProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<CodeProps>(FrontendComponentType.LOW_LEVEL_CODE, 'Code')(preset)\n  return <Component {...props} />\n}\n"]}

package/dist/esm/components/typography/truncated-text.d.ts

@@ -1,8 +1,11 @@
 import * as React from "react";
 import { PlacementSide } from "@wildo-ai/presets-components-models";
-export interface TruncatedTextProps extends React.HTMLAttributes<HTMLSpanElement> {
+type TruncatedTextElement = 'span' | 'p' | 'div';
+export interface TruncatedTextProps extends React.HTMLAttributes<HTMLElement> {
     /** The text content to display */
     children: React.ReactNode;
+    /** Element used for the measured text node. */
+    as?: TruncatedTextElement;
     /** Maximum width before truncation (CSS value, e.g., "200px", "100%") */
     maxWidth?: string;
     /** Custom class for the text element */
@@ -26,6 +29,6 @@ export interface TruncatedTextProps extends React.HTMLAttributes<HTMLSpanElement
  * </TruncatedText>
  * ```
  */
-declare function TruncatedText({ children, className, textClassName, maxWidth, tooltipSide, tooltipDelayDuration, alwaysShowTooltip, ...props }: TruncatedTextProps): React.JSX.Element;
+declare function TruncatedText({ as: TextElement, children, className, textClassName, maxWidth, tooltipSide, tooltipDelayDuration, alwaysShowTooltip, ...props }: TruncatedTextProps): React.JSX.Element;
 export { TruncatedText };
 //# sourceMappingURL=truncated-text.d.ts.map

package/dist/esm/components/typography/truncated-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"truncated-text.d.ts","sourceRoot":"","sources":["../../../../src/components/typography/truncated-text.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AAGnE,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;IAC/E,kCAAkC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,wCAAwC;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,EACrB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,QAAiB,EACjB,WAA+B,EAC/B,oBAA0B,EAC1B,iBAAyB,EACzB,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA4DxC;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"truncated-text.d.ts","sourceRoot":"","sources":["../../../../../src/components/typography/truncated-text.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AAGnE,KAAK,oBAAoB,GAAG,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC;AAEjD,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IAC3E,kCAAkC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,+CAA+C;IAC/C,EAAE,CAAC,EAAE,oBAAoB,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,wCAAwC;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,EACrB,EAAE,EAAE,WAAoB,EACxB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,QAAiB,EACjB,WAA+B,EAC/B,oBAA0B,EAC1B,iBAAyB,EACzB,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAgExC;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}