@12-apps/ui 6.7.0 → 6.8.0

package/dist/types/pt-BR.form.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The pt-BR pack for the form family. Split out of `pt-BR.ts`, which is a
+ * barrel over this folder — see that file for why.
+ */
+import type { AddressAutocompleteCopy, AutocompleteCopy, CodeEditorCopy, PasswordStrengthCopy, PhoneInputCopy, RichEditorToolbarCopy, UploadButtonCopy } from './copy';
+export declare const PT_BR_ADDRESS_AUTOCOMPLETE_COPY: AddressAutocompleteCopy;
+export declare const PT_BR_AUTOCOMPLETE_COPY: AutocompleteCopy;
+export declare const PT_BR_CODE_EDITOR_COPY: CodeEditorCopy;
+export declare const PT_BR_PASSWORD_STRENGTH_COPY: PasswordStrengthCopy;
+export declare const PT_BR_RICH_EDITOR_TOOLBAR_COPY: RichEditorToolbarCopy;
+export declare const PT_BR_PHONE_INPUT_COPY: PhoneInputCopy;
+export declare const PT_BR_UPLOAD_BUTTON_COPY: UploadButtonCopy;
+//# sourceMappingURL=pt-BR.form.d.ts.map

package/dist/types/pt-BR.form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pt-BR.form.d.ts","sourceRoot":"","sources":["../../src/pt-BR.form.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,QAAQ,CAAC;AAEhB,eAAO,MAAM,+BAA+B,EAAE,uBAK7C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAIrC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAUpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,oBAyB1C,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,qBAY5C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAIpC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAStC,CAAC"}

package/dist/types/pt-BR.layout.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The pt-BR pack for the layout family. Split out of `pt-BR.ts`, which is a
+ * barrel over this folder — see that file for why.
+ */
+import type { TableFilterCopy } from './copy';
+export declare const PT_BR_TABLE_FILTER_COPY: TableFilterCopy;
+//# sourceMappingURL=pt-BR.layout.d.ts.map

package/dist/types/pt-BR.layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pt-BR.layout.d.ts","sourceRoot":"","sources":["../../src/pt-BR.layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,QAAQ,CAAC;AAEhB,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC"}

package/dist/types/pt-BR.navigation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The pt-BR pack for the navigation family. Split out of `pt-BR.ts`, which is a
+ * barrel over this folder — see that file for why.
+ */
+import type { BreadcrumbCopy, CommandPaletteCopy } from './copy';
+export declare const PT_BR_COMMAND_PALETTE_COPY: CommandPaletteCopy;
+export declare const PT_BR_BREADCRUMB_COPY: BreadcrumbCopy;
+//# sourceMappingURL=pt-BR.navigation.d.ts.map

package/dist/types/pt-BR.navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pt-BR.navigation.d.ts","sourceRoot":"","sources":["../../src/pt-BR.navigation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,QAAQ,CAAC;AAEhB,eAAO,MAAM,0BAA0B,EAAE,kBAMxC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAGnC,CAAC"}

package/dist/types/pt-BR.shared.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The pt-BR pack for the shared family. Split out of `pt-BR.ts`, which is a
+ * barrel over this folder — see that file for why.
+ */
+import type { SavedViewsLabels } from "./components/layout/ContentToolbar/ContentToolbar.types";
+import type { CategorySelectCopy, CepFieldCopy, ConfirmActionCopy, SectionOnboardingCopy } from './copy';
+export declare const PT_BR_SECTION_ONBOARDING_COPY: SectionOnboardingCopy;
+export declare const PT_BR_CONFIRM_ACTION_COPY: ConfirmActionCopy;
+export declare const PT_BR_CATEGORY_SELECT_COPY: CategorySelectCopy;
+export declare const PT_BR_CEP_FIELD_COPY: CepFieldCopy;
+/**
+ * The saved-views dropdown's labels.
+ *
+ * Typed as the package's OWN `SavedViewsLabels` rather than a parallel shape:
+ * that interface already named every string, including the seven with no
+ * diacritics the copy gate could not see (`Aplicar`, `Fixar na barra lateral`,
+ * `Editar`…). The prop was `Partial<SavedViewsLabels>` with a pt-BR default —
+ * configurable in the type, inherited in practice.
+ */
+export declare const PT_BR_SAVED_VIEWS_LABELS: SavedViewsLabels;
+//# sourceMappingURL=pt-BR.shared.d.ts.map

package/dist/types/pt-BR.shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pt-BR.shared.d.ts","sourceRoot":"","sources":["../../src/pt-BR.shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAChG,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,QAAQ,CAAC;AAEhB,eAAO,MAAM,6BAA6B,EAAE,qBAI3C,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,iBAKvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,kBAkCxC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAIlC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,gBAiBtC,CAAC"}

package/dist/types/pt-BR.utility.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The pt-BR pack for the utility family. Split out of `pt-BR.ts`, which is a
+ * barrel over this folder — see that file for why.
+ */
+import type { InstallPromptCopy, UserAvatarCopy } from './copy';
+export declare const PT_BR_INSTALL_PROMPT_COPY: InstallPromptCopy;
+export declare const PT_BR_USER_AVATAR_COPY: UserAvatarCopy;
+//# sourceMappingURL=pt-BR.utility.d.ts.map

package/dist/types/pt-BR.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pt-BR.utility.d.ts","sourceRoot":"","sources":["../../src/pt-BR.utility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACf,MAAM,QAAQ,CAAC;AAEhB,eAAO,MAAM,yBAAyB,EAAE,iBAOvC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAEpC,CAAC"}

package/dist/types/user-avatar/user-avatar.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { UserAvatarCopy } from '../copy';
 export interface UserAvatarProps {
     src?: string | null;
     name?: string | null;
@@ -17,9 +18,14 @@ export interface UserMenuProps {
         image?: string | null;
     };
     onSignOut: () => void;
+    /**
+     * The card's one action. REQUIRED: this package ships no default copy, and
+     * the button is the only thing on this card a host does not already supply.
+     */
+    copy: UserAvatarCopy;
 }
 /**
  * User menu with avatar, info, and sign out button
  */
-export declare function UserMenu({ user, onSignOut }: UserMenuProps): React.ReactElement;
+export declare function UserMenu({ user, onSignOut, copy }: UserMenuProps): React.ReactElement;
 //# sourceMappingURL=user-avatar.d.ts.map

package/dist/types/user-avatar/user-avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-avatar.d.ts","sourceRoot":"","sources":["../../../src/user-avatar/user-avatar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAoB/B,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EACzB,GAAG,EACH,IAAI,EACJ,IAAW,EACX,OAAO,EACP,WAAmB,GACpB,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CActC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAkC/E"}
+{"version":3,"file":"user-avatar.d.ts","sourceRoot":"","sources":["../../../src/user-avatar/user-avatar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAe9C,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EACzB,GAAG,EACH,IAAI,EACJ,IAAW,EACX,OAAO,EACP,WAAmB,GACpB,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CActC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAkCrF"}

package/dist/user-avatar.js

@@ -45,7 +45,7 @@ function UserAvatar({
     }
   );
 }
-function UserMenu({ user, onSignOut }) {
+function UserMenu({ user, onSignOut, copy }) {
   return /* @__PURE__ */ jsx(Card, { variant: "elevated", borderRadius: "md", children: /* @__PURE__ */ jsx(Box, { sx: { p: 2 }, children: /* @__PURE__ */ jsxs(Stack, { direction: "row", spacing: 2, alignItems: "center", children: [
     /* @__PURE__ */ jsx(
       UserAvatar,
@@ -66,7 +66,7 @@ function UserMenu({ user, onSignOut }) {
         color: "danger",
         size: "sm",
         onClick: onSignOut,
-        children: "Sign out"
+        children: copy.signOut
       }
     )
   ] }) }) });

package/dist/user-avatar.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/user-avatar/user-avatar.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from 'react';\nimport { Box, Stack } from '@mui/material';\nimport { Avatar } from '../components/data-display/Avatar';\nimport { Button } from '../components/form/Button';\nimport { Text } from '../components/typography/Text';\nimport { Card } from '../components/layout/Card';\n\n/**\n * Generate initials from a name\n */\nfunction getInitials(name: string): string {\n  const parts = name.trim().split(/\\s+/);\n  if (parts.length === 1) {\n    return parts[0]?.substring(0, 2).toUpperCase() ?? \"\";\n  }\n  return (\n    (parts[0]?.charAt(0) ?? \"\") + (parts[parts.length - 1]?.charAt(0) ?? \"\")\n  ).toUpperCase();\n}\n\nexport interface UserAvatarProps {\n  src?: string | null;\n  name?: string | null;\n  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';\n  onClick?: () => void;\n  interactive?: boolean;\n}\n\n/**\n * User avatar using UI package Avatar component\n */\nexport function UserAvatar({\n  src,\n  name,\n  size = 'md',\n  onClick,\n  interactive = false,\n}: UserAvatarProps): React.ReactElement {\n  const fallbackText = name ? getInitials(name) : \"?\";\n\n  return (\n    <Avatar\n      src={src ?? undefined}\n      alt={name ?? \"User avatar\"}\n      fallback={fallbackText}\n      size={size}\n      variant=\"circle\"\n      interactive={interactive || !!onClick}\n      onClick={onClick}\n    />\n  );\n}\n\nexport interface UserMenuProps {\n  user: {\n    name?: string | null;\n    email?: string | null;\n    image?: string | null;\n  };\n  onSignOut: () => void;\n}\n\n/**\n * User menu with avatar, info, and sign out button\n */\nexport function UserMenu({ user, onSignOut }: UserMenuProps): React.ReactElement {\n  return (\n    <Card variant=\"elevated\" borderRadius=\"md\">\n      <Box sx={{ p: 2 }}>\n        <Stack direction=\"row\" spacing={2} alignItems=\"center\">\n          <UserAvatar\n            src={user.image}\n            name={user.name}\n            size=\"md\"\n          />\n\n          <Stack spacing={0.5} sx={{ flex: 1, minWidth: 0 }}>\n            <Text weight=\"semibold\" size=\"sm\">\n              {user.name ?? \"User\"}\n            </Text>\n            {user.email && (\n              <Text color=\"secondary\" size=\"xs\">\n                {user.email}\n              </Text>\n            )}\n          </Stack>\n\n          <Button\n            variant=\"outline\"\n            color=\"danger\"\n            size=\"sm\"\n            onClick={onSignOut}\n          >\n            Sign out\n          </Button>\n        </Stack>\n      </Box>\n    </Card>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAGA,SAAS,KAAK,aAAa;AAwCvB,cAmCM,YAnCN;AA/BJ,SAAS,YAAY,MAAsB;AACzC,QAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK;AACrC,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO,MAAM,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,YAAY,KAAK;AAAA,EACpD;AACA,WACG,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,OAAO,MAAM,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK,KACrE,YAAY;AAChB;AAaO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA,cAAc;AAChB,GAAwC;AACtC,QAAM,eAAe,OAAO,YAAY,IAAI,IAAI;AAEhD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,OAAO;AAAA,MACZ,KAAK,QAAQ;AAAA,MACb,UAAU;AAAA,MACV;AAAA,MACA,SAAQ;AAAA,MACR,aAAa,eAAe,CAAC,CAAC;AAAA,MAC9B;AAAA;AAAA,EACF;AAEJ;AAcO,SAAS,SAAS,EAAE,MAAM,UAAU,GAAsC;AAC/E,SACE,oBAAC,QAAK,SAAQ,YAAW,cAAa,MACpC,8BAAC,OAAI,IAAI,EAAE,GAAG,EAAE,GACd,+BAAC,SAAM,WAAU,OAAM,SAAS,GAAG,YAAW,UAC5C;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,KAAK,KAAK;AAAA,QACV,MAAM,KAAK;AAAA,QACX,MAAK;AAAA;AAAA,IACP;AAAA,IAEA,qBAAC,SAAM,SAAS,KAAK,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,GAC9C;AAAA,0BAAC,QAAK,QAAO,YAAW,MAAK,MAC1B,eAAK,QAAQ,QAChB;AAAA,MACC,KAAK,SACJ,oBAAC,QAAK,OAAM,aAAY,MAAK,MAC1B,eAAK,OACR;AAAA,OAEJ;AAAA,IAEA;AAAA,MAAC;AAAA;AAAA,QACC,SAAQ;AAAA,QACR,OAAM;AAAA,QACN,MAAK;AAAA,QACL,SAAS;AAAA,QACV;AAAA;AAAA,IAED;AAAA,KACF,GACF,GACF;AAEJ;","names":[]}
+{"version":3,"sources":["../src/user-avatar/user-avatar.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from 'react';\nimport { Box, Stack } from '@mui/material';\nimport { Avatar } from '../components/data-display/Avatar';\nimport { Button } from '../components/form/Button';\nimport { Text } from '../components/typography/Text';\nimport { Card } from '../components/layout/Card';\nimport type { UserAvatarCopy } from '../copy';\n\n/**\n * Generate initials from a name\n */\nfunction getInitials(name: string): string {\n  const parts = name.trim().split(/\\s+/);\n  if (parts.length === 1) {\n    return parts[0]?.substring(0, 2).toUpperCase() ?? \"\";\n  }\n  return (\n    (parts[0]?.charAt(0) ?? \"\") + (parts[parts.length - 1]?.charAt(0) ?? \"\")\n  ).toUpperCase();\n}\n\nexport interface UserAvatarProps {\n  src?: string | null;\n  name?: string | null;\n  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';\n  onClick?: () => void;\n  interactive?: boolean;\n}\n\n/**\n * User avatar using UI package Avatar component\n */\nexport function UserAvatar({\n  src,\n  name,\n  size = 'md',\n  onClick,\n  interactive = false,\n}: UserAvatarProps): React.ReactElement {\n  const fallbackText = name ? getInitials(name) : \"?\";\n\n  return (\n    <Avatar\n      src={src ?? undefined}\n      alt={name ?? \"User avatar\"}\n      fallback={fallbackText}\n      size={size}\n      variant=\"circle\"\n      interactive={interactive || !!onClick}\n      onClick={onClick}\n    />\n  );\n}\n\nexport interface UserMenuProps {\n  user: {\n    name?: string | null;\n    email?: string | null;\n    image?: string | null;\n  };\n  onSignOut: () => void;\n  /**\n   * The card's one action. REQUIRED: this package ships no default copy, and\n   * the button is the only thing on this card a host does not already supply.\n   */\n  copy: UserAvatarCopy;\n}\n\n/**\n * User menu with avatar, info, and sign out button\n */\nexport function UserMenu({ user, onSignOut, copy }: UserMenuProps): React.ReactElement {\n  return (\n    <Card variant=\"elevated\" borderRadius=\"md\">\n      <Box sx={{ p: 2 }}>\n        <Stack direction=\"row\" spacing={2} alignItems=\"center\">\n          <UserAvatar\n            src={user.image}\n            name={user.name}\n            size=\"md\"\n          />\n\n          <Stack spacing={0.5} sx={{ flex: 1, minWidth: 0 }}>\n            <Text weight=\"semibold\" size=\"sm\">\n              {user.name ?? \"User\"}\n            </Text>\n            {user.email && (\n              <Text color=\"secondary\" size=\"xs\">\n                {user.email}\n              </Text>\n            )}\n          </Stack>\n\n          <Button\n            variant=\"outline\"\n            color=\"danger\"\n            size=\"sm\"\n            onClick={onSignOut}\n          >\n            {copy.signOut}\n          </Button>\n        </Stack>\n      </Box>\n    </Card>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAGA,SAAS,KAAK,aAAa;AAyCvB,cAwCM,YAxCN;AA/BJ,SAAS,YAAY,MAAsB;AACzC,QAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK;AACrC,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO,MAAM,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,YAAY,KAAK;AAAA,EACpD;AACA,WACG,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,OAAO,MAAM,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK,KACrE,YAAY;AAChB;AAaO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA,cAAc;AAChB,GAAwC;AACtC,QAAM,eAAe,OAAO,YAAY,IAAI,IAAI;AAEhD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,OAAO;AAAA,MACZ,KAAK,QAAQ;AAAA,MACb,UAAU;AAAA,MACV;AAAA,MACA,SAAQ;AAAA,MACR,aAAa,eAAe,CAAC,CAAC;AAAA,MAC9B;AAAA;AAAA,EACF;AAEJ;AAmBO,SAAS,SAAS,EAAE,MAAM,WAAW,KAAK,GAAsC;AACrF,SACE,oBAAC,QAAK,SAAQ,YAAW,cAAa,MACpC,8BAAC,OAAI,IAAI,EAAE,GAAG,EAAE,GACd,+BAAC,SAAM,WAAU,OAAM,SAAS,GAAG,YAAW,UAC5C;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,KAAK,KAAK;AAAA,QACV,MAAM,KAAK;AAAA,QACX,MAAK;AAAA;AAAA,IACP;AAAA,IAEA,qBAAC,SAAM,SAAS,KAAK,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,GAC9C;AAAA,0BAAC,QAAK,QAAO,YAAW,MAAK,MAC1B,eAAK,QAAQ,QAChB;AAAA,MACC,KAAK,SACJ,oBAAC,QAAK,OAAM,aAAY,MAAK,MAC1B,eAAK,OACR;AAAA,OAEJ;AAAA,IAEA;AAAA,MAAC;AAAA;AAAA,QACC,SAAQ;AAAA,QACR,OAAM;AAAA,QACN,MAAK;AAAA,QACL,SAAS;AAAA,QAER,eAAK;AAAA;AAAA,IACR;AAAA,KACF,GACF,GACF;AAEJ;","names":[]}

package/dist/utility/InfiniteScroll.js

@@ -85,11 +85,11 @@ var CENTERED = {
   alignItems: "center",
   p: 2
 };
-var DefaultLoader = () => /* @__PURE__ */ jsxs(Box, { sx: CENTERED, children: [
+var DefaultLoader = ({ loadingText }) => /* @__PURE__ */ jsxs(Box, { sx: CENTERED, children: [
   /* @__PURE__ */ jsx(CircularProgress, { size: 24 }),
-  /* @__PURE__ */ jsx(Typography, { variant: "body2", sx: { ml: 1 }, children: "Loading..." })
+  /* @__PURE__ */ jsx(Typography, { variant: "body2", sx: { ml: 1 }, children: loadingText })
 ] });
-var DefaultEndMessage = () => /* @__PURE__ */ jsx(Box, { sx: CENTERED, children: /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "text.secondary", children: "No more items to load" }) });
+var DefaultEndMessage = ({ endText }) => /* @__PURE__ */ jsx(Box, { sx: CENTERED, children: /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "text.secondary", children: endText }) });
 var DefaultError = ({ error }) => /* @__PURE__ */ jsx(Alert, { severity: "error", sx: { m: 2 }, children: error.message || "An error occurred while loading more items" });
 var containerStyles = (variant, width) => {
   const horizontal = variant === "horizontal";
@@ -114,6 +114,8 @@ var InfiniteScroll = ({
   threshold = 150,
   loadMore,
   loader,
+  loadingText,
+  endText,
   endMessage,
   error,
   errorComponent,
@@ -137,9 +139,9 @@ var InfiniteScroll = ({
     testTriggerRef
   });
   const renderSentinel = () => {
-    if (!hasMore) return endMessage || /* @__PURE__ */ jsx2(DefaultEndMessage, {});
+    if (!hasMore) return endMessage || /* @__PURE__ */ jsx2(DefaultEndMessage, { endText });
     if (error) return errorComponent || /* @__PURE__ */ jsx2(DefaultError, { error });
-    if (loading) return loader || /* @__PURE__ */ jsx2(DefaultLoader, {});
+    if (loading) return loader || /* @__PURE__ */ jsx2(DefaultLoader, { loadingText });
     return /* @__PURE__ */ jsx2(
       "div",
       {

package/dist/utility/InfiniteScroll.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/utility/InfiniteScroll/InfiniteScroll.tsx","../../src/components/utility/InfiniteScroll/InfiniteScroll.hooks.ts","../../src/components/utility/InfiniteScroll/InfiniteScroll.parts.tsx"],"sourcesContent":["import { Box } from '@mui/material';\nimport React from 'react';\n\nimport { useLoadMore, useSentinel } from './InfiniteScroll.hooks';\nimport {\n  containerStyles,\n  DefaultEndMessage,\n  DefaultError,\n  DefaultLoader,\n} from './InfiniteScroll.parts';\nimport type { InfiniteScrollProps } from './InfiniteScroll.types';\n\nexport const InfiniteScroll: React.FC<InfiniteScrollProps> = ({\n  children,\n  variant = 'default',\n  hasMore,\n  loading,\n  threshold = 150,\n  loadMore,\n  loader,\n  endMessage,\n  error,\n  errorComponent,\n  onError,\n  className,\n  style,\n  width,\n  scrollableTarget,\n  testMode = false,\n  testTriggerRef,\n}) => {\n  const { sentinelRef, isIntersecting } = useSentinel({ testMode, threshold, scrollableTarget });\n\n  useLoadMore({\n    hasMore,\n    loading,\n    error,\n    loadMore,\n    onError,\n    isIntersecting,\n    testMode,\n    testTriggerRef,\n  });\n\n  // The tail of the list is one of four things: the end message, an error, a\n  // spinner, or the sentinel that asks for the next page.\n  const renderSentinel = () => {\n    if (!hasMore) return endMessage || <DefaultEndMessage />;\n    if (error) return errorComponent || <DefaultError error={error} />;\n    if (loading) return loader || <DefaultLoader />;\n\n    return (\n      <div\n        ref={sentinelRef}\n        data-testid=\"infinite-scroll-sentinel\"\n        style={{\n          height: variant === 'horizontal' ? '100%' : '1px',\n          width: variant === 'horizontal' ? '1px' : '100%',\n        }}\n      />\n    );\n  };\n\n  return (\n    <Box\n      className={className}\n      sx={{\n        ...containerStyles(variant, width),\n        ...style,\n      }}\n    >\n      {variant === 'reverse' && renderSentinel()}\n\n      {variant === 'horizontal' ? (\n        <Box sx={{ display: 'flex', flexDirection: 'row' }}>{children}</Box>\n      ) : (\n        children\n      )}\n\n      {variant !== 'reverse' && renderSentinel()}\n\n      {variant === 'horizontal' && renderSentinel()}\n    </Box>\n  );\n};\n","import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport type { InfiniteScrollProps } from './InfiniteScroll.types';\n\ntype ScrollableTarget = InfiniteScrollProps['scrollableTarget'];\n\n/** A string target is looked up by id first, then as a selector. */\nconst resolveScrollable = (scrollableTarget: ScrollableTarget): Element | null => {\n  if (!scrollableTarget) return null;\n\n  if (typeof scrollableTarget === 'string') {\n    return (\n      document.getElementById(scrollableTarget) || document.querySelector(scrollableTarget)\n    );\n  }\n\n  return scrollableTarget;\n};\n\ninterface ObserverArgs {\n  testMode: boolean;\n  threshold: number;\n  scrollableTarget: ScrollableTarget;\n}\n\n/**\n * Watches a zero-size sentinel at the end of the list. `rootMargin` is what makes\n * it fire before the sentinel is actually on screen, so the next page is already\n * loading by the time the user reaches the bottom.\n */\nexport const useSentinel = ({ testMode, threshold, scrollableTarget }: ObserverArgs) => {\n  const sentinelRef = useRef<HTMLDivElement>(null);\n  const [isIntersecting, setIsIntersecting] = useState(false);\n\n  useEffect(() => {\n    if (testMode || !sentinelRef.current) return;\n\n    const observer = new window.IntersectionObserver(\n      ([entry]) => {\n        if (entry) {\n          setIsIntersecting(entry.isIntersecting);\n        }\n      },\n      {\n        root: resolveScrollable(scrollableTarget) || undefined,\n        rootMargin: `${threshold}px`,\n        threshold: 0,\n      },\n    );\n\n    observer.observe(sentinelRef.current);\n\n    return () => observer.disconnect();\n  }, [testMode, threshold, scrollableTarget]);\n\n  return { sentinelRef, isIntersecting };\n};\n\ntype LoadArgs = Pick<\n  InfiniteScrollProps,\n  'hasMore' | 'loading' | 'error' | 'loadMore' | 'onError' | 'testTriggerRef'\n> & {\n  isIntersecting: boolean;\n  testMode: boolean;\n};\n\n/**\n * A ref rather than state guards re-entry, so a second intersection landing while\n * the first `loadMore` is still in flight is dropped rather than queued.\n */\nexport const useLoadMore = ({\n  hasMore,\n  loading,\n  error,\n  loadMore,\n  onError,\n  isIntersecting,\n  testMode,\n  testTriggerRef,\n}: LoadArgs) => {\n  const loadingRef = useRef(false);\n\n  const handleLoadMore = useCallback(async () => {\n    if (loadingRef.current || !hasMore || error) {\n      return;\n    }\n\n    loadingRef.current = true;\n\n    try {\n      await loadMore();\n    } catch (err) {\n      const errorObj = err instanceof Error ? err : new Error('Unknown error');\n      onError?.(errorObj);\n    } finally {\n      loadingRef.current = false;\n    }\n  }, [hasMore, error, loadMore, onError]);\n\n  // Expose test trigger for test mode\n  useEffect(() => {\n    if (testMode && testTriggerRef) {\n      testTriggerRef.current = handleLoadMore;\n    }\n\n    return () => {\n      if (testMode && testTriggerRef) {\n        testTriggerRef.current = undefined;\n      }\n    };\n  }, [testMode, testTriggerRef, handleLoadMore]);\n\n  useEffect(() => {\n    if (isIntersecting && hasMore && !loading && !error) {\n      handleLoadMore();\n    }\n  }, [isIntersecting, hasMore, loading, error, handleLoadMore]);\n};\n","import { Alert, Box, CircularProgress, Typography } from '@mui/material';\nimport React from 'react';\n\nimport type { InfiniteScrollProps } from './InfiniteScroll.types';\n\ntype Variant = NonNullable<InfiniteScrollProps['variant']>;\n\nconst CENTERED = {\n  display: 'flex',\n  justifyContent: 'center',\n  alignItems: 'center',\n  p: 2,\n} as const;\n\nexport const DefaultLoader: React.FC = () => (\n  <Box sx={CENTERED}>\n    <CircularProgress size={24} />\n    <Typography variant=\"body2\" sx={{ ml: 1 }}>\n      Loading...\n    </Typography>\n  </Box>\n);\n\nexport const DefaultEndMessage: React.FC = () => (\n  <Box sx={CENTERED}>\n    <Typography variant=\"body2\" color=\"text.secondary\">\n      No more items to load\n    </Typography>\n  </Box>\n);\n\nexport const DefaultError: React.FC<{ error: Error }> = ({ error }) => (\n  <Alert severity=\"error\" sx={{ m: 2 }}>\n    {error.message || 'An error occurred while loading more items'}\n  </Alert>\n);\n\n/**\n * `horizontal` scrolls along a row; `reverse` stacks bottom-up, for a chat log\n * that loads older messages as you scroll away from the newest.\n */\nexport const containerStyles = (variant: Variant, width?: number | string) => {\n  const horizontal = variant === 'horizontal';\n  const base = {\n    width: horizontal ? width || '100%' : '100%',\n    height: horizontal ? '100%' : 'auto',\n    overflowX: horizontal ? 'auto' : 'hidden',\n    overflowY: horizontal ? 'hidden' : 'visible',\n    display: 'flex',\n    flexDirection: horizontal ? 'row' : 'column',\n  };\n\n  return variant === 'reverse' ? { ...base, flexDirection: 'column-reverse' } : base;\n};\n"],"mappings":"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","names":["Box","jsx","jsxs","Box"]}
+{"version":3,"sources":["../../src/components/utility/InfiniteScroll/InfiniteScroll.tsx","../../src/components/utility/InfiniteScroll/InfiniteScroll.hooks.ts","../../src/components/utility/InfiniteScroll/InfiniteScroll.parts.tsx"],"sourcesContent":["import { Box } from '@mui/material';\nimport React from 'react';\n\nimport { useLoadMore, useSentinel } from './InfiniteScroll.hooks';\nimport {\n  containerStyles,\n  DefaultEndMessage,\n  DefaultError,\n  DefaultLoader,\n} from './InfiniteScroll.parts';\nimport type { InfiniteScrollProps } from './InfiniteScroll.types';\n\nexport const InfiniteScroll: React.FC<InfiniteScrollProps> = ({\n  children,\n  variant = 'default',\n  hasMore,\n  loading,\n  threshold = 150,\n  loadMore,\n  loader,\n  loadingText,\n  endText,\n  endMessage,\n  error,\n  errorComponent,\n  onError,\n  className,\n  style,\n  width,\n  scrollableTarget,\n  testMode = false,\n  testTriggerRef,\n}) => {\n  const { sentinelRef, isIntersecting } = useSentinel({ testMode, threshold, scrollableTarget });\n\n  useLoadMore({\n    hasMore,\n    loading,\n    error,\n    loadMore,\n    onError,\n    isIntersecting,\n    testMode,\n    testTriggerRef,\n  });\n\n  // The tail of the list is one of four things: the end message, an error, a\n  // spinner, or the sentinel that asks for the next page.\n  const renderSentinel = () => {\n    if (!hasMore) return endMessage || <DefaultEndMessage endText={endText} />;\n    if (error) return errorComponent || <DefaultError error={error} />;\n    if (loading) return loader || <DefaultLoader loadingText={loadingText} />;\n\n    return (\n      <div\n        ref={sentinelRef}\n        data-testid=\"infinite-scroll-sentinel\"\n        style={{\n          height: variant === 'horizontal' ? '100%' : '1px',\n          width: variant === 'horizontal' ? '1px' : '100%',\n        }}\n      />\n    );\n  };\n\n  return (\n    <Box\n      className={className}\n      sx={{\n        ...containerStyles(variant, width),\n        ...style,\n      }}\n    >\n      {variant === 'reverse' && renderSentinel()}\n\n      {variant === 'horizontal' ? (\n        <Box sx={{ display: 'flex', flexDirection: 'row' }}>{children}</Box>\n      ) : (\n        children\n      )}\n\n      {variant !== 'reverse' && renderSentinel()}\n\n      {variant === 'horizontal' && renderSentinel()}\n    </Box>\n  );\n};\n","import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport type { InfiniteScrollProps } from './InfiniteScroll.types';\n\ntype ScrollableTarget = InfiniteScrollProps['scrollableTarget'];\n\n/** A string target is looked up by id first, then as a selector. */\nconst resolveScrollable = (scrollableTarget: ScrollableTarget): Element | null => {\n  if (!scrollableTarget) return null;\n\n  if (typeof scrollableTarget === 'string') {\n    return (\n      document.getElementById(scrollableTarget) || document.querySelector(scrollableTarget)\n    );\n  }\n\n  return scrollableTarget;\n};\n\ninterface ObserverArgs {\n  testMode: boolean;\n  threshold: number;\n  scrollableTarget: ScrollableTarget;\n}\n\n/**\n * Watches a zero-size sentinel at the end of the list. `rootMargin` is what makes\n * it fire before the sentinel is actually on screen, so the next page is already\n * loading by the time the user reaches the bottom.\n */\nexport const useSentinel = ({ testMode, threshold, scrollableTarget }: ObserverArgs) => {\n  const sentinelRef = useRef<HTMLDivElement>(null);\n  const [isIntersecting, setIsIntersecting] = useState(false);\n\n  useEffect(() => {\n    if (testMode || !sentinelRef.current) return;\n\n    const observer = new window.IntersectionObserver(\n      ([entry]) => {\n        if (entry) {\n          setIsIntersecting(entry.isIntersecting);\n        }\n      },\n      {\n        root: resolveScrollable(scrollableTarget) || undefined,\n        rootMargin: `${threshold}px`,\n        threshold: 0,\n      },\n    );\n\n    observer.observe(sentinelRef.current);\n\n    return () => observer.disconnect();\n  }, [testMode, threshold, scrollableTarget]);\n\n  return { sentinelRef, isIntersecting };\n};\n\ntype LoadArgs = Pick<\n  InfiniteScrollProps,\n  'hasMore' | 'loading' | 'error' | 'loadMore' | 'onError' | 'testTriggerRef'\n> & {\n  isIntersecting: boolean;\n  testMode: boolean;\n};\n\n/**\n * A ref rather than state guards re-entry, so a second intersection landing while\n * the first `loadMore` is still in flight is dropped rather than queued.\n */\nexport const useLoadMore = ({\n  hasMore,\n  loading,\n  error,\n  loadMore,\n  onError,\n  isIntersecting,\n  testMode,\n  testTriggerRef,\n}: LoadArgs) => {\n  const loadingRef = useRef(false);\n\n  const handleLoadMore = useCallback(async () => {\n    if (loadingRef.current || !hasMore || error) {\n      return;\n    }\n\n    loadingRef.current = true;\n\n    try {\n      await loadMore();\n    } catch (err) {\n      const errorObj = err instanceof Error ? err : new Error('Unknown error');\n      onError?.(errorObj);\n    } finally {\n      loadingRef.current = false;\n    }\n  }, [hasMore, error, loadMore, onError]);\n\n  // Expose test trigger for test mode\n  useEffect(() => {\n    if (testMode && testTriggerRef) {\n      testTriggerRef.current = handleLoadMore;\n    }\n\n    return () => {\n      if (testMode && testTriggerRef) {\n        testTriggerRef.current = undefined;\n      }\n    };\n  }, [testMode, testTriggerRef, handleLoadMore]);\n\n  useEffect(() => {\n    if (isIntersecting && hasMore && !loading && !error) {\n      handleLoadMore();\n    }\n  }, [isIntersecting, hasMore, loading, error, handleLoadMore]);\n};\n","import { Alert, Box, CircularProgress, Typography } from '@mui/material';\nimport React from 'react';\n\nimport type { InfiniteScrollProps } from './InfiniteScroll.types';\n\ntype Variant = NonNullable<InfiniteScrollProps['variant']>;\n\nconst CENTERED = {\n  display: 'flex',\n  justifyContent: 'center',\n  alignItems: 'center',\n  p: 2,\n} as const;\n\nexport const DefaultLoader: React.FC<{ loadingText: string }> = ({ loadingText }) => (\n  <Box sx={CENTERED}>\n    <CircularProgress size={24} />\n    <Typography variant=\"body2\" sx={{ ml: 1 }}>\n      {loadingText}\n    </Typography>\n  </Box>\n);\n\nexport const DefaultEndMessage: React.FC<{ endText: string }> = ({ endText }) => (\n  <Box sx={CENTERED}>\n    <Typography variant=\"body2\" color=\"text.secondary\">\n      {endText}\n    </Typography>\n  </Box>\n);\n\nexport const DefaultError: React.FC<{ error: Error }> = ({ error }) => (\n  <Alert severity=\"error\" sx={{ m: 2 }}>\n    {error.message || 'An error occurred while loading more items'}\n  </Alert>\n);\n\n/**\n * `horizontal` scrolls along a row; `reverse` stacks bottom-up, for a chat log\n * that loads older messages as you scroll away from the newest.\n */\nexport const containerStyles = (variant: Variant, width?: number | string) => {\n  const horizontal = variant === 'horizontal';\n  const base = {\n    width: horizontal ? width || '100%' : '100%',\n    height: horizontal ? '100%' : 'auto',\n    overflowX: horizontal ? 'auto' : 'hidden',\n    overflowY: horizontal ? 'hidden' : 'visible',\n    display: 'flex',\n    flexDirection: horizontal ? 'row' : 'column',\n  };\n\n  return variant === 'reverse' ? { ...base, flexDirection: 'column-reverse' } : base;\n};\n"],"mappings":"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","names":["Box","jsx","jsxs","Box"]}

package/dist/utility/InstallPrompt.js

@@ -250,7 +250,7 @@ var usePwaInstall = (options = {}) => {
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var StyledInstallPrompt = styled(Box)(({ theme }) => installPromptStyles(theme));
 var testIdFor = (base, suffix) => base ? `${base}-${suffix}` : `install-prompt-${suffix}`;
-var IosInstructions = ({ instructions, dataTestId }) => /* @__PURE__ */ jsx(
+var IosInstructions = ({ copy, instructions, dataTestId }) => /* @__PURE__ */ jsx(
   Typography,
   {
     className: "install-prompt-description",
@@ -259,13 +259,15 @@ var IosInstructions = ({ instructions, dataTestId }) => /* @__PURE__ */ jsx(
     "data-testid": testIdFor(dataTestId, "ios-instructions"),
     sx: { display: "flex", alignItems: "center", gap: 0.5, flexWrap: "wrap" },
     children: instructions ?? /* @__PURE__ */ jsxs(Fragment, { children: [
-      "Tap ",
-      /* @__PURE__ */ jsx(IosShare, { fontSize: "small", "aria-label": "Share" }),
-      ' then "Add to Home Screen"'
+      copy.iosTapBefore,
+      " ",
+      /* @__PURE__ */ jsx(IosShare, { fontSize: "small", "aria-label": copy.shareLabel }),
+      " ",
+      copy.iosTapAfter
     ] })
   }
 );
-var InstallPromptBody = ({ icon, title, description, iosInstructions, platform, dataTestId }) => /* @__PURE__ */ jsxs(Fragment, { children: [
+var InstallPromptBody = ({ copy, icon, title, description, iosInstructions, platform, dataTestId }) => /* @__PURE__ */ jsxs(Fragment, { children: [
   /* @__PURE__ */ jsx(Box, { className: "install-prompt-icon", "aria-hidden": "true", children: icon ?? /* @__PURE__ */ jsx(InstallMobile, {}) }),
   /* @__PURE__ */ jsxs(Box, { className: "install-prompt-content", children: [
     /* @__PURE__ */ jsx(
@@ -288,7 +290,7 @@ var InstallPromptBody = ({ icon, title, description, iosInstructions, platform,
         children: description
       }
     ),
-    platform === "ios" && /* @__PURE__ */ jsx(IosInstructions, { instructions: iosInstructions, dataTestId })
+    platform === "ios" && /* @__PURE__ */ jsx(IosInstructions, { copy, instructions: iosInstructions, dataTestId })
   ] })
 ] });
 var InstallPromptActions = ({ platform, installLabel, dismissLabel, onInstallClick, onDismissClick, dataTestId }) => /* @__PURE__ */ jsxs(Box, { className: "install-prompt-actions", children: [
@@ -315,11 +317,9 @@ var InstallPromptActions = ({ platform, installLabel, dismissLabel, onInstallCli
 ] });
 var InstallPrompt = React.forwardRef(
   ({
-    title = "Install this app",
+    copy,
     description,
-    installLabel = "Install",
     iosInstructions,
-    dismissLabel = "Dismiss install prompt",
     icon,
     onInstall,
     onDismiss,
@@ -349,7 +349,7 @@ var InstallPrompt = React.forwardRef(
         ref,
         className,
         role: "region",
-        "aria-label": title,
+        "aria-label": copy.title,
         "data-testid": dataTestId,
         ...props,
         children: [
@@ -357,7 +357,8 @@ var InstallPrompt = React.forwardRef(
             InstallPromptBody,
             {
               icon,
-              title,
+              copy,
+              title: copy.title,
               description,
               iosInstructions,
               platform,
@@ -368,8 +369,8 @@ var InstallPrompt = React.forwardRef(
             InstallPromptActions,
             {
               platform,
-              installLabel,
-              dismissLabel,
+              installLabel: copy.installLabel,
+              dismissLabel: copy.dismissLabel,
               onInstallClick: handleInstall,
               onDismissClick: handleDismiss,
               dataTestId

package/dist/utility/InstallPrompt.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/utility/InstallPrompt/InstallPrompt.tsx","../../src/components/utility/InstallPrompt/InstallPrompt.styles.ts","../../src/components/utility/InstallPrompt/usePwaInstall.ts","../../src/components/utility/InstallPrompt/InstallPrompt.earlyCapture.ts","../../src/components/utility/InstallPrompt/InstallPrompt.helpers.ts"],"sourcesContent":["import Close from '@mui/icons-material/Close';\nimport InstallMobile from '@mui/icons-material/InstallMobile';\nimport IosShare from '@mui/icons-material/IosShare';\nimport { Box, Button, IconButton, Typography } from '@mui/material';\nimport { styled } from '@mui/material';\nimport React from 'react';\n\nimport { installPromptStyles } from './InstallPrompt.styles';\nimport type { InstallPlatform, InstallPromptProps } from './InstallPrompt.types';\nimport { usePwaInstall } from './usePwaInstall';\n\nconst StyledInstallPrompt = styled(Box)(({ theme }) => installPromptStyles(theme));\n\nconst testIdFor = (base: string | undefined, suffix: string) =>\n  base ? `${base}-${suffix}` : `install-prompt-${suffix}`;\n\n/**\n * The iOS branch renders instructions rather than a button, because Safari\n * exposes no API to open its own Add to Home Screen sheet. A button here would\n * be a control that does nothing when pressed.\n */\nconst IosInstructions: React.FC<{\n  instructions?: React.ReactNode;\n  dataTestId?: string;\n}> = ({ instructions, dataTestId }) => (\n  <Typography\n    className=\"install-prompt-description\"\n    variant=\"body2\"\n    component=\"div\"\n    data-testid={testIdFor(dataTestId, 'ios-instructions')}\n    sx={{ display: 'flex', alignItems: 'center', gap: 0.5, flexWrap: 'wrap' }}\n  >\n    {instructions ?? (\n      <>\n        Tap <IosShare fontSize=\"small\" aria-label=\"Share\" /> then &quot;Add to Home Screen&quot;\n      </>\n    )}\n  </Typography>\n);\n\nconst InstallPromptBody: React.FC<{\n  icon?: React.ReactNode;\n  title: string;\n  description?: string;\n  iosInstructions?: React.ReactNode;\n  platform: InstallPlatform;\n  dataTestId?: string;\n}> = ({ icon, title, description, iosInstructions, platform, dataTestId }) => (\n  <>\n    <Box className=\"install-prompt-icon\" aria-hidden=\"true\">\n      {icon ?? <InstallMobile />}\n    </Box>\n\n    <Box className=\"install-prompt-content\">\n      <Typography\n        className=\"install-prompt-title\"\n        variant=\"subtitle2\"\n        component=\"div\"\n        data-testid={testIdFor(dataTestId, 'title')}\n      >\n        {title}\n      </Typography>\n\n      {description && (\n        <Typography\n          className=\"install-prompt-description\"\n          variant=\"body2\"\n          component=\"div\"\n          data-testid={testIdFor(dataTestId, 'description')}\n        >\n          {description}\n        </Typography>\n      )}\n\n      {platform === 'ios' && (\n        <IosInstructions instructions={iosInstructions} dataTestId={dataTestId} />\n      )}\n    </Box>\n  </>\n);\n\nconst InstallPromptActions: React.FC<{\n  platform: InstallPlatform;\n  installLabel: string;\n  dismissLabel: string;\n  onInstallClick: () => void;\n  onDismissClick: () => void;\n  dataTestId?: string;\n}> = ({ platform, installLabel, dismissLabel, onInstallClick, onDismissClick, dataTestId }) => (\n  <Box className=\"install-prompt-actions\">\n    {platform === 'prompt' && (\n      <Button\n        size=\"small\"\n        variant=\"contained\"\n        onClick={onInstallClick}\n        data-testid={testIdFor(dataTestId, 'install')}\n      >\n        {installLabel}\n      </Button>\n    )}\n\n    <IconButton\n      size=\"small\"\n      onClick={onDismissClick}\n      aria-label={dismissLabel}\n      data-testid={testIdFor(dataTestId, 'dismiss')}\n    >\n      <Close fontSize=\"small\" />\n    </IconButton>\n  </Box>\n);\n\n/**\n * A dismissible invitation to install the app, rendered only when the browser\n * is actually able to install it and the user has not recently said no.\n *\n * Returns `null` in every other case — already installed, dismissed, or a\n * browser with no install route at all — so it is safe to mount unconditionally\n * in a layout rather than gating it at the call site.\n *\n * The copy defaults to English and every string is a prop: this package stays\n * locale-neutral and the consuming app supplies its own wording.\n */\nexport const InstallPrompt = React.forwardRef<HTMLDivElement, InstallPromptProps>(\n  (\n    {\n      title = 'Install this app',\n      description,\n      installLabel = 'Install',\n      iosInstructions,\n      dismissLabel = 'Dismiss install prompt',\n      icon,\n      onInstall,\n      onDismiss,\n      storageKey,\n      dismissForDays,\n      className,\n      'data-testid': dataTestId = 'install-prompt',\n      ...props\n    },\n    ref,\n  ) => {\n    const { canInstall, platform, promptInstall, dismiss } = usePwaInstall({\n      storageKey,\n      dismissForDays,\n    });\n\n    const handleInstall = React.useCallback(() => {\n      void promptInstall().then((outcome) => onInstall?.(outcome));\n    }, [promptInstall, onInstall]);\n\n    const handleDismiss = React.useCallback(() => {\n      dismiss();\n      onDismiss?.();\n    }, [dismiss, onDismiss]);\n\n    if (!canInstall) {\n      return null;\n    }\n\n    return (\n      <StyledInstallPrompt\n        ref={ref}\n        className={className}\n        role=\"region\"\n        aria-label={title}\n        data-testid={dataTestId}\n        {...props}\n      >\n        <InstallPromptBody\n          icon={icon}\n          title={title}\n          description={description}\n          iosInstructions={iosInstructions}\n          platform={platform}\n          dataTestId={dataTestId}\n        />\n\n        <InstallPromptActions\n          platform={platform}\n          installLabel={installLabel}\n          dismissLabel={dismissLabel}\n          onInstallClick={handleInstall}\n          onDismissClick={handleDismiss}\n          dataTestId={dataTestId}\n        />\n      </StyledInstallPrompt>\n    );\n  },\n);\n\nInstallPrompt.displayName = 'InstallPrompt';\n","import { alpha } from '@mui/material';\nimport type { CSSObject, Theme } from '@mui/material';\n\nexport const installPromptStyles = (theme: Theme): CSSObject => ({\n  display: 'flex',\n  alignItems: 'flex-start',\n  gap: theme.spacing(1.5),\n  padding: theme.spacing(1.5, 2),\n  borderRadius: theme.spacing(1),\n  backgroundColor: alpha(theme.palette.primary.main, 0.08),\n  border: `1px solid ${alpha(theme.palette.primary.main, 0.2)}`,\n\n  '.install-prompt-icon': {\n    flexShrink: 0,\n    marginTop: theme.spacing(0.25),\n    display: 'flex',\n    color: theme.palette.primary.main,\n  },\n\n  '.install-prompt-content': {\n    flex: 1,\n    minWidth: 0,\n  },\n\n  '.install-prompt-title': {\n    fontWeight: 600,\n  },\n\n  '.install-prompt-description': {\n    opacity: 0.9,\n  },\n\n  '.install-prompt-actions': {\n    display: 'flex',\n    flexShrink: 0,\n    alignItems: 'center',\n    gap: theme.spacing(1),\n  },\n\n  // The actions drop to their own full-width row on a phone, where this\n  // component does most of its work.\n  [theme.breakpoints.down('sm')]: {\n    flexWrap: 'wrap',\n\n    '.install-prompt-actions': {\n      width: '100%',\n      marginTop: theme.spacing(1),\n    },\n  },\n});\n","import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { PWA_INSTALL_AVAILABLE_EVENT, readPwaInstallStash } from './InstallPrompt.earlyCapture';\nimport {\n  DEFAULT_DISMISS_DAYS,\n  DEFAULT_STORAGE_KEY,\n  isDismissalActive,\n  isStandaloneDisplay,\n  readDismissedAt,\n  resolveInstallPlatform,\n  writeDismissedAt,\n} from './InstallPrompt.helpers';\nimport type {\n  BeforeInstallPromptEvent,\n  InstallOutcome,\n  InstallPlatform,\n  PwaInstallState,\n  UsePwaInstallOptions,\n} from './InstallPrompt.types';\n\n/**\n * Headless PWA install machinery.\n *\n * A manifest and a service worker make a site installABLE; they do not make it\n * install. Chromium announces its willingness by firing `beforeinstallprompt`\n * and then does nothing further on its own beyond a small address-bar icon most\n * users never notice. Unless a page calls `preventDefault()` on that event and\n * keeps it, the handle is gone and the app can never ask.\n *\n * That is the whole reason this hook exists. It captures the event, tracks the\n * three states that should suppress an install invitation (already installed,\n * recently dismissed, browser cannot install), and hands back a\n * gesture-callable `promptInstall`.\n *\n * Every environment probe runs in an effect rather than in a state initialiser:\n * touching `window` during render breaks SSR and desynchronises hydration, so\n * the first paint deliberately reports `canInstall: false` and corrects itself\n * on mount.\n */\n\n/** Tracks whether the page is running as an installed app. */\nconst useInstalledState = (onInstalled?: () => void) => {\n  const [isInstalled, setIsInstalled] = useState(false);\n\n  // Held in a ref, and refreshed in its own effect rather than during render, so\n  // that a caller passing an inline callback does not re-subscribe the listener\n  // on every render.\n  const onInstalledRef = useRef(onInstalled);\n  useEffect(() => {\n    onInstalledRef.current = onInstalled;\n  }, [onInstalled]);\n\n  useEffect(() => {\n    // `appinstalled` can also land before the app mounts, so the stash is\n    // consulted for the same reason the deferred event is.\n    setIsInstalled(isStandaloneDisplay() || readPwaInstallStash()?.installedAt != null);\n\n    const markInstalled = () => {\n      setIsInstalled(true);\n      onInstalledRef.current?.();\n    };\n\n    window.addEventListener('appinstalled', markInstalled);\n    return () => window.removeEventListener('appinstalled', markInstalled);\n  }, []);\n\n  return isInstalled;\n};\n\n/**\n * Holds the deferred `beforeinstallprompt` event.\n *\n * The stash written by `capturePwaInstallEvent` is the PRIMARY source, not a\n * fallback. Chromium fires the event once, during initial page load; a\n * listener attached in an effect runs after hydration and, when the component\n * is code-split, after a download that may not happen until a later route. In\n * a real browser it essentially never catches the event, and the event is not\n * reissued on request — so a hook that relies on its own listener reports\n * \"cannot install\" forever on the one platform that can.\n *\n * The live listeners below therefore cover only the narrow case they can\n * actually serve: a browser re-evaluating installability while the app is\n * already running, and a host that never wired the capture at all.\n */\nconst useDeferredPrompt = () => {\n  const deferredRef = useRef<BeforeInstallPromptEvent | null>(null);\n  const [promptReady, setPromptReady] = useState(false);\n\n  useEffect(() => {\n    const hold = (event: BeforeInstallPromptEvent) => {\n      deferredRef.current = event;\n      setPromptReady(true);\n    };\n\n    // Whatever fired before this component existed.\n    const held = readPwaInstallStash()?.event;\n    if (held) hold(held);\n\n    // The capture rang the bell after mount: adopt what it is holding.\n    const adopt = () => {\n      const fresh = readPwaInstallStash()?.event;\n      if (fresh) hold(fresh);\n    };\n\n    const capture = (event: Event) => {\n      // Without preventDefault the browser owns the event and the handle dies\n      // with it. The capture has normally done this already; repeating it is\n      // harmless and keeps the hook correct on a host that skipped wiring.\n      event.preventDefault();\n      hold(event as BeforeInstallPromptEvent);\n    };\n\n    window.addEventListener(PWA_INSTALL_AVAILABLE_EVENT, adopt);\n    window.addEventListener('beforeinstallprompt', capture);\n    return () => {\n      window.removeEventListener(PWA_INSTALL_AVAILABLE_EVENT, adopt);\n      window.removeEventListener('beforeinstallprompt', capture);\n    };\n  }, []);\n\n  const clearPrompt = useCallback(() => {\n    deferredRef.current = null;\n    setPromptReady(false);\n  }, []);\n\n  return { deferredRef, promptReady, clearPrompt };\n};\n\n/** Reads and writes the \"don't ask again for a while\" record. */\nconst useDismissal = (storageKey: string, dismissForDays: number) => {\n  const [dismissed, setDismissed] = useState(false);\n\n  useEffect(() => {\n    const dismissedAt = readDismissedAt(storageKey);\n    setDismissed(isDismissalActive(dismissedAt, dismissForDays, Date.now()));\n  }, [storageKey, dismissForDays]);\n\n  const persistDismissal = useCallback(() => {\n    writeDismissedAt(storageKey, Date.now());\n    setDismissed(true);\n  }, [storageKey]);\n\n  return { dismissed, persistDismissal };\n};\n\n/** Resolves the install route once the deferred-prompt state is known. */\nconst useInstallPlatform = (promptReady: boolean): InstallPlatform => {\n  const [platform, setPlatform] = useState<InstallPlatform>('unsupported');\n\n  useEffect(() => {\n    setPlatform(resolveInstallPlatform(promptReady));\n  }, [promptReady]);\n\n  return platform;\n};\n\nexport const usePwaInstall = (options: UsePwaInstallOptions = {}): PwaInstallState => {\n  const {\n    storageKey = DEFAULT_STORAGE_KEY,\n    dismissForDays = DEFAULT_DISMISS_DAYS,\n    onInstalled,\n  } = options;\n\n  const isInstalled = useInstalledState(onInstalled);\n  const { deferredRef, promptReady, clearPrompt } = useDeferredPrompt();\n  const { dismissed, persistDismissal } = useDismissal(storageKey, dismissForDays);\n  const platform = useInstallPlatform(promptReady);\n\n  const promptInstall = useCallback(async (): Promise<InstallOutcome> => {\n    const deferred = deferredRef.current;\n    if (!deferred) return 'unavailable';\n\n    await deferred.prompt();\n    const { outcome } = await deferred.userChoice;\n\n    // Single-use handle: spent whichever way the user answered. Chromium emits a\n    // fresh event if the app is still installable, so holding this one would\n    // only mean calling prompt() twice on a dead event.\n    clearPrompt();\n\n    // Declining the browser's own dialog is a real \"no\" — record it, or the\n    // affordance reappears on the next render and badgers the user.\n    if (outcome === 'dismissed') persistDismissal();\n\n    return outcome;\n  }, [deferredRef, clearPrompt, persistDismissal]);\n\n  // iOS has no event to wait for, so its affordance is gated on the platform\n  // probe alone; everywhere else a live captured prompt is the prerequisite.\n  const canInstall = !isInstalled && !dismissed && (platform === 'ios' || promptReady);\n\n  return {\n    canInstall,\n    platform,\n    isInstalled,\n    promptInstall,\n    dismiss: persistDismissal,\n  };\n};\n","import type { BeforeInstallPromptEvent, PwaInstallStash } from './InstallPrompt.types';\n\n/**\n * Holds `beforeinstallprompt` from before the app exists.\n *\n * `usePwaInstall` cannot attach its own listener early enough, and no React\n * hook can. Chromium fires the event once, during initial page load, the\n * moment it has a manifest and a registered worker — which in a real app is\n * before hydration, and often before the chunk containing the component has\n * even been downloaded. A listener registered in an effect is not late by\n * milliseconds; it can be late by entire navigations. Nothing calls\n * `preventDefault()` in time, the browser keeps the event, and the page can\n * never ask again.\n *\n * So the capture has to live outside React, and the host has to install it as\n * the very first thing the document does. Two supported ways, in order of\n * reliability:\n *\n * 1. An inline `<script>` in `<head>`, which beats a deferred module bundle:\n *\n *        <script>\n *          window.addEventListener('beforeinstallprompt', function (e) {\n *            e.preventDefault();\n *            var s = (window.__pwaInstall = window.__pwaInstall || {});\n *            s.event = e; s.firedAt = Date.now();\n *            window.dispatchEvent(new Event('pwa-install-available'));\n *          });\n *        </script>\n *\n * 2. `capturePwaInstallEvent()` as the first statement of the entry module,\n *    before `createRoot`. Simpler to wire and correct in most apps, but a\n *    module is still deferred, so a very early event can outrun it.\n *\n * Both write the same shape, so the hook does not care which was used.\n */\n\n/** Property on `window` holding the captured event. Shared with the inline snippet. */\nexport const PWA_INSTALL_STASH_KEY = '__pwaInstall';\n\n/** Fired after a capture, so an app already running can adopt the event. */\nexport const PWA_INSTALL_AVAILABLE_EVENT = 'pwa-install-available';\n\ntype StashHost = Window & { [PWA_INSTALL_STASH_KEY]?: PwaInstallStash };\n\n/** The stash, or `null` when no capture ever ran (SSR, or a host that skipped wiring). */\nexport const readPwaInstallStash = (): PwaInstallStash | null => {\n  if (typeof window === 'undefined') return null;\n  return (window as StashHost)[PWA_INSTALL_STASH_KEY] ?? null;\n};\n\nconst ensureStash = (): PwaInstallStash => {\n  const host = window as StashHost;\n  host[PWA_INSTALL_STASH_KEY] ??= { event: null, firedAt: null, installedAt: null };\n  return host[PWA_INSTALL_STASH_KEY];\n};\n\n/**\n * The teardown for the capture currently running, so `resetPwaInstallStash`\n * can unwind completely. Held here rather than on the stash because it must\n * survive the stash being deleted, and because it must never be serialised\n * into the diagnostic payload.\n */\nlet activeTeardown: (() => void) | null = null;\n\n/**\n * Starts capturing. Returns a teardown, and is safe to call twice — a second\n * call is a no-op rather than a duplicate listener, so a host that wires both\n * the inline snippet and this function does not double-handle the event.\n */\nexport const capturePwaInstallEvent = (): (() => void) => {\n  if (typeof window === 'undefined') return () => undefined;\n\n  const stash = ensureStash();\n  if (stash.capturing === true) return () => undefined;\n  stash.capturing = true;\n\n  const onBeforeInstall = (event: Event): void => {\n    // The line the whole component depends on. Without it the browser owns the\n    // event, shows at most its own mini-infobar, and discards the handle.\n    event.preventDefault();\n    stash.event = event as BeforeInstallPromptEvent;\n    stash.firedAt = Date.now();\n    window.dispatchEvent(new Event(PWA_INSTALL_AVAILABLE_EVENT));\n  };\n\n  const onInstalled = (): void => {\n    stash.installedAt = Date.now();\n    stash.event = null;\n  };\n\n  window.addEventListener('beforeinstallprompt', onBeforeInstall);\n  window.addEventListener('appinstalled', onInstalled);\n\n  const teardown = () => {\n    window.removeEventListener('beforeinstallprompt', onBeforeInstall);\n    window.removeEventListener('appinstalled', onInstalled);\n    stash.capturing = false;\n    if (activeTeardown === teardown) activeTeardown = null;\n  };\n\n  activeTeardown = teardown;\n  return teardown;\n};\n\n/**\n * Returns the page to its pre-capture state: listeners removed, stash gone.\n *\n * Exists for tests and stories, which need a clean page per case. It unwinds\n * the listeners as well as the data, because a leaked capture from a previous\n * case would go on suppressing events that the next case expects to observe.\n */\nexport const resetPwaInstallStash = (): void => {\n  if (typeof window === 'undefined') return;\n  activeTeardown?.();\n  activeTeardown = null;\n  delete (window as StashHost)[PWA_INSTALL_STASH_KEY];\n};\n","import type { InstallPlatform } from './InstallPrompt.types';\n\n/**\n * Pure environment probes and dismissal storage for `usePwaInstall`.\n *\n * Everything here is a plain function taking its clock and its storage from the\n * caller where that matters, so the hook's behaviour is testable without\n * faking timers or a browser.\n */\n\nexport const DEFAULT_STORAGE_KEY = 'pwa-install-dismissed';\nexport const DEFAULT_DISMISS_DAYS = 30;\n\nconst MS_PER_DAY = 86_400_000;\nconst STANDALONE_QUERY = '(display-mode: standalone)';\n\n/** iOS Safari predates `display-mode` and exposes this instead. */\ninterface IosNavigator extends Navigator {\n  standalone?: boolean;\n}\n\n/** Guard for SSR and for jsdom runs where `matchMedia` is not implemented. */\nconst hasWindow = (): boolean => typeof window !== 'undefined';\n\n/**\n * True when the page is already running as an installed app.\n *\n * Both checks are needed: `display-mode: standalone` is the standard signal,\n * but iOS never implemented it for home-screen launches and reports\n * `navigator.standalone` instead. Miss the iOS branch and the installed app\n * nags its own users to install it again.\n */\nexport const isStandaloneDisplay = (): boolean => {\n  if (!hasWindow()) return false;\n  if ((window.navigator as IosNavigator).standalone === true) return true;\n  return window.matchMedia?.(STANDALONE_QUERY).matches === true;\n};\n\n/**\n * True for Safari on iOS/iPadOS — the one browser that can install but cannot\n * be asked programmatically.\n *\n * Two traps handled here. iPadOS 13+ reports a Macintosh user agent, so the\n * touch-point count is what separates an iPad from a desktop; and Chrome,\n * Firefox and Edge on iOS are Safari underneath but offer no Add to Home\n * Screen at all, so telling their users to tap Share is a dead end.\n *\n * Kept parameterised so the agent table can be tested without reassigning\n * `navigator`, which leaks across test files when it is not restored.\n */\nexport const isIosSafariAgent = (userAgent: string, maxTouchPoints: number): boolean => {\n  const isIosDevice =\n    /iPad|iPhone|iPod/.test(userAgent) ||\n    (userAgent.includes('Macintosh') && maxTouchPoints > 1);\n\n  if (!isIosDevice) return false;\n\n  return !/CriOS|FxiOS|EdgiOS|OPiOS/.test(userAgent);\n};\n\n/** `isIosSafariAgent` against the live browser. Internal — callers use `resolveInstallPlatform`. */\nconst isIosSafari = (): boolean => {\n  if (!hasWindow()) return false;\n\n  const { userAgent, maxTouchPoints } = window.navigator;\n  return isIosSafariAgent(userAgent, maxTouchPoints);\n};\n\n/**\n * Reads the stored dismissal timestamp.\n *\n * Storage access is wrapped because it THROWS rather than returning null in\n * Safari private mode and wherever cookies are blocked — an uncaught throw\n * here would take down the storefront on the very browsers this component\n * exists to serve.\n */\nexport const readDismissedAt = (storageKey: string): number | null => {\n  if (!hasWindow()) return null;\n\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n    if (!raw) return null;\n\n    const parsed = Number.parseInt(raw, 10);\n    return Number.isFinite(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n};\n\n/** Persists a dismissal. Silently a no-op when storage is unavailable. */\nexport const writeDismissedAt = (storageKey: string, at: number): void => {\n  if (!hasWindow()) return;\n\n  try {\n    window.localStorage.setItem(storageKey, String(at));\n  } catch {\n    // Storage blocked — the dismissal lasts for this page view only.\n  }\n};\n\n/**\n * Whether a stored dismissal still suppresses the prompt.\n *\n * `dismissForDays: 0` means forever. A timestamp in the future (a device whose\n * clock was wound back) is treated as active rather than expired, so a bad\n * clock cannot turn into a prompt on every page view.\n */\nexport const isDismissalActive = (\n  dismissedAt: number | null,\n  dismissForDays: number,\n  now: number,\n): boolean => {\n  if (dismissedAt === null) return false;\n  if (dismissForDays <= 0) return true;\n\n  return now - dismissedAt < dismissForDays * MS_PER_DAY;\n};\n\n/** Resolves which install route this browser offers. */\nexport const resolveInstallPlatform = (hasDeferredPrompt: boolean): InstallPlatform => {\n  if (hasDeferredPrompt) return 'prompt';\n  return isIosSafari() ? 'ios' : 'unsupported';\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/utility/InstallPrompt/InstallPrompt.tsx","../../src/components/utility/InstallPrompt/InstallPrompt.styles.ts","../../src/components/utility/InstallPrompt/usePwaInstall.ts","../../src/components/utility/InstallPrompt/InstallPrompt.earlyCapture.ts","../../src/components/utility/InstallPrompt/InstallPrompt.helpers.ts"],"sourcesContent":["import Close from '@mui/icons-material/Close';\nimport InstallMobile from '@mui/icons-material/InstallMobile';\nimport IosShare from '@mui/icons-material/IosShare';\nimport { Box, Button, IconButton, Typography } from '@mui/material';\nimport { styled } from '@mui/material';\nimport React from 'react';\n\nimport { installPromptStyles } from './InstallPrompt.styles';\nimport type { InstallPlatform, InstallPromptProps } from './InstallPrompt.types';\nimport { usePwaInstall } from './usePwaInstall';\nimport type { InstallPromptCopy } from '../../../copy';\n\nconst StyledInstallPrompt = styled(Box)(({ theme }) => installPromptStyles(theme));\n\nconst testIdFor = (base: string | undefined, suffix: string) =>\n  base ? `${base}-${suffix}` : `install-prompt-${suffix}`;\n\n/**\n * The iOS branch renders instructions rather than a button, because Safari\n * exposes no API to open its own Add to Home Screen sheet. A button here would\n * be a control that does nothing when pressed.\n */\nconst IosInstructions: React.FC<{\n  copy: InstallPromptCopy;\n  instructions?: React.ReactNode;\n  dataTestId?: string;\n}> = ({ copy, instructions, dataTestId }) => (\n  <Typography\n    className=\"install-prompt-description\"\n    variant=\"body2\"\n    component=\"div\"\n    data-testid={testIdFor(dataTestId, 'ios-instructions')}\n    sx={{ display: 'flex', alignItems: 'center', gap: 0.5, flexWrap: 'wrap' }}\n  >\n    {instructions ?? (\n      <>\n        {copy.iosTapBefore} <IosShare fontSize=\"small\" aria-label={copy.shareLabel} />{' '}\n        {copy.iosTapAfter}\n      </>\n    )}\n  </Typography>\n);\n\nconst InstallPromptBody: React.FC<{\n  copy: InstallPromptCopy;\n  icon?: React.ReactNode;\n  title: string;\n  description?: string;\n  iosInstructions?: React.ReactNode;\n  platform: InstallPlatform;\n  dataTestId?: string;\n}> = ({ copy, icon, title, description, iosInstructions, platform, dataTestId }) => (\n  <>\n    <Box className=\"install-prompt-icon\" aria-hidden=\"true\">\n      {icon ?? <InstallMobile />}\n    </Box>\n\n    <Box className=\"install-prompt-content\">\n      <Typography\n        className=\"install-prompt-title\"\n        variant=\"subtitle2\"\n        component=\"div\"\n        data-testid={testIdFor(dataTestId, 'title')}\n      >\n        {title}\n      </Typography>\n\n      {description && (\n        <Typography\n          className=\"install-prompt-description\"\n          variant=\"body2\"\n          component=\"div\"\n          data-testid={testIdFor(dataTestId, 'description')}\n        >\n          {description}\n        </Typography>\n      )}\n\n      {platform === 'ios' && (\n        <IosInstructions copy={copy} instructions={iosInstructions} dataTestId={dataTestId} />\n      )}\n    </Box>\n  </>\n);\n\nconst InstallPromptActions: React.FC<{\n  platform: InstallPlatform;\n  installLabel: string;\n  dismissLabel: string;\n  onInstallClick: () => void;\n  onDismissClick: () => void;\n  dataTestId?: string;\n}> = ({ platform, installLabel, dismissLabel, onInstallClick, onDismissClick, dataTestId }) => (\n  <Box className=\"install-prompt-actions\">\n    {platform === 'prompt' && (\n      <Button\n        size=\"small\"\n        variant=\"contained\"\n        onClick={onInstallClick}\n        data-testid={testIdFor(dataTestId, 'install')}\n      >\n        {installLabel}\n      </Button>\n    )}\n\n    <IconButton\n      size=\"small\"\n      onClick={onDismissClick}\n      aria-label={dismissLabel}\n      data-testid={testIdFor(dataTestId, 'dismiss')}\n    >\n      <Close fontSize=\"small\" />\n    </IconButton>\n  </Box>\n);\n\n/**\n * A dismissible invitation to install the app, rendered only when the browser\n * is actually able to install it and the user has not recently said no.\n *\n * Returns `null` in every other case — already installed, dismissed, or a\n * browser with no install route at all — so it is safe to mount unconditionally\n * in a layout rather than gating it at the call site.\n *\n * Every string is REQUIRED host config (`copy`): this package stays\n * locale-neutral and the consuming app supplies its own wording. There is no\n * English default to fall through to, so a missing word is a typecheck failure\n * rather than an English sentence in a pt-BR store.\n */\nexport const InstallPrompt = React.forwardRef<HTMLDivElement, InstallPromptProps>(\n  (\n    {\n      copy,\n      description,\n      iosInstructions,\n      icon,\n      onInstall,\n      onDismiss,\n      storageKey,\n      dismissForDays,\n      className,\n      'data-testid': dataTestId = 'install-prompt',\n      ...props\n    },\n    ref,\n  ) => {\n    const { canInstall, platform, promptInstall, dismiss } = usePwaInstall({\n      storageKey,\n      dismissForDays,\n    });\n\n    const handleInstall = React.useCallback(() => {\n      void promptInstall().then((outcome) => onInstall?.(outcome));\n    }, [promptInstall, onInstall]);\n\n    const handleDismiss = React.useCallback(() => {\n      dismiss();\n      onDismiss?.();\n    }, [dismiss, onDismiss]);\n\n    if (!canInstall) {\n      return null;\n    }\n\n    return (\n      <StyledInstallPrompt\n        ref={ref}\n        className={className}\n        role=\"region\"\n        aria-label={copy.title}\n        data-testid={dataTestId}\n        {...props}\n      >\n        <InstallPromptBody\n          icon={icon}\n          copy={copy}\n          title={copy.title}\n          description={description}\n          iosInstructions={iosInstructions}\n          platform={platform}\n          dataTestId={dataTestId}\n        />\n\n        <InstallPromptActions\n          platform={platform}\n          installLabel={copy.installLabel}\n          dismissLabel={copy.dismissLabel}\n          onInstallClick={handleInstall}\n          onDismissClick={handleDismiss}\n          dataTestId={dataTestId}\n        />\n      </StyledInstallPrompt>\n    );\n  },\n);\n\nInstallPrompt.displayName = 'InstallPrompt';\n","import { alpha } from '@mui/material';\nimport type { CSSObject, Theme } from '@mui/material';\n\nexport const installPromptStyles = (theme: Theme): CSSObject => ({\n  display: 'flex',\n  alignItems: 'flex-start',\n  gap: theme.spacing(1.5),\n  padding: theme.spacing(1.5, 2),\n  borderRadius: theme.spacing(1),\n  backgroundColor: alpha(theme.palette.primary.main, 0.08),\n  border: `1px solid ${alpha(theme.palette.primary.main, 0.2)}`,\n\n  '.install-prompt-icon': {\n    flexShrink: 0,\n    marginTop: theme.spacing(0.25),\n    display: 'flex',\n    color: theme.palette.primary.main,\n  },\n\n  '.install-prompt-content': {\n    flex: 1,\n    minWidth: 0,\n  },\n\n  '.install-prompt-title': {\n    fontWeight: 600,\n  },\n\n  '.install-prompt-description': {\n    opacity: 0.9,\n  },\n\n  '.install-prompt-actions': {\n    display: 'flex',\n    flexShrink: 0,\n    alignItems: 'center',\n    gap: theme.spacing(1),\n  },\n\n  // The actions drop to their own full-width row on a phone, where this\n  // component does most of its work.\n  [theme.breakpoints.down('sm')]: {\n    flexWrap: 'wrap',\n\n    '.install-prompt-actions': {\n      width: '100%',\n      marginTop: theme.spacing(1),\n    },\n  },\n});\n","import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { PWA_INSTALL_AVAILABLE_EVENT, readPwaInstallStash } from './InstallPrompt.earlyCapture';\nimport {\n  DEFAULT_DISMISS_DAYS,\n  DEFAULT_STORAGE_KEY,\n  isDismissalActive,\n  isStandaloneDisplay,\n  readDismissedAt,\n  resolveInstallPlatform,\n  writeDismissedAt,\n} from './InstallPrompt.helpers';\nimport type {\n  BeforeInstallPromptEvent,\n  InstallOutcome,\n  InstallPlatform,\n  PwaInstallState,\n  UsePwaInstallOptions,\n} from './InstallPrompt.types';\n\n/**\n * Headless PWA install machinery.\n *\n * A manifest and a service worker make a site installABLE; they do not make it\n * install. Chromium announces its willingness by firing `beforeinstallprompt`\n * and then does nothing further on its own beyond a small address-bar icon most\n * users never notice. Unless a page calls `preventDefault()` on that event and\n * keeps it, the handle is gone and the app can never ask.\n *\n * That is the whole reason this hook exists. It captures the event, tracks the\n * three states that should suppress an install invitation (already installed,\n * recently dismissed, browser cannot install), and hands back a\n * gesture-callable `promptInstall`.\n *\n * Every environment probe runs in an effect rather than in a state initialiser:\n * touching `window` during render breaks SSR and desynchronises hydration, so\n * the first paint deliberately reports `canInstall: false` and corrects itself\n * on mount.\n */\n\n/** Tracks whether the page is running as an installed app. */\nconst useInstalledState = (onInstalled?: () => void) => {\n  const [isInstalled, setIsInstalled] = useState(false);\n\n  // Held in a ref, and refreshed in its own effect rather than during render, so\n  // that a caller passing an inline callback does not re-subscribe the listener\n  // on every render.\n  const onInstalledRef = useRef(onInstalled);\n  useEffect(() => {\n    onInstalledRef.current = onInstalled;\n  }, [onInstalled]);\n\n  useEffect(() => {\n    // `appinstalled` can also land before the app mounts, so the stash is\n    // consulted for the same reason the deferred event is.\n    setIsInstalled(isStandaloneDisplay() || readPwaInstallStash()?.installedAt != null);\n\n    const markInstalled = () => {\n      setIsInstalled(true);\n      onInstalledRef.current?.();\n    };\n\n    window.addEventListener('appinstalled', markInstalled);\n    return () => window.removeEventListener('appinstalled', markInstalled);\n  }, []);\n\n  return isInstalled;\n};\n\n/**\n * Holds the deferred `beforeinstallprompt` event.\n *\n * The stash written by `capturePwaInstallEvent` is the PRIMARY source, not a\n * fallback. Chromium fires the event once, during initial page load; a\n * listener attached in an effect runs after hydration and, when the component\n * is code-split, after a download that may not happen until a later route. In\n * a real browser it essentially never catches the event, and the event is not\n * reissued on request — so a hook that relies on its own listener reports\n * \"cannot install\" forever on the one platform that can.\n *\n * The live listeners below therefore cover only the narrow case they can\n * actually serve: a browser re-evaluating installability while the app is\n * already running, and a host that never wired the capture at all.\n */\nconst useDeferredPrompt = () => {\n  const deferredRef = useRef<BeforeInstallPromptEvent | null>(null);\n  const [promptReady, setPromptReady] = useState(false);\n\n  useEffect(() => {\n    const hold = (event: BeforeInstallPromptEvent) => {\n      deferredRef.current = event;\n      setPromptReady(true);\n    };\n\n    // Whatever fired before this component existed.\n    const held = readPwaInstallStash()?.event;\n    if (held) hold(held);\n\n    // The capture rang the bell after mount: adopt what it is holding.\n    const adopt = () => {\n      const fresh = readPwaInstallStash()?.event;\n      if (fresh) hold(fresh);\n    };\n\n    const capture = (event: Event) => {\n      // Without preventDefault the browser owns the event and the handle dies\n      // with it. The capture has normally done this already; repeating it is\n      // harmless and keeps the hook correct on a host that skipped wiring.\n      event.preventDefault();\n      hold(event as BeforeInstallPromptEvent);\n    };\n\n    window.addEventListener(PWA_INSTALL_AVAILABLE_EVENT, adopt);\n    window.addEventListener('beforeinstallprompt', capture);\n    return () => {\n      window.removeEventListener(PWA_INSTALL_AVAILABLE_EVENT, adopt);\n      window.removeEventListener('beforeinstallprompt', capture);\n    };\n  }, []);\n\n  const clearPrompt = useCallback(() => {\n    deferredRef.current = null;\n    setPromptReady(false);\n  }, []);\n\n  return { deferredRef, promptReady, clearPrompt };\n};\n\n/** Reads and writes the \"don't ask again for a while\" record. */\nconst useDismissal = (storageKey: string, dismissForDays: number) => {\n  const [dismissed, setDismissed] = useState(false);\n\n  useEffect(() => {\n    const dismissedAt = readDismissedAt(storageKey);\n    setDismissed(isDismissalActive(dismissedAt, dismissForDays, Date.now()));\n  }, [storageKey, dismissForDays]);\n\n  const persistDismissal = useCallback(() => {\n    writeDismissedAt(storageKey, Date.now());\n    setDismissed(true);\n  }, [storageKey]);\n\n  return { dismissed, persistDismissal };\n};\n\n/** Resolves the install route once the deferred-prompt state is known. */\nconst useInstallPlatform = (promptReady: boolean): InstallPlatform => {\n  const [platform, setPlatform] = useState<InstallPlatform>('unsupported');\n\n  useEffect(() => {\n    setPlatform(resolveInstallPlatform(promptReady));\n  }, [promptReady]);\n\n  return platform;\n};\n\nexport const usePwaInstall = (options: UsePwaInstallOptions = {}): PwaInstallState => {\n  const {\n    storageKey = DEFAULT_STORAGE_KEY,\n    dismissForDays = DEFAULT_DISMISS_DAYS,\n    onInstalled,\n  } = options;\n\n  const isInstalled = useInstalledState(onInstalled);\n  const { deferredRef, promptReady, clearPrompt } = useDeferredPrompt();\n  const { dismissed, persistDismissal } = useDismissal(storageKey, dismissForDays);\n  const platform = useInstallPlatform(promptReady);\n\n  const promptInstall = useCallback(async (): Promise<InstallOutcome> => {\n    const deferred = deferredRef.current;\n    if (!deferred) return 'unavailable';\n\n    await deferred.prompt();\n    const { outcome } = await deferred.userChoice;\n\n    // Single-use handle: spent whichever way the user answered. Chromium emits a\n    // fresh event if the app is still installable, so holding this one would\n    // only mean calling prompt() twice on a dead event.\n    clearPrompt();\n\n    // Declining the browser's own dialog is a real \"no\" — record it, or the\n    // affordance reappears on the next render and badgers the user.\n    if (outcome === 'dismissed') persistDismissal();\n\n    return outcome;\n  }, [deferredRef, clearPrompt, persistDismissal]);\n\n  // iOS has no event to wait for, so its affordance is gated on the platform\n  // probe alone; everywhere else a live captured prompt is the prerequisite.\n  const canInstall = !isInstalled && !dismissed && (platform === 'ios' || promptReady);\n\n  return {\n    canInstall,\n    platform,\n    isInstalled,\n    promptInstall,\n    dismiss: persistDismissal,\n  };\n};\n","import type { BeforeInstallPromptEvent, PwaInstallStash } from './InstallPrompt.types';\n\n/**\n * Holds `beforeinstallprompt` from before the app exists.\n *\n * `usePwaInstall` cannot attach its own listener early enough, and no React\n * hook can. Chromium fires the event once, during initial page load, the\n * moment it has a manifest and a registered worker — which in a real app is\n * before hydration, and often before the chunk containing the component has\n * even been downloaded. A listener registered in an effect is not late by\n * milliseconds; it can be late by entire navigations. Nothing calls\n * `preventDefault()` in time, the browser keeps the event, and the page can\n * never ask again.\n *\n * So the capture has to live outside React, and the host has to install it as\n * the very first thing the document does. Two supported ways, in order of\n * reliability:\n *\n * 1. An inline `<script>` in `<head>`, which beats a deferred module bundle:\n *\n *        <script>\n *          window.addEventListener('beforeinstallprompt', function (e) {\n *            e.preventDefault();\n *            var s = (window.__pwaInstall = window.__pwaInstall || {});\n *            s.event = e; s.firedAt = Date.now();\n *            window.dispatchEvent(new Event('pwa-install-available'));\n *          });\n *        </script>\n *\n * 2. `capturePwaInstallEvent()` as the first statement of the entry module,\n *    before `createRoot`. Simpler to wire and correct in most apps, but a\n *    module is still deferred, so a very early event can outrun it.\n *\n * Both write the same shape, so the hook does not care which was used.\n */\n\n/** Property on `window` holding the captured event. Shared with the inline snippet. */\nexport const PWA_INSTALL_STASH_KEY = '__pwaInstall';\n\n/** Fired after a capture, so an app already running can adopt the event. */\nexport const PWA_INSTALL_AVAILABLE_EVENT = 'pwa-install-available';\n\ntype StashHost = Window & { [PWA_INSTALL_STASH_KEY]?: PwaInstallStash };\n\n/** The stash, or `null` when no capture ever ran (SSR, or a host that skipped wiring). */\nexport const readPwaInstallStash = (): PwaInstallStash | null => {\n  if (typeof window === 'undefined') return null;\n  return (window as StashHost)[PWA_INSTALL_STASH_KEY] ?? null;\n};\n\nconst ensureStash = (): PwaInstallStash => {\n  const host = window as StashHost;\n  host[PWA_INSTALL_STASH_KEY] ??= { event: null, firedAt: null, installedAt: null };\n  return host[PWA_INSTALL_STASH_KEY];\n};\n\n/**\n * The teardown for the capture currently running, so `resetPwaInstallStash`\n * can unwind completely. Held here rather than on the stash because it must\n * survive the stash being deleted, and because it must never be serialised\n * into the diagnostic payload.\n */\nlet activeTeardown: (() => void) | null = null;\n\n/**\n * Starts capturing. Returns a teardown, and is safe to call twice — a second\n * call is a no-op rather than a duplicate listener, so a host that wires both\n * the inline snippet and this function does not double-handle the event.\n */\nexport const capturePwaInstallEvent = (): (() => void) => {\n  if (typeof window === 'undefined') return () => undefined;\n\n  const stash = ensureStash();\n  if (stash.capturing === true) return () => undefined;\n  stash.capturing = true;\n\n  const onBeforeInstall = (event: Event): void => {\n    // The line the whole component depends on. Without it the browser owns the\n    // event, shows at most its own mini-infobar, and discards the handle.\n    event.preventDefault();\n    stash.event = event as BeforeInstallPromptEvent;\n    stash.firedAt = Date.now();\n    window.dispatchEvent(new Event(PWA_INSTALL_AVAILABLE_EVENT));\n  };\n\n  const onInstalled = (): void => {\n    stash.installedAt = Date.now();\n    stash.event = null;\n  };\n\n  window.addEventListener('beforeinstallprompt', onBeforeInstall);\n  window.addEventListener('appinstalled', onInstalled);\n\n  const teardown = () => {\n    window.removeEventListener('beforeinstallprompt', onBeforeInstall);\n    window.removeEventListener('appinstalled', onInstalled);\n    stash.capturing = false;\n    if (activeTeardown === teardown) activeTeardown = null;\n  };\n\n  activeTeardown = teardown;\n  return teardown;\n};\n\n/**\n * Returns the page to its pre-capture state: listeners removed, stash gone.\n *\n * Exists for tests and stories, which need a clean page per case. It unwinds\n * the listeners as well as the data, because a leaked capture from a previous\n * case would go on suppressing events that the next case expects to observe.\n */\nexport const resetPwaInstallStash = (): void => {\n  if (typeof window === 'undefined') return;\n  activeTeardown?.();\n  activeTeardown = null;\n  delete (window as StashHost)[PWA_INSTALL_STASH_KEY];\n};\n","import type { InstallPlatform } from './InstallPrompt.types';\n\n/**\n * Pure environment probes and dismissal storage for `usePwaInstall`.\n *\n * Everything here is a plain function taking its clock and its storage from the\n * caller where that matters, so the hook's behaviour is testable without\n * faking timers or a browser.\n */\n\nexport const DEFAULT_STORAGE_KEY = 'pwa-install-dismissed';\nexport const DEFAULT_DISMISS_DAYS = 30;\n\nconst MS_PER_DAY = 86_400_000;\nconst STANDALONE_QUERY = '(display-mode: standalone)';\n\n/** iOS Safari predates `display-mode` and exposes this instead. */\ninterface IosNavigator extends Navigator {\n  standalone?: boolean;\n}\n\n/** Guard for SSR and for jsdom runs where `matchMedia` is not implemented. */\nconst hasWindow = (): boolean => typeof window !== 'undefined';\n\n/**\n * True when the page is already running as an installed app.\n *\n * Both checks are needed: `display-mode: standalone` is the standard signal,\n * but iOS never implemented it for home-screen launches and reports\n * `navigator.standalone` instead. Miss the iOS branch and the installed app\n * nags its own users to install it again.\n */\nexport const isStandaloneDisplay = (): boolean => {\n  if (!hasWindow()) return false;\n  if ((window.navigator as IosNavigator).standalone === true) return true;\n  return window.matchMedia?.(STANDALONE_QUERY).matches === true;\n};\n\n/**\n * True for Safari on iOS/iPadOS — the one browser that can install but cannot\n * be asked programmatically.\n *\n * Two traps handled here. iPadOS 13+ reports a Macintosh user agent, so the\n * touch-point count is what separates an iPad from a desktop; and Chrome,\n * Firefox and Edge on iOS are Safari underneath but offer no Add to Home\n * Screen at all, so telling their users to tap Share is a dead end.\n *\n * Kept parameterised so the agent table can be tested without reassigning\n * `navigator`, which leaks across test files when it is not restored.\n */\nexport const isIosSafariAgent = (userAgent: string, maxTouchPoints: number): boolean => {\n  const isIosDevice =\n    /iPad|iPhone|iPod/.test(userAgent) ||\n    (userAgent.includes('Macintosh') && maxTouchPoints > 1);\n\n  if (!isIosDevice) return false;\n\n  return !/CriOS|FxiOS|EdgiOS|OPiOS/.test(userAgent);\n};\n\n/** `isIosSafariAgent` against the live browser. Internal — callers use `resolveInstallPlatform`. */\nconst isIosSafari = (): boolean => {\n  if (!hasWindow()) return false;\n\n  const { userAgent, maxTouchPoints } = window.navigator;\n  return isIosSafariAgent(userAgent, maxTouchPoints);\n};\n\n/**\n * Reads the stored dismissal timestamp.\n *\n * Storage access is wrapped because it THROWS rather than returning null in\n * Safari private mode and wherever cookies are blocked — an uncaught throw\n * here would take down the storefront on the very browsers this component\n * exists to serve.\n */\nexport const readDismissedAt = (storageKey: string): number | null => {\n  if (!hasWindow()) return null;\n\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n    if (!raw) return null;\n\n    const parsed = Number.parseInt(raw, 10);\n    return Number.isFinite(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n};\n\n/** Persists a dismissal. Silently a no-op when storage is unavailable. */\nexport const writeDismissedAt = (storageKey: string, at: number): void => {\n  if (!hasWindow()) return;\n\n  try {\n    window.localStorage.setItem(storageKey, String(at));\n  } catch {\n    // Storage blocked — the dismissal lasts for this page view only.\n  }\n};\n\n/**\n * Whether a stored dismissal still suppresses the prompt.\n *\n * `dismissForDays: 0` means forever. A timestamp in the future (a device whose\n * clock was wound back) is treated as active rather than expired, so a bad\n * clock cannot turn into a prompt on every page view.\n */\nexport const isDismissalActive = (\n  dismissedAt: number | null,\n  dismissForDays: number,\n  now: number,\n): boolean => {\n  if (dismissedAt === null) return false;\n  if (dismissForDays <= 0) return true;\n\n  return now - dismissedAt < dismissForDays * MS_PER_DAY;\n};\n\n/** Resolves which install route this browser offers. */\nexport const resolveInstallPlatform = (hasDeferredPrompt: boolean): InstallPlatform => {\n  if (hasDeferredPrompt) return 'prompt';\n  return isIosSafari() ? 'ios' : 'unsupported';\n};\n"],"mappings":"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","names":[]}

package/package.json

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

package/src/components/data-display/DataGrid/DataGrid.states.tsx

@@ -87,14 +87,14 @@ export function DataGridError(
 }
 
 export function DataGridEmpty(
-  props: StateProps & { emptyState?: React.ReactNode },
+  props: StateProps & { emptyState?: React.ReactNode; emptyText: string },
 ): React.JSX.Element {
-  const { emptyState, ...rest } = props;
+  const { emptyState, emptyText, ...rest } = props;
   return (
     <Placeholder {...rest} flag="data-empty">
       {emptyState ?? (
         <Typography variant="body1" color="text.secondary">
-          No data available
+          {emptyText}
         </Typography>
       )}
     </Placeholder>

package/src/components/data-display/DataGrid/DataGrid.tsx

@@ -68,7 +68,7 @@ export const DataGrid = <T extends Record<string, unknown> = Record<string, unkn
   if (props.loading) return <DataGridLoading {...placeholder} />;
   if (props.error) return <DataGridError {...placeholder} error={props.error} />;
   if (model.processedRows.length === 0) {
-    return <DataGridEmpty {...placeholder} emptyState={props.emptyState} />;
+    return <DataGridEmpty {...placeholder} emptyState={props.emptyState} emptyText={props.emptyText} />;
   }
 
   const leadingColumns = (props.selection?.mode ?? 'none') !== 'none' ? 1 : 0;

package/src/components/data-display/DataGrid/DataGrid.types.ts

@@ -119,6 +119,11 @@ export interface GridEditing<T = Record<string, unknown>> {
 }
 
 export interface DataGridProps<T = Record<string, unknown>> extends React.HTMLAttributes<HTMLElement> {
+  /**
+   * What an empty result reads as. REQUIRED — the fallback was the English
+   * "No data available", on the package every host renders.
+   */
+  emptyText: string;
   /** Dataset (client mode uses this array; server mode renders current page) */
   rows: T[];
   /** Stable row id accessor */

package/src/components/data-display/DataViews/data-views-category-pill.tsx

@@ -84,6 +84,8 @@ export function PillControl<T extends Record<string, unknown>>({
   }
   return (
     <MultiSelectDropdown
+      extraOptionsHeading={copy.filters.optionsHeading}
+      clearText={copy.filters.clear}
       clearLabel={copy.filters.clearRange(pill.label)}
       label={pill.label}
       options={pill.options}

package/src/components/data-display/DataViews/data-views-copy.ts

@@ -1,4 +1,4 @@
-import type { CategorySelectCopy, ConfirmActionCopy } from "../../../copy";
+import type { CategorySelectCopy, ConfirmActionCopy, TableFilterCopy } from "../../../copy";
 import type { SavedViewsLabels } from "../../layout/ContentToolbar/ContentToolbar.types";
 /**
  * Every word the DataViews family renders, as REQUIRED host config (FUT-760).
@@ -177,6 +177,16 @@ export interface DataViewsFiltersCopy {
    * dates alone — and getting it wrong silently drops or adds a day's rows.
    */
   rangeInclusiveNote: string;
+  /** The FROM half of a range, in the box itself. */
+  rangeStart: string;
+  /**
+   * The day field's mask, which IS its placeholder — so the expected ORDER is
+   * on screen before the first keystroke rather than discovered by getting it
+   * wrong. `dd/mm/aaaa` is one locale's order and one locale's letters.
+   */
+  dayMask: string;
+  /** Drop every applied filter, spelled out in the panel where there is room. */
+  clearAllFilters: string;
   /** The day-range presets' labels, keyed by preset id. */
   rangePresets: Readonly<Record<string, string>>;
   scopesLabel: string;
@@ -197,6 +207,11 @@ export interface DataViewsFiltersCopy {
   allOption: string;
   optionSearchPlaceholder: string;
   optionsEmpty: string;
+  /**
+   * The heading over a dropdown's EXTRA toggles — the section below the option
+   * list, not the list itself. It only appears when a pill supplies extras.
+   */
+  optionsHeading: string;
 }
 
 export interface DataViewsSelectionCopy {
@@ -233,6 +248,10 @@ export interface DataViewsNavCopy {
   updateFailed: string;
   /** The dismiss on that failure's alert — a glyph with no visible label. */
   dismissError: string;
+  /** The filter panel's back arrow — a glyph with no visible label. */
+  goBack: string;
+  /** The label in front of the page-size select. */
+  pageSize: string;
   saveFailed: string;
   /** Reopen the save dialog over an existing view. */
   editView: string;
@@ -267,6 +286,13 @@ export interface DataViewsCopy {
   savedViewsMenu: SavedViewsLabels;
   confirmAction: ConfirmActionCopy;
   categorySelect: CategorySelectCopy;
+  /**
+   * The filter shell's own words. DataViews mounts three of its parts — the
+   * panel, the keyword box and the numeric range field — so all five are on
+   * screen; the range's two ends are `Mínimo`/`Máximo` rather than the day
+   * range's `De`/`Até`, which is why this cannot be derived from `filters`.
+   */
+  tableFilter: TableFilterCopy;
   board: DataViewsBoardCopy;
   deleteView: DeleteViewCopy;
   manageViews: ManageViewsCopy;