@portnet/ui 6.0.0 → 6.0.1

package/dist/esm/v2/tokens/spacing.js

@@ -0,0 +1,51 @@
+/**
+ * Spacing tokens — Portnet UI v2
+ * Aligned with Design System v1.0 §02.3 — base grid 8 px.
+ *
+ * R-S.1 — Every padding / margin / gap is a multiple of 4 (preferably 8).
+ * R-S.2 — Use flex/grid `gap`; never sibling-margin.
+ *
+ * Two equivalent APIs are exposed:
+ *   - Numeric scale  (s1..s10)  — historical; keep stable.
+ *   - Semantic alias (xs..xxl)  — preferred for new code.
+ * Both resolve to the same pixel values.
+ */
+export var spacing = {
+  s1: 4,
+  // gap d'icônes inline
+  s2: 8,
+  // gap boutons d'un groupe
+  s3: 12,
+  // padding cards compact
+  s4: 16,
+  // gap formulaire (default)
+  s5: 20,
+  // padding card body
+  s6: 24,
+  // gap entre sections
+  s7: 32,
+  // padding content principal
+  s8: 40,
+  // gap blocs majeurs
+  s9: 48,
+  // empty states
+  s10: 64,
+  // marges hero / landing
+
+  /* Semantic aliases — preferred for new code */
+  xs: 4,
+  sm: 8,
+  md: 16,
+  lg: 24,
+  xl: 32,
+  xxl: 48
+};
+
+/**
+ * MUI's `theme.spacing(n)` factor. Keep MUI's 4-px unit so existing
+ * `theme.spacing(2)` == 8 px. Never use fractional units
+ * (`theme.spacing(2.5)` = 10 px) — R-S.1 violation.
+ */
+export var spacingBase = 4;
+export default spacing;
+//# sourceMappingURL=spacing.js.map

package/dist/esm/v2/tokens/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","names":["spacing","s1","s2","s3","s4","s5","s6","s7","s8","s9","s10","xs","sm","md","lg","xl","xxl","spacingBase"],"sources":["../../../../src/lib/v2/tokens/spacing.ts"],"sourcesContent":["/**\r\n * Spacing tokens — Portnet UI v2\r\n * Aligned with Design System v1.0 §02.3 — base grid 8 px.\r\n *\r\n * R-S.1 — Every padding / margin / gap is a multiple of 4 (preferably 8).\r\n * R-S.2 — Use flex/grid `gap`; never sibling-margin.\r\n *\r\n * Two equivalent APIs are exposed:\r\n *   - Numeric scale  (s1..s10)  — historical; keep stable.\r\n *   - Semantic alias (xs..xxl)  — preferred for new code.\r\n * Both resolve to the same pixel values.\r\n */\r\nexport const spacing = {\r\n  s1:  4,  // gap d'icônes inline\r\n  s2:  8,  // gap boutons d'un groupe\r\n  s3:  12, // padding cards compact\r\n  s4:  16, // gap formulaire (default)\r\n  s5:  20, // padding card body\r\n  s6:  24, // gap entre sections\r\n  s7:  32, // padding content principal\r\n  s8:  40, // gap blocs majeurs\r\n  s9:  48, // empty states\r\n  s10: 64, // marges hero / landing\r\n\r\n  /* Semantic aliases — preferred for new code */\r\n  xs:   4,\r\n  sm:   8,\r\n  md:  16,\r\n  lg:  24,\r\n  xl:  32,\r\n  xxl: 48,\r\n};\r\n\r\n/**\r\n * MUI's `theme.spacing(n)` factor. Keep MUI's 4-px unit so existing\r\n * `theme.spacing(2)` == 8 px. Never use fractional units\r\n * (`theme.spacing(2.5)` = 10 px) — R-S.1 violation.\r\n */\r\nexport const spacingBase = 4;\r\n\r\nexport default spacing;\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMA,OAAO,GAAG;EACrBC,EAAE,EAAG,CAAC;EAAG;EACTC,EAAE,EAAG,CAAC;EAAG;EACTC,EAAE,EAAG,EAAE;EAAE;EACTC,EAAE,EAAG,EAAE;EAAE;EACTC,EAAE,EAAG,EAAE;EAAE;EACTC,EAAE,EAAG,EAAE;EAAE;EACTC,EAAE,EAAG,EAAE;EAAE;EACTC,EAAE,EAAG,EAAE;EAAE;EACTC,EAAE,EAAG,EAAE;EAAE;EACTC,GAAG,EAAE,EAAE;EAAE;;EAET;EACAC,EAAE,EAAI,CAAC;EACPC,EAAE,EAAI,CAAC;EACPC,EAAE,EAAG,EAAE;EACPC,EAAE,EAAG,EAAE;EACPC,EAAE,EAAG,EAAE;EACPC,GAAG,EAAE;AACP,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMC,WAAW,GAAG,CAAC;AAE5B,eAAejB,OAAO","ignoreList":[]}

package/dist/esm/v2/tokens/state.js

@@ -0,0 +1,41 @@
+/**
+ * State tokens — Portnet UI v2
+ * Aligned with Design System v1.0 §02.5 (states).
+ *
+ * Semantic interaction overlays. Replaces ad-hoc `color-mix(in srgb,
+ * currentColor 8%, transparent)` / 10% / 14% / 18% / 30% percentages
+ * scattered across component sx blocks with three named tiers.
+ *
+ * The overlays use `currentColor` so they ADAPT to whichever
+ * foreground is in scope:
+ *   - On a light card with --fg ink, the overlay is a soft ink wash.
+ *   - On the BulkActionBar (bg = --fg, fg = --fg-inverse), the
+ *     overlay is a soft white wash. Same token, opposite intent.
+ *
+ * Three tiers — DO NOT add a fourth without DS council sign-off.
+ * The tiers map onto a perceptual scale (light tap, firm press,
+ * persistent selection) that hosts have learned to recognise; a
+ * fourth tier would dilute the meaning.
+ */
+
+export var state = {
+  /**
+   * Pointer-hover wash. Subtle enough to coexist with the existing
+   * surface colour without blocking text contrast. R-1.4.3.
+   */
+  hoverOverlay: "color-mix(in srgb, currentColor 8%, transparent)",
+  /**
+   * Active / pressed wash. Stronger than hover but still translucent
+   * so the underlying state (selected, focused) remains visible.
+   */
+  pressedOverlay: "color-mix(in srgb, currentColor 14%, transparent)",
+  /**
+   * Persistent "selected" state — list rows, chip selected, etc.
+   * Slightly weaker than pressed so a SELECTED row that is also
+   * hovered (overlay = hover + selected ≈ 20%) doesn't become a
+   * solid block.
+   */
+  selectedOverlay: "color-mix(in srgb, currentColor 12%, transparent)"
+};
+export default state;
+//# sourceMappingURL=state.js.map

package/dist/esm/v2/tokens/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","names":["state","hoverOverlay","pressedOverlay","selectedOverlay"],"sources":["../../../../src/lib/v2/tokens/state.ts"],"sourcesContent":["/**\r\n * State tokens — Portnet UI v2\r\n * Aligned with Design System v1.0 §02.5 (states).\r\n *\r\n * Semantic interaction overlays. Replaces ad-hoc `color-mix(in srgb,\r\n * currentColor 8%, transparent)` / 10% / 14% / 18% / 30% percentages\r\n * scattered across component sx blocks with three named tiers.\r\n *\r\n * The overlays use `currentColor` so they ADAPT to whichever\r\n * foreground is in scope:\r\n *   - On a light card with --fg ink, the overlay is a soft ink wash.\r\n *   - On the BulkActionBar (bg = --fg, fg = --fg-inverse), the\r\n *     overlay is a soft white wash. Same token, opposite intent.\r\n *\r\n * Three tiers — DO NOT add a fourth without DS council sign-off.\r\n * The tiers map onto a perceptual scale (light tap, firm press,\r\n * persistent selection) that hosts have learned to recognise; a\r\n * fourth tier would dilute the meaning.\r\n */\r\n\r\nexport const state = {\r\n  /**\r\n   * Pointer-hover wash. Subtle enough to coexist with the existing\r\n   * surface colour without blocking text contrast. R-1.4.3.\r\n   */\r\n  hoverOverlay:    \"color-mix(in srgb, currentColor 8%, transparent)\",\r\n\r\n  /**\r\n   * Active / pressed wash. Stronger than hover but still translucent\r\n   * so the underlying state (selected, focused) remains visible.\r\n   */\r\n  pressedOverlay:  \"color-mix(in srgb, currentColor 14%, transparent)\",\r\n\r\n  /**\r\n   * Persistent \"selected\" state — list rows, chip selected, etc.\r\n   * Slightly weaker than pressed so a SELECTED row that is also\r\n   * hovered (overlay = hover + selected ≈ 20%) doesn't become a\r\n   * solid block.\r\n   */\r\n  selectedOverlay: \"color-mix(in srgb, currentColor 12%, transparent)\",\r\n};\r\n\r\nexport default state;\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,IAAMA,KAAK,GAAG;EACnB;AACF;AACA;AACA;EACEC,YAAY,EAAK,kDAAkD;EAEnE;AACF;AACA;AACA;EACEC,cAAc,EAAG,mDAAmD;EAEpE;AACF;AACA;AACA;AACA;AACA;EACEC,eAAe,EAAE;AACnB,CAAC;AAED,eAAeH,KAAK","ignoreList":[]}

package/dist/esm/v2/tokens/statusPalette.js

@@ -0,0 +1,66 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * Status palette mapping — Portnet UI v2
+ *
+ * Six and only six canonical workflow statuses (R-2.2).
+ * Any new business status must map onto one of these.
+ * New chips with custom colours require a charter amendment.
+ *
+ * UX writing (labels) is the consumer's responsibility (i18n) — do not
+ * couple labels to design tokens.
+ *
+ * Charter §02.1 / R-2.2.
+ */
+import { status } from "./colors";
+export var STATUS_KEYS = Object.freeze(["new", "sent", "pending", "approved", "rejected", "neutral"]);
+var _STATUS_KEYS_SET = new Set(STATUS_KEYS);
+
+/**
+ * Resolve a status descriptor.
+ *
+ *   statusToken("approved") → { key, soft, fg, cls: "status-approved" }
+ *
+ * Unknown keys silently resolve to `neutral`. In dev mode a console
+ * warning is emitted to surface bad data without breaking UI.
+ */
+export function statusToken(key) {
+  if (!_STATUS_KEYS_SET.has(key)) {
+    if (process.env["NODE_ENV"] !== "production" && key !== undefined && key !== null) {
+      // eslint-disable-next-line no-console
+      console.warn("[@portnet/ui] statusToken: unknown key \"".concat(key, "\". ") + "Falling back to \"neutral\". Allowed: ".concat(STATUS_KEYS.join(", "), "."));
+    }
+    return _objectSpread(_objectSpread({}, status.neutral), {}, {
+      cls: "status-neutral",
+      key: "neutral"
+    });
+  }
+  return _objectSpread(_objectSpread({}, status[key]), {}, {
+    cls: "status-".concat(key),
+    key: key
+  });
+}
+
+/**
+ * @deprecated FR labels belong in consumer i18n bundles, not tokens.
+ * Will be removed in v0.3. Kept for backward compatibility only.
+ */
+export var STATUS_LABELS_FR = Object.freeze({
+  "new": "Nouveau",
+  sent: "Soumis",
+  pending: "En attente",
+  approved: "Approuvé",
+  rejected: "Rejeté",
+  neutral: "Neutre"
+});
+var statusPalette = {
+  STATUS_KEYS: STATUS_KEYS,
+  statusToken: statusToken,
+  STATUS_LABELS_FR: STATUS_LABELS_FR
+};
+export default statusPalette;
+//# sourceMappingURL=statusPalette.js.map

package/dist/esm/v2/tokens/statusPalette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusPalette.js","names":["status","STATUS_KEYS","Object","freeze","_STATUS_KEYS_SET","Set","statusToken","key","has","process","env","undefined","console","warn","concat","join","_objectSpread","neutral","cls","STATUS_LABELS_FR","sent","pending","approved","rejected","statusPalette"],"sources":["../../../../src/lib/v2/tokens/statusPalette.ts"],"sourcesContent":["/**\r\n * Status palette mapping — Portnet UI v2\r\n *\r\n * Six and only six canonical workflow statuses (R-2.2).\r\n * Any new business status must map onto one of these.\r\n * New chips with custom colours require a charter amendment.\r\n *\r\n * UX writing (labels) is the consumer's responsibility (i18n) — do not\r\n * couple labels to design tokens.\r\n *\r\n * Charter §02.1 / R-2.2.\r\n */\r\nimport { status } from \"./colors\";\r\n\r\nexport const STATUS_KEYS = Object.freeze([\r\n  \"new\", \"sent\", \"pending\", \"approved\", \"rejected\", \"neutral\",\r\n]);\r\n\r\nconst _STATUS_KEYS_SET = new Set(STATUS_KEYS);\r\n\r\n/**\r\n * Resolve a status descriptor.\r\n *\r\n *   statusToken(\"approved\") → { key, soft, fg, cls: \"status-approved\" }\r\n *\r\n * Unknown keys silently resolve to `neutral`. In dev mode a console\r\n * warning is emitted to surface bad data without breaking UI.\r\n */\r\nexport function statusToken(key: keyof typeof status) {\r\n  if (!_STATUS_KEYS_SET.has(key)) {\r\n    if (\r\n      process.env[\"NODE_ENV\"] !== \"production\" &&\r\n      key !== undefined &&\r\n      key !== null\r\n    ) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\r\n        `[@portnet/ui] statusToken: unknown key \"${key}\". ` +\r\n        `Falling back to \"neutral\". Allowed: ${STATUS_KEYS.join(\", \")}.`\r\n      );\r\n    }\r\n    return { ...status.neutral, cls: \"status-neutral\", key: \"neutral\" };\r\n  }\r\n  return { ...status[key], cls: `status-${key}`, key };\r\n}\r\n\r\n/**\r\n * @deprecated FR labels belong in consumer i18n bundles, not tokens.\r\n * Will be removed in v0.3. Kept for backward compatibility only.\r\n */\r\nexport const STATUS_LABELS_FR = Object.freeze({\r\n  new:      \"Nouveau\",\r\n  sent:     \"Soumis\",\r\n  pending:  \"En attente\",\r\n  approved: \"Approuvé\",\r\n  rejected: \"Rejeté\",\r\n  neutral:  \"Neutre\",\r\n});\r\n\r\nconst statusPalette = { STATUS_KEYS, statusToken, STATUS_LABELS_FR };\r\nexport default statusPalette;\r\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,MAAM,QAAQ,UAAU;AAEjC,OAAO,IAAMC,WAAW,GAAGC,MAAM,CAACC,MAAM,CAAC,CACvC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAC5D,CAAC;AAEF,IAAMC,gBAAgB,GAAG,IAAIC,GAAG,CAACJ,WAAW,CAAC;;AAE7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,WAAWA,CAACC,GAAwB,EAAE;EACpD,IAAI,CAACH,gBAAgB,CAACI,GAAG,CAACD,GAAG,CAAC,EAAE;IAC9B,IACEE,OAAO,CAACC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,IACxCH,GAAG,KAAKI,SAAS,IACjBJ,GAAG,KAAK,IAAI,EACZ;MACA;MACAK,OAAO,CAACC,IAAI,CACV,4CAAAC,MAAA,CAA2CP,GAAG,qDAAAO,MAAA,CACPb,WAAW,CAACc,IAAI,CAAC,IAAI,CAAC,MAC/D,CAAC;IACH;IACA,OAAAC,aAAA,CAAAA,aAAA,KAAYhB,MAAM,CAACiB,OAAO;MAAEC,GAAG,EAAE,gBAAgB;MAAEX,GAAG,EAAE;IAAS;EACnE;EACA,OAAAS,aAAA,CAAAA,aAAA,KAAYhB,MAAM,CAACO,GAAG,CAAC;IAAEW,GAAG,YAAAJ,MAAA,CAAYP,GAAG,CAAE;IAAEA,GAAG,EAAHA;EAAG;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,IAAMY,gBAAgB,GAAGjB,MAAM,CAACC,MAAM,CAAC;EAC5C,OAAU,SAAS;EACnBiB,IAAI,EAAM,QAAQ;EAClBC,OAAO,EAAG,YAAY;EACtBC,QAAQ,EAAE,UAAU;EACpBC,QAAQ,EAAE,QAAQ;EAClBN,OAAO,EAAG;AACZ,CAAC,CAAC;AAEF,IAAMO,aAAa,GAAG;EAAEvB,WAAW,EAAXA,WAAW;EAAEK,WAAW,EAAXA,WAAW;EAAEa,gBAAgB,EAAhBA;AAAiB,CAAC;AACpE,eAAeK,aAAa","ignoreList":[]}

package/dist/esm/v2/tokens/tokens.json

@@ -0,0 +1,153 @@
+{
+  "$schema": "https://design-tokens.github.io/community-group/format/",
+  "_meta": {
+    "name": "Portnet UI Design Tokens",
+    "version": "0.2.1",
+    "charterRef": "Design System v1.0 §02",
+    "wcag": "2.2 AA (fg-muted AAA)"
+  },
+
+  "color": {
+    "accent":        { "value": "#232F66", "_contrast": "AAA · ~12.6:1 on white (Portnet navy)" },
+    "accent-hover":  { "value": "#1A2452" },
+    "accent-soft":   { "value": "#E9ECF4" },
+    "accent-fg":     { "value": "#FFFFFF" },
+
+    "fg":            { "value": "#0F1525", "_contrast": "AAA · 17.40:1 on white" },
+    "fg-muted":      { "value": "#474C5A", "_contrast": "AAA · 8.43:1 on white, 7.94:1 on bg, 7.52:1 on bg-subtle" },
+    "fg-subtle":     { "value": "#6B7280", "_contrast": "AA · 4.8:1 on white — incidental text only (WCAG 1.4.6)" },
+    "fg-inverse":    { "value": "#FFFFFF" },
+
+    "bg":            { "value": "#F7F8FA" },
+    "bg-elev":       { "value": "#FFFFFF" },
+    "bg-subtle":     { "value": "#F1F2F5" },
+    "bg-hover":      { "value": "#EAECF0" },
+    "surface":       { "value": "#FFFFFF" },
+
+    "border":        { "value": "#E4E6EB" },
+    "border-strong": { "value": "#9099AA", "_contrast": "WCAG 1.4.11 · 3.04:1" },
+
+    "success":       { "value": "#10A968", "_use": "fills, icons, borders (1.4.11 ≥ 3:1)" },
+    "success-soft":  { "value": "#E7F7EF" },
+    "success-fg":    { "value": "#0A6E44", "_contrast": "AA · ~5.7:1 on success-soft, ~6.3:1 on white", "_use": "text on success-soft / white (1.4.3)" },
+    "warning":       { "value": "#C78400", "_use": "fills, icons, borders (1.4.11 ≥ 3:1)" },
+    "warning-soft":  { "value": "#FDF4E0" },
+    "warning-fg":    { "value": "#7A5200", "_contrast": "AA · ~6.4:1 on warning-soft, ~7:1 on white", "_use": "text on warning-soft / white (1.4.3)" },
+    "danger":        { "value": "#D93644", "_use": "fills, icons, borders (1.4.11 ≥ 3:1)" },
+    "danger-soft":   { "value": "#FBEBED" },
+    "danger-fg":     { "value": "#9B1F2B", "_contrast": "AAA · ~7.95:1 on white, ~5.6:1 on danger-soft", "_use": "text on danger-soft / white (1.4.3)" },
+    "info":          { "value": "#1A7FB8", "_use": "fills, icons, borders (1.4.11 ≥ 3:1)" },
+    "info-soft":     { "value": "#E0F2FE" },
+    "info-fg":       { "value": "#075985", "_contrast": "AA · ~6.6:1 on info-soft, ~7.6:1 on white", "_use": "text on info-soft / white (1.4.3)" },
+
+    "status": {
+      "new":      { "soft": { "value": "#EEF3FF" }, "fg": { "value": "#1A3EA8" } },
+      "sent":     { "soft": { "value": "#E0F2FE" }, "fg": { "value": "#075985" } },
+      "pending":  { "soft": { "value": "#FDF4E0" }, "fg": { "value": "#7A5200" } },
+      "approved": { "soft": { "value": "#E7F7EF" }, "fg": { "value": "#0A6E44" } },
+      "rejected": { "soft": { "value": "#FBEBED" }, "fg": { "value": "#9B1F2B" } },
+      "neutral":  { "soft": { "value": "#F1F2F5" }, "fg": { "value": "#3A3F4A" } }
+    }
+  },
+
+  "font": {
+    "sans": { "value": "Inter, system-ui, -apple-system, Segoe UI, sans-serif" },
+    "mono": { "value": "JetBrains Mono, ui-monospace, SFMono-Regular, Menlo, monospace" }
+  },
+
+  "size": {
+    "text": {
+      "display": { "value": 26 },
+      "h2":      { "value": 20 },
+      "h3":      { "value": 16 },
+      "h4":      { "value": 14 },
+      "body":    { "value": 14 },
+      "sm":      { "value": 13 },
+      "xs":      { "value": 12 }
+    },
+    "weight": {
+      "regular":  { "value": 400 },
+      "medium":   { "value": 500 },
+      "semibold": { "value": 600 },
+      "bold":     { "value": 650 },
+      "black":    { "value": 700 }
+    },
+    "lineHeight": {
+      "tight":  { "value": 1.25 },
+      "snug":   { "value": 1.4 },
+      "normal": { "value": 1.5 },
+      "loose":  { "value": 1.6 }
+    },
+    "space": {
+      "1":  { "value": 4 },
+      "2":  { "value": 8 },
+      "3":  { "value": 12 },
+      "4":  { "value": 16 },
+      "5":  { "value": 20 },
+      "6":  { "value": 24 },
+      "7":  { "value": 32 },
+      "8":  { "value": 40 },
+      "9":  { "value": 48 },
+      "10": { "value": 64 }
+    },
+    "radius": {
+      "sm":   { "value": 6 },
+      "md":   { "value": 8 },
+      "lg":   { "value": 12 },
+      "xl":   { "value": 16 },
+      "full": { "value": 9999 }
+    },
+    "density": {
+      "comfortable": { "row": 44, "input": 38, "btn": 36, "fs": 14 },
+      "compact":     { "row": 36, "input": 32, "btn": 30, "fs": 13 }
+    },
+    "layout": {
+      "sidebar":     { "value": 248 },
+      "sidebarMin":  { "value": 64 },
+      "topbar":      { "value": 56 },
+      "contentMax":  { "value": 1440 },
+      "formMax":     { "value": 720 },
+      "tactileMin":  { "value": 44, "_ref": "WCAG 2.5.5" },
+      "modal": {
+        "sm": { "value": 440 },
+        "md": { "value": 640 },
+        "lg": { "value": 840 },
+        "xl": { "value": 1000 }
+      },
+      "drawer":      { "value": 560 }
+    }
+  },
+
+  "shadow": {
+    "xs":    { "value": "0 1px 2px rgba(15,21,37,.04)" },
+    "sm":    { "value": "0 1px 2px rgba(15,21,37,.04), 0 1px 3px rgba(15,21,37,.06)" },
+    "md":    { "value": "0 2px 4px rgba(15,21,37,.04), 0 4px 12px rgba(15,21,37,.08)" },
+    "lg":    { "value": "0 4px 8px rgba(15,21,37,.06), 0 12px 32px rgba(15,21,37,.12)" },
+    "focus": { "value": "0 0 0 3px color-mix(in srgb, var(--accent) 22%, transparent)" }
+  },
+
+  "motion": {
+    "duration": {
+      "fast": { "value": "80ms" },
+      "base": { "value": "180ms" },
+      "slow": { "value": "280ms" }
+    },
+    "easing": {
+      "out":   { "value": "cubic-bezier(0.2, 0.8, 0.2, 1)" },
+      "in":    { "value": "cubic-bezier(0.4, 0, 1, 1)" },
+      "soft":  { "value": "cubic-bezier(0.16, 1, 0.3, 1)" }
+    }
+  },
+
+  "z": {
+    "base":      { "value": 0 },
+    "sticky":    { "value": 15 },
+    "topbar":    { "value": 20 },
+    "bulk":      { "value": 30 },
+    "overflow":  { "value": 50 },
+    "drawer":    { "value": 80 },
+    "modal":     { "value": 100 },
+    "toast":     { "value": 200 },
+    "netError":  { "value": 2000 }
+  }
+}

package/dist/esm/v2/tokens/typography.js

@@ -0,0 +1,149 @@
+/**
+ * Typography tokens — Portnet UI v2
+ * Aligned with Design System v1.0 §02.2.
+ *
+ * Stack: Inter (UI) + JetBrains Mono (codes, IDs, montants).
+ * Production: auto-host via woff2 (R-9.1). Dev: fall back to Google Fonts.
+ *
+ * R-T.1 — Font-size minimum 12 px (WCAG 1.4.4).
+ * R-T.2 — Line-height ≥ 1.5 on body text.
+ * R-T.3 — Tabular numerals on numeric columns.
+ *
+ * Pixel values are stored as integers; the theme layer + cssVariables
+ * append the unit. For raw CSS strings, use `${n}px` at the call site.
+ */
+
+export var fontFamily = {
+  sans: 'Inter, system-ui, -apple-system, "Segoe UI", sans-serif',
+  mono: '"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace'
+};
+export var fontSize = {
+  display: 26,
+  // H1 — page title
+  h2: 20,
+  // section header
+  h3: 16,
+  // card / form group
+  h4: 14,
+  // sub-section
+  body: 14,
+  // default
+  sm: 13,
+  // compact / tables
+  xs: 12 // labels, hints (MIN — R-T.1)
+};
+
+/* Standard CSS weights only — non-variable fallbacks (system-ui /
+ * Segoe UI) cannot render arbitrary weights such as 650; they would
+ * silently round to 700, breaking visual rhythm across browsers. */
+export var fontWeight = {
+  regular: 400,
+  medium: 500,
+  semibold: 600,
+  bold: 700
+};
+export var lineHeight = {
+  tight: 1.25,
+  snug: 1.4,
+  normal: 1.5,
+  // R-T.2 minimum on body
+  loose: 1.6
+};
+
+/**
+ * Letter-spacing scale — added by the ms-dfd-fe Area 7 audit (A7-02).
+ *
+ * WHY THIS IS A CODIFICATION, NOT AN INVENTION.
+ *
+ * Both values were ALREADY platform vocabulary before this scale existed; they
+ * simply had no CSS-variable route, so every consumer hardcoded them:
+ *
+ *   -0.01em  was hardcoded TWICE in this very file (`variants.display`,
+ *            `variants.mono`) — both now reference `letterSpacing.tight`, so
+ *            adding the scale REMOVED two magic values from the token layer.
+ *
+ *    0.04em  was hardcoded inside the LIBRARY's own components (KV's eyebrow
+ *            label, ConfirmDialog's "Conséquences" heading) and appeared 5+
+ *            times across ms-dfd-fe and ms-ti-fe — always for the same purpose:
+ *            positive tracking on uppercase micro-labels, which is a
+ *            typographic necessity at 11-12px, not decoration.
+ *
+ * The audit found six token names referenced fleet-wide that cssVariables never
+ * emitted (`--ls-tight`, `--ls-wide`, `--border-subtle`, `--r-xs`, `--icon-sm`,
+ * `--icon-xl`). For each, the `var(--x, literal)` fallback was the only thing
+ * that had ever rendered — hard-coded magic values wearing a token's name
+ * (R-2.3 / R-AI.1). Only the two letter-spacing names had a genuine platform
+ * basis, so only they are promoted here. The others are local inventions and
+ * are fixed at their call sites instead.
+ *
+ * Charter §02.2 amendment. Requires a MINOR bump + changelog entry.
+ */
+export var letterSpacing = {
+  /** Display / mono — tightens large text and monospaced references. */
+  tight: "-0.01em",
+  /** Default — explicit so a consumer can reset tracking via a token. */
+  normal: "0",
+  /** Uppercase micro-labels (KV eyebrows, section captions, stat labels). */
+  wide: "0.04em"
+};
+
+/**
+ * Pre-baked typography variants for direct use in `<Typography variant="…">`
+ * or as a reference for native components.
+ */
+export var variants = {
+  display: {
+    fontSize: fontSize.display,
+    fontWeight: fontWeight.bold,
+    lineHeight: lineHeight.tight,
+    letterSpacing: letterSpacing.tight
+  },
+  h2: {
+    fontSize: fontSize.h2,
+    fontWeight: fontWeight.semibold,
+    lineHeight: lineHeight.tight
+  },
+  h3: {
+    fontSize: fontSize.h3,
+    fontWeight: fontWeight.semibold,
+    lineHeight: lineHeight.snug
+  },
+  h4: {
+    fontSize: fontSize.h4,
+    fontWeight: fontWeight.semibold,
+    lineHeight: lineHeight.snug
+  },
+  body: {
+    fontSize: fontSize.body,
+    fontWeight: fontWeight.regular,
+    lineHeight: lineHeight.normal
+  },
+  sm: {
+    fontSize: fontSize.sm,
+    fontWeight: fontWeight.regular,
+    lineHeight: lineHeight.normal
+  },
+  xs: {
+    fontSize: fontSize.xs,
+    fontWeight: fontWeight.medium,
+    lineHeight: lineHeight.normal
+  },
+  mono: {
+    fontFamily: fontFamily.mono,
+    fontSize: fontSize.sm,
+    fontWeight: fontWeight.medium,
+    fontVariantNumeric: "tabular-nums",
+    // R-T.3
+    letterSpacing: letterSpacing.tight
+  }
+};
+var typography = {
+  fontFamily: fontFamily,
+  fontSize: fontSize,
+  fontWeight: fontWeight,
+  lineHeight: lineHeight,
+  letterSpacing: letterSpacing,
+  variants: variants
+};
+export default typography;
+//# sourceMappingURL=typography.js.map

package/dist/esm/v2/tokens/typography.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.js","names":["fontFamily","sans","mono","fontSize","display","h2","h3","h4","body","sm","xs","fontWeight","regular","medium","semibold","bold","lineHeight","tight","snug","normal","loose","letterSpacing","wide","variants","fontVariantNumeric","typography"],"sources":["../../../../src/lib/v2/tokens/typography.ts"],"sourcesContent":["/**\r\n * Typography tokens — Portnet UI v2\r\n * Aligned with Design System v1.0 §02.2.\r\n *\r\n * Stack: Inter (UI) + JetBrains Mono (codes, IDs, montants).\r\n * Production: auto-host via woff2 (R-9.1). Dev: fall back to Google Fonts.\r\n *\r\n * R-T.1 — Font-size minimum 12 px (WCAG 1.4.4).\r\n * R-T.2 — Line-height ≥ 1.5 on body text.\r\n * R-T.3 — Tabular numerals on numeric columns.\r\n *\r\n * Pixel values are stored as integers; the theme layer + cssVariables\r\n * append the unit. For raw CSS strings, use `${n}px` at the call site.\r\n */\r\n\r\nexport const fontFamily = {\r\n  sans: 'Inter, system-ui, -apple-system, \"Segoe UI\", sans-serif',\r\n  mono: '\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, monospace',\r\n};\r\n\r\nexport const fontSize = {\r\n  display: 26, // H1 — page title\r\n  h2:      20, // section header\r\n  h3:      16, // card / form group\r\n  h4:      14, // sub-section\r\n  body:    14, // default\r\n  sm:      13, // compact / tables\r\n  xs:      12, // labels, hints (MIN — R-T.1)\r\n};\r\n\r\n/* Standard CSS weights only — non-variable fallbacks (system-ui /\r\n * Segoe UI) cannot render arbitrary weights such as 650; they would\r\n * silently round to 700, breaking visual rhythm across browsers. */\r\nexport const fontWeight = {\r\n  regular:  400,\r\n  medium:   500,\r\n  semibold: 600,\r\n  bold:     700,\r\n};\r\n\r\nexport const lineHeight = {\r\n  tight:  1.25,\r\n  snug:   1.4,\r\n  normal: 1.5, // R-T.2 minimum on body\r\n  loose:  1.6,\r\n};\r\n\r\n/**\r\n * Letter-spacing scale — added by the ms-dfd-fe Area 7 audit (A7-02).\r\n *\r\n * WHY THIS IS A CODIFICATION, NOT AN INVENTION.\r\n *\r\n * Both values were ALREADY platform vocabulary before this scale existed; they\r\n * simply had no CSS-variable route, so every consumer hardcoded them:\r\n *\r\n *   -0.01em  was hardcoded TWICE in this very file (`variants.display`,\r\n *            `variants.mono`) — both now reference `letterSpacing.tight`, so\r\n *            adding the scale REMOVED two magic values from the token layer.\r\n *\r\n *    0.04em  was hardcoded inside the LIBRARY's own components (KV's eyebrow\r\n *            label, ConfirmDialog's \"Conséquences\" heading) and appeared 5+\r\n *            times across ms-dfd-fe and ms-ti-fe — always for the same purpose:\r\n *            positive tracking on uppercase micro-labels, which is a\r\n *            typographic necessity at 11-12px, not decoration.\r\n *\r\n * The audit found six token names referenced fleet-wide that cssVariables never\r\n * emitted (`--ls-tight`, `--ls-wide`, `--border-subtle`, `--r-xs`, `--icon-sm`,\r\n * `--icon-xl`). For each, the `var(--x, literal)` fallback was the only thing\r\n * that had ever rendered — hard-coded magic values wearing a token's name\r\n * (R-2.3 / R-AI.1). Only the two letter-spacing names had a genuine platform\r\n * basis, so only they are promoted here. The others are local inventions and\r\n * are fixed at their call sites instead.\r\n *\r\n * Charter §02.2 amendment. Requires a MINOR bump + changelog entry.\r\n */\r\nexport const letterSpacing = {\r\n  /** Display / mono — tightens large text and monospaced references. */\r\n  tight:  \"-0.01em\",\r\n  /** Default — explicit so a consumer can reset tracking via a token. */\r\n  normal: \"0\",\r\n  /** Uppercase micro-labels (KV eyebrows, section captions, stat labels). */\r\n  wide:   \"0.04em\",\r\n};\r\n\r\n/**\r\n * Pre-baked typography variants for direct use in `<Typography variant=\"…\">`\r\n * or as a reference for native components.\r\n */\r\nexport const variants = {\r\n  display: {\r\n    fontSize:      fontSize.display,\r\n    fontWeight:    fontWeight.bold,\r\n    lineHeight:    lineHeight.tight,\r\n    letterSpacing: letterSpacing.tight,\r\n  },\r\n  h2: {\r\n    fontSize:   fontSize.h2,\r\n    fontWeight: fontWeight.semibold,\r\n    lineHeight: lineHeight.tight,\r\n  },\r\n  h3: {\r\n    fontSize:   fontSize.h3,\r\n    fontWeight: fontWeight.semibold,\r\n    lineHeight: lineHeight.snug,\r\n  },\r\n  h4: {\r\n    fontSize:   fontSize.h4,\r\n    fontWeight: fontWeight.semibold,\r\n    lineHeight: lineHeight.snug,\r\n  },\r\n  body: {\r\n    fontSize:   fontSize.body,\r\n    fontWeight: fontWeight.regular,\r\n    lineHeight: lineHeight.normal,\r\n  },\r\n  sm: {\r\n    fontSize:   fontSize.sm,\r\n    fontWeight: fontWeight.regular,\r\n    lineHeight: lineHeight.normal,\r\n  },\r\n  xs: {\r\n    fontSize:   fontSize.xs,\r\n    fontWeight: fontWeight.medium,\r\n    lineHeight: lineHeight.normal,\r\n  },\r\n  mono: {\r\n    fontFamily:         fontFamily.mono,\r\n    fontSize:           fontSize.sm,\r\n    fontWeight:         fontWeight.medium,\r\n    fontVariantNumeric: \"tabular-nums\", // R-T.3\r\n    letterSpacing:      letterSpacing.tight,\r\n  },\r\n};\r\n\r\nconst typography = { fontFamily, fontSize, fontWeight, lineHeight, letterSpacing, variants };\r\nexport default typography;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/tokens/zIndex.js

@@ -0,0 +1,44 @@
+/**
+ * Z-index scale — Portnet UI v2
+ * Aligned with Design System v1.0 §02.6.
+ *
+ * Charter forbids inline z-index numerics. Use named tokens only.
+ *
+ * MUI compatibility:
+ *   Material UI's default zIndex scale runs 1100..1500. We override
+ *   it via `createPortnetTheme` so MUI components (Tooltip, Popper,
+ *   Snackbar, Modal) align with this scale and stay below `netError`.
+ *
+ * Layering invariant:
+ *   skipLink > netError. The skip-link must remain visible even
+ *   when the network-error banner is on screen, otherwise users
+ *   lose their keyboard escape hatch the moment connectivity drops.
+ */
+export var zIndex = {
+  base: 0,
+  sticky: 15,
+  // sticky headers (action bar)
+  topbar: 20,
+  // app topbar
+  bulk: 30,
+  // bulk action bar
+  overflow: 50,
+  // overflow menus inside flow
+  popover: 60,
+  // popovers (above overflow)
+  drawer: 80,
+  // drawer + backdrop
+  modal: 100,
+  // modal + backdrop
+  snackbar: 150,
+  // snackbars
+  toast: 200,
+  // toasts, command palette
+  tooltip: 250,
+  // tooltips (above toasts/modals)
+  netError: 2000,
+  // network error banner (top of all)
+  skipLink: 2010 // skip-link must remain visible above netError
+};
+export default zIndex;
+//# sourceMappingURL=zIndex.js.map

package/dist/esm/v2/tokens/zIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zIndex.js","names":["zIndex","base","sticky","topbar","bulk","overflow","popover","drawer","modal","snackbar","toast","tooltip","netError","skipLink"],"sources":["../../../../src/lib/v2/tokens/zIndex.ts"],"sourcesContent":["/**\r\n * Z-index scale — Portnet UI v2\r\n * Aligned with Design System v1.0 §02.6.\r\n *\r\n * Charter forbids inline z-index numerics. Use named tokens only.\r\n *\r\n * MUI compatibility:\r\n *   Material UI's default zIndex scale runs 1100..1500. We override\r\n *   it via `createPortnetTheme` so MUI components (Tooltip, Popper,\r\n *   Snackbar, Modal) align with this scale and stay below `netError`.\r\n *\r\n * Layering invariant:\r\n *   skipLink > netError. The skip-link must remain visible even\r\n *   when the network-error banner is on screen, otherwise users\r\n *   lose their keyboard escape hatch the moment connectivity drops.\r\n */\r\nexport const zIndex = {\r\n  base:     0,\r\n  sticky:   15,    // sticky headers (action bar)\r\n  topbar:   20,    // app topbar\r\n  bulk:     30,    // bulk action bar\r\n  overflow: 50,    // overflow menus inside flow\r\n  popover:  60,    // popovers (above overflow)\r\n  drawer:   80,    // drawer + backdrop\r\n  modal:    100,   // modal + backdrop\r\n  snackbar: 150,   // snackbars\r\n  toast:    200,   // toasts, command palette\r\n  tooltip:  250,   // tooltips (above toasts/modals)\r\n  netError: 2000,  // network error banner (top of all)\r\n  skipLink: 2010,  // skip-link must remain visible above netError\r\n};\r\n\r\nexport default zIndex;\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMA,MAAM,GAAG;EACpBC,IAAI,EAAM,CAAC;EACXC,MAAM,EAAI,EAAE;EAAK;EACjBC,MAAM,EAAI,EAAE;EAAK;EACjBC,IAAI,EAAM,EAAE;EAAK;EACjBC,QAAQ,EAAE,EAAE;EAAK;EACjBC,OAAO,EAAG,EAAE;EAAK;EACjBC,MAAM,EAAI,EAAE;EAAK;EACjBC,KAAK,EAAK,GAAG;EAAI;EACjBC,QAAQ,EAAE,GAAG;EAAI;EACjBC,KAAK,EAAK,GAAG;EAAI;EACjBC,OAAO,EAAG,GAAG;EAAI;EACjBC,QAAQ,EAAE,IAAI;EAAG;EACjBC,QAAQ,EAAE,IAAI,CAAG;AACnB,CAAC;AAED,eAAeb,MAAM","ignoreList":[]}

package/dist/esm/v2/types/common.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.js.map

package/dist/esm/v2/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":[],"sources":["../../../../src/lib/v2/types/common.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Shared UI type primitives.\r\n *\r\n * Framework-agnostic, cross-cutting types reused across the v2 surface.\r\n * No business meaning (those live in ../models).\r\n */\r\n\r\n/** Stable identifier for a data row (DataGrid, personalization, selection). */\r\nexport type RowId = string | number;\r\n\r\n/** Charter density modes (tokens/density.js). */\r\nexport type Density = \"comfortable\" | \"compact\";\r\n\r\n/** Charter responsive breakpoints (tokens/breakpoints.js; mirrors MUI). */\r\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\r\n\r\n/** Horizontal alignment for table cells / headers. */\r\nexport type Alignment = \"left\" | \"right\" | \"center\";\r\n\r\n/** Sort direction. */\r\nexport type SortDir = \"asc\" | \"desc\";\r\n\r\n/** A single (multi-)sort entry: column key + direction. */\r\nexport interface SortDescriptor {\r\n  key: string;\r\n  dir: SortDir;\r\n}\r\n\r\n/** WAI-ARIA `aria-sort` token (see SortableHeader.getAriaSort). */\r\nexport type AriaSort = \"none\" | \"ascending\" | \"descending\";\r\n"],"mappings":"","ignoreList":[]}

package/dist/esm/v2/types/datagrid.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=datagrid.js.map

package/dist/esm/v2/types/datagrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datagrid.js","names":[],"sources":["../../../../src/lib/v2/types/datagrid.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — DataGrid generic contract.\r\n *\r\n * Derived verbatim from the DataGrid / SortableHeader / _dataGridShared\r\n * PropTypes + implementation (the executable contract). MUI-independent:\r\n * component-level composition with MUI prop types happens in the component\r\n * itself (Part 2), not here.\r\n */\r\n\r\nimport type { Dispatch, ReactNode, SetStateAction } from \"react\";\r\nimport type { Alignment, Breakpoint, Density, RowId, SortDescriptor } from \"./common\";\r\n\r\n/** A DataGrid column definition over row type `T`. */\r\nexport interface DataGridColumn<T> {\r\n  /** Unique column key; also the default value accessor (`row[key]`). */\r\n  key: string;\r\n  /** Header content. */\r\n  header: ReactNode;\r\n  align?: Alignment | undefined;\r\n  /** Right-align + tabular numerals. */\r\n  numeric?: boolean | undefined;\r\n  /** Monospaced cell font + tabular numerals. */\r\n  mono?: boolean | undefined;\r\n  /** Default true when `onSortChange` is set; `false` opts the column out of sorting. */\r\n  sortable?: boolean | undefined;\r\n  /** Default true when the grid is `resizable`; `false` opts the column out. */\r\n  resizable?: boolean | undefined;\r\n  /** Default true when the grid is `reorderable`; `false` opts the column out. */\r\n  reorderable?: boolean | undefined;\r\n  /** Reveal the cell only on row hover / focus-within / coarse pointer. */\r\n  hoverOnly?: boolean | undefined;\r\n  /** Column may be toggled by a column-visibility UI. */\r\n  toggleable?: boolean | undefined;\r\n  /** Preferred width (px number or CSS length). */\r\n  width?: number | string | undefined;\r\n  /** Hard max width (px number or CSS length). */\r\n  maxWidth?: number | string | undefined;\r\n  /** Wrap long content instead of truncating with an ellipsis. */\r\n  wrap?: boolean | undefined;\r\n  /** Custom cell renderer; overrides `getValue` / `row[key]`. */\r\n  render?: ((row: T) => ReactNode) | undefined;\r\n  /** Custom value accessor used when `render` is absent (default `row[key]`). */\r\n  getValue?: ((row: T) => unknown) | undefined;\r\n}\r\n\r\n/** Pagination model for DataGrid (`page` is 1-based). */\r\nexport interface DataGridPagination {\r\n  page: number;\r\n  pageSize: number;\r\n  total: number;\r\n  onPageChange: (page: number) => void;\r\n  onPageSizeChange?: ((pageSize: number) => void) | undefined;\r\n  pageSizes?: number[] | undefined;\r\n}\r\n\r\n/** i18n labels for the DataGrid pagination bar. */\r\nexport interface DataGridPaginationLabels {\r\n  loading?: ReactNode | undefined;\r\n  rowsPerPage?: ReactNode | undefined;\r\n  firstPage?: string | undefined;\r\n  previousPage?: string | undefined;\r\n  nextPage?: string | undefined;\r\n  lastPage?: string | undefined;\r\n  /** Accessible name for the pagination navigation landmark (WCAG landmark / 2.4.1). */\r\n  navLabel?: string | undefined;\r\n  /** Range summary; `fmt` is the resolved locale number formatter. */\r\n  rangeOf?: ((from: number, to: number, total: number, fmt: (n: number) => string) => ReactNode) | undefined;\r\n}\r\n\r\n/** i18n labels for DataGrid. */\r\nexport interface DataGridLabels {\r\n  tableAria?: string | undefined;\r\n  selectAll?: string | undefined;\r\n  selectRow?: ((id: RowId) => string) | undefined;\r\n  actionsHeader?: string | undefined;\r\n  pagination?: DataGridPaginationLabels | undefined;\r\n}\r\n\r\n/** Context object passed to `renderMobileCard`. */\r\nexport interface DataGridMobileCardContext {\r\n  isActive: boolean;\r\n  isSelected: boolean;\r\n}\r\n\r\n/** Options accepted by the exported `applySort` helper. */\r\nexport interface ApplySortOptions {\r\n  /** BCP-47 locale for collation (default \"fr-FR\"). */\r\n  locale?: string | undefined;\r\n}\r\n\r\n/** Props for the DataGrid pattern over row type `T`. */\r\nexport interface DataGridProps<T> {\r\n  rows?: T[] | undefined;\r\n  columns: DataGridColumn<T>[];\r\n  loading?: boolean | undefined;\r\n  /** Any truthy value switches the grid to its error branch (renders `errorState`). */\r\n  error?: unknown;\r\n  sort?: SortDescriptor[] | undefined;\r\n  /**\r\n   * Sort-state setter. DataGrid forwards this straight to SortableHeader,\r\n   * which invokes it with an UPDATER function — so it must behave like a\r\n   * `useState` dispatcher (accepts a value OR a `(prev) => next` updater).\r\n   */\r\n  onSortChange?: Dispatch<SetStateAction<SortDescriptor[]>> | undefined;\r\n  selection?: Set<RowId> | RowId[] | undefined;\r\n  /** Receives the next selection as a `Set`. Presence enables the checkbox column. */\r\n  onSelectionChange?: ((selection: Set<RowId>) => void) | undefined;\r\n  pagination?: DataGridPagination | undefined;\r\n  emptyState?: ReactNode | undefined;\r\n  filteredEmptyState?: ReactNode | undefined;\r\n  errorState?: ReactNode | undefined;\r\n  /** Row identity (default `(row) => row.id`). */\r\n  getRowId?: ((row: T) => RowId) | undefined;\r\n  onRowClick?: ((row: T) => void) | undefined;\r\n  rowFlashId?: RowId | undefined;\r\n  activeRowId?: RowId | undefined;\r\n  /** Renders the per-row actions overlay. Presence enables the actions column. */\r\n  rowActions?: ((row: T) => ReactNode) | undefined;\r\n  hiddenColumns?: Set<string> | string[] | undefined;\r\n  /** Marks an empty result as filter-induced (renders `filteredEmptyState`). */\r\n  filtered?: boolean | undefined;\r\n  density?: Density | undefined;\r\n  /** Contextual accessible table name (WCAG 1.3.1 / Charter R-DG). */\r\n  ariaLabel?: string | undefined;\r\n  /** BCP-47 locale for number formatting (default \"fr-FR\"). */\r\n  locale?: string | undefined;\r\n  labels?: DataGridLabels | undefined;\r\n  maxBodyHeight?: number | string | undefined;\r\n  resizable?: boolean | undefined;\r\n  columnWidths?: Record<string, number> | undefined;\r\n  onColumnWidthsChange?: ((widths: Record<string, number>) => void) | undefined;\r\n  reorderable?: boolean | undefined;\r\n  columnOrder?: string[] | undefined;\r\n  onColumnOrderChange?: ((order: string[]) => void) | undefined;\r\n  /** Opt-in mobile card renderer; below `mobileBreakpoint` the grid renders cards. */\r\n  renderMobileCard?: ((row: T, ctx: DataGridMobileCardContext) => ReactNode) | undefined;\r\n  mobileBreakpoint?: Breakpoint | undefined;\r\n}\r\n"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,12 @@
+/**
+ * @portnet/ui v2 — Shared UI type architecture (barrel).
+ *
+ * Reusable UI/structural types. Business/domain models live under ../models.
+ * Topic modules are re-exported here; component-specific prop types are added
+ * as each component migrates (Part 2). The public typed surface is finalised
+ * in Batch 5 (barrels + `exports` type conditions).
+ */
+
+export * from "./common";
+export * from "./datagrid";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/lib/v2/types/index.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Shared UI type architecture (barrel).\r\n *\r\n * Reusable UI/structural types. Business/domain models live under ../models.\r\n * Topic modules are re-exported here; component-specific prop types are added\r\n * as each component migrates (Part 2). The public typed surface is finalised\r\n * in Batch 5 (barrels + `exports` type conditions).\r\n */\r\n\r\nexport * from \"./common\";\r\nexport * from \"./datagrid\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,UAAU;AACxB,cAAc,YAAY","ignoreList":[]}