@freighttech/ui 0.13.18

package/dist/backend/dynamic-table/split-view/index.js

@@ -0,0 +1,61 @@
+import { SplitViewHost } from "./SplitViewHost.js";
+import { EmptySlot } from "./EmptySlot.js";
+import {
+  ARRANGE_PRESETS,
+  GRID_TEMPLATES,
+  GRID_TEMPLATE_LIST,
+  PANE_MIN_HEIGHT_PX,
+  PANE_MIN_WIDTH_PX,
+  SPLIT_LAYOUT_VERSION,
+  applyGridTemplate,
+  applyPreset,
+  countPanes,
+  countSlots,
+  evenAll,
+  evenSizes,
+  fillSlot,
+  getNode,
+  listPanes,
+  listSlots,
+  makePaneId,
+  normalizeLayout,
+  paneTableId,
+  removePane,
+  resizeAt,
+  setAllPaneChrome,
+  setPaneChrome,
+  splitPane,
+  tableContent
+} from "./types.js";
+import { useSplitViewLayouts } from "./useSplitViewLayouts.js";
+export {
+  ARRANGE_PRESETS,
+  EmptySlot,
+  GRID_TEMPLATES,
+  GRID_TEMPLATE_LIST,
+  PANE_MIN_HEIGHT_PX,
+  PANE_MIN_WIDTH_PX,
+  SPLIT_LAYOUT_VERSION,
+  SplitViewHost,
+  applyGridTemplate,
+  applyPreset,
+  countPanes,
+  countSlots,
+  evenAll,
+  evenSizes,
+  fillSlot,
+  getNode,
+  listPanes,
+  listSlots,
+  makePaneId,
+  normalizeLayout,
+  paneTableId,
+  removePane,
+  resizeAt,
+  setAllPaneChrome,
+  setPaneChrome,
+  splitPane,
+  tableContent,
+  useSplitViewLayouts
+};
+//# sourceMappingURL=index.js.map

package/dist/backend/dynamic-table/split-view/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/split-view/index.ts"],
+  "sourcesContent": ["export { SplitViewHost } from './SplitViewHost'\nexport type { SplitViewHostProps } from './SplitViewHost'\nexport { EmptySlot } from './EmptySlot'\nexport {\n  ARRANGE_PRESETS,\n  GRID_TEMPLATES,\n  GRID_TEMPLATE_LIST,\n  PANE_MIN_HEIGHT_PX,\n  PANE_MIN_WIDTH_PX,\n  SPLIT_LAYOUT_VERSION,\n  applyGridTemplate,\n  applyPreset,\n  countPanes,\n  countSlots,\n  evenAll,\n  evenSizes,\n  fillSlot,\n  getNode,\n  listPanes,\n  listSlots,\n  makePaneId,\n  normalizeLayout,\n  paneTableId,\n  removePane,\n  resizeAt,\n  setAllPaneChrome,\n  setPaneChrome,\n  splitPane,\n  tableContent,\n} from './types'\nexport type {\n  EmptyNode,\n  GridTemplate,\n  GridTemplateId,\n  LayoutNode,\n  LegacySplitLayoutV1,\n  NodePath,\n  PaneChrome,\n  PaneContentRef,\n  PaneNode,\n  PresetId,\n  SlotNode,\n  SplitDirection,\n  SplitLayout,\n  SplitNode,\n} from './types'\nexport { useSplitViewLayouts } from './useSplitViewLayouts'\nexport type { SavedSplitLayout } from './useSplitViewLayouts'\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAE9B,SAAS,iBAAiB;AAC1B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAiBP,SAAS,2BAA2B;",
+  "names": []
+}

package/dist/backend/dynamic-table/split-view/layoutPersistence.js

@@ -0,0 +1,91 @@
+"use client";
+import { DENSITY_SCOPE_CACHE_KEY } from "../hooks/useDensityPreference.js";
+import { getCurrentOrganizationScope } from "@open-mercato/shared/lib/frontend/organizationEvents";
+import {
+  countPanes,
+  normalizeLayout
+} from "./types.js";
+const SPLIT_LAYOUT_STORAGE_PREFIX = "fms.dt.split";
+const FALLBACK_SCOPE = "shared";
+function scopeCandidates() {
+  const scopes = [];
+  try {
+    const cached = window.localStorage.getItem(DENSITY_SCOPE_CACHE_KEY);
+    if (cached) scopes.push(cached);
+  } catch {
+  }
+  try {
+    const org = getCurrentOrganizationScope().organizationId;
+    if (org) scopes.push(org);
+  } catch {
+  }
+  scopes.push(FALLBACK_SCOPE);
+  return Array.from(new Set(scopes));
+}
+function keyFor(anchorTableId, scope) {
+  return `${SPLIT_LAYOUT_STORAGE_PREFIX}:${scope}:${anchorTableId}`;
+}
+function pruneUnknown(node, isKnown) {
+  if (node.kind === "pane") return isKnown(node.content) ? node : null;
+  if (node.kind === "empty") return node;
+  const kept = [];
+  const sizes = [];
+  node.children.forEach((child, index) => {
+    const pruned = pruneUnknown(child, isKnown);
+    if (!pruned) return;
+    kept.push(pruned);
+    sizes.push(node.sizes?.[index] ?? 1 / node.children.length);
+  });
+  if (kept.length === 0) return null;
+  if (kept.length === 1) return kept[0];
+  const total = sizes.reduce((sum, value) => sum + value, 0) || 1;
+  return { ...node, children: kept, sizes: sizes.map((value) => value / total) };
+}
+function readStoredLayout(anchorTableId, isKnown) {
+  if (typeof window === "undefined") return null;
+  let raw = null;
+  try {
+    for (const scope of scopeCandidates()) {
+      raw = window.localStorage.getItem(keyFor(anchorTableId, scope));
+      if (raw) break;
+    }
+  } catch {
+    return null;
+  }
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") return null;
+    const layout = normalizeLayout(parsed, anchorTableId);
+    if (!layout?.root) return null;
+    const pruned = pruneUnknown(layout.root, isKnown);
+    if (!pruned) return null;
+    if (countPanes(pruned) === 0) return null;
+    return { ...layout, root: pruned };
+  } catch {
+    return null;
+  }
+}
+function writeStoredLayout(anchorTableId, layout) {
+  if (typeof window === "undefined") return;
+  try {
+    const [best, ...stale] = scopeCandidates();
+    window.localStorage.setItem(keyFor(anchorTableId, best), JSON.stringify(layout));
+    for (const scope of stale) window.localStorage.removeItem(keyFor(anchorTableId, scope));
+  } catch {
+  }
+}
+function clearStoredLayout(anchorTableId) {
+  if (typeof window === "undefined") return;
+  try {
+    for (const scope of scopeCandidates()) window.localStorage.removeItem(keyFor(anchorTableId, scope));
+  } catch {
+  }
+}
+export {
+  SPLIT_LAYOUT_STORAGE_PREFIX,
+  clearStoredLayout,
+  readStoredLayout,
+  writeStoredLayout
+};
+//# sourceMappingURL=layoutPersistence.js.map

package/dist/backend/dynamic-table/split-view/layoutPersistence.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/split-view/layoutPersistence.ts"],
+  "sourcesContent": ["'use client'\n\n/**\n * WORKING-LAYOUT PERSISTENCE \u2014 what you left on screen is what you come back to.\n *\n * Without this the split view was amnesiac: open invoicing beside transports,\n * drag the divider, hide a toolbar, reload \u2014 and you were back to one pane at\n * the default width with the chrome restored. Every arrangement had to be\n * rebuilt by hand on every page load, which makes the feature decorative.\n *\n * This is the WORKING layout (the one you are using right now), which is a\n * different thing from a NAMED layout (`useSplitViewLayouts`, saved to the\n * server under a name you chose). Named layouts are deliberate and shareable;\n * the working layout is incidental and personal. Only the latter is stored\n * here.\n *\n * localStorage, user-scoped, for the same reasons `useDensityPreference`\n * argues at length: it CANNOT leak between users (the A3 incident, where one\n * person's view change hit the whole organisation, was received as a bug), it\n * is synchronous so the first paint is already correct rather than flashing\n * one-pane-then-two, and a layout is a statement about the SCREEN you are\n * sitting at \u2014 a 27\" desk monitor and a 13\" laptop want different answers.\n *\n * The scope segment reuses density's `fms.dt.uid` cache rather than resolving\n * identity a third way, so all three stores agree on who the user is.\n */\n\nimport { DENSITY_SCOPE_CACHE_KEY } from '../hooks/useDensityPreference'\nimport { getCurrentOrganizationScope } from '@open-mercato/shared/lib/frontend/organizationEvents'\nimport {\n  countPanes,\n  normalizeLayout,\n  type LayoutNode,\n  type PaneContentRef,\n  type SplitLayout,\n} from './types'\n\nexport const SPLIT_LAYOUT_STORAGE_PREFIX = 'fms.dt.split'\n\nconst FALLBACK_SCOPE = 'shared'\n\n/**\n * Every scope this user could plausibly have written under, best first.\n *\n * The scope segment is NOT stable across a page load: the shared `fms.dt.uid`\n * cache is populated asynchronously, so an early write (first paint, before\n * identity resolves) lands under the organisation or `shared`, while a later\n * read resolves the real user id. Keying on a single \"current\" scope therefore\n * loses the layout on the next load \u2014 observed as the split view forgetting a\n * four-pane arrangement immediately after login.\n *\n * Rather than coordinate on the async hydration, reads try every candidate and\n * writes collapse to the best one, so at most one entry survives per table.\n */\nfunction scopeCandidates(): string[] {\n  const scopes: string[] = []\n  try {\n    const cached = window.localStorage.getItem(DENSITY_SCOPE_CACHE_KEY)\n    if (cached) scopes.push(cached)\n  } catch {\n    /* storage unavailable \u2014 the org scope below still applies */\n  }\n  try {\n    const org = getCurrentOrganizationScope().organizationId\n    if (org) scopes.push(org)\n  } catch {\n    /* scope module not ready */\n  }\n  scopes.push(FALLBACK_SCOPE)\n  return Array.from(new Set(scopes))\n}\n\n/** One entry per ANCHOR table: the transports page and the invoicing page each\n *  remember their own arrangement, which is how users think about them. */\nfunction keyFor(anchorTableId: string, scope: string): string {\n  return `${SPLIT_LAYOUT_STORAGE_PREFIX}:${scope}:${anchorTableId}`\n}\n\n/**\n * Drop panes whose CONTENT the user can no longer open.\n *\n * A stored layout outlives the grant that created it: a feature can be revoked,\n * a module removed, a table renamed, a widget dropped from the catalogue.\n * Restoring such a pane would mount an unresolvable id and leave a permanently\n * empty box the user cannot get rid of \u2014 it carries no toolbar, so it carries\n * no menu to close it with \u2014 so the pane is dropped and its siblings absorb the\n * space.\n *\n * EMPTY slots always survive: a hole the user deliberately left in a grid\n * template is content in its own right, and it is removable from the UI.\n *\n * Returns `null` when nothing survives \u2014 the caller then falls back to the\n * plain single pane rather than rendering an empty split.\n */\nfunction pruneUnknown(\n  node: LayoutNode,\n  isKnown: (content: PaneContentRef) => boolean,\n): LayoutNode | null {\n  if (node.kind === 'pane') return isKnown(node.content) ? node : null\n  if (node.kind === 'empty') return node\n\n  const kept: LayoutNode[] = []\n  const sizes: number[] = []\n  node.children.forEach((child, index) => {\n    const pruned = pruneUnknown(child, isKnown)\n    if (!pruned) return\n    kept.push(pruned)\n    sizes.push(node.sizes?.[index] ?? 1 / node.children.length)\n  })\n\n  if (kept.length === 0) return null\n  // A split with one surviving child is not a split any more.\n  if (kept.length === 1) return kept[0]\n\n  const total = sizes.reduce((sum, value) => sum + value, 0) || 1\n  return { ...node, children: kept, sizes: sizes.map((value) => value / total) }\n}\n\n/**\n * Read the stored working layout, or `null` when there is none, it is corrupt,\n * it predates the current tree model, or none of its tables resolve.\n *\n * Deliberately total: a user whose stored layout cannot be honoured gets the\n * default view, never a crash and never an empty screen.\n */\nexport function readStoredLayout(\n  anchorTableId: string,\n  isKnown: (content: PaneContentRef) => boolean,\n): SplitLayout | null {\n  if (typeof window === 'undefined') return null\n  let raw: string | null = null\n  try {\n    for (const scope of scopeCandidates()) {\n      raw = window.localStorage.getItem(keyFor(anchorTableId, scope))\n      if (raw) break\n    }\n  } catch {\n    return null\n  }\n  if (!raw) return null\n\n  try {\n    const parsed = JSON.parse(raw) as unknown\n    if (!parsed || typeof parsed !== 'object') return null\n    const layout = normalizeLayout(parsed, anchorTableId)\n    if (!layout?.root) return null\n    const pruned = pruneUnknown(layout.root, isKnown)\n    if (!pruned) return null\n    // A workspace with nothing left in it is not worth restoring: the page's\n    // own table is a better answer than a screen of holes, and the user can\n    // pick a template again in two clicks.\n    if (countPanes(pruned) === 0) return null\n    return { ...layout, root: pruned }\n  } catch {\n    // Corrupt JSON, or a shape from a future/never-shipped version. Treated\n    // exactly like \"no stored layout\" \u2014 the default is always safe.\n    return null\n  }\n}\n\n/** Best-effort write. A user with no reachable storage simply gets today's\n *  amnesiac behaviour rather than an error. */\nexport function writeStoredLayout(anchorTableId: string, layout: SplitLayout): void {\n  if (typeof window === 'undefined') return\n  try {\n    const [best, ...stale] = scopeCandidates()\n    window.localStorage.setItem(keyFor(anchorTableId, best), JSON.stringify(layout))\n    // Collapse to one entry: once identity resolves, anything written earlier\n    // under the org/`shared` fallback is a duplicate that would later shadow or\n    // resurrect an older arrangement.\n    for (const scope of stale) window.localStorage.removeItem(keyFor(anchorTableId, scope))\n  } catch {\n    /* quota exceeded / storage blocked \u2014 persistence is best-effort */\n  }\n}\n\n/** Used by tests, and by any future \"reset this page's layout\" affordance. */\nexport function clearStoredLayout(anchorTableId: string): void {\n  if (typeof window === 'undefined') return\n  try {\n    for (const scope of scopeCandidates()) window.localStorage.removeItem(keyFor(anchorTableId, scope))\n  } catch {\n    /* nothing to do */\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/backend/dynamic-table/split-view/sharedCriteria.js

@@ -0,0 +1,62 @@
+import { needsValueInput } from "../types/filters.js";
+const SHARED_CRITERION_KEYS = ["customer", "dateRange", "status", "transportMode"];
+const NOTHING = Object.freeze({
+  filters: Object.freeze([]),
+  unmapped: Object.freeze([])
+});
+const SHARED_FILTER_ID_PREFIX = "shared:";
+function isSharedCriterionKey(value) {
+  return SHARED_CRITERION_KEYS.includes(value);
+}
+function isInert(rule) {
+  return needsValueInput(rule.operator) && rule.values.length === 0;
+}
+function mapWith(criteria, mapping) {
+  const rules = criteria?.rules;
+  if (!rules || rules.length === 0) return NOTHING;
+  const filters = [];
+  const unmapped = [];
+  for (const rule of rules) {
+    if (!isSharedCriterionKey(rule.key)) continue;
+    const field = mapping?.[rule.key];
+    if (!field) {
+      if (!unmapped.includes(rule.key)) unmapped.push(rule.key);
+      continue;
+    }
+    if (isInert(rule)) continue;
+    filters.push({
+      // Deterministic, not random: the same criteria must produce the same
+      // request string on every render, or the list query key churns and the
+      // pane refetches on every parent re-render. The prefix also lets a
+      // consumer tell a shared row from one the user authored.
+      id: `${SHARED_FILTER_ID_PREFIX}${rule.key}`,
+      field,
+      operator: rule.operator,
+      values: [...rule.values]
+    });
+  }
+  if (filters.length === 0 && unmapped.length === 0) return NOTHING;
+  return { filters, unmapped };
+}
+function mapCriteriaForTable(criteria, metadata) {
+  return mapWith(criteria, metadata?.sharedFilters);
+}
+const WIDGET_SHARED_FILTERS = {};
+function mapCriteriaForWidget(criteria, widgetId) {
+  return mapWith(criteria, widgetId ? WIDGET_SHARED_FILTERS[widgetId] : void 0);
+}
+function mergeSharedFilters(own, shared) {
+  if (!shared || shared.length === 0) return own;
+  const sharedFields = new Set(shared.map((row) => row.field));
+  return [...own.filter((row) => !sharedFields.has(row.field)), ...shared];
+}
+export {
+  SHARED_CRITERION_KEYS,
+  SHARED_FILTER_ID_PREFIX,
+  WIDGET_SHARED_FILTERS,
+  isSharedCriterionKey,
+  mapCriteriaForTable,
+  mapCriteriaForWidget,
+  mergeSharedFilters
+};
+//# sourceMappingURL=sharedCriteria.js.map

package/dist/backend/dynamic-table/split-view/sharedCriteria.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/split-view/sharedCriteria.ts"],
+  "sourcesContent": ["/**\n * Workspace-level shared criteria \u2014 one question asked of every pane at once.\n *\n * WHY A MAPPING AT ALL: panes hold DIFFERENT entities. \"Customer\" is\n * `contractorId` on transports, `customerId` on offers and nothing at all on a\n * ships map. Matching on column name was rejected (FMS schemas barely share\n * names, so nearly every pane would grey out); matching semantically off\n * `entityId` was rejected for a worse reason \u2014 when a pane silently fails to\n * filter, the user is reading the wrong rows *believing* they are filtered.\n *\n * So every table DECLARES which of its own fields answers each criterion\n * (`TableDefinitionMetadata.sharedFilters`), and anything that cannot be\n * answered is RETURNED as `unmapped` for the pane to say so out loud. Silence\n * is the failure mode this module exists to prevent.\n *\n * Pure functions, no React, no I/O \u2014 the whole mechanism is unit-testable.\n *\n * Spec: .ai/specs/2026-08-17-split-view-workspace-composition.md\n */\n\nimport type { FilterRow } from '../types/index'\nimport { needsValueInput, type FilterOperator } from '../types/filters'\n\n/**\n * The vocabulary. CLOSED, deliberately: an open one cannot be mapped onto a\n * table's own field names, validated on the server, or explained to a user when\n * a pane cannot honour it.\n *\n * MUST stay identical to `SHARED_CRITERION_KEYS` in\n * `packages/split-view/src/modules/split_views/data/validators.ts` \u2014 that zod\n * enum is the server's authority and rejects anything it does not know, so a\n * key added here alone would 400 on save with no clue why.\n */\nexport const SHARED_CRITERION_KEYS = ['customer', 'dateRange', 'status', 'transportMode'] as const\n\nexport type SharedCriterionKey = (typeof SHARED_CRITERION_KEYS)[number]\n\nexport type SharedCriterionRule = {\n  key: SharedCriterionKey\n  operator: FilterOperator\n  values: unknown[]\n}\n\n/** What the workspace bar owns: one search string plus zero or more rules. */\nexport type SharedCriteria = {\n  search?: string\n  rules: SharedCriterionRule[]\n}\n\n/** A table's (or widget's) answer to the vocabulary, in its OWN field names. */\nexport type SharedFilterMapping = Partial<Record<SharedCriterionKey, string>>\n\n/**\n * The result of asking one pane to honour the criteria.\n *\n * `unmapped` is not diagnostics \u2014 it is what the pane renders as \"not filtered\n * by customer\". A caller that drops it reintroduces exactly the silent wrong\n * data this module was written to prevent.\n */\nexport type MappedCriteria = {\n  filters: FilterRow[]\n  unmapped: SharedCriterionKey[]\n}\n\n/** Shared identity for \"nothing to apply\", so callers can compare by reference. */\nconst NOTHING: MappedCriteria = Object.freeze({\n  filters: Object.freeze([]) as unknown as FilterRow[],\n  unmapped: Object.freeze([]) as unknown as SharedCriterionKey[],\n})\n\n/** `FilterRow.id` prefix. Deterministic \u2014 see `mapCriteriaForTable`. */\nexport const SHARED_FILTER_ID_PREFIX = 'shared:'\n\nexport function isSharedCriterionKey(value: unknown): value is SharedCriterionKey {\n  return (SHARED_CRITERION_KEYS as readonly unknown[]).includes(value)\n}\n\n/** True for a rule that would filter nothing away, so it is not worth sending. */\nfunction isInert(rule: SharedCriterionRule): boolean {\n  return needsValueInput(rule.operator) && rule.values.length === 0\n}\n\nfunction mapWith(criteria: SharedCriteria | null | undefined, mapping: SharedFilterMapping | undefined): MappedCriteria {\n  const rules = criteria?.rules\n  if (!rules || rules.length === 0) return NOTHING\n\n  const filters: FilterRow[] = []\n  const unmapped: SharedCriterionKey[] = []\n\n  for (const rule of rules) {\n    // A key outside the vocabulary is DROPPED here and never reaches the\n    // request. It cannot be reported as unmapped either \u2014 `unmapped` is typed\n    // to the vocabulary, and a pane cannot honestly caption a criterion whose\n    // meaning nobody defines. The server's zod enum rejects it on save; this is\n    // the same refusal one layer earlier, for criteria restored from an older\n    // client or a hand-edited row.\n    if (!isSharedCriterionKey(rule.key)) continue\n\n    const field = mapping?.[rule.key]\n    if (!field) {\n      if (!unmapped.includes(rule.key)) unmapped.push(rule.key)\n      continue\n    }\n    if (isInert(rule)) continue\n\n    filters.push({\n      // Deterministic, not random: the same criteria must produce the same\n      // request string on every render, or the list query key churns and the\n      // pane refetches on every parent re-render. The prefix also lets a\n      // consumer tell a shared row from one the user authored.\n      id: `${SHARED_FILTER_ID_PREFIX}${rule.key}`,\n      field,\n      operator: rule.operator,\n      values: [...rule.values],\n    })\n  }\n\n  if (filters.length === 0 && unmapped.length === 0) return NOTHING\n  return { filters, unmapped }\n}\n\n/**\n * Translate the workspace criteria into ONE table's own field names.\n *\n * `metadata` is deliberately a structural type rather than the whole\n * `TableDefinitionMetadata`: this stays testable without building a registry\n * entry, and a table that never declares `sharedFilters` simply reports every\n * live criterion as unmapped.\n */\nexport function mapCriteriaForTable(\n  criteria: SharedCriteria | null | undefined,\n  metadata: { sharedFilters?: SharedFilterMapping } | null | undefined,\n): MappedCriteria {\n  return mapWith(criteria, metadata?.sharedFilters)\n}\n\n/**\n * Widget shared-filter mappings, keyed by widget id.\n *\n * WHY IT IS HERE and not on the widget: `DashboardWidgetMetadata` is an\n * `@open-mercato/*` type this repo consumes read-only. Declaring the mapping on\n * it would be an upstream change, which this spec forbids outright \u2014 so the\n * declaration lives on our side of the line instead.\n *\n * DELIBERATELY EMPTY. A widget appears here only once someone has READ its\n * component and confirmed it accepts an equivalent value through `settings`;\n * an invented entry would produce a pane that claims to be filtered and is not,\n * which is strictly worse than one that admits it is not filtered.\n *\n * To add one:\n *   1. Open the widget and find the `settings` key it filters on.\n *   2. Add `'<module>:<widget>': { customer: 'contractorId' }` below.\n *   3. The pane stops reporting that criterion as unmapped, and the host passes\n *      the mapped value through the slot's `settings`.\n */\nexport const WIDGET_SHARED_FILTERS: Record<string, SharedFilterMapping> = {}\n\n/**\n * Same contract as `mapCriteriaForTable`, for a widget pane.\n *\n * A widget with no entry reports every live criterion as unmapped and STILL\n * RENDERS \u2014 its own data, unfiltered, with the pane saying so. Blanking it\n * would destroy the reason the user put it on screen.\n */\nexport function mapCriteriaForWidget(\n  criteria: SharedCriteria | null | undefined,\n  widgetId: string | null | undefined,\n): MappedCriteria {\n  return mapWith(criteria, widgetId ? WIDGET_SHARED_FILTERS[widgetId] : undefined)\n}\n\n/**\n * The pane's OWN filters combined with the workspace's, for one request.\n *\n * Two invariants, both load-bearing:\n *\n *  1. **`own` is never mutated and never re-ordered.** Shared criteria are a\n *     view over the pane's state, not a write to it \u2014 otherwise turning the\n *     workspace toggle off could not restore what the user had, because it\n *     would have been overwritten.\n *  2. **With nothing shared, the SAME array reference comes back**, so every\n *     memo downstream of it (query params, and through them the list query key)\n *     is byte-identical to a build without this feature.\n *\n * Precedence: a shared rule REPLACES the pane's own rule on the same field for\n * the duration of the request. Sending both would AND two rules over one column\n * \u2014 usually zero rows \u2014 and the bar is the control the user is looking at.\n */\nexport function mergeSharedFilters(\n  own: FilterRow[],\n  shared: FilterRow[] | null | undefined,\n): FilterRow[] {\n  if (!shared || shared.length === 0) return own\n  const sharedFields = new Set(shared.map((row) => row.field))\n  return [...own.filter((row) => !sharedFields.has(row.field)), ...shared]\n}\n"],
+  "mappings": "AAqBA,SAAS,uBAA4C;AAY9C,MAAM,wBAAwB,CAAC,YAAY,aAAa,UAAU,eAAe;AAgCxF,MAAM,UAA0B,OAAO,OAAO;AAAA,EAC5C,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,EACzB,UAAU,OAAO,OAAO,CAAC,CAAC;AAC5B,CAAC;AAGM,MAAM,0BAA0B;AAEhC,SAAS,qBAAqB,OAA6C;AAChF,SAAQ,sBAA6C,SAAS,KAAK;AACrE;AAGA,SAAS,QAAQ,MAAoC;AACnD,SAAO,gBAAgB,KAAK,QAAQ,KAAK,KAAK,OAAO,WAAW;AAClE;AAEA,SAAS,QAAQ,UAA6C,SAA0D;AACtH,QAAM,QAAQ,UAAU;AACxB,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG,QAAO;AAEzC,QAAM,UAAuB,CAAC;AAC9B,QAAM,WAAiC,CAAC;AAExC,aAAW,QAAQ,OAAO;AAOxB,QAAI,CAAC,qBAAqB,KAAK,GAAG,EAAG;AAErC,UAAM,QAAQ,UAAU,KAAK,GAAG;AAChC,QAAI,CAAC,OAAO;AACV,UAAI,CAAC,SAAS,SAAS,KAAK,GAAG,EAAG,UAAS,KAAK,KAAK,GAAG;AACxD;AAAA,IACF;AACA,QAAI,QAAQ,IAAI,EAAG;AAEnB,YAAQ,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA,MAKX,IAAI,GAAG,uBAAuB,GAAG,KAAK,GAAG;AAAA,MACzC;AAAA,MACA,UAAU,KAAK;AAAA,MACf,QAAQ,CAAC,GAAG,KAAK,MAAM;AAAA,IACzB,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,WAAW,KAAK,SAAS,WAAW,EAAG,QAAO;AAC1D,SAAO,EAAE,SAAS,SAAS;AAC7B;AAUO,SAAS,oBACd,UACA,UACgB;AAChB,SAAO,QAAQ,UAAU,UAAU,aAAa;AAClD;AAqBO,MAAM,wBAA6D,CAAC;AASpE,SAAS,qBACd,UACA,UACgB;AAChB,SAAO,QAAQ,UAAU,WAAW,sBAAsB,QAAQ,IAAI,MAAS;AACjF;AAmBO,SAAS,mBACd,KACA,QACa;AACb,MAAI,CAAC,UAAU,OAAO,WAAW,EAAG,QAAO;AAC3C,QAAM,eAAe,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;AAC3D,SAAO,CAAC,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI,KAAK,CAAC,GAAG,GAAG,MAAM;AACzE;",
+  "names": []
+}