@portnet/ui 6.0.0 → 6.0.1

package/dist/esm/v2/components/_ErrorPageBody.js

@@ -0,0 +1,85 @@
+/**
+ * Internal: error-page body block — Portnet UI v2.
+ *
+ * Shared inner block for the v2 error-page family
+ * (ForbiddenPage, NotFoundPage, ServerErrorPage, NetworkErrorPage).
+ * Keeps the four pages visually consistent — icon + monospace code
+ * ornament + h2 title + body description, vertically centred with
+ * the charter spacing scale.
+ *
+ * NOT part of the public surface. The underscore prefix and the
+ * absence of a re-export from components/index.js make this clear.
+ *
+ *   import ErrorPageBody from "./_ErrorPageBody";
+ *
+ * A11y (audit Batch 4 external, finding B4-EXT-1):
+ *   The big HTTP code ("403", "404", "500") is a VISUAL ornament,
+ *   not a heading. It used to be rendered as <h1>, which collided
+ *   with ActionBar's own <h1> on every error page → two <h1>s on
+ *   the same page + the semantic page heading was a non-heading
+ *   <Box>. WCAG 1.3.1 / 2.4.6 violation.
+ *
+ *   Fix: code is now a presentational <div aria-hidden="true">
+ *   (sighted users still see it; AT users skip it). The `title`
+ *   is now a real <h2> so it sits subordinate to ActionBar's <h1>
+ *   in the heading hierarchy. SR users navigating by H key hear
+ *   "Accès refusé" (h1) → "Vous n'avez pas accès…" (h2).
+ */
+import * as React from "react";
+import Box from "@mui/material/Box";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function ErrorPageBody(_ref) {
+  var icon = _ref.icon,
+    code = _ref.code,
+    title = _ref.title,
+    description = _ref.description;
+  return /*#__PURE__*/_jsxs(Box, {
+    sx: {
+      display: "flex",
+      flexDirection: "column",
+      alignItems: "center",
+      justifyContent: "center",
+      textAlign: "center",
+      gap: "var(--s-3)",
+      padding: "var(--s-7) var(--s-5)",
+      minHeight: "60vh"
+    },
+    children: [icon ? /*#__PURE__*/_jsx(Box, {
+      "aria-hidden": "true",
+      sx: {
+        display: "inline-flex"
+      },
+      children: icon
+    }) : null, /*#__PURE__*/_jsx(Box, {
+      "aria-hidden": "true",
+      sx: {
+        fontFamily: "var(--font-mono)",
+        fontSize: "var(--text-display)",
+        fontWeight: "var(--fw-bold)",
+        color: "var(--fg)",
+        margin: 0,
+        letterSpacing: "0.02em"
+      },
+      children: code
+    }), /*#__PURE__*/_jsx(Box, {
+      component: "h2",
+      sx: {
+        fontSize: "var(--text-h2)",
+        fontWeight: "var(--fw-semibold)",
+        color: "var(--fg)",
+        margin: 0,
+        lineHeight: "var(--lh-snug)"
+      },
+      children: title
+    }), description ? /*#__PURE__*/_jsx(Box, {
+      sx: {
+        fontSize: "var(--text-sm)",
+        color: "var(--fg-muted)",
+        maxWidth: "48ch"
+      },
+      children: description
+    }) : null]
+  });
+}
+export default ErrorPageBody;
+//# sourceMappingURL=_ErrorPageBody.js.map

package/dist/esm/v2/components/_ErrorPageBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_ErrorPageBody.js","names":["React","Box","jsx","_jsx","jsxs","_jsxs","ErrorPageBody","_ref","icon","code","title","description","sx","display","flexDirection","alignItems","justifyContent","textAlign","gap","padding","minHeight","children","fontFamily","fontSize","fontWeight","color","margin","letterSpacing","component","lineHeight","maxWidth"],"sources":["../../../../src/lib/v2/components/_ErrorPageBody.tsx"],"sourcesContent":["/**\r\n * Internal: error-page body block — Portnet UI v2.\r\n *\r\n * Shared inner block for the v2 error-page family\r\n * (ForbiddenPage, NotFoundPage, ServerErrorPage, NetworkErrorPage).\r\n * Keeps the four pages visually consistent — icon + monospace code\r\n * ornament + h2 title + body description, vertically centred with\r\n * the charter spacing scale.\r\n *\r\n * NOT part of the public surface. The underscore prefix and the\r\n * absence of a re-export from components/index.js make this clear.\r\n *\r\n *   import ErrorPageBody from \"./_ErrorPageBody\";\r\n *\r\n * A11y (audit Batch 4 external, finding B4-EXT-1):\r\n *   The big HTTP code (\"403\", \"404\", \"500\") is a VISUAL ornament,\r\n *   not a heading. It used to be rendered as <h1>, which collided\r\n *   with ActionBar's own <h1> on every error page → two <h1>s on\r\n *   the same page + the semantic page heading was a non-heading\r\n *   <Box>. WCAG 1.3.1 / 2.4.6 violation.\r\n *\r\n *   Fix: code is now a presentational <div aria-hidden=\"true\">\r\n *   (sighted users still see it; AT users skip it). The `title`\r\n *   is now a real <h2> so it sits subordinate to ActionBar's <h1>\r\n *   in the heading hierarchy. SR users navigating by H key hear\r\n *   \"Accès refusé\" (h1) → \"Vous n'avez pas accès…\" (h2).\r\n */\r\nimport * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\n\r\ninterface ErrorPageBodyProps {\r\n  /** Optional illustrative icon (rendered above the code). */\r\n  icon?: React.ReactNode;\r\n  /**\r\n   * Big monospace HTTP code ornament (e.g. \"403\", \"404\", \"500\", \"—\").\r\n   * Rendered as aria-hidden visual decoration — the page's semantic\r\n   * heading is owned by ActionBar (audit B4-EXT-1).\r\n   */\r\n  code: React.ReactNode;\r\n  /**\r\n   * Sub-heading sentence beneath the code. Rendered as <h2> so it\r\n   * sits below ActionBar's <h1> in the heading hierarchy.\r\n   */\r\n  title: React.ReactNode;\r\n  /** Optional body description paragraph. */\r\n  description?: React.ReactNode;\r\n}\r\n\r\nfunction ErrorPageBody({ icon, code, title, description }: ErrorPageBodyProps) {\r\n  return (\r\n    <Box\r\n      sx={{\r\n        display:        \"flex\",\r\n        flexDirection:  \"column\",\r\n        alignItems:     \"center\",\r\n        justifyContent: \"center\",\r\n        textAlign:      \"center\",\r\n        gap:            \"var(--s-3)\",\r\n        padding:        \"var(--s-7) var(--s-5)\",\r\n        minHeight:      \"60vh\",\r\n      }}\r\n    >\r\n      {icon ? (\r\n        <Box aria-hidden=\"true\" sx={{ display: \"inline-flex\" }}>\r\n          {icon}\r\n        </Box>\r\n      ) : null}\r\n\r\n      {/* B4-EXT-1 — Was <Box component=\"h1\">. The HTTP code is a\r\n          visual ornament; the page's semantic heading is owned by\r\n          ActionBar's <h1>. Hiding the code from AT removes the\r\n          duplicate-h1 and gives SR users a meaningful heading\r\n          hierarchy. */}\r\n      <Box\r\n        aria-hidden=\"true\"\r\n        sx={{\r\n          fontFamily:    \"var(--font-mono)\",\r\n          fontSize:      \"var(--text-display)\",\r\n          fontWeight:    \"var(--fw-bold)\",\r\n          color:         \"var(--fg)\",\r\n          margin:        0,\r\n          letterSpacing: \"0.02em\",\r\n        }}\r\n      >\r\n        {code}\r\n      </Box>\r\n\r\n      {/* B4-EXT-1 — Was a non-semantic <Box>. Promoted to <h2> so\r\n          this descriptive sentence becomes the subordinate heading\r\n          to ActionBar's <h1>. Visual size unchanged (--text-h2). */}\r\n      <Box\r\n        component=\"h2\"\r\n        sx={{\r\n          fontSize:   \"var(--text-h2)\",\r\n          fontWeight: \"var(--fw-semibold)\",\r\n          color:      \"var(--fg)\",\r\n          margin:     0,\r\n          lineHeight: \"var(--lh-snug)\",\r\n        }}\r\n      >\r\n        {title}\r\n      </Box>\r\n\r\n      {description ? (\r\n        <Box\r\n          sx={{\r\n            fontSize: \"var(--text-sm)\",\r\n            color:    \"var(--fg-muted)\",\r\n            maxWidth: \"48ch\",\r\n          }}\r\n        >\r\n          {description}\r\n        </Box>\r\n      ) : null}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default ErrorPageBody;\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,OAAOC,GAAG,MAAM,mBAAmB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAoBpC,SAASC,aAAaA,CAAAC,IAAA,EAAyD;EAAA,IAAtDC,IAAI,GAAAD,IAAA,CAAJC,IAAI;IAAEC,IAAI,GAAAF,IAAA,CAAJE,IAAI;IAAEC,KAAK,GAAAH,IAAA,CAALG,KAAK;IAAEC,WAAW,GAAAJ,IAAA,CAAXI,WAAW;EACrD,oBACEN,KAAA,CAACJ,GAAG;IACFW,EAAE,EAAE;MACFC,OAAO,EAAS,MAAM;MACtBC,aAAa,EAAG,QAAQ;MACxBC,UAAU,EAAM,QAAQ;MACxBC,cAAc,EAAE,QAAQ;MACxBC,SAAS,EAAO,QAAQ;MACxBC,GAAG,EAAa,YAAY;MAC5BC,OAAO,EAAS,uBAAuB;MACvCC,SAAS,EAAO;IAClB,CAAE;IAAAC,QAAA,GAEDb,IAAI,gBACHL,IAAA,CAACF,GAAG;MAAC,eAAY,MAAM;MAACW,EAAE,EAAE;QAAEC,OAAO,EAAE;MAAc,CAAE;MAAAQ,QAAA,EACpDb;IAAI,CACF,CAAC,GACJ,IAAI,eAORL,IAAA,CAACF,GAAG;MACF,eAAY,MAAM;MAClBW,EAAE,EAAE;QACFU,UAAU,EAAK,kBAAkB;QACjCC,QAAQ,EAAO,qBAAqB;QACpCC,UAAU,EAAK,gBAAgB;QAC/BC,KAAK,EAAU,WAAW;QAC1BC,MAAM,EAAS,CAAC;QAChBC,aAAa,EAAE;MACjB,CAAE;MAAAN,QAAA,EAEDZ;IAAI,CACF,CAAC,eAKNN,IAAA,CAACF,GAAG;MACF2B,SAAS,EAAC,IAAI;MACdhB,EAAE,EAAE;QACFW,QAAQ,EAAI,gBAAgB;QAC5BC,UAAU,EAAE,oBAAoB;QAChCC,KAAK,EAAO,WAAW;QACvBC,MAAM,EAAM,CAAC;QACbG,UAAU,EAAE;MACd,CAAE;MAAAR,QAAA,EAEDX;IAAK,CACH,CAAC,EAELC,WAAW,gBACVR,IAAA,CAACF,GAAG;MACFW,EAAE,EAAE;QACFW,QAAQ,EAAE,gBAAgB;QAC1BE,KAAK,EAAK,iBAAiB;QAC3BK,QAAQ,EAAE;MACZ,CAAE;MAAAT,QAAA,EAEDV;IAAW,CACT,CAAC,GACJ,IAAI;EAAA,CACL,CAAC;AAEV;AAEA,eAAeL,aAAa","ignoreList":[]}

package/dist/esm/v2/components/_pickerShared.js

@@ -0,0 +1,60 @@
+/**
+ * _pickerShared — Portnet UI v2 (private)
+ *
+ * Internal sibling module. Not part of the public surface — leading
+ * underscore is the convention. Hosts MUST NOT deep-import from this
+ * file.
+ *
+ * Houses the Date ↔ moment boundary helpers shared between DatePicker,
+ * DateTimePicker, TimePicker, and DateRangePicker. Each picker stays
+ * a thin wrapper around a MUI X picker but uses these helpers to
+ * coerce values at the React/MUI boundary.
+ *
+ * Contract: NEVER expose an Invalid Date instance. Either a valid
+ * value or null. Hosts that consume v2 picker onChange always get a
+ * usable value — no defensive `if (Number.isNaN(d.getTime()))` checks
+ * scattered across consumer code.
+ */
+
+import moment from "moment";
+/**
+ * Coerce any incoming value to a valid moment instance, or null.
+ *
+ * Handles:
+ *   - null / undefined          → null
+ *   - moment instance           → returned if valid, null otherwise
+ *   - Date instance             → wrapped in moment(); valid → returned
+ *   - any other (string, number) → moment() coerced; valid → returned
+ *
+ * The "valid" check uses moment.isValid(), which catches Invalid Date
+ * (NaN getTime), out-of-range values, and malformed strings.
+ */
+export function dateToMoment(d) {
+  if (d == null) return null;
+  if (moment.isMoment(d)) return d.isValid() ? d : null;
+  var m = moment(d);
+  return m.isValid() ? m : null;
+}
+
+/**
+ * Coerce any incoming value to a valid Date instance, or null.
+ *
+ * Handles:
+ *   - null / undefined          → null
+ *   - moment instance           → toDate() if valid, null otherwise
+ *   - Date instance             → returned if finite, null otherwise
+ *   - any other (string, number) → new Date() coerced; finite → returned
+ *
+ * The "finite" check on Date uses Number.isFinite(d.getTime()), which
+ * catches Invalid Date (NaN), since NaN is not finite.
+ */
+export function momentToDate(m) {
+  if (m == null) return null;
+  if (!moment.isMoment(m)) {
+    if (m instanceof Date) return Number.isFinite(m.getTime()) ? m : null;
+    var d = new Date(m);
+    return Number.isFinite(d.getTime()) ? d : null;
+  }
+  return m.isValid() ? m.toDate() : null;
+}
+//# sourceMappingURL=_pickerShared.js.map

package/dist/esm/v2/components/_pickerShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_pickerShared.js","names":["moment","dateToMoment","d","isMoment","isValid","m","momentToDate","Date","Number","isFinite","getTime","toDate"],"sources":["../../../../src/lib/v2/components/_pickerShared.ts"],"sourcesContent":["/**\r\n * _pickerShared — Portnet UI v2 (private)\r\n *\r\n * Internal sibling module. Not part of the public surface — leading\r\n * underscore is the convention. Hosts MUST NOT deep-import from this\r\n * file.\r\n *\r\n * Houses the Date ↔ moment boundary helpers shared between DatePicker,\r\n * DateTimePicker, TimePicker, and DateRangePicker. Each picker stays\r\n * a thin wrapper around a MUI X picker but uses these helpers to\r\n * coerce values at the React/MUI boundary.\r\n *\r\n * Contract: NEVER expose an Invalid Date instance. Either a valid\r\n * value or null. Hosts that consume v2 picker onChange always get a\r\n * usable value — no defensive `if (Number.isNaN(d.getTime()))` checks\r\n * scattered across consumer code.\r\n */\r\n\r\nimport moment from \"moment\";\r\n\r\ntype PickerValueInput = moment.Moment | Date | string | number | null | undefined;\r\n\r\n/**\r\n * Coerce any incoming value to a valid moment instance, or null.\r\n *\r\n * Handles:\r\n *   - null / undefined          → null\r\n *   - moment instance           → returned if valid, null otherwise\r\n *   - Date instance             → wrapped in moment(); valid → returned\r\n *   - any other (string, number) → moment() coerced; valid → returned\r\n *\r\n * The \"valid\" check uses moment.isValid(), which catches Invalid Date\r\n * (NaN getTime), out-of-range values, and malformed strings.\r\n */\r\nexport function dateToMoment(d: PickerValueInput): moment.Moment | null {\r\n  if (d == null) return null;\r\n  if (moment.isMoment(d)) return d.isValid() ? d : null;\r\n  const m = moment(d);\r\n  return m.isValid() ? m : null;\r\n}\r\n\r\n/**\r\n * Coerce any incoming value to a valid Date instance, or null.\r\n *\r\n * Handles:\r\n *   - null / undefined          → null\r\n *   - moment instance           → toDate() if valid, null otherwise\r\n *   - Date instance             → returned if finite, null otherwise\r\n *   - any other (string, number) → new Date() coerced; finite → returned\r\n *\r\n * The \"finite\" check on Date uses Number.isFinite(d.getTime()), which\r\n * catches Invalid Date (NaN), since NaN is not finite.\r\n */\r\nexport function momentToDate(m: PickerValueInput): Date | null {\r\n  if (m == null) return null;\r\n  if (!moment.isMoment(m)) {\r\n    if (m instanceof Date) return Number.isFinite(m.getTime()) ? m : null;\r\n    const d = new Date(m);\r\n    return Number.isFinite(d.getTime()) ? d : null;\r\n  }\r\n  return m.isValid() ? m.toDate() : null;\r\n}\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,MAAM,MAAM,QAAQ;AAI3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,CAAmB,EAAwB;EACtE,IAAIA,CAAC,IAAI,IAAI,EAAE,OAAO,IAAI;EAC1B,IAAIF,MAAM,CAACG,QAAQ,CAACD,CAAC,CAAC,EAAE,OAAOA,CAAC,CAACE,OAAO,CAAC,CAAC,GAAGF,CAAC,GAAG,IAAI;EACrD,IAAMG,CAAC,GAAGL,MAAM,CAACE,CAAC,CAAC;EACnB,OAAOG,CAAC,CAACD,OAAO,CAAC,CAAC,GAAGC,CAAC,GAAG,IAAI;AAC/B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACD,CAAmB,EAAe;EAC7D,IAAIA,CAAC,IAAI,IAAI,EAAE,OAAO,IAAI;EAC1B,IAAI,CAACL,MAAM,CAACG,QAAQ,CAACE,CAAC,CAAC,EAAE;IACvB,IAAIA,CAAC,YAAYE,IAAI,EAAE,OAAOC,MAAM,CAACC,QAAQ,CAACJ,CAAC,CAACK,OAAO,CAAC,CAAC,CAAC,GAAGL,CAAC,GAAG,IAAI;IACrE,IAAMH,CAAC,GAAG,IAAIK,IAAI,CAACF,CAAC,CAAC;IACrB,OAAOG,MAAM,CAACC,QAAQ,CAACP,CAAC,CAACQ,OAAO,CAAC,CAAC,CAAC,GAAGR,CAAC,GAAG,IAAI;EAChD;EACA,OAAOG,CAAC,CAACD,OAAO,CAAC,CAAC,GAAGC,CAAC,CAACM,MAAM,CAAC,CAAC,GAAG,IAAI;AACxC","ignoreList":[]}

package/dist/esm/v2/components/index.js

@@ -0,0 +1,244 @@
+export { default as Spinner } from "./Spinner";
+export { default as Button } from "./Button";
+export { default as Field } from "./Field";
+/**
+ * FieldError — the message renderer `Field` uses, exported standalone
+ * (capability gap G-18).
+ *
+ * Charter R-4.1 MUST requires a field error to carry an ICON; `Field` rendered a
+ * bare red helper text without one, so the canonical field wrapper missed a MUST
+ * on every form of every module. And a LIST-level error (a Formik array, an
+ * upload slot) has no single control to wrap in a `Field` at all — addpe-fe's
+ * local `InlineFieldAlert` reimplemented the recipe and was, ironically, more
+ * charter-compliant than the shared component it could not reuse.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as FieldError } from "./FieldError";
+export { default as Input } from "./Input";
+export { default as Select } from "./Select";
+export { default as Textarea } from "./Textarea";
+export { default as Checkbox, CheckboxGroup } from "./Checkbox";
+export { default as Radio, RadioGroup } from "./Radio";
+export { default as Switch } from "./Switch";
+export { default as Combobox } from "./Combobox";
+export { default as TelInput } from "./TelInput";
+export { default as NumberInput, FR_DECIMAL_SEPARATOR, FR_THOUSAND_SEPARATOR } from "./NumberInput";
+export { default as DatePicker, DATE_FORMAT_CHARTER } from "./DatePicker";
+export { default as DateTimePicker, DATETIME_FORMAT_CHARTER } from "./DateTimePicker";
+export { default as TimePicker, TIME_FORMAT_CHARTER } from "./TimePicker";
+export { default as DateRangePicker } from "./DateRangePicker";
+export { default as Status } from "./Status";
+/**
+ * Status contracts — public typed surface (capability gap G-31).
+ *
+ * Same defect as the `StepStatus` and `FieldHelp` blocks below: `Status` was
+ * exported as a VALUE while the types describing it were not re-exported here,
+ * so a host mapping its own business codes onto the six canonical workflow
+ * tones had to hand-write the union at the call site — which the Platform
+ * TypeScript Guidelines forbid ("Reusable types belong inside Shared UI
+ * Library … Never duplicate"). caution-ui carried exactly that local twin
+ * (`CautionStatusKind`, six members, structurally identical) plus five
+ * `as ComponentProps<typeof Status>` assertions at the render sites — casts
+ * that were never needed for anything except reaching an unreachable type.
+ *
+ * `StatusProps` travels with it: a consumer building the chip props as an
+ * object (mobile card, KV value slot, DataGrid cell renderer) needs the prop
+ * contract, and re-declaring it is the same duplication one level down.
+ *
+ * KNOWN DEBT: `StatusKind` is currently derived as
+ * `keyof typeof STATUS_LABELS_FR`, and STATUS_LABELS_FR is itself marked
+ * `@deprecated … Will be removed in v0.3` (we are at 0.8.0). Deleting that
+ * const would delete the public type with it. Re-anchoring `StatusKind` to a
+ * literal tuple form of STATUS_KEYS — which is typed `readonly string[]` and
+ * so cannot currently derive a union — is tracked separately; surfacing the
+ * type now does not deepen that debt, it only makes it visible to consumers.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts: not added to
+ * ./v2/index.ts, which is a retiring surface. Reachable as
+ * `import type { StatusKind } from "@portnet/ui"` via the root star-export.
+ *
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+
+export { default as Chip } from "./Chip";
+export { default as Skeleton, SkeletonKPI, SkeletonRow, SkeletonDetailHero, SkeletonTabContent, SkeletonText } from "./Skeleton";
+export { default as Modal } from "./Modal";
+export { default as Drawer } from "./Drawer";
+export { default as ConfirmDialog } from "./ConfirmDialog";
+export { default as Tabs } from "./Tabs";
+export { default as HStepper, VStepper } from "./Stepper";
+/**
+ * Stepper data contracts — public typed surface.
+ *
+ * `StepStatus` is the literal union `HStepper`/`VStepper` accept on each
+ * step. It was exported from ./Stepper but never re-exported here, so a host
+ * building a step array had to hand-write the union at the call site — which
+ * the Platform TypeScript Guidelines forbid ("Reusable types belong inside
+ * Shared UI Library … Never duplicate"). ms_licenceexportation's
+ * ExportationDetailProgress carried exactly that duplicate, with a comment
+ * recording why. `VStepperItem` is surfaced alongside it because the same
+ * consumer constructs the item objects the union lives in.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts: not added to
+ * ./v2/index.ts, which is a retiring surface. Reachable as
+ * `import type { StepStatus } from "@portnet/ui"` via the root star-export.
+ *
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+
+export { default as FilterTab } from "./FilterTab";
+export { default as EmptyState } from "./EmptyState";
+export { default as Banner } from "./Banner";
+/**
+ * SectionErrorBoundary — fault tolerance by import, not by copy (gap G-30).
+ *
+ * ISO/IEC 25010 § Reliability requires a system to keep operating despite a
+ * fault; React unmounts the WHOLE tree on a render exception, so one failing
+ * section replaces the page with a blank screen. `ms-ti-fe` wrapped 13 sections
+ * in a boundary of its own while `addpe-fe` and this library had none — a
+ * platform guarantee living as one module's private safeguard.
+ *
+ * Declared after Banner because it renders one as its fallback.
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as SectionErrorBoundary } from "./SectionErrorBoundary";
+export { default as ToastProvider, useToast } from "./Toast";
+export { default as KV } from "./KV";
+export { default as KPICard } from "./KPICard";
+/**
+ * KPIStrip — the metric-tile row (capability gap G-11).
+ *
+ * Charter §07 names this zone in the canonical page template (« ③ FILTERS / KPI
+ * STRIP ») but the library shipped only the TILE. So every screen wrote the
+ * grid, and the two in addpe-fe disagree on the desktop ladder — a KPI row that
+ * reflows differently per screen for no reason a user could name.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as KPIStrip } from "./KPIStrip";
+export { default as MobileRowCard } from "./MobileRowCard";
+export { default as OverflowMenu } from "./OverflowMenu";
+export { default as FieldHelp } from "./FieldHelp";
+/**
+ * FieldHelp contracts — public typed surface (capability gap G-16).
+ *
+ * Same defect as the `StepStatus` block above: `FieldHelp` was exported as a
+ * VALUE while the types describing what it accepts were not re-exported here,
+ * so a host maintaining a help-copy dictionary had to hand-declare the entry
+ * shape — which the Platform TypeScript Guidelines forbid ("Reusable types
+ * belong inside Shared UI Library … Never duplicate"). addpe-fe's `HELP_TEXTS`
+ * carries exactly that local twin (`HelpTextEntry`), with a comment recording
+ * that `FieldHelpProps` was unreachable.
+ *
+ * `FieldHelpVariant` / `FieldHelpIcon` travel with it: a dictionary that sets
+ * `variant` per entry needs the union, and re-declaring `"tooltip" | "popover"`
+ * at the call site is the same duplication one level down.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+
+export { default as SkipLink } from "./SkipLink";
+export { default as ProgressBar } from "./ProgressBar";
+export { default as Segmented } from "./Segmented";
+export { default as Dropzone } from "./Dropzone";
+export { default as CommandPalette } from "./CommandPalette";
+
+// Loading-overlay primitives (Charter §04.4). See ./Busy.js.
+// Replaces the PAGE_OVERLAY_SX inline block that host modules
+// previously froze in 15+ feature pages.
+export { default as SectionBusy, PageBusy } from "./Busy";
+
+// Layout primitives (Charter §03). Replace local FormGrid / KVGrid
+// wrappers that host modules previously inlined.
+export { default as FormGrid } from "./FormGrid";
+export { default as KVGrid } from "./KVGrid";
+
+/**
+ * Surface — the bare card container (capability gap G-10).
+ *
+ * The card recipe (--surface + --border + -r-lg + --shadow-*) existed only
+ * WELDED INSIDE FormSection, which also imposes a numbered heading and an inner
+ * FormGrid. A consumer needing just the container — a DataGrid shell, a hero
+ * card, a sticky side rail, a nested file row — could not reach it and rewrote
+ * the recipe: three copies in addpe-fe plus a document card repeated across
+ * three files, each having picked its own elevation and radius from memory.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as Surface } from "./Surface";
+/**
+ * FileCard — an attached document, displayed (capability gap G-12).
+ *
+ * The library shipped `Dropzone`, the UPLOAD affordance, and nothing for the
+ * state immediately after it. So every screen showing an attachment rebuilt the
+ * same row: three copies in addpe-fe, with THREE different paddings for one
+ * concept — accidental drift, exactly what R-2.1 forbids. Composes `Surface`.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as FileCard } from "./FileCard";
+// Generic flex container + stack shorthand (B17). Drop-in
+// replacement for the common MUI Box/Stack usage pattern when no
+// breakpoint variation is required. See ./Layout.js.
+export { Box, Stack } from "./Layout";
+
+// Section-header primitive (Charter §03). Standalone heading row;
+// see SectionHeader.js for how it differs from FormSection.
+export { default as SectionHeader } from "./SectionHeader";
+
+// Disclosure primitives (Charter §03). Accordion uses native
+// <details>/<summary>; Tooltip wraps MuiTooltip with token theming
+// and aria-label mirroring for icon-only triggers.
+export { default as Accordion } from "./Accordion";
+export { default as Tooltip } from "./Tooltip";
+
+// Footer action strip (Charter §03). Distinct from ActionBar
+// (page header) and BulkActionBar (selection toolbar).
+export { default as ActionStrip } from "./ActionStrip";
+
+// Taxonomy chip — reuses the 6-tone status palette but distinct
+// from v2.Status (category != workflow state).
+export { default as CategoryTag } from "./CategoryTag";
+
+// Favorite toggle (☆/★) — presentational, controlled leaf primitive
+// used by the User Personalization Foundation's favorites capability
+// (v2/personalization). Provider-free: wire with useIsFavorite /
+// useFavorites, or drive manually via pressed/onChange.
+export { default as FavoriteToggle } from "./FavoriteToggle";
+
+// Document viewer (Charter §07). Presentational pdf.js wrapper; the host
+// owns fetching (fileUrl|base64 + loading/error + workerUrl). Pulls the
+// @react-pdf-viewer / pdfjs-dist OPTIONAL peer deps — installed only by
+// PDF-consuming modules.
+export { default as PdfViewer } from "./PdfViewer";
+// Error pages — Charter §07. Router-agnostic; the lib accepts
+// onBack / onHome / onRetry callback props rather than importing
+// any router hook. NB: the internal _ErrorPageBody helper is NOT
+// re-exported (underscore-prefix convention).
+export { default as ForbiddenPage } from "./ForbiddenPage";
+export { default as NotFoundPage } from "./NotFoundPage";
+export { default as ServerErrorPage } from "./ServerErrorPage";
+export { default as NetworkErrorPage } from "./NetworkErrorPage";
+/**
+ * Error-page prop contracts — public typed surface (capability gap G-32).
+ *
+ * The four pages are deliberately router-agnostic: they take `onBack` /
+ * `onHome` / `onRetry` callbacks instead of importing a router hook. That
+ * design REQUIRES every consumer to write a thin adapter binding its own
+ * router to those callbacks — and each adapter needs the prop type to declare
+ * what it is producing. The types existed on each module but were not
+ * re-exported here, so the adapters could not reach them: caution-ui's
+ * ErrorPages.tsx carried four
+ * `as React.ComponentProps<typeof V2ForbiddenPage>` assertions for no reason
+ * other than that `ForbiddenPageProps` was unreachable.
+ *
+ * A router adapter is the single most-repeated consumer of these components
+ * across the fleet — one per module — so leaving the contract unreachable
+ * guaranteed the same four casts in every repository.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+//# sourceMappingURL=index.js.map

package/dist/esm/v2/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["default","Spinner","Button","Field","FieldError","Input","Select","Textarea","Checkbox","CheckboxGroup","Radio","RadioGroup","Switch","Combobox","TelInput","NumberInput","FR_DECIMAL_SEPARATOR","FR_THOUSAND_SEPARATOR","DatePicker","DATE_FORMAT_CHARTER","DateTimePicker","DATETIME_FORMAT_CHARTER","TimePicker","TIME_FORMAT_CHARTER","DateRangePicker","Status","Chip","Skeleton","SkeletonKPI","SkeletonRow","SkeletonDetailHero","SkeletonTabContent","SkeletonText","Modal","Drawer","ConfirmDialog","Tabs","HStepper","VStepper","FilterTab","EmptyState","Banner","SectionErrorBoundary","ToastProvider","useToast","KV","KPICard","KPIStrip","MobileRowCard","OverflowMenu","FieldHelp","SkipLink","ProgressBar","Segmented","Dropzone","CommandPalette","SectionBusy","PageBusy","FormGrid","KVGrid","Surface","FileCard","Box","Stack","SectionHeader","Accordion","Tooltip","ActionStrip","CategoryTag","FavoriteToggle","PdfViewer","ForbiddenPage","NotFoundPage","ServerErrorPage","NetworkErrorPage"],"sources":["../../../../src/lib/v2/components/index.ts"],"sourcesContent":["export { default as Spinner }       from \"./Spinner\";\r\nexport { default as Button }        from \"./Button\";\r\nexport { default as Field }         from \"./Field\";\r\n/**\r\n * FieldError — the message renderer `Field` uses, exported standalone\r\n * (capability gap G-18).\r\n *\r\n * Charter R-4.1 MUST requires a field error to carry an ICON; `Field` rendered a\r\n * bare red helper text without one, so the canonical field wrapper missed a MUST\r\n * on every form of every module. And a LIST-level error (a Formik array, an\r\n * upload slot) has no single control to wrap in a `Field` at all — addpe-fe's\r\n * local `InlineFieldAlert` reimplemented the recipe and was, ironically, more\r\n * charter-compliant than the shared component it could not reuse.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n */\r\nexport { default as FieldError }    from \"./FieldError\";\r\nexport type { FieldErrorProps } from \"./FieldError\";\r\nexport { default as Input }         from \"./Input\";\r\nexport { default as Select }        from \"./Select\";\r\nexport type { SelectOption, SelectOptionObject, SelectOptionValue, SelectValue, SelectChangeLike, SelectLabels } from \"./Select\";\r\nexport { default as Textarea }      from \"./Textarea\";\r\nexport { default as Checkbox, CheckboxGroup } from \"./Checkbox\";\r\nexport { default as Radio, RadioGroup } from \"./Radio\";\r\nexport { default as Switch }        from \"./Switch\";\r\nexport { default as Combobox }      from \"./Combobox\";\r\nexport type { ComboboxOption, ComboboxOptionValue, ComboboxValue, ComboboxLabels, ComboboxProps } from \"./Combobox\";\r\nexport { default as TelInput }      from \"./TelInput\";\r\nexport {\r\n  default as NumberInput,\r\n  FR_DECIMAL_SEPARATOR,\r\n  FR_THOUSAND_SEPARATOR,\r\n} from \"./NumberInput\";\r\nexport {\r\n  default as DatePicker,\r\n  DATE_FORMAT_CHARTER,\r\n} from \"./DatePicker\";\r\nexport {\r\n  default as DateTimePicker,\r\n  DATETIME_FORMAT_CHARTER,\r\n} from \"./DateTimePicker\";\r\nexport {\r\n  default as TimePicker,\r\n  TIME_FORMAT_CHARTER,\r\n} from \"./TimePicker\";\r\nexport { default as DateRangePicker } from \"./DateRangePicker\";\r\nexport { default as Status }        from \"./Status\";\r\n/**\r\n * Status contracts — public typed surface (capability gap G-31).\r\n *\r\n * Same defect as the `StepStatus` and `FieldHelp` blocks below: `Status` was\r\n * exported as a VALUE while the types describing it were not re-exported here,\r\n * so a host mapping its own business codes onto the six canonical workflow\r\n * tones had to hand-write the union at the call site — which the Platform\r\n * TypeScript Guidelines forbid (\"Reusable types belong inside Shared UI\r\n * Library … Never duplicate\"). caution-ui carried exactly that local twin\r\n * (`CautionStatusKind`, six members, structurally identical) plus five\r\n * `as ComponentProps<typeof Status>` assertions at the render sites — casts\r\n * that were never needed for anything except reaching an unreachable type.\r\n *\r\n * `StatusProps` travels with it: a consumer building the chip props as an\r\n * object (mobile card, KV value slot, DataGrid cell renderer) needs the prop\r\n * contract, and re-declaring it is the same duplication one level down.\r\n *\r\n * KNOWN DEBT: `StatusKind` is currently derived as\r\n * `keyof typeof STATUS_LABELS_FR`, and STATUS_LABELS_FR is itself marked\r\n * `@deprecated … Will be removed in v0.3` (we are at 0.8.0). Deleting that\r\n * const would delete the public type with it. Re-anchoring `StatusKind` to a\r\n * literal tuple form of STATUS_KEYS — which is typed `readonly string[]` and\r\n * so cannot currently derive a union — is tracked separately; surfacing the\r\n * type now does not deepen that debt, it only makes it visible to consumers.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts: not added to\r\n * ./v2/index.ts, which is a retiring surface. Reachable as\r\n * `import type { StatusKind } from \"@portnet/ui\"` via the root star-export.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type { StatusKind, StatusProps } from \"./Status\";\r\nexport { default as Chip }          from \"./Chip\";\r\nexport {\r\n  default as Skeleton,\r\n  SkeletonKPI,\r\n  SkeletonRow,\r\n  SkeletonDetailHero,\r\n  SkeletonTabContent,\r\n  SkeletonText,\r\n} from \"./Skeleton\";\r\nexport { default as Modal }         from \"./Modal\";\r\nexport { default as Drawer }        from \"./Drawer\";\r\nexport type { DrawerProps, DrawerLabels, DrawerAnchor } from \"./Drawer\";\r\nexport { default as ConfirmDialog } from \"./ConfirmDialog\";\r\nexport { default as Tabs }          from \"./Tabs\";\r\nexport { default as HStepper, VStepper } from \"./Stepper\";\r\n/**\r\n * Stepper data contracts — public typed surface.\r\n *\r\n * `StepStatus` is the literal union `HStepper`/`VStepper` accept on each\r\n * step. It was exported from ./Stepper but never re-exported here, so a host\r\n * building a step array had to hand-write the union at the call site — which\r\n * the Platform TypeScript Guidelines forbid (\"Reusable types belong inside\r\n * Shared UI Library … Never duplicate\"). ms_licenceexportation's\r\n * ExportationDetailProgress carried exactly that duplicate, with a comment\r\n * recording why. `VStepperItem` is surfaced alongside it because the same\r\n * consumer constructs the item objects the union lives in.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts: not added to\r\n * ./v2/index.ts, which is a retiring surface. Reachable as\r\n * `import type { StepStatus } from \"@portnet/ui\"` via the root star-export.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type { StepStatus, StepState, VStepperItem } from \"./Stepper\";\r\nexport { default as FilterTab }     from \"./FilterTab\";\r\nexport type { FilterTabVariant, FilterTabLabels } from \"./FilterTab\";\r\nexport { default as EmptyState }    from \"./EmptyState\";\r\nexport { default as Banner }        from \"./Banner\";\r\nexport type { BannerVariant, BannerAction } from \"./Banner\";\r\n/**\r\n * SectionErrorBoundary — fault tolerance by import, not by copy (gap G-30).\r\n *\r\n * ISO/IEC 25010 § Reliability requires a system to keep operating despite a\r\n * fault; React unmounts the WHOLE tree on a render exception, so one failing\r\n * section replaces the page with a blank screen. `ms-ti-fe` wrapped 13 sections\r\n * in a boundary of its own while `addpe-fe` and this library had none — a\r\n * platform guarantee living as one module's private safeguard.\r\n *\r\n * Declared after Banner because it renders one as its fallback.\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n */\r\nexport { default as SectionErrorBoundary } from \"./SectionErrorBoundary\";\r\nexport type { SectionErrorBoundaryProps } from \"./SectionErrorBoundary\";\r\nexport { default as ToastProvider, useToast } from \"./Toast\";\r\nexport type { ToastVariant, ToastProviderLabels, ToastUndoOptions, ToastProgressHandle, ToastApi } from \"./Toast\";\r\nexport { default as KV }            from \"./KV\";\r\nexport { default as KPICard }       from \"./KPICard\";\r\nexport type { KPICardProps, KPICardLabels } from \"./KPICard\";\r\n/**\r\n * KPIStrip — the metric-tile row (capability gap G-11).\r\n *\r\n * Charter §07 names this zone in the canonical page template (« ③ FILTERS / KPI\r\n * STRIP ») but the library shipped only the TILE. So every screen wrote the\r\n * grid, and the two in addpe-fe disagree on the desktop ladder — a KPI row that\r\n * reflows differently per screen for no reason a user could name.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n */\r\nexport { default as KPIStrip }      from \"./KPIStrip\";\r\nexport type { KPIStripProps } from \"./KPIStrip\";\r\nexport { default as MobileRowCard } from \"./MobileRowCard\";\r\nexport type { MobileRowCardProps } from \"./MobileRowCard\";\r\nexport { default as OverflowMenu }  from \"./OverflowMenu\";\r\nexport type { OverflowMenuAction, OverflowMenuProps, OverflowMenuLabels } from \"./OverflowMenu\";\r\nexport { default as FieldHelp }     from \"./FieldHelp\";\r\n/**\r\n * FieldHelp contracts — public typed surface (capability gap G-16).\r\n *\r\n * Same defect as the `StepStatus` block above: `FieldHelp` was exported as a\r\n * VALUE while the types describing what it accepts were not re-exported here,\r\n * so a host maintaining a help-copy dictionary had to hand-declare the entry\r\n * shape — which the Platform TypeScript Guidelines forbid (\"Reusable types\r\n * belong inside Shared UI Library … Never duplicate\"). addpe-fe's `HELP_TEXTS`\r\n * carries exactly that local twin (`HelpTextEntry`), with a comment recording\r\n * that `FieldHelpProps` was unreachable.\r\n *\r\n * `FieldHelpVariant` / `FieldHelpIcon` travel with it: a dictionary that sets\r\n * `variant` per entry needs the union, and re-declaring `\"tooltip\" | \"popover\"`\r\n * at the call site is the same duplication one level down.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type { FieldHelpProps, FieldHelpVariant, FieldHelpIcon } from \"./FieldHelp\";\r\nexport { default as SkipLink }      from \"./SkipLink\";\r\nexport { default as ProgressBar }    from \"./ProgressBar\";\r\nexport { default as Segmented }      from \"./Segmented\";\r\nexport { default as Dropzone }       from \"./Dropzone\";\r\nexport type {\r\n  DropzoneProps,\r\n  DropzoneFile,\r\n  DropzoneFileStatus,\r\n  DropzoneRejection,\r\n  DropzoneRejectReason,\r\n  DropzoneReasons,\r\n  DropzoneLabels,\r\n} from \"./Dropzone\";\r\nexport { default as CommandPalette } from \"./CommandPalette\";\r\n\r\n// Loading-overlay primitives (Charter §04.4). See ./Busy.js.\r\n// Replaces the PAGE_OVERLAY_SX inline block that host modules\r\n// previously froze in 15+ feature pages.\r\nexport { default as SectionBusy, PageBusy } from \"./Busy\";\r\n\r\n// Layout primitives (Charter §03). Replace local FormGrid / KVGrid\r\n// wrappers that host modules previously inlined.\r\nexport { default as FormGrid }      from \"./FormGrid\";\r\nexport { default as KVGrid }        from \"./KVGrid\";\r\n\r\n/**\r\n * Surface — the bare card container (capability gap G-10).\r\n *\r\n * The card recipe (--surface + --border + -r-lg + --shadow-*) existed only\r\n * WELDED INSIDE FormSection, which also imposes a numbered heading and an inner\r\n * FormGrid. A consumer needing just the container — a DataGrid shell, a hero\r\n * card, a sticky side rail, a nested file row — could not reach it and rewrote\r\n * the recipe: three copies in addpe-fe plus a document card repeated across\r\n * three files, each having picked its own elevation and radius from memory.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n */\r\nexport { default as Surface }       from \"./Surface\";\r\nexport type {\r\n  SurfaceProps,\r\n  SurfaceTone,\r\n  SurfaceElevation,\r\n  SurfaceRadius,\r\n  SurfacePadding,\r\n} from \"./Surface\";\r\n\r\n/**\r\n * FileCard — an attached document, displayed (capability gap G-12).\r\n *\r\n * The library shipped `Dropzone`, the UPLOAD affordance, and nothing for the\r\n * state immediately after it. So every screen showing an attachment rebuilt the\r\n * same row: three copies in addpe-fe, with THREE different paddings for one\r\n * concept — accidental drift, exactly what R-2.1 forbids. Composes `Surface`.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n */\r\nexport { default as FileCard }      from \"./FileCard\";\r\nexport type { FileCardProps } from \"./FileCard\";\r\n\r\n// Generic flex container + stack shorthand (B17). Drop-in\r\n// replacement for the common MUI Box/Stack usage pattern when no\r\n// breakpoint variation is required. See ./Layout.js.\r\nexport { Box, Stack }               from \"./Layout\";\r\n\r\n// Section-header primitive (Charter §03). Standalone heading row;\r\n// see SectionHeader.js for how it differs from FormSection.\r\nexport { default as SectionHeader } from \"./SectionHeader\";\r\n\r\n// Disclosure primitives (Charter §03). Accordion uses native\r\n// <details>/<summary>; Tooltip wraps MuiTooltip with token theming\r\n// and aria-label mirroring for icon-only triggers.\r\nexport { default as Accordion }     from \"./Accordion\";\r\nexport { default as Tooltip }       from \"./Tooltip\";\r\n\r\n// Footer action strip (Charter §03). Distinct from ActionBar\r\n// (page header) and BulkActionBar (selection toolbar).\r\nexport { default as ActionStrip }   from \"./ActionStrip\";\r\n\r\n// Taxonomy chip — reuses the 6-tone status palette but distinct\r\n// from v2.Status (category != workflow state).\r\nexport { default as CategoryTag }   from \"./CategoryTag\";\r\n\r\n// Favorite toggle (☆/★) — presentational, controlled leaf primitive\r\n// used by the User Personalization Foundation's favorites capability\r\n// (v2/personalization). Provider-free: wire with useIsFavorite /\r\n// useFavorites, or drive manually via pressed/onChange.\r\nexport { default as FavoriteToggle } from \"./FavoriteToggle\";\r\n\r\n// Document viewer (Charter §07). Presentational pdf.js wrapper; the host\r\n// owns fetching (fileUrl|base64 + loading/error + workerUrl). Pulls the\r\n// @react-pdf-viewer / pdfjs-dist OPTIONAL peer deps — installed only by\r\n// PDF-consuming modules.\r\nexport { default as PdfViewer }     from \"./PdfViewer\";\r\nexport type { PdfViewerProps } from \"./PdfViewer\";\r\n\r\n// Error pages — Charter §07. Router-agnostic; the lib accepts\r\n// onBack / onHome / onRetry callback props rather than importing\r\n// any router hook. NB: the internal _ErrorPageBody helper is NOT\r\n// re-exported (underscore-prefix convention).\r\nexport { default as ForbiddenPage }    from \"./ForbiddenPage\";\r\nexport { default as NotFoundPage }     from \"./NotFoundPage\";\r\nexport { default as ServerErrorPage }  from \"./ServerErrorPage\";\r\nexport { default as NetworkErrorPage } from \"./NetworkErrorPage\";\r\n/**\r\n * Error-page prop contracts — public typed surface (capability gap G-32).\r\n *\r\n * The four pages are deliberately router-agnostic: they take `onBack` /\r\n * `onHome` / `onRetry` callbacks instead of importing a router hook. That\r\n * design REQUIRES every consumer to write a thin adapter binding its own\r\n * router to those callbacks — and each adapter needs the prop type to declare\r\n * what it is producing. The types existed on each module but were not\r\n * re-exported here, so the adapters could not reach them: caution-ui's\r\n * ErrorPages.tsx carried four\r\n * `as React.ComponentProps<typeof V2ForbiddenPage>` assertions for no reason\r\n * other than that `ForbiddenPageProps` was unreachable.\r\n *\r\n * A router adapter is the single most-repeated consumer of these components\r\n * across the fleet — one per module — so leaving the contract unreachable\r\n * guaranteed the same four casts in every repository.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type { ForbiddenPageProps }    from \"./ForbiddenPage\";\r\nexport type { NotFoundPageProps }     from \"./NotFoundPage\";\r\nexport type { ServerErrorPageProps }  from \"./ServerErrorPage\";\r\nexport type { NetworkErrorPageProps } from \"./NetworkErrorPage\";\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/hooks/index.js

@@ -0,0 +1,10 @@
+export { default as useFocusTrap } from "./useFocusTrap";
+export { default as useTabLoading, PERCEPTION_THRESHOLD_MS } from "./useTabLoading";
+export { default as useDelayedFlag } from "./useDelayedFlag";
+export { default as useDensity } from "./useDensity";
+export { default as useResolvedDensity } from "./useResolvedDensity";
+export { default as useSortedRows } from "./useSortedRows";
+export { default as useFormAutoSave } from "./useFormAutoSave";
+export { default as useFormCompletionProgress } from "./useFormCompletionProgress";
+export { default as useFocusFirstError, focusFieldByName } from "./useFocusFirstError";
+//# sourceMappingURL=index.js.map

package/dist/esm/v2/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["default","useFocusTrap","useTabLoading","PERCEPTION_THRESHOLD_MS","useDelayedFlag","useDensity","useResolvedDensity","useSortedRows","useFormAutoSave","useFormCompletionProgress","useFocusFirstError","focusFieldByName"],"sources":["../../../../src/lib/v2/hooks/index.ts"],"sourcesContent":["export { default as useFocusTrap } from \"./useFocusTrap\";\r\nexport {\r\n  default as useTabLoading,\r\n  PERCEPTION_THRESHOLD_MS,\r\n} from \"./useTabLoading\";\r\nexport { default as useDelayedFlag } from \"./useDelayedFlag\";\r\nexport { default as useDensity } from \"./useDensity\";\r\nexport { default as useResolvedDensity } from \"./useResolvedDensity\";\r\nexport { default as useSortedRows } from \"./useSortedRows\";\r\nexport { default as useFormAutoSave } from \"./useFormAutoSave\";\r\nexport { default as useFormCompletionProgress } from \"./useFormCompletionProgress\";\r\nexport {\r\n  default as useFocusFirstError,\r\n  focusFieldByName,\r\n} from \"./useFocusFirstError\";\r\nexport type {\r\n  FocusFieldOptions,\r\n  UseFocusFirstErrorOptions,\r\n} from \"./useFocusFirstError\";\r\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,YAAY,QAAQ,gBAAgB;AACxD,SACED,OAAO,IAAIE,aAAa,EACxBC,uBAAuB,QAClB,iBAAiB;AACxB,SAASH,OAAO,IAAII,cAAc,QAAQ,kBAAkB;AAC5D,SAASJ,OAAO,IAAIK,UAAU,QAAQ,cAAc;AACpD,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,sBAAsB;AACpE,SAASN,OAAO,IAAIO,aAAa,QAAQ,iBAAiB;AAC1D,SAASP,OAAO,IAAIQ,eAAe,QAAQ,mBAAmB;AAC9D,SAASR,OAAO,IAAIS,yBAAyB,QAAQ,6BAA6B;AAClF,SACET,OAAO,IAAIU,kBAAkB,EAC7BC,gBAAgB,QACX,sBAAsB","ignoreList":[]}

package/dist/esm/v2/hooks/useDelayedFlag.js

@@ -0,0 +1,55 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useState, useEffect } from "react";
+import { PERCEPTION_THRESHOLD_MS } from "./useTabLoading";
+
+/**
+ * useDelayedFlag — Portnet UI v2
+ *
+ * Returns `true` only when `active` has been continuously true for
+ * at least `delayMs` ms. Resets to `false` the moment `active` flips
+ * back to false. Charter R-Sk.1 — perception threshold.
+ *
+ *   const showSkeleton = useDelayedFlag(loading);
+ *   if (showSkeleton) return <Skeleton />;
+ *   if (loading)     return null;        // sub-threshold, render nothing
+ *   return <Data rows={rows} />;
+ *
+ * Use when:
+ *   - You want to delay showing a loading affordance (skeleton,
+ *     spinner overlay, "Loading…" text) until the user actually
+ *     perceives the wait.
+ *   - The flag has no tab/key semantics. For tab-aware loading
+ *     (preserves across tab swap to avoid flicker between two
+ *     consecutive skeletons), use `useTabLoading`.
+ */
+export default function useDelayedFlag(active) {
+  var delayMs = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : PERCEPTION_THRESHOLD_MS;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    delayed = _useState2[0],
+    setDelayed = _useState2[1];
+  useEffect(function () {
+    if (!active) {
+      // Inactive — drop any in-flight delayed flag immediately so
+      // the consumer can render the success path without waiting.
+      setDelayed(false);
+      return undefined;
+    }
+    // Schedule the flag flip. If `active` resolves false before the
+    // timer fires, cleanup clears the timer and the flag never goes
+    // true (the perception-threshold contract).
+    var t = setTimeout(function () {
+      return setDelayed(true);
+    }, delayMs);
+    return function () {
+      return clearTimeout(t);
+    };
+  }, [active, delayMs]);
+  return delayed;
+}
+//# sourceMappingURL=useDelayedFlag.js.map

package/dist/esm/v2/hooks/useDelayedFlag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDelayedFlag.js","names":["useState","useEffect","PERCEPTION_THRESHOLD_MS","useDelayedFlag","active","delayMs","arguments","length","undefined","_useState","_useState2","_slicedToArray","delayed","setDelayed","t","setTimeout","clearTimeout"],"sources":["../../../../src/lib/v2/hooks/useDelayedFlag.ts"],"sourcesContent":["import { useState, useEffect } from \"react\";\r\nimport { PERCEPTION_THRESHOLD_MS } from \"./useTabLoading\";\r\n\r\n/**\r\n * useDelayedFlag — Portnet UI v2\r\n *\r\n * Returns `true` only when `active` has been continuously true for\r\n * at least `delayMs` ms. Resets to `false` the moment `active` flips\r\n * back to false. Charter R-Sk.1 — perception threshold.\r\n *\r\n *   const showSkeleton = useDelayedFlag(loading);\r\n *   if (showSkeleton) return <Skeleton />;\r\n *   if (loading)     return null;        // sub-threshold, render nothing\r\n *   return <Data rows={rows} />;\r\n *\r\n * Use when:\r\n *   - You want to delay showing a loading affordance (skeleton,\r\n *     spinner overlay, \"Loading…\" text) until the user actually\r\n *     perceives the wait.\r\n *   - The flag has no tab/key semantics. For tab-aware loading\r\n *     (preserves across tab swap to avoid flicker between two\r\n *     consecutive skeletons), use `useTabLoading`.\r\n */\r\nexport default function useDelayedFlag(\r\n  active: boolean,\r\n  delayMs: number = PERCEPTION_THRESHOLD_MS\r\n): boolean {\r\n  const [delayed, setDelayed] = useState(false);\r\n\r\n  useEffect(() => {\r\n    if (!active) {\r\n      // Inactive — drop any in-flight delayed flag immediately so\r\n      // the consumer can render the success path without waiting.\r\n      setDelayed(false);\r\n      return undefined;\r\n    }\r\n    // Schedule the flag flip. If `active` resolves false before the\r\n    // timer fires, cleanup clears the timer and the flag never goes\r\n    // true (the perception-threshold contract).\r\n    const t = setTimeout(() => setDelayed(true), delayMs);\r\n    return () => clearTimeout(t);\r\n  }, [active, delayMs]);\r\n\r\n  return delayed;\r\n}\r\n"],"mappings":";;;;;;AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;AAC3C,SAASC,uBAAuB,QAAQ,iBAAiB;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,cAAcA,CACpCC,MAAe,EAEN;EAAA,IADTC,OAAe,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGJ,uBAAuB;EAEzC,IAAAO,SAAA,GAA8BT,QAAQ,CAAC,KAAK,CAAC;IAAAU,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAAtCG,OAAO,GAAAF,UAAA;IAAEG,UAAU,GAAAH,UAAA;EAE1BT,SAAS,CAAC,YAAM;IACd,IAAI,CAACG,MAAM,EAAE;MACX;MACA;MACAS,UAAU,CAAC,KAAK,CAAC;MACjB,OAAOL,SAAS;IAClB;IACA;IACA;IACA;IACA,IAAMM,CAAC,GAAGC,UAAU,CAAC;MAAA,OAAMF,UAAU,CAAC,IAAI,CAAC;IAAA,GAAER,OAAO,CAAC;IACrD,OAAO;MAAA,OAAMW,YAAY,CAACF,CAAC,CAAC;IAAA;EAC9B,CAAC,EAAE,CAACV,MAAM,EAAEC,OAAO,CAAC,CAAC;EAErB,OAAOO,OAAO;AAChB","ignoreList":[]}