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

package/dist/esm/components/resources/ResourceOperationSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceOperationSurface.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/ResourceOperationSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AACzH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAWtH,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,gCAAgC,CAAC;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAED,wBAAgB,wBAAwB,CAAC,EACvC,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,EAAE,6BAA6B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAoCnD"}
+{"version":3,"file":"ResourceOperationSurface.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceOperationSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AACzH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAWtH,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,gCAAgC,CAAC;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAED,wBAAgB,wBAAwB,CAAC,EACvC,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,EAAE,6BAA6B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAoCnD"}

package/dist/esm/components/resources/ResourceOperationSurface.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { resolveResourceOperationLayoutKind } from '../../core/resources/operation-semantics.frontend.utils.js';
-import { ResourceOperationViewProvider } from '../../core/resources/ResourceOperationViewContext.js';
+import { ResourceOperationViewProvider } from '../../core/resources/ResourceOperationViewProvider.js';
 import { ResourceLayout_Action } from './ResourceLayout_Action.js';
 import { ResourceLayout_Create } from './ResourceLayout_Create.js';
 import { ResourceLayout_List } from './ResourceLayout_List.js';
@@ -37,4 +37,4 @@ export function ResourceOperationSurface({ resourceContext, navigationZone, navi
     }
     return (_jsx(ResourceOperationViewProvider, { ...commonProps, children: layout }));
 }
-//# sourceMappingURL=ResourceOperationSurface.js.map
+//# sourceMappingURL=ResourceOperationSurface.js.map

package/dist/esm/components/resources/ResourceOperationSurface.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceOperationSurface.js","sourceRoot":"","sources":["../../../../src/components/resources/ResourceOperationSurface.tsx"],"names":[],"mappings":";AAIA,OAAO,EAAE,kCAAkC,EAAE,MAAM,uEAAuE,CAAC;AAC3H,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAEhH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,MAAM,UAAU,wBAAwB,CAAC,EACvC,eAAe,EACf,cAAc,EACd,mBAAmB,GACW;IAC9B,MAAM,WAAW,GAAG;QAClB,eAAe;QACf,cAAc;QACd,mBAAmB;KACpB,CAAC;IAEF,MAAM,UAAU,GAAG,kCAAkC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAEjF,IAAI,MAAyB,CAAC;IAC9B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;QACR,KAAK,MAAM;YACT,MAAM,GAAG,KAAC,mBAAmB,OAAK,WAAW,GAAI,CAAC;YAClD,MAAM;QACR,KAAK,MAAM;YACT,MAAM,GAAG,KAAC,mBAAmB,OAAK,WAAW,GAAI,CAAC;YAClD,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;QACR;YACE,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;IACV,CAAC;IAED,OAAO,CACL,KAAC,6BAA6B,OAAK,WAAW,YAC3C,MAAM,GACuB,CACjC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ResourceOperationSurface.js","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceOperationSurface.tsx"],"names":[],"mappings":";AAIA,OAAO,EAAE,kCAAkC,EAAE,MAAM,uEAAuE,CAAC;AAC3H,OAAO,EAAE,6BAA6B,EAAE,MAAM,kEAAkE,CAAC;AAEjH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,MAAM,UAAU,wBAAwB,CAAC,EACvC,eAAe,EACf,cAAc,EACd,mBAAmB,GACW;IAC9B,MAAM,WAAW,GAAG;QAClB,eAAe;QACf,cAAc;QACd,mBAAmB;KACpB,CAAC;IAEF,MAAM,UAAU,GAAG,kCAAkC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAEjF,IAAI,MAAyB,CAAC;IAC9B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;QACR,KAAK,MAAM;YACT,MAAM,GAAG,KAAC,mBAAmB,OAAK,WAAW,GAAI,CAAC;YAClD,MAAM;QACR,KAAK,MAAM;YACT,MAAM,GAAG,KAAC,mBAAmB,OAAK,WAAW,GAAI,CAAC;YAClD,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;QACR;YACE,MAAM,GAAG,KAAC,qBAAqB,OAAK,WAAW,GAAI,CAAC;YACpD,MAAM;IACV,CAAC;IAED,OAAO,CACL,KAAC,6BAA6B,OAAK,WAAW,YAC3C,MAAM,GACuB,CACjC,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\nimport type { NavigationInitiatorContext, NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { resolveResourceOperationLayoutKind } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { ResourceOperationViewProvider } from '~wildo-frontend-lib/core/resources/ResourceOperationViewProvider';\n\nimport { ResourceLayout_Action } from './ResourceLayout_Action';\nimport { ResourceLayout_Create } from './ResourceLayout_Create';\nimport { ResourceLayout_List } from './ResourceLayout_List';\nimport { ResourceLayout_Read } from './ResourceLayout_Read';\nimport { ResourceLayout_Search } from './ResourceLayout_Search';\nimport { ResourceLayout_Update } from './ResourceLayout_Update';\n\nexport interface ResourceOperationSurfaceProps {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n}\n\nexport function ResourceOperationSurface({\n  resourceContext,\n  navigationZone,\n  navigationInitiator,\n}: ResourceOperationSurfaceProps): React.JSX.Element {\n  const commonProps = {\n    resourceContext,\n    navigationZone,\n    navigationInitiator,\n  };\n\n  const layoutKind = resolveResourceOperationLayoutKind(resourceContext.operation);\n\n  let layout: React.JSX.Element;\n  switch (layoutKind) {\n    case 'create':\n      layout = <ResourceLayout_Create {...commonProps} />;\n      break;\n    case 'list':\n      layout = <ResourceLayout_List {...commonProps} />;\n      break;\n    case 'read':\n      layout = <ResourceLayout_Read {...commonProps} />;\n      break;\n    case 'update':\n      layout = <ResourceLayout_Update {...commonProps} />;\n      break;\n    case 'search':\n      layout = <ResourceLayout_Search {...commonProps} />;\n      break;\n    default:\n      layout = <ResourceLayout_Action {...commonProps} />;\n      break;\n  }\n\n  return (\n    <ResourceOperationViewProvider {...commonProps}>\n      {layout}\n    </ResourceOperationViewProvider>\n  );\n}\n"]}

package/dist/esm/components/resources/ResourceOwnedViewEmbeds.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import { type ChartInputValues } from '@wildo-ai/saas-models';
+import type { NavigationInitiatorContext, NavigationZone } from '../../core/navigation/navigation.schemas';
+import type { FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
+export interface EmbedResourceOwnedCompositeViewProps {
+    resourceContext: FrontendResourceOperationContext;
+    viewRef: string;
+    navigationZone?: NavigationZone;
+    navigationInitiator?: NavigationInitiatorContext;
+}
+/**
+ * Embed a resource-owned composite view from an operation/custom host.
+ *
+ * Custom operation hosts should not have to hand-author inserted-view identity
+ * strings or re-normalize semantic operation context into plain view context
+ * ids. This helper keeps that bridge explicit but ergonomic.
+ */
+export declare function EmbedResourceOwnedCompositeView({ resourceContext, viewRef, navigationZone, navigationInitiator, }: EmbedResourceOwnedCompositeViewProps): React.JSX.Element;
+export interface EmbedResourceOwnedChartViewProps {
+    resourceContext: FrontendResourceOperationContext;
+    viewRef: string;
+    inputs?: ChartInputValues;
+    urlParamValues?: Record<string, string>;
+    className?: string;
+}
+export declare function EmbedResourceOwnedChartView({ resourceContext, viewRef, inputs, urlParamValues, className, }: EmbedResourceOwnedChartViewProps): React.JSX.Element;
+export interface EmbedResourceOwnedExecutionViewProps {
+    resourceContext: FrontendResourceOperationContext;
+    viewRef: string;
+    navigationZone: NavigationZone;
+    className?: string;
+}
+export declare function EmbedResourceOwnedExecutionView({ resourceContext, viewRef, navigationZone, className, }: EmbedResourceOwnedExecutionViewProps): React.JSX.Element;
+//# sourceMappingURL=ResourceOwnedViewEmbeds.d.ts.map

package/dist/esm/components/resources/ResourceOwnedViewEmbeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceOwnedViewEmbeds.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceOwnedViewEmbeds.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,0BAA0B,EAC1B,cAAc,EACf,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,+DAA+D,CAAC;AAuBvE,MAAM,WAAW,oCAAoC;IACnD,eAAe,EAAE,gCAAgC,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,EAC9C,eAAe,EACf,OAAO,EACP,cAAc,EACd,mBAAmB,GACpB,EAAE,oCAAoC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiB1D;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,gCAAgC,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,eAAe,EACf,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,GACV,EAAE,gCAAgC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0CtD;AAED,MAAM,WAAW,oCAAoC;IACnD,eAAe,EAAE,gCAAgC,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,+BAA+B,CAAC,EAC9C,eAAe,EACf,OAAO,EACP,cAAc,EACd,SAAS,GACV,EAAE,oCAAoC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiB1D"}

package/dist/esm/components/resources/ResourceOwnedViewEmbeds.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { buildResolvedInsertedChartDescriptor, buildResourceInsertedChartIdentity, } from '../../core/config/chart-view.frontend.schemas.js';
+import { buildResourceInsertedCompositeIdentity, } from '../../core/config/composite-view.schemas.js';
+import { buildResourceInsertedExecutionIdentity, } from '../../core/config/execution-view.schemas.js';
+import { FeatureRouteGuard } from '../../core/features/FeatureRouteGuard.js';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+import { FrontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { CompositeView } from '../../components/views/composite-view/CompositeView.js';
+// ChartView MUST come from the `.lazy` wrapper — a static import of the real
+// module merges the whole ECharts payload into the entry chunk (Rollup merges
+// a module that is both statically and dynamically imported; no warning).
+import { ChartView } from '../../components/views/chart-view/ChartView.lazy.js';
+import { ExecutionView } from '../../components/views/execution-view/ExecutionView.js';
+import { normalizeInsertedResourceViewContextResourceIdentifiers } from './inserted-resource-view.frontend.utils.js';
+/**
+ * Embed a resource-owned composite view from an operation/custom host.
+ *
+ * Custom operation hosts should not have to hand-author inserted-view identity
+ * strings or re-normalize semantic operation context into plain view context
+ * ids. This helper keeps that bridge explicit but ergonomic.
+ */
+export function EmbedResourceOwnedCompositeView({ resourceContext, viewRef, navigationZone, navigationInitiator, }) {
+    const insertedIdentity = useMemo(() => {
+        return buildResourceInsertedCompositeIdentity(resourceContext.resourceType, { ref: viewRef });
+    }, [resourceContext.resourceType, viewRef]);
+    const contextResourceIdentifiers = useMemo(() => {
+        return normalizeInsertedResourceViewContextResourceIdentifiers(resourceContext);
+    }, [resourceContext]);
+    return (_jsx(CompositeView, { viewRef: insertedIdentity.insertedViewRef, contextResourceIdentifiers: contextResourceIdentifiers, navigationZone: navigationZone, navigationInitiator: navigationInitiator }));
+}
+export function EmbedResourceOwnedChartView({ resourceContext, viewRef, inputs, urlParamValues, className, }) {
+    const { registry } = useResourceRegistry();
+    const identity = useMemo(() => {
+        return buildResourceInsertedChartIdentity(resourceContext.resourceType, { ref: viewRef });
+    }, [resourceContext.resourceType, viewRef]);
+    const contextResourceIdentifiers = useMemo(() => {
+        return normalizeInsertedResourceViewContextResourceIdentifiers(resourceContext);
+    }, [resourceContext]);
+    const chartView = registry.resourceConfigurations[resourceContext.resourceType]
+        ?.frontendConfiguration
+        ?.chartViews
+        ?.find((candidate) => candidate.ref === viewRef);
+    if (!chartView) {
+        throw buildResourceOwnedViewEmbedConfigurationError(`Cannot resolve resource-owned chart view "${viewRef}" on resource "${resourceContext.resourceType}".`, {
+            resourceType: resourceContext.resourceType,
+            viewRef,
+        });
+    }
+    return (_jsx("div", { className: className, children: _jsx(FeatureRouteGuard, { requiredFeatures: chartView.chartDefinition.requiredFeatures, children: _jsx(ChartView, { viewRef: identity.insertedViewRef, viewDefinition: chartView, runtimeDescriptor: buildResolvedInsertedChartDescriptor({
+                    identity,
+                    chartView,
+                    contextResourceIdentifiers,
+                }), contextResourceIdentifiers: contextResourceIdentifiers, inputs: inputs, urlParamValues: urlParamValues, 
+                // Resource-owned embedded chart → degrade locally, no page-level toast.
+                localErrorOnly: true }) }) }));
+}
+export function EmbedResourceOwnedExecutionView({ resourceContext, viewRef, navigationZone, className, }) {
+    const identity = useMemo(() => {
+        return buildResourceInsertedExecutionIdentity(resourceContext.resourceType, { ref: viewRef });
+    }, [resourceContext.resourceType, viewRef]);
+    const contextResourceIdentifiers = useMemo(() => {
+        return normalizeInsertedResourceViewContextResourceIdentifiers(resourceContext);
+    }, [resourceContext]);
+    return (_jsx("div", { className: className, children: _jsx(ExecutionView, { viewRef: identity.insertedViewRef, navigationZone: navigationZone, contextResourceIdentifiers: contextResourceIdentifiers }) }));
+}
+function buildResourceOwnedViewEmbedConfigurationError(message, context) {
+    return FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+        component: 'ResourceOwnedViewEmbeds',
+        message,
+        ...context,
+    });
+}
+//# sourceMappingURL=ResourceOwnedViewEmbeds.js.map

package/dist/esm/components/resources/ResourceOwnedViewEmbeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceOwnedViewEmbeds.js","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceOwnedViewEmbeds.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useMemo } from 'react';\n\nimport {\n  ErrorCustomMessageReference,\n  type ChartInputValues,\n} from '@wildo-ai/saas-models';\nimport type {\n  NavigationInitiatorContext,\n  NavigationZone,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type {\n  FrontendResourceOperationContext,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n  buildResolvedInsertedChartDescriptor,\n  buildResourceInsertedChartIdentity,\n} from '~wildo-frontend-lib/core/config/chart-view.frontend.schemas';\nimport {\n  buildResourceInsertedCompositeIdentity,\n} from '~wildo-frontend-lib/core/config/composite-view.schemas';\nimport {\n  buildResourceInsertedExecutionIdentity,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport { FeatureRouteGuard } from '~wildo-frontend-lib/core/features/FeatureRouteGuard';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { CompositeView } from '~wildo-frontend-lib/components/views/composite-view/CompositeView';\n// ChartView MUST come from the `.lazy` wrapper — a static import of the real\n// module merges the whole ECharts payload into the entry chunk (Rollup merges\n// a module that is both statically and dynamically imported; no warning).\nimport { ChartView } from '~wildo-frontend-lib/components/views/chart-view/ChartView.lazy';\nimport { ExecutionView } from '~wildo-frontend-lib/components/views/execution-view/ExecutionView';\n\nimport { normalizeInsertedResourceViewContextResourceIdentifiers } from './inserted-resource-view.frontend.utils';\n\nexport interface EmbedResourceOwnedCompositeViewProps {\n  resourceContext: FrontendResourceOperationContext;\n  viewRef: string;\n  navigationZone?: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n}\n\n/**\n * Embed a resource-owned composite view from an operation/custom host.\n *\n * Custom operation hosts should not have to hand-author inserted-view identity\n * strings or re-normalize semantic operation context into plain view context\n * ids. This helper keeps that bridge explicit but ergonomic.\n */\nexport function EmbedResourceOwnedCompositeView({\n  resourceContext,\n  viewRef,\n  navigationZone,\n  navigationInitiator,\n}: EmbedResourceOwnedCompositeViewProps): React.JSX.Element {\n  const insertedIdentity = useMemo(() => {\n    return buildResourceInsertedCompositeIdentity(resourceContext.resourceType, { ref: viewRef });\n  }, [resourceContext.resourceType, viewRef]);\n\n  const contextResourceIdentifiers = useMemo(() => {\n    return normalizeInsertedResourceViewContextResourceIdentifiers(resourceContext);\n  }, [resourceContext]);\n\n  return (\n    <CompositeView\n      viewRef={insertedIdentity.insertedViewRef}\n      contextResourceIdentifiers={contextResourceIdentifiers}\n      navigationZone={navigationZone}\n      navigationInitiator={navigationInitiator}\n    />\n  );\n}\n\nexport interface EmbedResourceOwnedChartViewProps {\n  resourceContext: FrontendResourceOperationContext;\n  viewRef: string;\n  inputs?: ChartInputValues;\n  urlParamValues?: Record<string, string>;\n  className?: string;\n}\n\nexport function EmbedResourceOwnedChartView({\n  resourceContext,\n  viewRef,\n  inputs,\n  urlParamValues,\n  className,\n}: EmbedResourceOwnedChartViewProps): React.JSX.Element {\n  const { registry } = useResourceRegistry();\n  const identity = useMemo(() => {\n    return buildResourceInsertedChartIdentity(resourceContext.resourceType, { ref: viewRef });\n  }, [resourceContext.resourceType, viewRef]);\n  const contextResourceIdentifiers = useMemo(() => {\n    return normalizeInsertedResourceViewContextResourceIdentifiers(resourceContext);\n  }, [resourceContext]);\n  const chartView = registry.resourceConfigurations[resourceContext.resourceType]\n    ?.frontendConfiguration\n    ?.chartViews\n    ?.find((candidate) => candidate.ref === viewRef);\n  if (!chartView) {\n    throw buildResourceOwnedViewEmbedConfigurationError(\n      `Cannot resolve resource-owned chart view \"${viewRef}\" on resource \"${resourceContext.resourceType}\".`,\n      {\n        resourceType: resourceContext.resourceType,\n        viewRef,\n      },\n    );\n  }\n\n  return (\n    <div className={className}>\n      <FeatureRouteGuard requiredFeatures={chartView.chartDefinition.requiredFeatures}>\n        <ChartView\n          viewRef={identity.insertedViewRef}\n          viewDefinition={chartView}\n          runtimeDescriptor={buildResolvedInsertedChartDescriptor({\n            identity,\n            chartView,\n            contextResourceIdentifiers,\n          })}\n          contextResourceIdentifiers={contextResourceIdentifiers}\n          inputs={inputs}\n          urlParamValues={urlParamValues}\n          // Resource-owned embedded chart → degrade locally, no page-level toast.\n          localErrorOnly\n        />\n      </FeatureRouteGuard>\n    </div>\n  );\n}\n\nexport interface EmbedResourceOwnedExecutionViewProps {\n  resourceContext: FrontendResourceOperationContext;\n  viewRef: string;\n  navigationZone: NavigationZone;\n  className?: string;\n}\n\nexport function EmbedResourceOwnedExecutionView({\n  resourceContext,\n  viewRef,\n  navigationZone,\n  className,\n}: EmbedResourceOwnedExecutionViewProps): React.JSX.Element {\n  const identity = useMemo(() => {\n    return buildResourceInsertedExecutionIdentity(resourceContext.resourceType, { ref: viewRef });\n  }, [resourceContext.resourceType, viewRef]);\n  const contextResourceIdentifiers = useMemo(() => {\n    return normalizeInsertedResourceViewContextResourceIdentifiers(resourceContext);\n  }, [resourceContext]);\n\n  return (\n    <div className={className}>\n      <ExecutionView\n        viewRef={identity.insertedViewRef}\n        navigationZone={navigationZone}\n        contextResourceIdentifiers={contextResourceIdentifiers}\n      />\n    </div>\n  );\n}\n\nfunction buildResourceOwnedViewEmbedConfigurationError(\n  message: string,\n  context?: Record<string, unknown>,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      component: 'ResourceOwnedViewEmbeds',\n      message,\n      ...context,\n    },\n  );\n}\n"]}

package/dist/esm/components/resources/ResourceViewModeToggle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ResourceViewModeToggle — a compact segmented control that switches a resource
+ * collection between CARDS and TABLE display. Icon-only (labels via tooltip +
+ * accessible name); the active segment is filled.
+ *
+ * Presentational: it owns no state. The collection host passes the current
+ * `viewMode` and an `onViewModeChange` handler (which persists the choice).
+ */
+import React from 'react';
+import { CollectionDisplayMode } from '../../core/resources/resources.frontend.schemas';
+export interface ResourceViewModeToggleProps {
+    /** The active view-mode. */
+    viewMode: CollectionDisplayMode;
+    /** Called with the newly selected mode (the host persists it). */
+    onViewModeChange: (mode: CollectionDisplayMode) => void;
+    /** Additional CSS classes for the segmented container. */
+    className?: string;
+}
+export declare const ResourceViewModeToggle: ({ viewMode, onViewModeChange, className, }: ResourceViewModeToggleProps) => React.JSX.Element | null;
+//# sourceMappingURL=ResourceViewModeToggle.d.ts.map

package/dist/esm/components/resources/ResourceViewModeToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceViewModeToggle.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceViewModeToggle.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAEtG,MAAM,WAAW,2BAA2B;IAC1C,4BAA4B;IAC5B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,kEAAkE;IAClE,gBAAgB,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACxD,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,eAAO,MAAM,sBAAsB,GAAI,4CAIpC,2BAA2B,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAuCpD,CAAC"}

package/dist/esm/components/resources/ResourceViewModeToggle.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useI18n } from '../../core/i18n/useI18n.js';
+import { useIconRegistry } from '../../core/icons/useIconRegistry.js';
+import { StandardIconReference, IconSize } from '../../core/icons/icon-registry.frontend.schemas.js';
+import { cn } from '../../core/ui/cn.js';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { CollectionDisplayMode } from '../../core/resources/resources.frontend.schemas.js';
+const VIEW_MODE_OPTIONS = [
+    { mode: CollectionDisplayMode.CARDS, icon: StandardIconReference.VIEW_LIST, labelKey: 'viewCards' },
+    { mode: CollectionDisplayMode.TABLE, icon: StandardIconReference.VIEW_TABLE, labelKey: 'viewTable' },
+];
+export const ResourceViewModeToggle = ({ viewMode, onViewModeChange, className, }) => {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_LIST });
+    const { renderIcon } = useIconRegistry();
+    if (!isReady)
+        return null;
+    const tc = (key) => tComponent(FrontendComponentType.RESOURCES_LAYOUTS_LIST, key);
+    return (_jsx("div", { role: "group", "aria-label": tc('viewModeLabel'), className: cn('inline-flex shrink-0 rounded-md border border-border overflow-hidden', className), children: VIEW_MODE_OPTIONS.map(({ mode, icon, labelKey }, index) => {
+            const isActive = viewMode === mode;
+            const label = tc(labelKey);
+            return (_jsx("button", { type: "button", "aria-pressed": isActive, "aria-label": label, title: label, onClick: () => { if (!isActive)
+                    onViewModeChange(mode); }, className: cn('inline-flex items-center justify-center px-element-sm py-element-sm transition-colors', index > 0 && 'border-s border-border', isActive
+                    ? 'bg-muted text-foreground'
+                    : 'text-muted-foreground hover:bg-muted/50 hover:text-foreground'), children: _jsx("span", { "aria-hidden": "true", children: renderIcon(icon, { size: IconSize.SM }) }) }, mode));
+        }) }));
+};
+//# sourceMappingURL=ResourceViewModeToggle.js.map

package/dist/esm/components/resources/ResourceViewModeToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceViewModeToggle.js","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceViewModeToggle.tsx"],"names":[],"mappings":";AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAiBtG,MAAM,iBAAiB,GAA8B;IACnD,EAAE,IAAI,EAAE,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE;IACnG,EAAE,IAAI,EAAE,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,qBAAqB,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE;CACrG,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EACrC,QAAQ,EACR,gBAAgB,EAChB,SAAS,GACmB,EAA4B,EAAE;IAC1D,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACrG,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC;IAEzC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,EAAE,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,UAAU,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAElG,OAAO,CACL,cACE,IAAI,EAAC,OAAO,gBACA,EAAE,CAAC,eAAe,CAAC,EAC/B,SAAS,EAAE,EAAE,CAAC,sEAAsE,EAAE,SAAS,CAAC,YAE/F,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE;YACzD,MAAM,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;YACnC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO,CACL,iBAEE,IAAI,EAAC,QAAQ,kBACC,QAAQ,gBACV,KAAK,EACjB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ;oBAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACzD,SAAS,EAAE,EAAE,CACX,uFAAuF,EACvF,KAAK,GAAG,CAAC,IAAI,wBAAwB,EACrC,QAAQ;oBACN,CAAC,CAAC,0BAA0B;oBAC5B,CAAC,CAAC,+DAA+D,CACpE,YAED,8BAAkB,MAAM,YAAE,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,GAAQ,IAdpE,IAAI,CAeF,CACV,CAAC;QACJ,CAAC,CAAC,GACE,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * ResourceViewModeToggle — a compact segmented control that switches a resource\n * collection between CARDS and TABLE display. Icon-only (labels via tooltip +\n * accessible name); the active segment is filled.\n *\n * Presentational: it owns no state. The collection host passes the current\n * `viewMode` and an `onViewModeChange` handler (which persists the choice).\n */\n\nimport React from 'react';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { StandardIconReference, IconSize } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { CollectionDisplayMode } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport interface ResourceViewModeToggleProps {\n  /** The active view-mode. */\n  viewMode: CollectionDisplayMode;\n  /** Called with the newly selected mode (the host persists it). */\n  onViewModeChange: (mode: CollectionDisplayMode) => void;\n  /** Additional CSS classes for the segmented container. */\n  className?: string;\n}\n\ninterface ViewModeOption {\n  mode: CollectionDisplayMode;\n  icon: StandardIconReference;\n  labelKey: string;\n}\n\nconst VIEW_MODE_OPTIONS: readonly ViewModeOption[] = [\n  { mode: CollectionDisplayMode.CARDS, icon: StandardIconReference.VIEW_LIST, labelKey: 'viewCards' },\n  { mode: CollectionDisplayMode.TABLE, icon: StandardIconReference.VIEW_TABLE, labelKey: 'viewTable' },\n];\n\nexport const ResourceViewModeToggle = ({\n  viewMode,\n  onViewModeChange,\n  className,\n}: ResourceViewModeToggleProps): React.JSX.Element | null => {\n  const { tComponent, isReady } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_LIST });\n  const { renderIcon } = useIconRegistry();\n\n  if (!isReady) return null;\n\n  const tc = (key: string): string => tComponent(FrontendComponentType.RESOURCES_LAYOUTS_LIST, key);\n\n  return (\n    <div\n      role=\"group\"\n      aria-label={tc('viewModeLabel')}\n      className={cn('inline-flex shrink-0 rounded-md border border-border overflow-hidden', className)}\n    >\n      {VIEW_MODE_OPTIONS.map(({ mode, icon, labelKey }, index) => {\n        const isActive = viewMode === mode;\n        const label = tc(labelKey);\n        return (\n          <button\n            key={mode}\n            type=\"button\"\n            aria-pressed={isActive}\n            aria-label={label}\n            title={label}\n            onClick={() => { if (!isActive) onViewModeChange(mode); }}\n            className={cn(\n              'inline-flex items-center justify-center px-element-sm py-element-sm transition-colors',\n              index > 0 && 'border-s border-border',\n              isActive\n                ? 'bg-muted text-foreground'\n                : 'text-muted-foreground hover:bg-muted/50 hover:text-foreground',\n            )}\n          >\n            <span aria-hidden=\"true\">{renderIcon(icon, { size: IconSize.SM })}</span>\n          </button>\n        );\n      })}\n    </div>\n  );\n};\n"]}

package/dist/esm/components/resources/card-action-placement.utils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Card action-button placement — resolves a 2-axis
+ * {@link VerticalPlacement} × {@link HorizontalPlacement} anchor (+ button-set
+ * {@link DisplayDirection} orientation) into the flex classes that position a
+ * card's per-item action region relative to its content.
+ *
+ * **Why flexbox, not an absolute overlay.** A card holds a variable number of
+ * action buttons and the button set can be a row or a vertical stack. Absolute
+ * corner-positioning would overlap the title/body and needs per-count padding
+ * guesses. Instead the 8 valid positions decompose into two robust flex modes:
+ *
+ * - **Side** (`horizontal` = START | END): content and actions share a row; the
+ *   `vertical` axis becomes the cross-axis alignment (TOP→`items-start`,
+ *   MIDDLE→`items-center`, BOTTOM→`items-end`). START flips the row so actions
+ *   sit at the inline-start while content keeps reading order.
+ * - **Band** (`horizontal` = MIDDLE, `vertical` = TOP | BOTTOM): content and a
+ *   horizontally-centered action band stack vertically; TOP puts the band above.
+ *
+ * `MIDDLE × MIDDLE` is rejected at the schema layer (dead-center over content),
+ * so it never reaches here — this resolver assumes a valid (non-dead-center)
+ * placement. A caller that bypasses schema validation and passes MIDDLE × MIDDLE
+ * gets the band-below layout (it hits the band branch), NOT the side default.
+ *
+ * DOM order is always [content][actions]; the `-reverse` variants flip the
+ * VISUAL order so reading/tab order stays content-first.
+ */
+import type { CardActionPlacement } from '../../core/resources/resources.frontend.schemas';
+/** Resolved flex classes for the content-vs-actions layout of a card. */
+export interface CardActionPlacementClasses {
+    /** Applied to the flex container wrapping [content][actions]. */
+    containerClass: string;
+    /** Applied to the content region. */
+    contentClass: string;
+    /** Applied to the actions region. */
+    actionsClass: string;
+}
+/**
+ * The framework default — matches the historical card look: actions at the
+ * inline-end, vertically centered, as a horizontal row.
+ */
+export declare const DEFAULT_CARD_ACTION_PLACEMENT: CardActionPlacement;
+export declare function resolveCardActionPlacementClasses(placement?: CardActionPlacement): CardActionPlacementClasses;
+//# sourceMappingURL=card-action-placement.utils.d.ts.map

package/dist/esm/components/resources/card-action-placement.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-action-placement.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/card-action-placement.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAC;AAEzG,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAI3C,CAAC;AAQF,wBAAgB,iCAAiC,CAC/C,SAAS,GAAE,mBAAmD,GAC7D,0BAA0B,CAsB5B"}

package/dist/esm/components/resources/card-action-placement.utils.js

@@ -0,0 +1,64 @@
+/**
+ * Card action-button placement — resolves a 2-axis
+ * {@link VerticalPlacement} × {@link HorizontalPlacement} anchor (+ button-set
+ * {@link DisplayDirection} orientation) into the flex classes that position a
+ * card's per-item action region relative to its content.
+ *
+ * **Why flexbox, not an absolute overlay.** A card holds a variable number of
+ * action buttons and the button set can be a row or a vertical stack. Absolute
+ * corner-positioning would overlap the title/body and needs per-count padding
+ * guesses. Instead the 8 valid positions decompose into two robust flex modes:
+ *
+ * - **Side** (`horizontal` = START | END): content and actions share a row; the
+ *   `vertical` axis becomes the cross-axis alignment (TOP→`items-start`,
+ *   MIDDLE→`items-center`, BOTTOM→`items-end`). START flips the row so actions
+ *   sit at the inline-start while content keeps reading order.
+ * - **Band** (`horizontal` = MIDDLE, `vertical` = TOP | BOTTOM): content and a
+ *   horizontally-centered action band stack vertically; TOP puts the band above.
+ *
+ * `MIDDLE × MIDDLE` is rejected at the schema layer (dead-center over content),
+ * so it never reaches here — this resolver assumes a valid (non-dead-center)
+ * placement. A caller that bypasses schema validation and passes MIDDLE × MIDDLE
+ * gets the band-below layout (it hits the band branch), NOT the side default.
+ *
+ * DOM order is always [content][actions]; the `-reverse` variants flip the
+ * VISUAL order so reading/tab order stays content-first.
+ */
+import { DisplayDirection } from '@wildo-ai/zod-decorators';
+import { VerticalPlacement, HorizontalPlacement } from '@wildo-ai/presets-components-models';
+/**
+ * The framework default — matches the historical card look: actions at the
+ * inline-end, vertically centered, as a horizontal row.
+ */
+export const DEFAULT_CARD_ACTION_PLACEMENT = {
+    vertical: VerticalPlacement.MIDDLE,
+    horizontal: HorizontalPlacement.END,
+    orientation: DisplayDirection.HORIZONTAL,
+};
+const VERTICAL_ALIGN_CLASS = {
+    [VerticalPlacement.TOP]: 'items-start',
+    [VerticalPlacement.MIDDLE]: 'items-center',
+    [VerticalPlacement.BOTTOM]: 'items-end',
+};
+export function resolveCardActionPlacementClasses(placement = DEFAULT_CARD_ACTION_PLACEMENT) {
+    const { vertical, horizontal, orientation = DisplayDirection.HORIZONTAL } = placement;
+    const stacked = orientation === DisplayDirection.VERTICAL;
+    const actionsInner = stacked ? 'flex flex-col gap-element-sm' : 'flex gap-element-sm';
+    // Band mode: horizontally-centered actions above/below the content.
+    if (horizontal === HorizontalPlacement.MIDDLE) {
+        const above = vertical === VerticalPlacement.TOP;
+        return {
+            containerClass: `flex ${above ? 'flex-col-reverse' : 'flex-col'} gap-element-sm`,
+            contentClass: 'min-w-0',
+            actionsClass: `${actionsInner} self-center`,
+        };
+    }
+    // Side mode: actions beside the content, aligned per the vertical axis.
+    const atStart = horizontal === HorizontalPlacement.START;
+    return {
+        containerClass: `flex ${atStart ? 'flex-row-reverse' : ''} ${VERTICAL_ALIGN_CLASS[vertical]} gap-element-sm`.replace(/\s+/g, ' ').trim(),
+        contentClass: 'min-w-0 flex-1',
+        actionsClass: `${actionsInner} shrink-0`,
+    };
+}
+//# sourceMappingURL=card-action-placement.utils.js.map

package/dist/esm/components/resources/card-action-placement.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-action-placement.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/card-action-placement.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAe7F;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,QAAQ,EAAE,iBAAiB,CAAC,MAAM;IAClC,UAAU,EAAE,mBAAmB,CAAC,GAAG;IACnC,WAAW,EAAE,gBAAgB,CAAC,UAAU;CACzC,CAAC;AAEF,MAAM,oBAAoB,GAAsC;IAC9D,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,aAAa;IACtC,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc;IAC1C,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW;CACxC,CAAC;AAEF,MAAM,UAAU,iCAAiC,CAC/C,YAAiC,6BAA6B;IAE9D,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,GAAG,gBAAgB,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC;IACtF,MAAM,OAAO,GAAG,WAAW,KAAK,gBAAgB,CAAC,QAAQ,CAAC;IAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAEtF,oEAAoE;IACpE,IAAI,UAAU,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,KAAK,iBAAiB,CAAC,GAAG,CAAC;QACjD,OAAO;YACL,cAAc,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,iBAAiB;YAChF,YAAY,EAAE,SAAS;YACvB,YAAY,EAAE,GAAG,YAAY,cAAc;SAC5C,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,MAAM,OAAO,GAAG,UAAU,KAAK,mBAAmB,CAAC,KAAK,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,IAAI,oBAAoB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;QACxI,YAAY,EAAE,gBAAgB;QAC9B,YAAY,EAAE,GAAG,YAAY,WAAW;KACzC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Card action-button placement — resolves a 2-axis\n * {@link VerticalPlacement} × {@link HorizontalPlacement} anchor (+ button-set\n * {@link DisplayDirection} orientation) into the flex classes that position a\n * card's per-item action region relative to its content.\n *\n * **Why flexbox, not an absolute overlay.** A card holds a variable number of\n * action buttons and the button set can be a row or a vertical stack. Absolute\n * corner-positioning would overlap the title/body and needs per-count padding\n * guesses. Instead the 8 valid positions decompose into two robust flex modes:\n *\n * - **Side** (`horizontal` = START | END): content and actions share a row; the\n *   `vertical` axis becomes the cross-axis alignment (TOP→`items-start`,\n *   MIDDLE→`items-center`, BOTTOM→`items-end`). START flips the row so actions\n *   sit at the inline-start while content keeps reading order.\n * - **Band** (`horizontal` = MIDDLE, `vertical` = TOP | BOTTOM): content and a\n *   horizontally-centered action band stack vertically; TOP puts the band above.\n *\n * `MIDDLE × MIDDLE` is rejected at the schema layer (dead-center over content),\n * so it never reaches here — this resolver assumes a valid (non-dead-center)\n * placement. A caller that bypasses schema validation and passes MIDDLE × MIDDLE\n * gets the band-below layout (it hits the band branch), NOT the side default.\n *\n * DOM order is always [content][actions]; the `-reverse` variants flip the\n * VISUAL order so reading/tab order stays content-first.\n */\n\nimport { DisplayDirection } from '@wildo-ai/zod-decorators';\nimport { VerticalPlacement, HorizontalPlacement } from '@wildo-ai/presets-components-models';\n// `CardActionPlacement` is inferred from `CardActionPlacementSchema` (its single\n// source of truth); this resolver and the config field can never drift.\nimport type { CardActionPlacement } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/** Resolved flex classes for the content-vs-actions layout of a card. */\nexport interface CardActionPlacementClasses {\n  /** Applied to the flex container wrapping [content][actions]. */\n  containerClass: string;\n  /** Applied to the content region. */\n  contentClass: string;\n  /** Applied to the actions region. */\n  actionsClass: string;\n}\n\n/**\n * The framework default — matches the historical card look: actions at the\n * inline-end, vertically centered, as a horizontal row.\n */\nexport const DEFAULT_CARD_ACTION_PLACEMENT: CardActionPlacement = {\n  vertical: VerticalPlacement.MIDDLE,\n  horizontal: HorizontalPlacement.END,\n  orientation: DisplayDirection.HORIZONTAL,\n};\n\nconst VERTICAL_ALIGN_CLASS: Record<VerticalPlacement, string> = {\n  [VerticalPlacement.TOP]: 'items-start',\n  [VerticalPlacement.MIDDLE]: 'items-center',\n  [VerticalPlacement.BOTTOM]: 'items-end',\n};\n\nexport function resolveCardActionPlacementClasses(\n  placement: CardActionPlacement = DEFAULT_CARD_ACTION_PLACEMENT,\n): CardActionPlacementClasses {\n  const { vertical, horizontal, orientation = DisplayDirection.HORIZONTAL } = placement;\n  const stacked = orientation === DisplayDirection.VERTICAL;\n  const actionsInner = stacked ? 'flex flex-col gap-element-sm' : 'flex gap-element-sm';\n\n  // Band mode: horizontally-centered actions above/below the content.\n  if (horizontal === HorizontalPlacement.MIDDLE) {\n    const above = vertical === VerticalPlacement.TOP;\n    return {\n      containerClass: `flex ${above ? 'flex-col-reverse' : 'flex-col'} gap-element-sm`,\n      contentClass: 'min-w-0',\n      actionsClass: `${actionsInner} self-center`,\n    };\n  }\n\n  // Side mode: actions beside the content, aligned per the vertical axis.\n  const atStart = horizontal === HorizontalPlacement.START;\n  return {\n    containerClass: `flex ${atStart ? 'flex-row-reverse' : ''} ${VERTICAL_ALIGN_CLASS[vertical]} gap-element-sm`.replace(/\\s+/g, ' ').trim(),\n    contentClass: 'min-w-0 flex-1',\n    actionsClass: `${actionsInner} shrink-0`,\n  };\n}\n"]}

package/dist/esm/components/resources/collection-card-layout.utils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Cards-mode collection layout — resolves the `<ul>` container className (and,
+ * for GRID, an inline `grid-template-columns`) for the two CARDS arrangements
+ * (see `CardLayoutStyle`):
+ *
+ * - **LIST**: one bordered container whose rows are separated by `divide-y`.
+ * - **GRID**: a responsive N-column grid; the shared `divide-y` border is
+ *   dropped, so each card CELL owns its own border (the host adds it on the
+ *   `<li>`). `columns` is the wide TARGET; the grid steps DOWN to fewer columns
+ *   as space narrows.
+ *
+ * **Container-responsive, not viewport-responsive.** The column count is an
+ * intrinsic `repeat(auto-fill, minmax(max(<minCard>, <target>), 1fr))` track
+ * spec that reacts to the GRID's OWN available width — so a cards grid embedded
+ * in a narrow pane (split view, composite panel, sidebar) collapses correctly
+ * even on a wide viewport. This needs no `@container` ancestor and no media
+ * breakpoints. Emitted as an inline style (not a Tailwind class) because the
+ * track formula is parameterised by N and the design-token gap, and because
+ * `cn`/twMerge cannot reason about design-token utilities anyway.
+ *
+ * Shared by `ResourceLayout_List` and `ResourceLayout_Search` so the two card
+ * surfaces can never drift.
+ */
+import type { CSSProperties } from 'react';
+/** LIST container: bordered box with `divide-y` rows (the classic stacked list). */
+export declare const CARDS_LIST_CONTAINER_CLASS = "border border-border rounded-lg divide-y divide-border list-none m-0 p-0";
+/** GRID cell border applied to each `<li>` (the shared border is gone in grid mode). */
+export declare const CARDS_GRID_CELL_CLASS = "border border-border rounded-lg overflow-hidden";
+/**
+ * Container `<ul>` className. Pass the target column count for a GRID, or
+ * `undefined` for the single-column LIST. Pair a GRID with
+ * {@link resolveCardsGridStyle} for the column tracks.
+ */
+export declare function resolveCardsContainerClass(columns: number | undefined): string;
+/**
+ * Inline `grid-template-columns` for a GRID, or `undefined` for LIST.
+ *
+ * `repeat(auto-fill, minmax(max(<minCard>, (100% − (N−1)·gap) / N), 1fr))`:
+ * - On WIDE space `(100% − gaps)/N ≥ <minCard>`, so the track min is the target
+ *   share → exactly N columns (caps at the authored count).
+ * - On NARROW space `(100% − gaps)/N < <minCard>`, so the track min is the
+ *   absolute `<minCard>` → `auto-fill` fits fewer than N → the grid steps down.
+ * Reacts to the `<ul>`'s own width, so embedded narrow hosts collapse without a
+ * viewport breakpoint or `@container` wrapper.
+ */
+export declare function resolveCardsGridStyle(columns: number | undefined): CSSProperties | undefined;
+//# sourceMappingURL=collection-card-layout.utils.d.ts.map

package/dist/esm/components/resources/collection-card-layout.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-card-layout.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/collection-card-layout.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAS3C,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,6EACqC,CAAC;AAE7E,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,oDAAoD,CAAC;AAKvF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAO5F"}

package/dist/esm/components/resources/collection-card-layout.utils.js

@@ -0,0 +1,66 @@
+/**
+ * Cards-mode collection layout — resolves the `<ul>` container className (and,
+ * for GRID, an inline `grid-template-columns`) for the two CARDS arrangements
+ * (see `CardLayoutStyle`):
+ *
+ * - **LIST**: one bordered container whose rows are separated by `divide-y`.
+ * - **GRID**: a responsive N-column grid; the shared `divide-y` border is
+ *   dropped, so each card CELL owns its own border (the host adds it on the
+ *   `<li>`). `columns` is the wide TARGET; the grid steps DOWN to fewer columns
+ *   as space narrows.
+ *
+ * **Container-responsive, not viewport-responsive.** The column count is an
+ * intrinsic `repeat(auto-fill, minmax(max(<minCard>, <target>), 1fr))` track
+ * spec that reacts to the GRID's OWN available width — so a cards grid embedded
+ * in a narrow pane (split view, composite panel, sidebar) collapses correctly
+ * even on a wide viewport. This needs no `@container` ancestor and no media
+ * breakpoints. Emitted as an inline style (not a Tailwind class) because the
+ * track formula is parameterised by N and the design-token gap, and because
+ * `cn`/twMerge cannot reason about design-token utilities anyway.
+ *
+ * Shared by `ResourceLayout_List` and `ResourceLayout_Search` so the two card
+ * surfaces can never drift.
+ */
+import { cn } from '../../core/ui/cn.js';
+/**
+ * Minimum card track width before a column is dropped (~240px). Below this, the
+ * grid fits fewer columns than the authored target; at/above it, up to N.
+ */
+const CARD_GRID_MIN_TRACK = '15rem';
+/** LIST container: bordered box with `divide-y` rows (the classic stacked list). */
+export const CARDS_LIST_CONTAINER_CLASS = 'border border-border rounded-lg divide-y divide-border list-none m-0 p-0';
+/** GRID cell border applied to each `<li>` (the shared border is gone in grid mode). */
+export const CARDS_GRID_CELL_CLASS = 'border border-border rounded-lg overflow-hidden';
+/** GRID container base classes (column tracks come from {@link resolveCardsGridStyle}). */
+const CARDS_GRID_CONTAINER_CLASS = 'grid gap-element list-none m-0 p-0';
+/**
+ * Container `<ul>` className. Pass the target column count for a GRID, or
+ * `undefined` for the single-column LIST. Pair a GRID with
+ * {@link resolveCardsGridStyle} for the column tracks.
+ */
+export function resolveCardsContainerClass(columns) {
+    if (columns === undefined)
+        return CARDS_LIST_CONTAINER_CLASS;
+    return cn(CARDS_GRID_CONTAINER_CLASS);
+}
+/**
+ * Inline `grid-template-columns` for a GRID, or `undefined` for LIST.
+ *
+ * `repeat(auto-fill, minmax(max(<minCard>, (100% − (N−1)·gap) / N), 1fr))`:
+ * - On WIDE space `(100% − gaps)/N ≥ <minCard>`, so the track min is the target
+ *   share → exactly N columns (caps at the authored count).
+ * - On NARROW space `(100% − gaps)/N < <minCard>`, so the track min is the
+ *   absolute `<minCard>` → `auto-fill` fits fewer than N → the grid steps down.
+ * Reacts to the `<ul>`'s own width, so embedded narrow hosts collapse without a
+ * viewport breakpoint or `@container` wrapper.
+ */
+export function resolveCardsGridStyle(columns) {
+    if (columns === undefined)
+        return undefined;
+    const n = Math.min(Math.max(Math.trunc(columns), 1), 6);
+    const target = `calc((100% - ${n - 1} * var(--spacing-element)) / ${n})`;
+    return {
+        gridTemplateColumns: `repeat(auto-fill, minmax(max(${CARD_GRID_MIN_TRACK}, ${target}), 1fr))`,
+    };
+}
+//# sourceMappingURL=collection-card-layout.utils.js.map

package/dist/esm/components/resources/collection-card-layout.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-card-layout.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/collection-card-layout.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD;;;GAGG;AACH,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAEpC,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GACrC,0EAA0E,CAAC;AAE7E,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,iDAAiD,CAAC;AAEvF,2FAA2F;AAC3F,MAAM,0BAA0B,GAAG,oCAAoC,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA2B;IACpE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,0BAA0B,CAAC;IAC7D,OAAO,EAAE,CAAC,0BAA0B,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,gCAAgC,CAAC,GAAG,CAAC;IACzE,OAAO;QACL,mBAAmB,EAAE,gCAAgC,mBAAmB,KAAK,MAAM,UAAU;KAC9F,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Cards-mode collection layout — resolves the `<ul>` container className (and,\n * for GRID, an inline `grid-template-columns`) for the two CARDS arrangements\n * (see `CardLayoutStyle`):\n *\n * - **LIST**: one bordered container whose rows are separated by `divide-y`.\n * - **GRID**: a responsive N-column grid; the shared `divide-y` border is\n *   dropped, so each card CELL owns its own border (the host adds it on the\n *   `<li>`). `columns` is the wide TARGET; the grid steps DOWN to fewer columns\n *   as space narrows.\n *\n * **Container-responsive, not viewport-responsive.** The column count is an\n * intrinsic `repeat(auto-fill, minmax(max(<minCard>, <target>), 1fr))` track\n * spec that reacts to the GRID's OWN available width — so a cards grid embedded\n * in a narrow pane (split view, composite panel, sidebar) collapses correctly\n * even on a wide viewport. This needs no `@container` ancestor and no media\n * breakpoints. Emitted as an inline style (not a Tailwind class) because the\n * track formula is parameterised by N and the design-token gap, and because\n * `cn`/twMerge cannot reason about design-token utilities anyway.\n *\n * Shared by `ResourceLayout_List` and `ResourceLayout_Search` so the two card\n * surfaces can never drift.\n */\n\nimport type { CSSProperties } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n/**\n * Minimum card track width before a column is dropped (~240px). Below this, the\n * grid fits fewer columns than the authored target; at/above it, up to N.\n */\nconst CARD_GRID_MIN_TRACK = '15rem';\n\n/** LIST container: bordered box with `divide-y` rows (the classic stacked list). */\nexport const CARDS_LIST_CONTAINER_CLASS =\n  'border border-border rounded-lg divide-y divide-border list-none m-0 p-0';\n\n/** GRID cell border applied to each `<li>` (the shared border is gone in grid mode). */\nexport const CARDS_GRID_CELL_CLASS = 'border border-border rounded-lg overflow-hidden';\n\n/** GRID container base classes (column tracks come from {@link resolveCardsGridStyle}). */\nconst CARDS_GRID_CONTAINER_CLASS = 'grid gap-element list-none m-0 p-0';\n\n/**\n * Container `<ul>` className. Pass the target column count for a GRID, or\n * `undefined` for the single-column LIST. Pair a GRID with\n * {@link resolveCardsGridStyle} for the column tracks.\n */\nexport function resolveCardsContainerClass(columns: number | undefined): string {\n  if (columns === undefined) return CARDS_LIST_CONTAINER_CLASS;\n  return cn(CARDS_GRID_CONTAINER_CLASS);\n}\n\n/**\n * Inline `grid-template-columns` for a GRID, or `undefined` for LIST.\n *\n * `repeat(auto-fill, minmax(max(<minCard>, (100% − (N−1)·gap) / N), 1fr))`:\n * - On WIDE space `(100% − gaps)/N ≥ <minCard>`, so the track min is the target\n *   share → exactly N columns (caps at the authored count).\n * - On NARROW space `(100% − gaps)/N < <minCard>`, so the track min is the\n *   absolute `<minCard>` → `auto-fill` fits fewer than N → the grid steps down.\n * Reacts to the `<ul>`'s own width, so embedded narrow hosts collapse without a\n * viewport breakpoint or `@container` wrapper.\n */\nexport function resolveCardsGridStyle(columns: number | undefined): CSSProperties | undefined {\n  if (columns === undefined) return undefined;\n  const n = Math.min(Math.max(Math.trunc(columns), 1), 6);\n  const target = `calc((100% - ${n - 1} * var(--spacing-element)) / ${n})`;\n  return {\n    gridTemplateColumns: `repeat(auto-fill, minmax(max(${CARD_GRID_MIN_TRACK}, ${target}), 1fr))`,\n  };\n}\n"]}

package/dist/esm/components/resources/collection-view-mode.frontend.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Collection view-mode state — the runtime "cards vs table" display choice for a
+ * resource collection view.
+ *
+ * The DEFAULT mode for a resource comes from its LIST/SEARCH operation's
+ * `collectionDisplayConfig.displayMode` (authored in the resource UI behavior),
+ * falling back to its registered preset seed. The user's toggle OVERRIDES that
+ * default and PERSISTS per resource type, so a chosen display sticks across
+ * navigations and reloads while the config still seeds the first view.
+ *
+ * The display vocabulary is `CollectionDisplayMode` (CARDS|TABLE), owned by the
+ * frontend core schema (`resources.frontend.schemas.ts`) — these persistence
+ * helpers are the runtime side of that vocabulary.
+ *
+ * Persistence goes through the framework's single storage abstraction
+ * (`getLocalStorageItem`/`setLocalStorageItem`), which fails closed when storage
+ * is unavailable (e.g. the companion's Node introspection render) — so reads fall
+ * back to the supplied default and the hook never throws off-browser.
+ */
+import { CollectionDisplayMode } from '../../core/resources/resources.frontend.schemas';
+/**
+ * The persisted display mode for a resource type, or `null` when none is stored
+ * (first visit) or storage is unavailable. Validated against the enum so a
+ * tampered/legacy value never leaks through.
+ */
+export declare function readPersistedViewMode(resourceType: string): CollectionDisplayMode | null;
+/** Persist the user's display-mode choice for a resource type. */
+export declare function persistViewMode(resourceType: string, mode: CollectionDisplayMode): void;
+export interface UseViewModeResult {
+    /** The active display mode (persisted choice if any, else the seeded default). */
+    viewMode: CollectionDisplayMode;
+    /** Set + persist the display mode for this resource type. */
+    setViewMode: (mode: CollectionDisplayMode) => void;
+}
+/**
+ * Display-mode state for a collection: seeds from the persisted choice (falling
+ * back to the config-derived `defaultMode`) and persists on change.
+ *
+ * `resourceType` is stable per mounted collection, so the lazy initializer reads
+ * storage exactly once.
+ */
+export declare function useViewMode(resourceType: string, defaultMode: CollectionDisplayMode): UseViewModeResult;
+//# sourceMappingURL=collection-view-mode.frontend.d.ts.map

package/dist/esm/components/resources/collection-view-mode.frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-view-mode.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/collection-view-mode.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAQtG;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAMxF;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAEvF;AAED,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,EAAE,qBAAqB,CAAC;IAChC,6DAA6D;IAC7D,WAAW,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,GAAG,iBAAiB,CAWvG"}

package/dist/esm/components/resources/collection-view-mode.frontend.js

@@ -0,0 +1,58 @@
+/**
+ * Collection view-mode state — the runtime "cards vs table" display choice for a
+ * resource collection view.
+ *
+ * The DEFAULT mode for a resource comes from its LIST/SEARCH operation's
+ * `collectionDisplayConfig.displayMode` (authored in the resource UI behavior),
+ * falling back to its registered preset seed. The user's toggle OVERRIDES that
+ * default and PERSISTS per resource type, so a chosen display sticks across
+ * navigations and reloads while the config still seeds the first view.
+ *
+ * The display vocabulary is `CollectionDisplayMode` (CARDS|TABLE), owned by the
+ * frontend core schema (`resources.frontend.schemas.ts`) — these persistence
+ * helpers are the runtime side of that vocabulary.
+ *
+ * Persistence goes through the framework's single storage abstraction
+ * (`getLocalStorageItem`/`setLocalStorageItem`), which fails closed when storage
+ * is unavailable (e.g. the companion's Node introspection render) — so reads fall
+ * back to the supplied default and the hook never throws off-browser.
+ */
+import { useCallback, useState } from 'react';
+import { getLocalStorageItem, setLocalStorageItem, } from '../../core/commons/local-storage.frontend.schemas.js';
+import { CollectionDisplayMode } from '../../core/resources/resources.frontend.schemas.js';
+const VIEW_MODE_STORAGE_PREFIX = 'wildo-collection-view-mode:';
+function viewModeStorageKey(resourceType) {
+    return `${VIEW_MODE_STORAGE_PREFIX}${resourceType}`;
+}
+/**
+ * The persisted display mode for a resource type, or `null` when none is stored
+ * (first visit) or storage is unavailable. Validated against the enum so a
+ * tampered/legacy value never leaks through.
+ */
+export function readPersistedViewMode(resourceType) {
+    const raw = getLocalStorageItem(viewModeStorageKey(resourceType));
+    if (raw === CollectionDisplayMode.CARDS || raw === CollectionDisplayMode.TABLE) {
+        return raw;
+    }
+    return null;
+}
+/** Persist the user's display-mode choice for a resource type. */
+export function persistViewMode(resourceType, mode) {
+    setLocalStorageItem(viewModeStorageKey(resourceType), mode);
+}
+/**
+ * Display-mode state for a collection: seeds from the persisted choice (falling
+ * back to the config-derived `defaultMode`) and persists on change.
+ *
+ * `resourceType` is stable per mounted collection, so the lazy initializer reads
+ * storage exactly once.
+ */
+export function useViewMode(resourceType, defaultMode) {
+    const [viewMode, setViewModeState] = useState(() => readPersistedViewMode(resourceType) ?? defaultMode);
+    const setViewMode = useCallback((mode) => {
+        setViewModeState(mode);
+        persistViewMode(resourceType, mode);
+    }, [resourceType]);
+    return { viewMode, setViewMode };
+}
+//# sourceMappingURL=collection-view-mode.frontend.js.map