@12-apps/ui 6.71.0 → 6.72.0

package/dist/_internal/components/data-display/CardKit/card-actions-context.js

@@ -2,7 +2,7 @@
 import {
   CardActionsProvider,
   useCardActions
-} from "../../../../chunk-N7KWWIF7.js";
+} from "../../../../chunk-LY7PBZ3Z.js";
 import "../../../../chunk-NUGT7LMR.js";
 import "../../../../chunk-DQJFCVXW.js";
 import "../../../../chunk-JYAXTRNH.js";

package/dist/_internal/components/data-display/CardKit/use-remove-confirm.js

@@ -1,8 +1,8 @@
 "use client";
 import {
   useRemoveConfirm
-} from "../../../../chunk-62BY4ZUQ.js";
-import "../../../../chunk-N7KWWIF7.js";
+} from "../../../../chunk-7KAZ3B5B.js";
+import "../../../../chunk-LY7PBZ3Z.js";
 import "../../../../chunk-XCBQXSTR.js";
 import "../../../../chunk-NJMAFII4.js";
 import "../../../../chunk-GICG3XJK.js";

package/dist/{chunk-62BY4ZUQ.js → chunk-7KAZ3B5B.js}

@@ -1,6 +1,6 @@
 import {
   useCardActions
-} from "./chunk-N7KWWIF7.js";
+} from "./chunk-LY7PBZ3Z.js";
 import {
   useConfirmAction
 } from "./chunk-EMYESBIT.js";
@@ -50,4 +50,4 @@ function useRemoveConfirm({
 export {
   useRemoveConfirm
 };
-//# sourceMappingURL=chunk-62BY4ZUQ.js.map
+//# sourceMappingURL=chunk-7KAZ3B5B.js.map

package/dist/{chunk-N7KWWIF7.js → chunk-LY7PBZ3Z.js}

@@ -13,13 +13,17 @@ function CardActionsProvider({
   errorTitle,
   errorDismissLabel,
   autoHideMs = 6e3,
+  onError,
   children
 }) {
   const [error, setError] = useState(null);
-  const notifyError = useCallback((message) => setError(message), []);
+  const notifyError = useCallback(
+    (message) => onError ? onError(errorTitle, message) : setError(message),
+    [onError, errorTitle]
+  );
   return /* @__PURE__ */ jsxs(CardActionsContext.Provider, { value: { tenantSlug, onRefresh, notifyError }, children: [
     children,
-    /* @__PURE__ */ jsx(
+    onError === void 0 && /* @__PURE__ */ jsx(
       Snackbar,
       {
         open: error !== null,
@@ -54,4 +58,4 @@ export {
   CardActionsProvider,
   useCardActions
 };
-//# sourceMappingURL=chunk-N7KWWIF7.js.map
+//# sourceMappingURL=chunk-LY7PBZ3Z.js.map

package/dist/chunk-LY7PBZ3Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/data-display/CardKit/card-actions-context.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useCallback, useContext, useState, type JSX, type ReactNode } from 'react';\n\nimport Snackbar from '@mui/material/Snackbar/index.js';\n\nimport { Alert } from '../Alert';\n\n/**\n * The ambient wiring a self-contained row/card menu needs, and nothing else.\n *\n * A menu that owns its own popups still needs three things it cannot know: the\n * tenant it is acting inside, what to do after a write lands, and somewhere to\n * put a failure. Passing those down through the grid, the layout and the card\n * is four props of drilling per entity; holding them in context is one.\n *\n * Kept deliberately SMALL — it is not an edit-dialog host. A menu that read its\n * dialogs from here would stop being portable, because the set of dialogs is\n * per-entity. What it may read is the three facts below.\n *\n * The provider renders ONE shared error snackbar, which is the whole reason the\n * error channel is here rather than per-menu: before it, every page carried its\n * own error alert and every menu had to find its page's.\n */\ninterface CardActionsValue {\n  /** The tenant every action in this subtree acts inside. */\n  tenantSlug: string;\n  /** Re-read the list after a write. */\n  onRefresh: () => void;\n  /** Surface a failed action's message (the shared snackbar). */\n  notifyError: (message: string) => void;\n}\n\nconst CardActionsContext = createContext<CardActionsValue | null>(null);\n\nexport function CardActionsProvider({\n  tenantSlug,\n  onRefresh,\n  errorTitle,\n  errorDismissLabel,\n  autoHideMs = 6_000,\n  onError,\n  children,\n}: {\n  tenantSlug: string;\n  onRefresh: () => void;\n  /**\n   * The snackbar's heading — required, no default.\n   *\n   * It is the one sentence this provider renders on its own, and a default\n   * would be the origin's language shipped as a finished-looking silence. The\n   * MESSAGE beside it comes from whatever failed, which is already the host's.\n   */\n  errorTitle: string;\n  /** The dismiss on that alert, which carries a glyph only. REQUIRED. */\n  errorDismissLabel: string;\n  /** How long the snackbar stays up. */\n  autoHideMs?: number;\n  /**\n   * Hand a failure to the HOST's own toast channel instead of this provider's\n   * snackbar. Given, the provider draws nothing of its own: an app with one\n   * toast column (every toast in one place, in one look) passes its `toast`\n   * here, so a card's failure lands with every other toast rather than in a\n   * corner of its own. It receives the same heading and message the snackbar\n   * would have shown.\n   */\n  onError?: (title: string, message: string) => void;\n  children: ReactNode;\n}): JSX.Element {\n  const [error, setError] = useState<string | null>(null);\n  const notifyError = useCallback(\n    (message: string) => (onError ? onError(errorTitle, message) : setError(message)),\n    [onError, errorTitle],\n  );\n\n  return (\n    <CardActionsContext.Provider value={{ tenantSlug, onRefresh, notifyError }}>\n      {children}\n      {onError === undefined && (\n      <Snackbar\n        open={error !== null}\n        autoHideDuration={autoHideMs}\n        onClose={() => setError(null)}\n        anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}\n      >\n        <span>\n          <Alert\n            variant=\"danger\"\n            title={errorTitle}\n            description={error ?? ''}\n            closable\n            closeLabel={errorDismissLabel}\n            onClose={() => setError(null)}\n            data-testid=\"card-action-error\"\n          />\n        </span>\n      </Snackbar>\n      )}\n    </CardActionsContext.Provider>\n  );\n}\n\n/**\n * Read the tenant + refresh + error wiring.\n *\n * THROWS outside a provider rather than answering a null object, deliberately:\n * a menu whose `onRefresh` silently did nothing would leave the operator\n * looking at a stale row after a delete that worked, which reads as the delete\n * having failed. Failing at mount says where the provider is missing.\n */\nexport function useCardActions(): CardActionsValue {\n  const value = useContext(CardActionsContext);\n  if (!value) {\n    throw new Error('useCardActions must be used within a CardActionsProvider');\n  }\n  return value;\n}\n"],"mappings":";;;;;AAEA,SAAS,eAAe,aAAa,YAAY,gBAA0C;AAE3F,OAAO,cAAc;AAwEjB,SAUM,KAVN;AA3CJ,IAAM,qBAAqB,cAAuC,IAAI;AAE/D,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AACF,GAyBgB;AACd,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AACtD,QAAM,cAAc;AAAA,IAClB,CAAC,YAAqB,UAAU,QAAQ,YAAY,OAAO,IAAI,SAAS,OAAO;AAAA,IAC/E,CAAC,SAAS,UAAU;AAAA,EACtB;AAEA,SACE,qBAAC,mBAAmB,UAAnB,EAA4B,OAAO,EAAE,YAAY,WAAW,YAAY,GACtE;AAAA;AAAA,IACA,YAAY,UACb;AAAA,MAAC;AAAA;AAAA,QACC,MAAM,UAAU;AAAA,QAChB,kBAAkB;AAAA,QAClB,SAAS,MAAM,SAAS,IAAI;AAAA,QAC5B,cAAc,EAAE,UAAU,UAAU,YAAY,SAAS;AAAA,QAEzD,8BAAC,UACC;AAAA,UAAC;AAAA;AAAA,YACC,SAAQ;AAAA,YACR,OAAO;AAAA,YACP,aAAa,SAAS;AAAA,YACtB,UAAQ;AAAA,YACR,YAAY;AAAA,YACZ,SAAS,MAAM,SAAS,IAAI;AAAA,YAC5B,eAAY;AAAA;AAAA,QACd,GACF;AAAA;AAAA,IACF;AAAA,KAEF;AAEJ;AAUO,SAAS,iBAAmC;AACjD,QAAM,QAAQ,WAAW,kBAAkB;AAC3C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;","names":[]}

package/dist/data-display/CardKit.js

@@ -6,11 +6,11 @@ import {
 } from "../chunk-6QOJEZDH.js";
 import {
   useRemoveConfirm
-} from "../chunk-62BY4ZUQ.js";
+} from "../chunk-7KAZ3B5B.js";
 import {
   CardActionsProvider,
   useCardActions
-} from "../chunk-N7KWWIF7.js";
+} from "../chunk-LY7PBZ3Z.js";
 import {
   rowActionsToMenuItems
 } from "../chunk-ZBXG6RVJ.js";

package/dist/types/components/data-display/CardKit/card-actions-context.d.ts

@@ -23,7 +23,7 @@ interface CardActionsValue {
     /** Surface a failed action's message (the shared snackbar). */
     notifyError: (message: string) => void;
 }
-export declare function CardActionsProvider({ tenantSlug, onRefresh, errorTitle, errorDismissLabel, autoHideMs, children, }: {
+export declare function CardActionsProvider({ tenantSlug, onRefresh, errorTitle, errorDismissLabel, autoHideMs, onError, children, }: {
     tenantSlug: string;
     onRefresh: () => void;
     /**
@@ -38,6 +38,15 @@ export declare function CardActionsProvider({ tenantSlug, onRefresh, errorTitle,
     errorDismissLabel: string;
     /** How long the snackbar stays up. */
     autoHideMs?: number;
+    /**
+     * Hand a failure to the HOST's own toast channel instead of this provider's
+     * snackbar. Given, the provider draws nothing of its own: an app with one
+     * toast column (every toast in one place, in one look) passes its `toast`
+     * here, so a card's failure lands with every other toast rather than in a
+     * corner of its own. It receives the same heading and message the snackbar
+     * would have shown.
+     */
+    onError?: (title: string, message: string) => void;
     children: ReactNode;
 }): JSX.Element;
 /**

package/dist/types/components/data-display/CardKit/card-actions-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-actions-context.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/CardKit/card-actions-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAoD,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMnG;;;;;;;;;;;;;;;GAeG;AACH,UAAU,gBAAgB;IACxB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,+DAA+D;IAC/D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAID,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,UAAkB,EAClB,QAAQ,GACT,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CA2Bd;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAMjD"}
+{"version":3,"file":"card-actions-context.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/CardKit/card-actions-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAoD,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMnG;;;;;;;;;;;;;;;GAeG;AACH,UAAU,gBAAgB;IACxB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,+DAA+D;IAC/D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAID,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,UAAkB,EAClB,OAAO,EACP,QAAQ,GACT,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAgCd;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAMjD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/ui",
-  "version": "6.71.0",
+  "version": "6.72.0",
   "license": "MIT",
   "packageManager": "pnpm@10.34.5",
   "type": "module",

package/src/components/data-display/CardKit/CardKit.md

@@ -33,6 +33,9 @@ language shipped as a finished-looking silence:
   verbatim by a screen reader.
 - `CardActionsProvider`'s **`errorTitle`** — the one sentence the provider
   renders on its own. The message beside it comes from whatever failed.
+  An app with one toast channel passes **`onError(title, message)`** instead of
+  living with the provider's bottom snackbar: given, the provider draws
+  nothing of its own and the failure lands with every other toast.
 - Both hooks' **`confirmText`** — the verb. `ConfirmOptions` already refuses to
   default one, for the same reason: a confirm button reading "OK" tells the
   operator nothing about what is about to happen.

package/src/components/data-display/CardKit/card-actions-context.tsx

@@ -39,6 +39,7 @@ export function CardActionsProvider({
   errorTitle,
   errorDismissLabel,
   autoHideMs = 6_000,
+  onError,
   children,
 }: {
   tenantSlug: string;
@@ -55,14 +56,27 @@ export function CardActionsProvider({
   errorDismissLabel: string;
   /** How long the snackbar stays up. */
   autoHideMs?: number;
+  /**
+   * Hand a failure to the HOST's own toast channel instead of this provider's
+   * snackbar. Given, the provider draws nothing of its own: an app with one
+   * toast column (every toast in one place, in one look) passes its `toast`
+   * here, so a card's failure lands with every other toast rather than in a
+   * corner of its own. It receives the same heading and message the snackbar
+   * would have shown.
+   */
+  onError?: (title: string, message: string) => void;
   children: ReactNode;
 }): JSX.Element {
   const [error, setError] = useState<string | null>(null);
-  const notifyError = useCallback((message: string) => setError(message), []);
+  const notifyError = useCallback(
+    (message: string) => (onError ? onError(errorTitle, message) : setError(message)),
+    [onError, errorTitle],
+  );
 
   return (
     <CardActionsContext.Provider value={{ tenantSlug, onRefresh, notifyError }}>
       {children}
+      {onError === undefined && (
       <Snackbar
         open={error !== null}
         autoHideDuration={autoHideMs}
@@ -81,6 +95,7 @@ export function CardActionsProvider({
           />
         </span>
       </Snackbar>
+      )}
     </CardActionsContext.Provider>
   );
 }

package/dist/chunk-N7KWWIF7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/data-display/CardKit/card-actions-context.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useCallback, useContext, useState, type JSX, type ReactNode } from 'react';\n\nimport Snackbar from '@mui/material/Snackbar/index.js';\n\nimport { Alert } from '../Alert';\n\n/**\n * The ambient wiring a self-contained row/card menu needs, and nothing else.\n *\n * A menu that owns its own popups still needs three things it cannot know: the\n * tenant it is acting inside, what to do after a write lands, and somewhere to\n * put a failure. Passing those down through the grid, the layout and the card\n * is four props of drilling per entity; holding them in context is one.\n *\n * Kept deliberately SMALL — it is not an edit-dialog host. A menu that read its\n * dialogs from here would stop being portable, because the set of dialogs is\n * per-entity. What it may read is the three facts below.\n *\n * The provider renders ONE shared error snackbar, which is the whole reason the\n * error channel is here rather than per-menu: before it, every page carried its\n * own error alert and every menu had to find its page's.\n */\ninterface CardActionsValue {\n  /** The tenant every action in this subtree acts inside. */\n  tenantSlug: string;\n  /** Re-read the list after a write. */\n  onRefresh: () => void;\n  /** Surface a failed action's message (the shared snackbar). */\n  notifyError: (message: string) => void;\n}\n\nconst CardActionsContext = createContext<CardActionsValue | null>(null);\n\nexport function CardActionsProvider({\n  tenantSlug,\n  onRefresh,\n  errorTitle,\n  errorDismissLabel,\n  autoHideMs = 6_000,\n  children,\n}: {\n  tenantSlug: string;\n  onRefresh: () => void;\n  /**\n   * The snackbar's heading — required, no default.\n   *\n   * It is the one sentence this provider renders on its own, and a default\n   * would be the origin's language shipped as a finished-looking silence. The\n   * MESSAGE beside it comes from whatever failed, which is already the host's.\n   */\n  errorTitle: string;\n  /** The dismiss on that alert, which carries a glyph only. REQUIRED. */\n  errorDismissLabel: string;\n  /** How long the snackbar stays up. */\n  autoHideMs?: number;\n  children: ReactNode;\n}): JSX.Element {\n  const [error, setError] = useState<string | null>(null);\n  const notifyError = useCallback((message: string) => setError(message), []);\n\n  return (\n    <CardActionsContext.Provider value={{ tenantSlug, onRefresh, notifyError }}>\n      {children}\n      <Snackbar\n        open={error !== null}\n        autoHideDuration={autoHideMs}\n        onClose={() => setError(null)}\n        anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}\n      >\n        <span>\n          <Alert\n            variant=\"danger\"\n            title={errorTitle}\n            description={error ?? ''}\n            closable\n            closeLabel={errorDismissLabel}\n            onClose={() => setError(null)}\n            data-testid=\"card-action-error\"\n          />\n        </span>\n      </Snackbar>\n    </CardActionsContext.Provider>\n  );\n}\n\n/**\n * Read the tenant + refresh + error wiring.\n *\n * THROWS outside a provider rather than answering a null object, deliberately:\n * a menu whose `onRefresh` silently did nothing would leave the operator\n * looking at a stale row after a delete that worked, which reads as the delete\n * having failed. Failing at mount says where the provider is missing.\n */\nexport function useCardActions(): CardActionsValue {\n  const value = useContext(CardActionsContext);\n  if (!value) {\n    throw new Error('useCardActions must be used within a CardActionsProvider');\n  }\n  return value;\n}\n"],"mappings":";;;;;AAEA,SAAS,eAAe,aAAa,YAAY,gBAA0C;AAE3F,OAAO,cAAc;AA2DjB,SASM,KATN;AA9BJ,IAAM,qBAAqB,cAAuC,IAAI;AAE/D,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AACF,GAgBgB;AACd,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AACtD,QAAM,cAAc,YAAY,CAAC,YAAoB,SAAS,OAAO,GAAG,CAAC,CAAC;AAE1E,SACE,qBAAC,mBAAmB,UAAnB,EAA4B,OAAO,EAAE,YAAY,WAAW,YAAY,GACtE;AAAA;AAAA,IACD;AAAA,MAAC;AAAA;AAAA,QACC,MAAM,UAAU;AAAA,QAChB,kBAAkB;AAAA,QAClB,SAAS,MAAM,SAAS,IAAI;AAAA,QAC5B,cAAc,EAAE,UAAU,UAAU,YAAY,SAAS;AAAA,QAEzD,8BAAC,UACC;AAAA,UAAC;AAAA;AAAA,YACC,SAAQ;AAAA,YACR,OAAO;AAAA,YACP,aAAa,SAAS;AAAA,YACtB,UAAQ;AAAA,YACR,YAAY;AAAA,YACZ,SAAS,MAAM,SAAS,IAAI;AAAA,YAC5B,eAAY;AAAA;AAAA,QACd,GACF;AAAA;AAAA,IACF;AAAA,KACF;AAEJ;AAUO,SAAS,iBAAmC;AACjD,QAAM,QAAQ,WAAW,kBAAkB;AAC3C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;","names":[]}