@persona/design-system 0.7.1 → 0.8.0

package/dist/{date-filter-CZeChs9T.mjs.map → date-filter-BnzR6NxT.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"date-filter-CZeChs9T.mjs","names":[],"sources":["../lib/date-filter/types.ts","../lib/date-filter/codec.ts"],"sourcesContent":["/** Ordered preset list shared by date-filter consumers. */\nexport const DATE_FILTER_PRESETS = [\n  'last_7_days',\n  'last_14_days',\n  'last_30_days',\n  'this_month',\n  'last_month',\n  'this_year',\n  'last_year',\n] as const;\n\n/** Closed vocabulary of named presets the picker offers. */\nexport type DateFilterPreset = (typeof DATE_FILTER_PRESETS)[number];\n\nexport const DATE_FILTER_PRESET_LABELS: Record<DateFilterPreset, string> = {\n  last_7_days: 'Last 7 days',\n  last_14_days: 'Last 14 days',\n  last_30_days: 'Last 30 days',\n  this_month: 'This month',\n  last_month: 'Last month',\n  this_year: 'This year',\n  last_year: 'Last year',\n};\n\nexport interface AbsoluteDateFilterValue {\n  kind: 'absolute';\n  startDate?: string;\n  endDate?: string;\n}\n\nexport interface PresetRelativeDateFilterValue {\n  kind: 'relative';\n  preset: DateFilterPreset;\n}\n\nexport type RelativeDateFilterValue = PresetRelativeDateFilterValue;\n\nexport type DateFilterValue = AbsoluteDateFilterValue | RelativeDateFilterValue;\n\nexport interface AbsoluteDateRange {\n  startDate?: string;\n  endDate?: string;\n}\n","import { DateTime, Settings } from 'luxon';\n\nimport { DATE_FILTER_PRESET_LABELS, DATE_FILTER_PRESETS } from './types';\nimport type {\n  AbsoluteDateFilterValue,\n  AbsoluteDateRange,\n  DateFilterPreset,\n  DateFilterValue,\n  PresetRelativeDateFilterValue,\n  RelativeDateFilterValue,\n} from './types';\n\ntype InternalWindow =\n  | { mode: 'rolling-days'; days: number }\n  | { mode: 'calendar'; unit: 'month' | 'year'; offset: 0 | 1 };\n\nconst PRESET_WINDOWS = {\n  last_7_days: { mode: 'rolling-days', days: 7 },\n  last_14_days: { mode: 'rolling-days', days: 14 },\n  last_30_days: { mode: 'rolling-days', days: 30 },\n  this_month: { mode: 'calendar', unit: 'month', offset: 0 },\n  last_month: { mode: 'calendar', unit: 'month', offset: 1 },\n  this_year: { mode: 'calendar', unit: 'year', offset: 0 },\n  last_year: { mode: 'calendar', unit: 'year', offset: 1 },\n} satisfies Record<DateFilterPreset, InternalWindow>;\n\nconst DATE_FILTER_PRESET_SET = new Set<DateFilterPreset>(DATE_FILTER_PRESETS);\n\nfunction isOptionalString(value: unknown): value is string | undefined {\n  return typeof value === 'undefined' || typeof value === 'string';\n}\n\nfunction normalizeOptionalString(value: unknown): unknown {\n  return value == null ? undefined : value;\n}\n\nfunction isAbsoluteDateFilterValue(value: unknown): value is AbsoluteDateFilterValue {\n  if (typeof value !== 'object' || value == null || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Record<string, unknown>;\n  return (\n    record.kind === 'absolute' &&\n    isOptionalString(normalizeOptionalString(record.startDate)) &&\n    isOptionalString(normalizeOptionalString(record.endDate))\n  );\n}\n\nfunction isPresetRelativeDateFilterValue(value: unknown): value is PresetRelativeDateFilterValue {\n  if (typeof value !== 'object' || value == null || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Record<string, unknown>;\n  return (\n    record.kind === 'relative' &&\n    typeof record.preset === 'string' &&\n    DATE_FILTER_PRESET_SET.has(record.preset as DateFilterPreset)\n  );\n}\n\nfunction normalizedAbsoluteDateRange(value: Record<string, unknown>): AbsoluteDateRange {\n  return {\n    startDate: normalizeOptionalString(value.startDate) as string | undefined,\n    endDate: normalizeOptionalString(value.endDate) as string | undefined,\n  };\n}\n\nexport function parseDateFilterValue(raw: unknown): DateFilterValue | null {\n  if (typeof raw !== 'object' || raw == null || Array.isArray(raw)) {\n    return null;\n  }\n  const value = raw as Record<string, unknown>;\n  if (!('kind' in value)) {\n    if (\n      ('startDate' in value || 'endDate' in value) &&\n      isOptionalString(normalizeOptionalString(value.startDate)) &&\n      isOptionalString(normalizeOptionalString(value.endDate))\n    ) {\n      return {\n        kind: 'absolute',\n        ...normalizedAbsoluteDateRange(value),\n      };\n    }\n    return null;\n  }\n  if (isAbsoluteDateFilterValue(value)) {\n    return {\n      kind: 'absolute',\n      ...normalizedAbsoluteDateRange(value),\n    };\n  }\n  if (isPresetRelativeDateFilterValue(value)) {\n    return {\n      kind: 'relative',\n      preset: value.preset,\n    };\n  }\n  return 'startDate' in value || 'endDate' in value\n    ? parseDateFilterValue({ startDate: value.startDate, endDate: value.endDate })\n    : null;\n}\n\nfunction relativeWindowFor(value: RelativeDateFilterValue): InternalWindow {\n  return PRESET_WINDOWS[value.preset];\n}\n\nfunction dateTimeToISO(value: DateTime): string {\n  const iso = value.toISO();\n  if (iso == null) {\n    throw new Error(\n      `Unable to evaluate invalid date: ${value.invalidExplanation ?? 'unknown error'}`,\n    );\n  }\n  return iso;\n}\n\nfunction isValidZone(zone: string): boolean {\n  return DateTime.utc().setZone(zone).isValid;\n}\n\nfunction resolvedZone(zone?: string): string {\n  if (zone && isValidZone(zone)) {\n    return zone;\n  }\n\n  const defaultZone = Settings.defaultZone.name;\n  return isValidZone(defaultZone) ? defaultZone : 'UTC';\n}\n\nfunction evaluationNow(context: { zone?: string; now?: DateTime }): DateTime {\n  // Constructing `DateTime.now()` uses Settings.defaultZone and is itself invalid\n  // when an application has configured an unsupported default zone. UTC gives us\n  // the same instant without depending on that ambient setting.\n  const now = context.now ?? DateTime.utc();\n  if (!now.isValid) {\n    throw new Error(\n      `Unable to evaluate invalid date: ${now.invalidExplanation ?? 'unknown error'}`,\n    );\n  }\n\n  const zonedNow = now.setZone(resolvedZone(context.zone));\n  if (!zonedNow.isValid) {\n    throw new Error(\n      `Unable to evaluate invalid date: ${zonedNow.invalidExplanation ?? 'unknown error'}`,\n    );\n  }\n  return zonedNow;\n}\n\nfunction evaluateRelative(\n  value: RelativeDateFilterValue,\n  context: { zone?: string; now?: DateTime },\n): Required<AbsoluteDateRange> {\n  const window = relativeWindowFor(value);\n  const zonedNow = evaluationNow(context);\n  let start: DateTime;\n  let end: DateTime;\n\n  if (window.mode === 'rolling-days') {\n    end = zonedNow.endOf('day');\n    // Preserve the established picker and legacy-filter contract: `days` is a\n    // lookback offset, so the start date and today are both included.\n    start = zonedNow.minus({ days: window.days }).startOf('day');\n  } else {\n    const referencedPeriod = zonedNow.minus({ [window.unit]: window.offset });\n    start = referencedPeriod.startOf(window.unit);\n    end = window.offset === 0 ? zonedNow.endOf('day') : referencedPeriod.endOf(window.unit);\n  }\n\n  return { startDate: dateTimeToISO(start), endDate: dateTimeToISO(end) };\n}\n\nexport function resolveDateFilterValue(\n  value: RelativeDateFilterValue,\n  context?: { zone?: string; now?: DateTime },\n): Required<AbsoluteDateRange>;\nexport function resolveDateFilterValue(\n  value: DateFilterValue,\n  context?: { zone?: string; now?: DateTime },\n): AbsoluteDateRange;\nexport function resolveDateFilterValue(\n  value: DateFilterValue,\n  context: { zone?: string; now?: DateTime } = {},\n): AbsoluteDateRange {\n  if (!isRelative(value)) {\n    return {\n      startDate: value.startDate,\n      endDate: value.endDate,\n    };\n  }\n  return evaluateRelative(value, context);\n}\n\n/**\n * Which preset a control should render as selected.\n *\n * Only stored metadata makes a value semantic. Once writes are enabled an absolute\n * value means the user picked dates, so inferring a preset from them would relabel\n * their choice; with writes disabled no metadata is ever stored, so inference is\n * the only thing that can highlight a preset at all.\n *\n * `undefined` asks the picker to infer from the dates, `null` selects nothing.\n */\nexport function selectedPresetFor(\n  value: DateFilterValue | null,\n  writesEnabled: boolean,\n): DateFilterPreset | null | undefined {\n  if (value != null && isRelative(value)) {\n    return value.preset;\n  }\n  return writesEnabled ? null : undefined;\n}\n\nexport function isRelative(value: DateFilterValue): value is RelativeDateFilterValue {\n  return value.kind === 'relative';\n}\n\nexport function formatDateFilterValue(value: DateFilterValue): string | null {\n  if (!isRelative(value)) {\n    return null;\n  }\n  return DATE_FILTER_PRESET_LABELS[value.preset];\n}\n"],"mappings":"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"}
+{"version":3,"file":"date-filter-BnzR6NxT.mjs","names":[],"sources":["../lib/date-filter/types.ts","../lib/date-filter/codec.ts"],"sourcesContent":["/** Ordered preset list shared by date-filter consumers. */\nexport const DATE_FILTER_PRESETS = [\n  'last_7_days',\n  'last_14_days',\n  'last_30_days',\n  'this_month',\n  'last_month',\n  'this_year',\n  'last_year',\n] as const;\n\n/** Closed vocabulary of named presets the picker offers. */\nexport type DateFilterPreset = (typeof DATE_FILTER_PRESETS)[number];\n\nexport const DATE_FILTER_PRESET_LABELS: Record<DateFilterPreset, string> = {\n  last_7_days: 'Last 7 days',\n  last_14_days: 'Last 14 days',\n  last_30_days: 'Last 30 days',\n  this_month: 'This month',\n  last_month: 'Last month',\n  this_year: 'This year',\n  last_year: 'Last year',\n};\n\nexport interface AbsoluteDateFilterValue {\n  kind: 'absolute';\n  startDate?: string;\n  endDate?: string;\n}\n\nexport interface PresetRelativeDateFilterValue {\n  kind: 'relative';\n  preset: DateFilterPreset;\n}\n\nexport type RelativeDateFilterValue = PresetRelativeDateFilterValue;\n\nexport type DateFilterValue = AbsoluteDateFilterValue | RelativeDateFilterValue;\n\nexport interface AbsoluteDateRange {\n  startDate?: string;\n  endDate?: string;\n}\n","import { DateTime, Settings } from 'luxon';\n\nimport { DATE_FILTER_PRESET_LABELS, DATE_FILTER_PRESETS } from './types';\nimport type {\n  AbsoluteDateFilterValue,\n  AbsoluteDateRange,\n  DateFilterPreset,\n  DateFilterValue,\n  PresetRelativeDateFilterValue,\n  RelativeDateFilterValue,\n} from './types';\n\ntype InternalWindow =\n  | { mode: 'rolling-days'; days: number }\n  | { mode: 'calendar'; unit: 'month' | 'year'; offset: 0 | 1 };\n\nconst PRESET_WINDOWS = {\n  last_7_days: { mode: 'rolling-days', days: 7 },\n  last_14_days: { mode: 'rolling-days', days: 14 },\n  last_30_days: { mode: 'rolling-days', days: 30 },\n  this_month: { mode: 'calendar', unit: 'month', offset: 0 },\n  last_month: { mode: 'calendar', unit: 'month', offset: 1 },\n  this_year: { mode: 'calendar', unit: 'year', offset: 0 },\n  last_year: { mode: 'calendar', unit: 'year', offset: 1 },\n} satisfies Record<DateFilterPreset, InternalWindow>;\n\nconst DATE_FILTER_PRESET_SET = new Set<DateFilterPreset>(DATE_FILTER_PRESETS);\n\nfunction isOptionalString(value: unknown): value is string | undefined {\n  return typeof value === 'undefined' || typeof value === 'string';\n}\n\nfunction normalizeOptionalString(value: unknown): unknown {\n  return value == null ? undefined : value;\n}\n\nfunction isAbsoluteDateFilterValue(value: unknown): value is AbsoluteDateFilterValue {\n  if (typeof value !== 'object' || value == null || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Record<string, unknown>;\n  return (\n    record.kind === 'absolute' &&\n    isOptionalString(normalizeOptionalString(record.startDate)) &&\n    isOptionalString(normalizeOptionalString(record.endDate))\n  );\n}\n\nfunction isPresetRelativeDateFilterValue(value: unknown): value is PresetRelativeDateFilterValue {\n  if (typeof value !== 'object' || value == null || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Record<string, unknown>;\n  return (\n    record.kind === 'relative' &&\n    typeof record.preset === 'string' &&\n    DATE_FILTER_PRESET_SET.has(record.preset as DateFilterPreset)\n  );\n}\n\nfunction normalizedAbsoluteDateRange(value: Record<string, unknown>): AbsoluteDateRange {\n  return {\n    startDate: normalizeOptionalString(value.startDate) as string | undefined,\n    endDate: normalizeOptionalString(value.endDate) as string | undefined,\n  };\n}\n\nexport function parseDateFilterValue(raw: unknown): DateFilterValue | null {\n  if (typeof raw !== 'object' || raw == null || Array.isArray(raw)) {\n    return null;\n  }\n  const value = raw as Record<string, unknown>;\n  if (!('kind' in value)) {\n    if (\n      ('startDate' in value || 'endDate' in value) &&\n      isOptionalString(normalizeOptionalString(value.startDate)) &&\n      isOptionalString(normalizeOptionalString(value.endDate))\n    ) {\n      return {\n        kind: 'absolute',\n        ...normalizedAbsoluteDateRange(value),\n      };\n    }\n    return null;\n  }\n  if (isAbsoluteDateFilterValue(value)) {\n    return {\n      kind: 'absolute',\n      ...normalizedAbsoluteDateRange(value),\n    };\n  }\n  if (isPresetRelativeDateFilterValue(value)) {\n    return {\n      kind: 'relative',\n      preset: value.preset,\n    };\n  }\n  return 'startDate' in value || 'endDate' in value\n    ? parseDateFilterValue({ startDate: value.startDate, endDate: value.endDate })\n    : null;\n}\n\nfunction relativeWindowFor(value: RelativeDateFilterValue): InternalWindow {\n  return PRESET_WINDOWS[value.preset];\n}\n\nfunction dateTimeToISO(value: DateTime): string {\n  const iso = value.toISO();\n  if (iso == null) {\n    throw new Error(\n      `Unable to evaluate invalid date: ${value.invalidExplanation ?? 'unknown error'}`,\n    );\n  }\n  return iso;\n}\n\nfunction isValidZone(zone: string): boolean {\n  return DateTime.utc().setZone(zone).isValid;\n}\n\nfunction resolvedZone(zone?: string): string {\n  if (zone && isValidZone(zone)) {\n    return zone;\n  }\n\n  const defaultZone = Settings.defaultZone.name;\n  return isValidZone(defaultZone) ? defaultZone : 'UTC';\n}\n\nfunction evaluationNow(context: { zone?: string; now?: DateTime }): DateTime {\n  // Constructing `DateTime.now()` uses Settings.defaultZone and is itself invalid\n  // when an application has configured an unsupported default zone. UTC gives us\n  // the same instant without depending on that ambient setting.\n  const now = context.now ?? DateTime.utc();\n  if (!now.isValid) {\n    throw new Error(\n      `Unable to evaluate invalid date: ${now.invalidExplanation ?? 'unknown error'}`,\n    );\n  }\n\n  const zonedNow = now.setZone(resolvedZone(context.zone));\n  if (!zonedNow.isValid) {\n    throw new Error(\n      `Unable to evaluate invalid date: ${zonedNow.invalidExplanation ?? 'unknown error'}`,\n    );\n  }\n  return zonedNow;\n}\n\nfunction evaluateRelative(\n  value: RelativeDateFilterValue,\n  context: { zone?: string; now?: DateTime },\n): Required<AbsoluteDateRange> {\n  const window = relativeWindowFor(value);\n  const zonedNow = evaluationNow(context);\n  let start: DateTime;\n  let end: DateTime;\n\n  if (window.mode === 'rolling-days') {\n    end = zonedNow.endOf('day');\n    // Preserve the established picker and legacy-filter contract: `days` is a\n    // lookback offset, so the start date and today are both included.\n    start = zonedNow.minus({ days: window.days }).startOf('day');\n  } else {\n    const referencedPeriod = zonedNow.minus({ [window.unit]: window.offset });\n    start = referencedPeriod.startOf(window.unit);\n    end = window.offset === 0 ? zonedNow.endOf('day') : referencedPeriod.endOf(window.unit);\n  }\n\n  return { startDate: dateTimeToISO(start), endDate: dateTimeToISO(end) };\n}\n\nexport function resolveDateFilterValue(\n  value: RelativeDateFilterValue,\n  context?: { zone?: string; now?: DateTime },\n): Required<AbsoluteDateRange>;\nexport function resolveDateFilterValue(\n  value: DateFilterValue,\n  context?: { zone?: string; now?: DateTime },\n): AbsoluteDateRange;\nexport function resolveDateFilterValue(\n  value: DateFilterValue,\n  context: { zone?: string; now?: DateTime } = {},\n): AbsoluteDateRange {\n  if (!isRelative(value)) {\n    return {\n      startDate: value.startDate,\n      endDate: value.endDate,\n    };\n  }\n  return evaluateRelative(value, context);\n}\n\n/**\n * Which preset a control should render as selected.\n *\n * Only stored metadata makes a value semantic. Once writes are enabled an absolute\n * value means the user picked dates, so inferring a preset from them would relabel\n * their choice; with writes disabled no metadata is ever stored, so inference is\n * the only thing that can highlight a preset at all.\n *\n * `undefined` asks the picker to infer from the dates, `null` selects nothing.\n */\nexport function selectedPresetFor(\n  value: DateFilterValue | null,\n  writesEnabled: boolean,\n): DateFilterPreset | null | undefined {\n  if (value != null && isRelative(value)) {\n    return value.preset;\n  }\n  return writesEnabled ? null : undefined;\n}\n\nexport function isRelative(value: DateFilterValue): value is RelativeDateFilterValue {\n  return value.kind === 'relative';\n}\n\nexport function formatDateFilterValue(value: DateFilterValue): string | null {\n  if (!isRelative(value)) {\n    return null;\n  }\n  return DATE_FILTER_PRESET_LABELS[value.preset];\n}\n"],"mappings":"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"}

package/dist/{date-range-rule-value-jZAHuxZJ.d.mts → date-range-rule-value-BRp5Bi7R.d.mts}

@@ -1,4 +1,4 @@
-import { l as FilterRule, r as DateRangeFilterValue, s as FilterFieldType } from "./types-N8PYonjD.mjs";
+import { l as FilterRule, r as DateRangeFilterValue, s as FilterFieldType } from "./types-C4WUSW3e.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/date-range-rule-value.d.ts
 /**
@@ -14,4 +14,4 @@ import { l as FilterRule, r as DateRangeFilterValue, s as FilterFieldType } from
 declare function resolveDateRangeRuleValue(rule: Pick<FilterRule, 'operator' | 'relativeDate' | 'value'>, fieldType?: FilterFieldType): DateRangeFilterValue | null;
 //#endregion
 export { resolveDateRangeRuleValue as t };
-//# sourceMappingURL=date-range-rule-value-jZAHuxZJ.d.mts.map
+//# sourceMappingURL=date-range-rule-value-BRp5Bi7R.d.mts.map

package/dist/date-range-rule-value.d.mts

@@ -1,2 +1,2 @@
-import { t as resolveDateRangeRuleValue } from "./date-range-rule-value-jZAHuxZJ.mjs";
+import { t as resolveDateRangeRuleValue } from "./date-range-rule-value-BRp5Bi7R.mjs";
 export { resolveDateRangeRuleValue };

package/dist/{date-rule-intent-CC1LdkE7.d.mts → date-rule-intent-CDBtV0ET.d.mts}

@@ -1,5 +1,5 @@
-import { a as DateFilterPreset } from "./types-D8rWSj3z.mjs";
-import { t as DateFilterChange } from "./DateRangePicker-ByD6IsLB.mjs";
+import { a as DateFilterPreset } from "./types-Cl-w8tYc.mjs";
+import { t as DateFilterChange } from "./DateRangePicker-HPYsa4wC.mjs";
 import { DateValue } from "@internationalized/date";
 import { RangeValue } from "@react-types/shared";
 
@@ -17,4 +17,4 @@ type DateRuleIntent = {
 declare function dateRuleIntent(change: DateFilterChange, writesEnabled: boolean): DateRuleIntent;
 //#endregion
 export { dateRuleIntent as t };
-//# sourceMappingURL=date-rule-intent-CC1LdkE7.d.mts.map
+//# sourceMappingURL=date-rule-intent-CDBtV0ET.d.mts.map

package/dist/date-rule-intent.d.mts

@@ -1,2 +1,2 @@
-import { t as dateRuleIntent } from "./date-rule-intent-CC1LdkE7.mjs";
+import { t as dateRuleIntent } from "./date-rule-intent-CDBtV0ET.mjs";
 export { dateRuleIntent };

package/dist/display.d.mts

@@ -1,7 +1,7 @@
-import { a as FilterField, c as FilterOperator, l as FilterRule, u as FilterRuleValue } from "./types-N8PYonjD.mjs";
+import { a as FilterField, c as FilterOperator, l as FilterRule, s as FilterFieldType, u as FilterRuleValue } from "./types-C4WUSW3e.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/AdvancedFilterRulesPopover/display.d.ts
-declare function valueDisplayString(value: FilterRuleValue, optionLabels?: Record<string, string>, relativeDate?: FilterRule['relativeDate']): string | undefined;
+declare function valueDisplayString(value: FilterRuleValue, optionLabels?: Record<string, string>, relativeDate?: FilterRule['relativeDate'], fieldType?: FilterFieldType): string | undefined;
 declare function draftValueFor(field: FilterField, operator: FilterOperator): FilterRuleValue;
 //#endregion
 export { draftValueFor, valueDisplayString };

package/dist/fieldPickerOptions.d.mts

@@ -1,5 +1,5 @@
-import { o as ComboboxOptionsOrGroups } from "./ComboboxBase-B3YqkjQp.mjs";
-import { t as FieldRegistry } from "./FieldRegistry-BdtxI1N2.mjs";
+import { o as ComboboxOptionsOrGroups } from "./ComboboxBase-BMCY6O7Y.mjs";
+import { t as FieldRegistry } from "./FieldRegistry-0LmSQ-jc.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/fieldPickerOptions.d.ts
 declare const FIELDS_SUBMENU_LABEL = "Fields";

package/dist/{filter-size-context-BGczB5R9.d.mts → filter-size-context-CqvQ190x.d.mts}

@@ -1,4 +1,4 @@
-import { f as FilterSize } from "./types-N8PYonjD.mjs";
+import { f as FilterSize } from "./types-C4WUSW3e.mjs";
 import * as _$react from "react";
 
 //#region components/DataTable/TableControls/FiltersV2/filter-size-context.d.ts
@@ -49,4 +49,4 @@ declare const FILTER_SIZE_TOKENS: Record<FilterSize, FilterSizeTokens>;
 declare function useFilterSizeTokens(override?: FilterSize): FilterSizeTokens;
 //#endregion
 export { useFilterBarSize as a, FilterSizeTokens as i, FilterBarContext as n, useFilterSizeTokens as o, FilterBarContextValue as r, FILTER_SIZE_TOKENS as t };
-//# sourceMappingURL=filter-size-context-BGczB5R9.d.mts.map
+//# sourceMappingURL=filter-size-context-CqvQ190x.d.mts.map

package/dist/filter-size-context.d.mts

@@ -1,2 +1,2 @@
-import { a as useFilterBarSize, i as FilterSizeTokens, n as FilterBarContext, o as useFilterSizeTokens, r as FilterBarContextValue, t as FILTER_SIZE_TOKENS } from "./filter-size-context-BGczB5R9.mjs";
+import { a as useFilterBarSize, i as FilterSizeTokens, n as FilterBarContext, o as useFilterSizeTokens, r as FilterBarContextValue, t as FILTER_SIZE_TOKENS } from "./filter-size-context-CqvQ190x.mjs";
 export { FILTER_SIZE_TOKENS, FilterBarContext, FilterBarContextValue, FilterSizeTokens, useFilterBarSize, useFilterSizeTokens };

package/dist/format-date-value.d.mts

@@ -0,0 +1,5 @@
+//#region components/DataTable/TableControls/FiltersV2/format-date-value.d.ts
+declare function formatDateValueForDisplay(value: string): string;
+//#endregion
+export { formatDateValueForDisplay };
+//# sourceMappingURL=format-date-value.d.mts.map

package/dist/helpers.d.mts

@@ -1,4 +1,4 @@
-import { n as CheckboxProps } from "./Checkbox-C-hMfItK.mjs";
+import { n as CheckboxProps } from "./Checkbox-DoJpxPEz.mjs";
 import { DataTableColumnFormat, DataTableColumnImageFormat, DataTableColumnPiiFormat, DataTableColumnStringFormat, DateConfig, DatetimeConfig, RenderValueStickerFormatConfig } from "./components/DataTable/types.mjs";
 import { ReactNode } from "react";
 

package/dist/{index-DalP_w0c.d.mts → index-BXSe73Xn.d.mts}

@@ -1,4 +1,4 @@
-import { t as TableHeaderCell } from "./TableHeaderCell-C_7X8QAT.mjs";
+import { t as TableHeaderCell } from "./TableHeaderCell-C7gp9j1X.mjs";
 import * as _$react from "react";
 import { ComponentPropsWithoutRef, ReactNode } from "react";
 
@@ -18,4 +18,4 @@ interface TableTHProps extends ComponentPropsWithoutRef<typeof TableHeaderCell>
 declare const TableTH: _$react.ForwardRefExoticComponent<TableTHProps & _$react.RefAttributes<HTMLTableCellElement>>;
 //#endregion
 export { TableTHProps as n, TableTH as t };
-//# sourceMappingURL=index-DalP_w0c.d.mts.map
+//# sourceMappingURL=index-BXSe73Xn.d.mts.map

package/dist/{index-BRKXhLGa.d.mts → index-CyAok7As.d.mts}

@@ -1,7 +1,7 @@
-import { n as FilterBarProps$1 } from "./FilterBar-jYjPeD7F.mjs";
+import { n as FilterBarProps$1 } from "./FilterBar-BMM4Swbt.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/FilterBar/index.d.ts
 type FilterBarProps = FilterBarProps$1;
 //#endregion
 export { FilterBarProps as t };
-//# sourceMappingURL=index-BRKXhLGa.d.mts.map
+//# sourceMappingURL=index-CyAok7As.d.mts.map

package/dist/index-gVcIuWLd.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/{index-BZmGEbsA.d.mts → index-wKK9f9La.d.mts}

@@ -1,5 +1,5 @@
-import { n as ListBoxItemProps, r as ListBoxProps } from "./ListBox-D-8iwYVj.mjs";
-import { n as LogicRowProps } from "./LogicRow-CgPds2tq.mjs";
+import { n as ListBoxItemProps, r as ListBoxProps } from "./ListBox-BcoXOt73.mjs";
+import { n as LogicRowProps } from "./LogicRow-DXywXdYt.mjs";
 import * as _$react from "react";
 import * as _$react_aria_components0 from "react-aria-components";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
@@ -52,4 +52,4 @@ declare const ListBox: {
 };
 //#endregion
 export { ListBox as t };
-//# sourceMappingURL=index-BZmGEbsA.d.mts.map
+//# sourceMappingURL=index-wKK9f9La.d.mts.map

package/dist/index-zeAhjge4.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as Root, i as HeaderProps, n as Header, o as Title, r as HeaderContainer, s as TitleContainer, t as ActionsContainer } from "./Header-ZnHGm8fs.mjs";
+import { a as Root, i as HeaderProps, n as Header, o as Title, r as HeaderContainer, s as TitleContainer, t as ActionsContainer } from "./Header-DxJ6TfPw.mjs";
 export { ActionsContainer, HeaderContainer, HeaderProps, Root, Title, TitleContainer, Header as default };

package/dist/index2.d.mts

@@ -1,2 +1,2 @@
-import { n as SearchInput, t as OmniSearchProps } from "./SearchInput-D69WxMNq.mjs";
+import { n as SearchInput, t as OmniSearchProps } from "./SearchInput-BGyUUcoz.mjs";
 export { OmniSearchProps, SearchInput as default };

package/dist/index3.d.mts

@@ -1,4 +1,4 @@
-import { r as resolveValueControl } from "./value-control-resolver-Au9JNS5z.mjs";
-import { t as FilterBar } from "./FilterBar-jYjPeD7F.mjs";
-import { t as FilterBarProps } from "./index-BRKXhLGa.mjs";
+import { r as resolveValueControl } from "./value-control-resolver-B0HDRxRN.mjs";
+import { t as FilterBar } from "./FilterBar-BMM4Swbt.mjs";
+import { t as FilterBarProps } from "./index-CyAok7As.mjs";
 export { FilterBarProps, FilterBar as default, resolveValueControl };

package/dist/index4.d.mts

@@ -1,2 +1,2 @@
-import { n as PillShellProps, t as PillShell } from "./PillShell-ChTB_koa.mjs";
+import { n as PillShellProps, t as PillShell } from "./PillShell-BA7KK1zS.mjs";
 export { PillShellProps, PillShell as default };

package/dist/index5.d.mts

@@ -1,15 +1,15 @@
-import { t as dateRuleIntent } from "./date-rule-intent-CC1LdkE7.mjs";
-import { a as FilterField, c as FilterOperator, d as FilterRuleValueChange, f as FilterSize, h as isEmptyState, i as EMPTY_FILTER_STATE, l as FilterRule, m as TopLevelFilterRule, n as CompoundExpression, o as FilterFieldSource, p as FilterStateV2, r as DateRangeFilterValue, s as FilterFieldType, t as AndGroup, u as FilterRuleValue } from "./types-N8PYonjD.mjs";
-import { t as resolveDateRangeRuleValue } from "./date-range-rule-value-jZAHuxZJ.mjs";
-import { n as RawFieldInfo, r as buildFieldRegistry, t as FieldRegistry } from "./FieldRegistry-BdtxI1N2.mjs";
-import { n as ValueControlResolver, r as resolveValueControl, t as ResolveValueControlOptions } from "./value-control-resolver-Au9JNS5z.mjs";
-import { t as FilterBar } from "./FilterBar-jYjPeD7F.mjs";
-import { t as FilterBarProps } from "./index-BRKXhLGa.mjs";
-import { a as useFilterBarSize, i as FilterSizeTokens, t as FILTER_SIZE_TOKENS } from "./filter-size-context-BGczB5R9.mjs";
-import { n as PillShellProps, t as PillShell } from "./PillShell-ChTB_koa.mjs";
-import { a as getDefaultOperatorForType, c as getOperatorsForType, d as isValuelessOperator, f as reconcileValueForOperator, l as isCompleteDateRange, r as emptyValueForRule, s as getOperatorsForField, u as isRangeOperator } from "./operators-x_ZENhrT.mjs";
-import { a as decodeFilterStateFromUrl, i as decodeFilterStateFromString, n as UrlStateCodecResult, o as encodeFilterStateToUrlParam, r as applyFilterStateToSearchParams, t as FILTER_STATE_URL_PARAM } from "./url-state-C2gl07_y.mjs";
-import { n as UseFilterStateV2Result, r as useFilterStateV2, t as UseFilterStateV2Options } from "./useFilterStateV2-BQYcAdKR.mjs";
-import { n as isFilterStateV2, r as pruneToRegistry, t as hasCompleteValue } from "./validation-CMtfUd-R.mjs";
-import { t as ValueControlProps } from "./types-gnF3MPfk2.mjs";
+import { t as dateRuleIntent } from "./date-rule-intent-CDBtV0ET.mjs";
+import { a as FilterField, c as FilterOperator, d as FilterRuleValueChange, f as FilterSize, h as isEmptyState, i as EMPTY_FILTER_STATE, l as FilterRule, m as TopLevelFilterRule, n as CompoundExpression, o as FilterFieldSource, p as FilterStateV2, r as DateRangeFilterValue, s as FilterFieldType, t as AndGroup, u as FilterRuleValue } from "./types-C4WUSW3e.mjs";
+import { t as resolveDateRangeRuleValue } from "./date-range-rule-value-BRp5Bi7R.mjs";
+import { n as RawFieldInfo, r as buildFieldRegistry, t as FieldRegistry } from "./FieldRegistry-0LmSQ-jc.mjs";
+import { n as ValueControlResolver, r as resolveValueControl, t as ResolveValueControlOptions } from "./value-control-resolver-B0HDRxRN.mjs";
+import { t as FilterBar } from "./FilterBar-BMM4Swbt.mjs";
+import { t as FilterBarProps } from "./index-CyAok7As.mjs";
+import { a as useFilterBarSize, i as FilterSizeTokens, t as FILTER_SIZE_TOKENS } from "./filter-size-context-CqvQ190x.mjs";
+import { n as PillShellProps, t as PillShell } from "./PillShell-BA7KK1zS.mjs";
+import { a as getDefaultOperatorForType, c as getOperatorsForType, d as isValuelessOperator, f as reconcileValueForOperator, l as isCompleteDateRange, r as emptyValueForRule, s as getOperatorsForField, u as isRangeOperator } from "./operators-CoXL5Hv6.mjs";
+import { a as decodeFilterStateFromUrl, i as decodeFilterStateFromString, n as UrlStateCodecResult, o as encodeFilterStateToUrlParam, r as applyFilterStateToSearchParams, t as FILTER_STATE_URL_PARAM } from "./url-state-8j_ef8Uf.mjs";
+import { n as UseFilterStateV2Result, r as useFilterStateV2, t as UseFilterStateV2Options } from "./useFilterStateV2-CW6eght1.mjs";
+import { n as isFilterStateV2, r as pruneToRegistry, t as hasCompleteValue } from "./validation-BgwNghi2.mjs";
+import { t as ValueControlProps } from "./types-CoVZwrMW.mjs";
 export { AndGroup, CompoundExpression, DateRangeFilterValue, EMPTY_FILTER_STATE, FILTER_SIZE_TOKENS, FILTER_STATE_URL_PARAM, FieldRegistry, FilterBar, FilterBarProps, FilterField, FilterFieldSource, FilterFieldType, FilterOperator, FilterRule, FilterRuleValue, FilterRuleValueChange, FilterSize, FilterSizeTokens, FilterStateV2, PillShell, PillShellProps, RawFieldInfo, ResolveValueControlOptions, TopLevelFilterRule, UrlStateCodecResult, UseFilterStateV2Options, UseFilterStateV2Result, ValueControlProps, ValueControlResolver, applyFilterStateToSearchParams, buildFieldRegistry, dateRuleIntent, decodeFilterStateFromString, decodeFilterStateFromUrl, emptyValueForRule, encodeFilterStateToUrlParam, getDefaultOperatorForType, getOperatorsForField, getOperatorsForType, hasCompleteValue, isCompleteDateRange, isEmptyState, isFilterStateV2, isRangeOperator, isValuelessOperator, pruneToRegistry, reconcileValueForOperator, resolveDateRangeRuleValue, resolveValueControl, useFilterBarSize, useFilterStateV2 };

package/dist/{input-DCJivcWf.d.mts → input-C6cyiqm2.d.mts}

@@ -1,5 +1,5 @@
-import { t as PseudoClassProps } from "./PseudoClassProps-CdRF3QNn.mjs";
-import { t as ErrorProps } from "./ErrorProps-Dgu98PkH.mjs";
+import { t as PseudoClassProps } from "./PseudoClassProps-BHs8TX_3.mjs";
+import { t as ErrorProps } from "./ErrorProps-B8-Mqf1W.mjs";
 import * as _$styled_components0 from "styled-components";
 
 //#region mixins/input.d.ts
@@ -14,4 +14,4 @@ interface InputMixinProps extends ErrorProps, PseudoClassProps {
 declare const inputMixin: _$styled_components0.FlattenInterpolation<_$styled_components0.ThemedStyledProps<InputMixinProps, any>>;
 //#endregion
 export { InputSizes as n, inputMixin as r, InputMixinProps as t };
-//# sourceMappingURL=input-DCJivcWf.d.mts.map
+//# sourceMappingURL=input-C6cyiqm2.d.mts.map

package/dist/inputFields.d.mts

@@ -1,20 +1,20 @@
-import { n as CheckboxProps } from "./Checkbox-C-hMfItK.mjs";
-import { n as ComboboxMultiSelectProps } from "./ComboboxMultiSelect-BuwVssvZ.mjs";
-import { n as ComboboxSingleSelectProps } from "./ComboboxSingleSelect-gJC4v7ER.mjs";
-import { n as FormFieldBaseProps } from "./FormField-CK8o1sMB.mjs";
-import { a as InputProps } from "./Input-Ce8FvSYf.mjs";
-import { n as RadioGroupProps } from "./RadioGroup-CxL6LW4q.mjs";
-import { i as SegmentedControlProps } from "./SegmentedControl-vCnGsdXo.mjs";
-import { i as SelectProps } from "./Select-sQb4dQwT.mjs";
-import { t as TextAreaProps } from "./TextArea-DOofaXJi.mjs";
-import { n as ToggleProps } from "./Toggle-2nrUX591.mjs";
+import { n as CheckboxProps } from "./Checkbox-DoJpxPEz.mjs";
+import { n as ComboboxMultiSelectProps } from "./ComboboxMultiSelect-L0KYMkmm.mjs";
+import { n as ComboboxSingleSelectProps } from "./ComboboxSingleSelect-v5oNrJ7M.mjs";
+import { n as FormFieldBaseProps } from "./FormField-BeLigf9j.mjs";
+import { a as InputProps } from "./Input-2N2e5JCf.mjs";
+import { n as RadioGroupProps } from "./RadioGroup-Cq3KV1TN.mjs";
+import { i as SegmentedControlProps } from "./SegmentedControl-DgDabSgr.mjs";
+import { i as SelectProps } from "./Select-wqTtGyga.mjs";
+import { t as TextAreaProps } from "./TextArea-CbxF6u7z.mjs";
+import { n as ToggleProps } from "./Toggle-BYMLrPXk.mjs";
 import * as _$react from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region components/FormField/inputFields.d.ts
 type ImplementsFormField = Omit<FormFieldBaseProps, 'children'>;
-type ExtractFormFieldProps<T extends ImplementsFormField> = Pick<T, 'label' | 'inputId' | 'helperText' | 'errorText' | 'warningText' | 'labelProps' | 'helperProps' | 'warningProps' | 'errorProps' | 'configField' | 'configFieldInputWidth' | 'rightActions'>;
-type OmitFormFieldProps<T extends ImplementsFormField> = Omit<T, keyof ExtractFormFieldProps<T>>;
+type ExtractFormFieldProps<T extends ImplementsFormField> = Pick<T, 'label' | 'inputId' | 'required' | 'helperText' | 'errorText' | 'warningText' | 'labelProps' | 'helperProps' | 'warningProps' | 'errorProps' | 'configField' | 'configFieldInputWidth' | 'rightActions'>;
+type OmitFormFieldProps<T extends ImplementsFormField> = Omit<T, Exclude<keyof ExtractFormFieldProps<T>, 'required'>>;
 /**
  * Helper to split out props that are sent to the FormField component from props sent
  * to the underlying input component.
@@ -39,6 +39,7 @@ declare const RadioGroupField: ({
   helperText,
   errorText,
   warningText,
+  required,
   children,
   ...props
 }: RadioGroupFieldProps) => _$react_jsx_runtime0.JSX.Element;
@@ -53,6 +54,7 @@ declare const CheckboxField: ({
   checkboxLabel,
   configField,
   labelProps,
+  required,
   ...props
 }: CheckboxFieldProps) => _$react_jsx_runtime0.JSX.Element;
 interface ToggleFieldProps extends ImplementsFormField, ToggleProps {}

package/dist/{intersperse-Bxcrxj2Q.mjs → intersperse-Df9zw7Bk.mjs}

@@ -18,4 +18,4 @@ function intersperse(arr, separator) {
 //#endregion
 export { intersperse as t };
 
-//# sourceMappingURL=intersperse-Bxcrxj2Q.mjs.map
+//# sourceMappingURL=intersperse-Df9zw7Bk.mjs.map

package/dist/{intersperse-Bxcrxj2Q.mjs.map → intersperse-Df9zw7Bk.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"intersperse-Bxcrxj2Q.mjs","names":[],"sources":["../lib/intersperse.ts"],"sourcesContent":["/**\n * @name intersperse\n *\n * Inserts an element between array items using a separator function. The\n * separator function is passed the previous index, the previous element, and\n * the next element.\n *\n * ```typescript\n * const nodeList: React.ReactNode[] = [...]\n * const commaSeparatedList = intersperse(nodeList, () => ', ')\n * const advancedSeparatedList = intersperse(nodeList, i => <Separator key={i}/>)\n * ```\n */\nexport function intersperse<T>(arr: T[], separator: (n: number, prev: T, curr: T) => T): T[] {\n  return arr.flatMap((a, i) => (i > 0 ? [separator(i - 1, arr[i - 1], a), a] : [a]));\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,SAAgB,YAAe,KAAU,WAAoD;AAC3F,QAAO,IAAI,SAAS,GAAG,MAAO,IAAI,IAAI,CAAC,UAAU,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAE"}
+{"version":3,"file":"intersperse-Df9zw7Bk.mjs","names":[],"sources":["../lib/intersperse.ts"],"sourcesContent":["/**\n * @name intersperse\n *\n * Inserts an element between array items using a separator function. The\n * separator function is passed the previous index, the previous element, and\n * the next element.\n *\n * ```typescript\n * const nodeList: React.ReactNode[] = [...]\n * const commaSeparatedList = intersperse(nodeList, () => ', ')\n * const advancedSeparatedList = intersperse(nodeList, i => <Separator key={i}/>)\n * ```\n */\nexport function intersperse<T>(arr: T[], separator: (n: number, prev: T, curr: T) => T): T[] {\n  return arr.flatMap((a, i) => (i > 0 ? [separator(i - 1, arr[i - 1], a), a] : [a]));\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,SAAgB,YAAe,KAAU,WAAoD;AAC3F,QAAO,IAAI,SAAS,GAAG,MAAO,IAAI,IAAI,CAAC,UAAU,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAE"}

package/dist/{jsonSchema-c_EfAj8y.d.mts → jsonSchema-CfGi1bzI.d.mts}

@@ -1,5 +1,3 @@
-import { t as FieldSchemaType } from "./fieldSchemaTypes-BVYSm74B.mjs";
-
 //#region lib/objectSchemaTypes.d.ts
 interface FunctionJsonSchema extends JsonSchemaObject {
   properties: {
@@ -73,6 +71,32 @@ interface JsonSchemaObjectKeyRegistry {}
 type JsonSchemaObjectKey = JsonSchemaObjectKeyRegistry extends {
   objectKey: infer K extends string;
 } ? K : string;
+/**
+ * Field types are consumer-defined. Register them by mapping each field type to the JSON type it
+ * serializes as (`null` when it has no fixed JSON type); PDS derives the full `fieldType` set and
+ * each JSON schema interface's allowed `fieldType`s from the map:
+ *
+ *   const FIELD_TYPE_JSON_TYPES = {
+ *     [MyFieldType.File]: 'object',
+ *     [MyFieldType.Alias]: null,
+ *   } as const satisfies Record<MyFieldType, `${JsonSchemaTypes}` | null>;
+ *
+ *   declare module '@persona/design-system/lib/jsonSchema' {
+ *     interface JsonSchemaFieldTypeRegistry { fieldTypes: typeof FIELD_TYPE_JSON_TYPES }
+ *   }
+ *
+ * See the "Lib/JSON Schema" docs page for the full guide.
+ */
+interface JsonSchemaFieldTypeRegistry {}
+type JsonSchemaFieldType = JsonSchemaFieldTypeRegistry extends {
+  fieldTypes: infer M;
+} ? keyof M & string : string;
+type FieldTypeKind = `${Exclude<JsonSchemaTypes, JsonSchemaTypes.Null>}`;
+type FieldTypeFor<K extends FieldTypeKind> = JsonSchemaFieldTypeRegistry extends {
+  fieldTypes: infer M;
+} ? { [P in keyof M]: M[P] extends K ? P : never }[keyof M] & string : string;
+/** A field type this module gives runtime meaning to, as the consumer's type spells it. */
+type KnownFieldType<V extends string> = string extends JsonSchemaFieldType ? V : Extract<JsonSchemaFieldType, V>;
 declare enum JsonSchemaTypes {
   Array = "array",
   Boolean = "boolean",
@@ -82,6 +106,37 @@ declare enum JsonSchemaTypes {
   String = "string",
   Null = "null"
 }
+declare enum JsonSchemaCustomTypes {
+  Date = "date",
+  Datetime = "datetime",
+  Enum = "enum",
+  File = "file",
+  MultiEnum = "multi-enum",
+  GroupedEnum = "grouped-enum",
+  Relation = "relation",
+  MaskedString = "secret",
+  Unknown = "unknown"
+}
+type JsonSchemaAllTypes = JsonSchemaTypes | JsonSchemaCustomTypes;
+declare const JsonSchemaAllTypes: {
+  Date: JsonSchemaCustomTypes.Date;
+  Datetime: JsonSchemaCustomTypes.Datetime;
+  Enum: JsonSchemaCustomTypes.Enum;
+  File: JsonSchemaCustomTypes.File;
+  MultiEnum: JsonSchemaCustomTypes.MultiEnum;
+  GroupedEnum: JsonSchemaCustomTypes.GroupedEnum;
+  Relation: JsonSchemaCustomTypes.Relation;
+  MaskedString: JsonSchemaCustomTypes.MaskedString;
+  Unknown: JsonSchemaCustomTypes.Unknown;
+  Array: JsonSchemaTypes.Array;
+  Boolean: JsonSchemaTypes.Boolean;
+  Integer: JsonSchemaTypes.Integer;
+  Number: JsonSchemaTypes.Number;
+  Object: JsonSchemaTypes.Object;
+  String: JsonSchemaTypes.String;
+  Null: JsonSchemaTypes.Null;
+};
+declare const JsonSchemaStringifiableTypes: (JsonSchemaTypes | JsonSchemaCustomTypes)[];
 type JsonSchemaBasicTypes = JsonSchemaTypes.Boolean | JsonSchemaTypes.Integer | JsonSchemaTypes.Number | JsonSchemaTypes.String;
 interface JsonSchemaBase {
   title?: string;
@@ -101,13 +156,13 @@ interface JsonSchemaArray<ItemSchema = JsonSchema> extends JsonSchemaBase {
   type: JsonSchemaTypes.Array;
   items: ItemSchema;
   uniqueItems?: boolean;
-  fieldType?: FieldSchemaType.Array | FieldSchemaType.MultiChoices;
+  fieldType?: FieldTypeFor<'array'>;
   default?: unknown[];
   supportedFunctions?: string[];
 }
 interface JsonSchemaBoolean extends JsonSchemaBase {
   type: JsonSchemaTypes.Boolean;
-  fieldType?: FieldSchemaType.Boolean;
+  fieldType?: FieldTypeFor<'boolean'>;
   default?: boolean;
 }
 interface JsonSchemaInteger extends JsonSchemaBase {
@@ -115,7 +170,7 @@ interface JsonSchemaInteger extends JsonSchemaBase {
   enum?: number[];
   minimum?: number;
   maximum?: number;
-  fieldType?: FieldSchemaType.Integer;
+  fieldType?: FieldTypeFor<'integer'>;
   default?: number;
 }
 interface JsonSchemaNumber extends JsonSchemaBase {
@@ -123,7 +178,7 @@ interface JsonSchemaNumber extends JsonSchemaBase {
   enum?: number[];
   minimum?: number;
   maximum?: number;
-  fieldType?: FieldSchemaType.Number;
+  fieldType?: FieldTypeFor<'number'>;
   default?: number;
 }
 interface JsonSchemaNull extends JsonSchemaBase {
@@ -135,7 +190,7 @@ interface JsonSchemaObject<PropertySchema = JsonSchema> extends JsonSchemaBase {
   properties: Record<string, PropertySchema>;
   required?: string[];
   objectKey?: JsonSchemaObjectKey;
-  fieldType?: FieldSchemaType.File | FieldSchemaType.Hash | FieldSchemaType.Json | FieldSchemaType.Relation | FieldSchemaType.DocumentGeneric | FieldSchemaType.GovernmentId | FieldSchemaType.GovernmentIdNfc | FieldSchemaType.Selfie;
+  fieldType?: FieldTypeFor<'object'>;
   isVariable?: boolean;
   rootDescription?: string;
   additionalProperties?: boolean;
@@ -151,7 +206,7 @@ interface JsonSchemaString extends JsonSchemaBase {
   group?: string;
   labels?: string[];
   maxLength?: number | null;
-  fieldType?: FieldSchemaType.Choices | FieldSchemaType.Date | FieldSchemaType.Datetime | FieldSchemaType.EmailAddress | FieldSchemaType.String;
+  fieldType?: FieldTypeFor<'string'>;
   default?: string;
 }
 interface JsonSchemaAnyOf extends JsonSchemaBase {
@@ -172,7 +227,8 @@ declare const isJsonSchemaObject: (schema: JsonSchema) => schema is JsonSchemaOb
 declare const isJsonSchemaArray: (schema: JsonSchema) => schema is JsonSchemaArray;
 /** Returns true for non-primitive schemas (object, array, or $ref to a platform object). */
 declare const isNonPrimitiveSchema: (schema: JsonSchema) => boolean;
-declare const isFileType: (fieldType: FieldSchemaType | undefined) => fieldType is FieldSchemaType.File;
+declare const isFileType: (fieldType: JsonSchemaFieldType | undefined) => fieldType is KnownFieldType<"file">;
+declare const isJsonType: (fieldType: JsonSchemaFieldType | undefined) => fieldType is KnownFieldType<"json">;
 declare const isFileField: (schema: JsonSchema) => boolean;
 declare const isArrayWithFileItems: (schema: JsonSchema) => boolean;
 /** ImageGallery accepts file schemas or arrays of file items. */
@@ -218,5 +274,5 @@ declare const getNonNullableRefSchema: (schema: JsonSchema | null | undefined) =
 declare const isSchemaTypeAllowed: (schema: JsonSchema | FunctionJsonSchema | null | undefined, allowedTypes: readonly string[]) => boolean;
 declare const extendSchema: (schemaMap: ObjectSchemaMap, schemaToAdd: Partial<Record<keyof typeof schemaMap, Record<string, JsonSchema>>>) => ObjectSchemaMap;
 //#endregion
-export { FunctionConvertedTypeSchema as $, isFileField as A, isJsonSchemaInteger as B, genericArrayItemSchema as C, humanizeSchemaType as D, getNonNullableType as E, isJsonSchemaArray as F, isJsonSchemaSecret as G, isJsonSchemaObject as H, isJsonSchemaBoolean as I, isOneOfSchema as J, isJsonSchemaString as K, isJsonSchemaChoices as L, isFileType as M, isFunctionSchema as N, isArrayWithFileItems as O, isGenericParameterSchema as P, CollectionMetaJsonSchema as Q, isJsonSchemaDate as R, functionParametersFromJsonSchema as S, getNonNullableRefSchema as T, isJsonSchemaPlatformObject as U, isJsonSchemaNumber as V, isJsonSchemaRef as W, isPrecedingSchema as X, isOneOfStringSchema as Y, isSchemaTypeAllowed as Z, JsonSchemaObjectKeyRegistry as _, JsonSchemaBase as a, ObjectSchemaMap as at, JsonSchemaTypes as b, JsonSchemaBoolean as c, JsonSchemaEmpty as d, FunctionGenericParameterSchema as et, JsonSchemaInteger as f, JsonSchemaObjectKey as g, JsonSchemaObject as h, JsonSchemaArray as i, GenericType as it, isFileSchema as j, isConvertedTypeSchema as k, JsonSchemaConst as l, JsonSchemaNumber as m, JsonSchema as n, FunctionParameterJsonSchema as nt, JsonSchemaBasic as o, JsonSchemaNull as p, isNonPrimitiveSchema as q, JsonSchemaAnyOf as r, FunctionReturnTypeJsonSchema as rt, JsonSchemaBasicTypes as s, EMPTY_JSON_SCHEMA_OBJECT as t, FunctionJsonSchema as tt, JsonSchemaCore as u, JsonSchemaRef as v, getArrayItemType as w, extendSchema as x, JsonSchemaString as y, isJsonSchemaDateTime as z };
-//# sourceMappingURL=jsonSchema-c_EfAj8y.d.mts.map
+export { isNonPrimitiveSchema as $, getNonNullableRefSchema as A, isJsonSchemaArray as B, JsonSchemaString as C, functionParametersFromJsonSchema as D, extendSchema as E, isFileField as F, isJsonSchemaInteger as G, isJsonSchemaChoices as H, isFileSchema as I, isJsonSchemaPlatformObject as J, isJsonSchemaNumber as K, isFileType as L, humanizeSchemaType as M, isArrayWithFileItems as N, genericArrayItemSchema as O, isConvertedTypeSchema as P, isJsonType as Q, isFunctionSchema as R, JsonSchemaRef as S, JsonSchemaTypes as T, isJsonSchemaDate as U, isJsonSchemaBoolean as V, isJsonSchemaDateTime as W, isJsonSchemaSecret as X, isJsonSchemaRef as Y, isJsonSchemaString as Z, JsonSchemaNull as _, JsonSchemaArray as a, FunctionConvertedTypeSchema as at, JsonSchemaObjectKey as b, JsonSchemaBasicTypes as c, FunctionParameterJsonSchema as ct, JsonSchemaCore as d, ObjectSchemaMap as dt, isOneOfSchema as et, JsonSchemaCustomTypes as f, JsonSchemaInteger as g, JsonSchemaFieldTypeRegistry as h, JsonSchemaAnyOf as i, CollectionMetaJsonSchema as it, getNonNullableType as j, getArrayItemType as k, JsonSchemaBoolean as l, FunctionReturnTypeJsonSchema as lt, JsonSchemaFieldType as m, JsonSchema as n, isPrecedingSchema as nt, JsonSchemaBase as o, FunctionGenericParameterSchema as ot, JsonSchemaEmpty as p, isJsonSchemaObject as q, JsonSchemaAllTypes as r, isSchemaTypeAllowed as rt, JsonSchemaBasic as s, FunctionJsonSchema as st, EMPTY_JSON_SCHEMA_OBJECT as t, isOneOfStringSchema as tt, JsonSchemaConst as u, GenericType as ut, JsonSchemaNumber as v, JsonSchemaStringifiableTypes as w, JsonSchemaObjectKeyRegistry as x, JsonSchemaObject as y, isGenericParameterSchema as z };
+//# sourceMappingURL=jsonSchema-CfGi1bzI.d.mts.map

package/dist/lib/PDSProvider.d.mts

@@ -1,5 +1,5 @@
-import { i as PersonaTheme } from "../theme-DKiszVRN.mjs";
-import { n as RouterAdapter } from "../types-CuQSgl1F.mjs";
+import { i as PersonaTheme } from "../theme-BcaR-Au5.mjs";
+import { n as RouterAdapter } from "../types-CkpixGWr.mjs";
 import { FC, PropsWithChildren } from "react";
 
 //#region lib/PDSProvider.d.ts

package/dist/lib/TruncatedText.d.mts

@@ -1,2 +1,2 @@
-import { n as TruncatedText, r as TruncatedTextProps, t as OverflowEllipsisSpan } from "../TruncatedText-g2T5HlqX.mjs";
+import { n as TruncatedText, r as TruncatedTextProps, t as OverflowEllipsisSpan } from "../TruncatedText-O7hE3w0O.mjs";
 export { OverflowEllipsisSpan, TruncatedText, TruncatedText as default, TruncatedTextProps };

package/dist/lib/TruncatedTextWithTooltip.d.mts

@@ -1,4 +1,4 @@
-import { n as Tooltip } from "../Tooltip-Cnqf1-tx.mjs";
+import { n as Tooltip } from "../Tooltip-4pshzB_i.mjs";
 import { ComponentProps, ComponentPropsWithoutRef, FC } from "react";
 
 //#region lib/TruncatedTextWithTooltip.d.ts

package/dist/lib/chainTypes.d.mts

@@ -0,0 +1,17 @@
+import { n as JsonSchema } from "../jsonSchema-CfGi1bzI.mjs";
+import { n as Chain } from "../methodChainTypes-CqWzfx0M.mjs";
+import { Option } from "./schemaOptions.mjs";
+
+//#region lib/chainTypes.d.ts
+interface ChainRoot {
+  chain: Chain;
+  label: string;
+  schema: JsonSchema;
+}
+interface PossibleChainSchema extends Option {
+  parentSchema: JsonSchema;
+  returnType: string;
+}
+//#endregion
+export { ChainRoot, PossibleChainSchema };
+//# sourceMappingURL=chainTypes.d.mts.map

package/dist/lib/color.d.mts

@@ -1,2 +1,2 @@
-import { a as withAlpha, i as transparent, n as PdsColor, r as opacityOf, t as CssColor } from "../color-Bt0Lv1e3.mjs";
-export { CssColor, PdsColor, opacityOf, transparent, withAlpha };
+import { a as transparent, i as opaqueOver, n as PdsColor, o as withAlpha, r as opacityOf, t as CssColor } from "../color-3UO63ocQ.mjs";
+export { CssColor, PdsColor, opacityOf, opaqueOver, transparent, withAlpha };

package/dist/lib/color.mjs

@@ -1,21 +1,28 @@
+import ColorValue from "color";
 //#region lib/color.ts
 const transparent = "transparent";
 const HEX = /^#([0-9a-f]{6})$/i;
 /** Percentage token as a unitless `opacity`; percentage `opacity` is below the browserslist floor. */
 const opacityOf = (amount) => String(Number.parseFloat(amount) / 100);
-/** `rgba()` rather than `color-mix()`: browserslist still includes IE 11 and iOS Safari < 16.2. */
+const assertHex = (color, name) => {
+	if (!HEX.test(color)) throw new Error(`${name} expects a six-digit hex primitive, received "${color}"`);
+};
+const unit = (amount) => Number.parseFloat(amount) / 100;
+/** Full alpha collapses to `rgb()`; partial alpha stays `rgba()`. */
 const withAlpha = (color, amount) => {
-	const hex = HEX.exec(color);
-	if (!hex) throw new Error(`withAlpha expects a six-digit hex primitive, received "${color}"`);
-	const channels = hex[1];
-	const [red, green, blue] = [
-		0,
-		2,
-		4
-	].map((offset) => Number.parseInt(channels.slice(offset, offset + 2), 16));
-	return `rgba(${red}, ${green}, ${blue}, ${opacityOf(amount)})`;
+	assertHex(color, "withAlpha");
+	return ColorValue(color).alpha(unit(amount)).rgb().string();
+};
+/**
+* Source-over composite of `overlay` at `amount` onto `base`, as an opaque `rgb()`.
+* Sticky cells that inherit a translucent wash paint it a second time.
+*/
+const opaqueOver = (overlay, amount, base) => {
+	assertHex(overlay, "opaqueOver");
+	assertHex(base, "opaqueOver");
+	return ColorValue(base).mix(ColorValue(overlay), unit(amount)).rgb().string();
 };
 //#endregion
-export { opacityOf, transparent, withAlpha };
+export { opacityOf, opaqueOver, transparent, withAlpha };
 
 //# sourceMappingURL=color.mjs.map

package/dist/lib/color.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"color.mjs","names":[],"sources":["../../lib/color.ts"],"sourcesContent":["import type { Color } from '@persona/design-tokens';\nimport type { CssPercentage } from 'design-system/variables/semantic';\n\n/**\n * A computed theme colour (not a token primitive). Property-branded rather than `unique symbol`\n * so the brand survives declaration emit.\n */\nexport type CssColor = string & { readonly __pdsCssColor: true };\n\nexport type PdsColor = Color | CssColor;\n\nexport const transparent = 'transparent' as CssColor;\n\nconst HEX = /^#([0-9a-f]{6})$/i;\n\n/** Percentage token as a unitless `opacity`; percentage `opacity` is below the browserslist floor. */\nexport const opacityOf = (amount: CssPercentage): string => String(Number.parseFloat(amount) / 100);\n\n/** `rgba()` rather than `color-mix()`: browserslist still includes IE 11 and iOS Safari < 16.2. */\nexport const withAlpha = (color: Color, amount: CssPercentage): CssColor => {\n  const hex = HEX.exec(color);\n  if (!hex) {\n    throw new Error(`withAlpha expects a six-digit hex primitive, received \"${color}\"`);\n  }\n\n  const channels = hex[1];\n  const [red, green, blue] = [0, 2, 4].map((offset) =>\n    Number.parseInt(channels.slice(offset, offset + 2), 16),\n  );\n  return `rgba(${red}, ${green}, ${blue}, ${opacityOf(amount)})` as CssColor;\n};\n"],"mappings":";AAWA,MAAa,cAAc;AAE3B,MAAM,MAAM;;AAGZ,MAAa,aAAa,WAAkC,OAAO,OAAO,WAAW,OAAO,GAAG,IAAI;;AAGnG,MAAa,aAAa,OAAc,WAAoC;CAC1E,MAAM,MAAM,IAAI,KAAK,MAAM;AAC3B,KAAI,CAAC,IACH,OAAM,IAAI,MAAM,0DAA0D,MAAM,GAAG;CAGrF,MAAM,WAAW,IAAI;CACrB,MAAM,CAAC,KAAK,OAAO,QAAQ;EAAC;EAAG;EAAG;EAAE,CAAC,KAAK,WACxC,OAAO,SAAS,SAAS,MAAM,QAAQ,SAAS,EAAE,EAAE,GAAG,CACxD;AACD,QAAO,QAAQ,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,UAAU,OAAO,CAAC"}
+{"version":3,"file":"color.mjs","names":[],"sources":["../../lib/color.ts"],"sourcesContent":["import ColorValue from 'color';\n\nimport type { Color } from '@persona/design-tokens';\nimport type { CssPercentage } from 'design-system/variables/semantic';\n\n/**\n * A computed theme colour (not a token primitive). Property-branded rather than `unique symbol`\n * so the brand survives declaration emit.\n */\nexport type CssColor = string & { readonly __pdsCssColor: true };\n\nexport type PdsColor = Color | CssColor;\n\nexport const transparent = 'transparent' as CssColor;\n\nconst HEX = /^#([0-9a-f]{6})$/i;\n\n/** Percentage token as a unitless `opacity`; percentage `opacity` is below the browserslist floor. */\nexport const opacityOf = (amount: CssPercentage): string => String(Number.parseFloat(amount) / 100);\n\nconst assertHex = (color: Color, name: string) => {\n  if (!HEX.test(color)) {\n    throw new Error(`${name} expects a six-digit hex primitive, received \"${color}\"`);\n  }\n};\n\nconst unit = (amount: CssPercentage) => Number.parseFloat(amount) / 100;\n\n/** Full alpha collapses to `rgb()`; partial alpha stays `rgba()`. */\nexport const withAlpha = (color: Color, amount: CssPercentage): CssColor => {\n  assertHex(color, 'withAlpha');\n  return ColorValue(color).alpha(unit(amount)).rgb().string() as CssColor;\n};\n\n/**\n * Source-over composite of `overlay` at `amount` onto `base`, as an opaque `rgb()`.\n * Sticky cells that inherit a translucent wash paint it a second time.\n */\nexport const opaqueOver = (overlay: Color, amount: CssPercentage, base: Color): CssColor => {\n  assertHex(overlay, 'opaqueOver');\n  assertHex(base, 'opaqueOver');\n  return ColorValue(base).mix(ColorValue(overlay), unit(amount)).rgb().string() as CssColor;\n};\n"],"mappings":";;AAaA,MAAa,cAAc;AAE3B,MAAM,MAAM;;AAGZ,MAAa,aAAa,WAAkC,OAAO,OAAO,WAAW,OAAO,GAAG,IAAI;AAEnG,MAAM,aAAa,OAAc,SAAiB;AAChD,KAAI,CAAC,IAAI,KAAK,MAAM,CAClB,OAAM,IAAI,MAAM,GAAG,KAAK,gDAAgD,MAAM,GAAG;;AAIrF,MAAM,QAAQ,WAA0B,OAAO,WAAW,OAAO,GAAG;;AAGpE,MAAa,aAAa,OAAc,WAAoC;AAC1E,WAAU,OAAO,YAAY;AAC7B,QAAO,WAAW,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ;;;;;;AAO7D,MAAa,cAAc,SAAgB,QAAuB,SAA0B;AAC1F,WAAU,SAAS,aAAa;AAChC,WAAU,MAAM,aAAa;AAC7B,QAAO,WAAW,KAAK,CAAC,IAAI,WAAW,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ"}