@fluid-app/rep-core 0.1.5 → 0.1.7

package/dist/registries/index.d.ts

@@ -1,7 +1,7 @@
 import { IconDefinition } from '@fortawesome/fontawesome-svg-core';
 import { StrictOmit, AlignOptions, ColorOptions, SectionLayoutType, FontSizeOptions, BorderRadiusOptions, PaddingOptions, ButtonSizeOptions, GapOptions } from '../types/index.js';
-import { b as WidgetType, W as WidgetSchema } from '../widget-schema-DxdlJD8E.js';
-import '../types-R1kV_DKF.js';
+import { b as WidgetType, a as WidgetSchema } from '../widget-schema-D-ca3--K.js';
+import '../types-CNIhy4JD.js';
 import 'colorjs.io';
 import '@fluid-app/fluidos-api-client';
 import '../shareable-item-DkgWpwoU.js';
@@ -42,6 +42,7 @@ declare const PROPERTY_FIELD_TYPES: {
     readonly background: "background";
     readonly contentPosition: "contentPosition";
     readonly textSizeSelect: "textSizeSelect";
+    readonly cssUnit: "cssUnit";
 };
 /**
  * Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.
@@ -244,10 +245,25 @@ interface TextSizeSelectFieldSchema extends PropertyFieldSchema {
     type: "textSizeSelect";
     defaultValue?: FontSizeOptions;
 }
+/**
+ * CSS unit type for height/width fields
+ */
+type CssUnit = "px" | "rem" | "vh";
+/**
+ * CSS unit field schema for numeric values with selectable units (px, rem, vh)
+ */
+interface CssUnitFieldSchema extends PropertyFieldSchema {
+    type: "cssUnit";
+    min?: number;
+    max?: number;
+    step?: number;
+    allowedUnits?: CssUnit[];
+    defaultUnit?: CssUnit;
+}
 /**
  * Union of all field schema types
  */
-type PropertyField = TextFieldSchema | TextareaFieldSchema | NumberFieldSchema | BooleanFieldSchema | SelectFieldSchema<string | number> | ColorFieldSchema | RangeFieldSchema | DataSourceFieldSchema | ResourceFieldSchema | AlignmentFieldSchema | SliderFieldSchema | ColorPickerFieldSchema | SectionHeaderFieldSchema | SeparatorFieldSchema | ButtonGroupFieldSchema<string | number> | ColorSelectFieldSchema | SectionLayoutSelectFieldSchema | BackgroundFieldSchema | ContentPositionFieldSchema | TextSizeSelectFieldSchema;
+type PropertyField = TextFieldSchema | TextareaFieldSchema | NumberFieldSchema | BooleanFieldSchema | SelectFieldSchema<string | number> | ColorFieldSchema | RangeFieldSchema | DataSourceFieldSchema | ResourceFieldSchema | AlignmentFieldSchema | SliderFieldSchema | ColorPickerFieldSchema | SectionHeaderFieldSchema | SeparatorFieldSchema | ButtonGroupFieldSchema<string | number> | ColorSelectFieldSchema | SectionLayoutSelectFieldSchema | BackgroundFieldSchema | ContentPositionFieldSchema | TextSizeSelectFieldSchema | CssUnitFieldSchema;
 /**
  * Schema for per-item configuration in custom data sources.
  * Widgets can define this to allow users to configure widget-specific
@@ -301,6 +317,7 @@ declare const getPaddingField: (props: Readonly<Omit<ButtonGroupFieldSchema<Padd
 declare const getButtonSizeField: (props: Readonly<Omit<ButtonGroupFieldSchema<ButtonSizeOptions>, "options" | "type">>) => ButtonGroupFieldSchema<ButtonSizeOptions>;
 declare const getFontSizeField: (props: Readonly<Omit<TextSizeSelectFieldSchema, "type">>) => TextSizeSelectFieldSchema;
 declare const getGapField: (props: Readonly<Omit<ButtonGroupFieldSchema<GapOptions>, "options" | "type">>) => ButtonGroupFieldSchema<GapOptions>;
+declare const getHeightField: (props: Readonly<Omit<CssUnitFieldSchema, "type">>) => CssUnitFieldSchema;
 /**
  * Gap value mapping - use `as const satisfies` for compile-time validation
  * with literal type preservation.
@@ -314,4 +331,4 @@ declare const gapValues: {
     readonly xl: 8;
 };
 
-export { type AlignmentFieldSchema, type BackgroundFieldSchema, type BooleanFieldSchema, type ButtonGroupFieldSchema, type ColorFieldSchema, type ColorPickerFieldSchema, type ColorSelectFieldSchema, type ContentPositionFieldSchema, type DataSourceFieldSchema, type ItemConfigSchema, type NumberFieldSchema, PROPERTY_FIELD_TYPES, type PropertyField, type PropertyFieldSchema, type PropertyFieldType, type PropertySchemaRegistry, type RangeFieldSchema, type ResourceFieldSchema, type SectionHeaderFieldSchema, type SectionLayoutSelectFieldSchema, type SelectFieldSchema, type SeparatorFieldSchema, type SliderFieldSchema, type TabConfig, type TextFieldSchema, type TextSizeSelectFieldSchema, type TextareaFieldSchema, type WidgetPropertySchema, applyPropertyValues, extractPropertyValues, gapValues, getBorderRadiusField, getButtonSizeField, getColorField, getFontSizeField, getGapField, getPaddingField, groupPropertyFields, isPropertyFieldType };
+export { type AlignmentFieldSchema, type BackgroundFieldSchema, type BooleanFieldSchema, type ButtonGroupFieldSchema, type ColorFieldSchema, type ColorPickerFieldSchema, type ColorSelectFieldSchema, type ContentPositionFieldSchema, type CssUnit, type CssUnitFieldSchema, type DataSourceFieldSchema, type ItemConfigSchema, type NumberFieldSchema, PROPERTY_FIELD_TYPES, type PropertyField, type PropertyFieldSchema, type PropertyFieldType, type PropertySchemaRegistry, type RangeFieldSchema, type ResourceFieldSchema, type SectionHeaderFieldSchema, type SectionLayoutSelectFieldSchema, type SelectFieldSchema, type SeparatorFieldSchema, type SliderFieldSchema, type TabConfig, type TextFieldSchema, type TextSizeSelectFieldSchema, type TextareaFieldSchema, type WidgetPropertySchema, applyPropertyValues, extractPropertyValues, gapValues, getBorderRadiusField, getButtonSizeField, getColorField, getFontSizeField, getGapField, getHeightField, getPaddingField, groupPropertyFields, isPropertyFieldType };

package/dist/registries/index.js

@@ -21,7 +21,8 @@ var PROPERTY_FIELD_TYPES = {
   sectionLayoutSelect: "sectionLayoutSelect",
   background: "background",
   contentPosition: "contentPosition",
-  textSizeSelect: "textSizeSelect"
+  textSizeSelect: "textSizeSelect",
+  cssUnit: "cssUnit"
 };
 function isPropertyFieldType(value) {
   return Object.values(PROPERTY_FIELD_TYPES).includes(
@@ -122,6 +123,12 @@ var getGapField = (props) => {
     ]
   };
 };
+var getHeightField = (props) => {
+  return {
+    ...props,
+    type: "cssUnit"
+  };
+};
 var gapValues = {
   none: 0,
   xs: 1,
@@ -131,6 +138,6 @@ var gapValues = {
   xl: 8
 };
 
-export { PROPERTY_FIELD_TYPES, applyPropertyValues, extractPropertyValues, gapValues, getBorderRadiusField, getButtonSizeField, getColorField, getFontSizeField, getGapField, getPaddingField, groupPropertyFields, isPropertyFieldType };
+export { PROPERTY_FIELD_TYPES, applyPropertyValues, extractPropertyValues, gapValues, getBorderRadiusField, getButtonSizeField, getColorField, getFontSizeField, getGapField, getHeightField, getPaddingField, groupPropertyFields, isPropertyFieldType };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/registries/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/registries/property-schema-types.ts","../../src/registries/field-helpers.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { IconDefinition } from \"@fortawesome/fontawesome-svg-core\";\nimport type {\n  WidgetType,\n  WidgetSchema,\n  AlignOptions,\n  ColorOptions,\n  FontSizeOptions,\n  SectionLayoutType,\n  StrictOmit,\n} from \"../types\";\n\n/**\n * Tab configuration for organizing properties\n */\nexport interface TabConfig {\n  /** Unique identifier for the tab */\n  id: string;\n  /** Display label for the tab */\n  label: string;\n}\n\n// ============================================================================\n// Property Field Types - Derive from constant for single source of truth\n// ============================================================================\n\n/**\n * Property field type constant - single source of truth for field types.\n * Use PROPERTY_FIELD_TYPES.text instead of \"text\" for type-safe comparisons.\n */\nexport const PROPERTY_FIELD_TYPES = {\n  text: \"text\",\n  textarea: \"textarea\",\n  number: \"number\",\n  boolean: \"boolean\",\n  select: \"select\",\n  color: \"color\",\n  range: \"range\",\n  dataSource: \"dataSource\",\n  resource: \"resource\",\n  alignment: \"alignment\",\n  slider: \"slider\",\n  colorPicker: \"colorPicker\",\n  sectionHeader: \"sectionHeader\",\n  separator: \"separator\",\n  buttonGroup: \"buttonGroup\",\n  colorSelect: \"colorSelect\",\n  sectionLayoutSelect: \"sectionLayoutSelect\",\n  background: \"background\",\n  contentPosition: \"contentPosition\",\n  textSizeSelect: \"textSizeSelect\",\n} as const;\n\n/**\n * Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.\n * @see deriving-typeof-for-object-keys pattern\n */\nexport type PropertyFieldType =\n  (typeof PROPERTY_FIELD_TYPES)[keyof typeof PROPERTY_FIELD_TYPES];\n\n/**\n * Runtime validation for property field types.\n * @param value - The value to check\n * @returns true if value is a valid PropertyFieldType\n */\nexport function isPropertyFieldType(value: string): value is PropertyFieldType {\n  return Object.values(PROPERTY_FIELD_TYPES).includes(\n    value as PropertyFieldType,\n  );\n}\n\n/**\n * Base schema for a property field\n */\nexport interface PropertyFieldSchema {\n  /** Property key in the widget props */\n  key: string;\n  /** Display label for the field */\n  label: string;\n  /** Field type determines the input control */\n  type: PropertyFieldType;\n  /** Optional description/help text */\n  description?: string;\n  /** Optional default value */\n  defaultValue?: unknown;\n  /** Optional tab ID (must match a TabConfig id if widget has tabsConfig) */\n  tab?: string;\n  /** Optional group for organizing fields within a tab */\n  group?: string;\n  /**\n   * @deprecated Use requiresKeyValue instead\n   */\n  requiresKeyToBeTrue?: string;\n  /** Optional requires a specific key to have a specific value */\n  requiresKeyValue?: { key: string; value: unknown };\n}\n\n/**\n * Text field schema\n */\nexport interface TextFieldSchema extends PropertyFieldSchema {\n  type: \"text\";\n  placeholder?: string;\n  maxLength?: number;\n}\n\n/**\n * Textarea field schema\n */\nexport interface TextareaFieldSchema extends PropertyFieldSchema {\n  type: \"textarea\";\n  placeholder?: string;\n  rows?: number;\n  maxLength?: number;\n}\n\n/**\n * Number field schema\n */\nexport interface NumberFieldSchema extends PropertyFieldSchema {\n  type: \"number\";\n  min?: number;\n  max?: number;\n  step?: number;\n}\n\n/**\n * Boolean field schema\n */\nexport interface BooleanFieldSchema extends PropertyFieldSchema {\n  type: \"boolean\";\n}\n\n/**\n * Select field schema with type-safe option values.\n * Uses StrictOmit to ensure \"defaultValue\" key exists on PropertyFieldSchema.\n */\nexport interface SelectFieldSchema<T extends string | number = string | number>\n  extends StrictOmit<PropertyFieldSchema, \"defaultValue\"> {\n  type: \"select\";\n  options: Array<{ label: string; value: T }>;\n  defaultValue?: T;\n}\n\n/**\n * Color field schema\n */\nexport interface ColorFieldSchema extends PropertyFieldSchema {\n  type: \"color\";\n}\n\n/**\n * Range slider field schema\n */\nexport interface RangeFieldSchema extends PropertyFieldSchema {\n  type: \"range\";\n  min: number;\n  max: number;\n  step?: number;\n}\n\n/**\n * Data source field schema for configuring widget data sources\n */\nexport interface DataSourceFieldSchema extends PropertyFieldSchema {\n  type: \"dataSource\";\n}\n\n/**\n * Resource field schema for selecting a single resource from the selection modal\n */\nexport interface ResourceFieldSchema extends PropertyFieldSchema {\n  type: \"resource\";\n  /** Optional filter to specific shareable types */\n  allowedTypes?: string[];\n}\n\n/**\n * Alignment field schema\n */\nexport interface AlignmentFieldSchema extends PropertyFieldSchema {\n  type: \"alignment\";\n  options: {\n    verticalEnabled: boolean;\n    horizontalEnabled: boolean;\n  };\n  defaultValue?: AlignOptions;\n}\n\n/**\n * Slider field schema with optional unit suffix (e.g., \"rem\", \"px\")\n */\nexport interface SliderFieldSchema extends PropertyFieldSchema {\n  type: \"slider\";\n  min: number;\n  max: number;\n  step?: number;\n  unit?: string;\n}\n\n/**\n * Color picker field schema with optional swatches\n */\nexport interface ColorPickerFieldSchema extends PropertyFieldSchema {\n  type: \"colorPicker\";\n  swatches?: string[];\n}\n\n/**\n * Section header field schema for visual grouping\n */\nexport interface SectionHeaderFieldSchema extends PropertyFieldSchema {\n  type: \"sectionHeader\";\n  subtitle?: string;\n}\n\n/**\n * Separator field schema for visual separation\n */\nexport interface SeparatorFieldSchema extends PropertyFieldSchema {\n  type: \"separator\";\n}\n\n/**\n * Button group field schema.\n * Uses StrictOmit to ensure \"defaultValue\" key exists on PropertyFieldSchema.\n */\nexport interface ButtonGroupFieldSchema<\n  T extends string | number = string | number,\n> extends StrictOmit<PropertyFieldSchema, \"defaultValue\"> {\n  type: \"buttonGroup\";\n  options: Array<{ label?: string; icon?: IconDefinition; value: T }>;\n  defaultValue?: T;\n}\n\n/**\n * Color select field schema\n */\nexport interface ColorSelectFieldSchema extends PropertyFieldSchema {\n  type: \"colorSelect\";\n  defaultValue?: ColorOptions;\n}\n\n/**\n * Section layout select field schema for visual masonry layout selector\n */\nexport interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {\n  type: \"sectionLayoutSelect\";\n  defaultValue?: SectionLayoutType;\n}\n\n/**\n * Background field combines resource selection and color properties.\n * Uses StrictOmit to exclude conflicting \"type\" discriminant from parents.\n */\nexport interface BackgroundFieldSchema\n  extends StrictOmit<ResourceFieldSchema, \"type\">,\n    StrictOmit<ColorFieldSchema, \"type\"> {\n  type: \"background\";\n}\n\n/**\n * Content position field schema for 3x3 grid position picker\n */\nexport interface ContentPositionFieldSchema extends PropertyFieldSchema {\n  type: \"contentPosition\";\n  defaultValue?: string;\n}\n\n/**\n * Text size select field schema for visual font size selector\n */\nexport interface TextSizeSelectFieldSchema extends PropertyFieldSchema {\n  type: \"textSizeSelect\";\n  defaultValue?: FontSizeOptions;\n}\n\n/**\n * Union of all field schema types\n */\nexport type PropertyField =\n  | TextFieldSchema\n  | TextareaFieldSchema\n  | NumberFieldSchema\n  | BooleanFieldSchema\n  | SelectFieldSchema<string | number>\n  | ColorFieldSchema\n  | RangeFieldSchema\n  | DataSourceFieldSchema\n  | ResourceFieldSchema\n  | AlignmentFieldSchema\n  | SliderFieldSchema\n  | ColorPickerFieldSchema\n  | SectionHeaderFieldSchema\n  | SeparatorFieldSchema\n  | ButtonGroupFieldSchema<string | number>\n  | ColorSelectFieldSchema\n  | SectionLayoutSelectFieldSchema\n  | BackgroundFieldSchema\n  | ContentPositionFieldSchema\n  | TextSizeSelectFieldSchema;\n\n/**\n * Schema for per-item configuration in custom data sources.\n * Widgets can define this to allow users to configure widget-specific\n * settings for each selected item (e.g., title, description, button).\n */\nexport interface ItemConfigSchema {\n  /** Fields available for per-item configuration */\n  fields: PropertyField[];\n  /** Optional description shown at top of item config panel */\n  description?: string;\n}\n\n/**\n * Schema for a widget's editable properties\n */\nexport interface WidgetPropertySchema {\n  /** Widget type this schema applies to */\n  widgetType: WidgetType;\n  /** Display name for the widget */\n  displayName: string;\n  /** Optional tab configuration - if present, tabs are enabled */\n  tabsConfig?: TabConfig[];\n  /** Editable property fields */\n  fields: PropertyField[];\n  /** Optional custom validator function */\n  validate?: (props: Record<string, unknown>) => string | null;\n  /** Props that can be populated from data sources */\n  dataSourceTargetProps?: string[];\n  /** Optional schema for per-item configurations in custom data sources */\n  itemConfigSchema?: ItemConfigSchema;\n}\n\n/**\n * Registry mapping widget types to their property schemas\n */\nexport type PropertySchemaRegistry = Record<WidgetType, WidgetPropertySchema>;\n\n/**\n * Group property fields by their group property\n */\nexport function groupPropertyFields(\n  fields: readonly PropertyField[],\n): Record<string, PropertyField[]> {\n  const grouped: Record<string, PropertyField[]> = {};\n\n  fields.forEach((field) => {\n    const group = field.group || \"General\";\n    if (!grouped[group]) {\n      grouped[group] = [];\n    }\n    grouped[group].push(field);\n  });\n\n  return grouped;\n}\n\n/**\n * Extract current values from widget props based on property fields\n */\nexport function extractPropertyValues(\n  widget: Readonly<WidgetSchema>,\n  fields: readonly PropertyField[],\n): Record<string, unknown> {\n  const values: Record<string, unknown> = {};\n\n  fields.forEach((field) => {\n    const value = widget.props[field.key];\n    values[field.key] = value !== undefined ? value : field.defaultValue;\n  });\n\n  return values;\n}\n\n/**\n * Apply property values to widget props\n */\nexport function applyPropertyValues(\n  widget: Readonly<WidgetSchema>,\n  values: Readonly<Record<string, unknown>>,\n): WidgetSchema {\n  return {\n    ...widget,\n    props: {\n      ...widget.props,\n      ...values,\n    },\n  };\n}\n","import type {\n  ButtonGroupFieldSchema,\n  ColorSelectFieldSchema,\n  TextSizeSelectFieldSchema,\n} from \"./property-schema-types\";\nimport type {\n  BorderRadiusOptions,\n  PaddingOptions,\n  ButtonSizeOptions,\n  GapOptions,\n} from \"../types\";\nimport { faBan } from \"@fortawesome/pro-regular-svg-icons\";\n\nexport const getColorField = (\n  props: Readonly<Omit<ColorSelectFieldSchema, \"type\">>,\n): ColorSelectFieldSchema => {\n  return {\n    ...props,\n    type: \"colorSelect\",\n  };\n};\n\nexport const getBorderRadiusField = (\n  props: Readonly<\n    Omit<ButtonGroupFieldSchema<BorderRadiusOptions>, \"options\" | \"type\">\n  >,\n): ButtonGroupFieldSchema<BorderRadiusOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { icon: faBan, value: \"none\" },\n      { label: \"SM\", value: \"sm\" },\n      { label: \"MD\", value: \"md\" },\n      { label: \"LG\", value: \"lg\" },\n      { label: \"XL\", value: \"xl\" },\n      { label: \"FULL\", value: \"full\" },\n    ],\n  };\n};\n\nexport const getPaddingField = (\n  props: Readonly<\n    Omit<ButtonGroupFieldSchema<PaddingOptions>, \"options\" | \"type\">\n  >,\n): ButtonGroupFieldSchema<PaddingOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { icon: faBan, value: 0 },\n      { label: \"SM\", value: 2 },\n      { label: \"MD\", value: 4 },\n      { label: \"LG\", value: 6 },\n      { label: \"XL\", value: 8 },\n      { label: \"FULL\", value: 10 },\n    ],\n  };\n};\n\nexport const getButtonSizeField = (\n  props: Readonly<\n    Omit<ButtonGroupFieldSchema<ButtonSizeOptions>, \"options\" | \"type\">\n  >,\n): ButtonGroupFieldSchema<ButtonSizeOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { label: \"SM\", value: \"sm\" },\n      { label: \"MD\", value: \"default\" },\n      { label: \"LG\", value: \"lg\" },\n      { label: \"XL\", value: \"xl\" },\n    ],\n  };\n};\n\nexport const getFontSizeField = (\n  props: Readonly<Omit<TextSizeSelectFieldSchema, \"type\">>,\n): TextSizeSelectFieldSchema => {\n  return {\n    ...props,\n    type: \"textSizeSelect\",\n  };\n};\n\nexport const getGapField = (\n  props: Readonly<Omit<ButtonGroupFieldSchema<GapOptions>, \"options\" | \"type\">>,\n): ButtonGroupFieldSchema<GapOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { icon: faBan, value: \"none\" },\n      { label: \"XS\", value: \"xs\" },\n      { label: \"SM\", value: \"sm\" },\n      { label: \"MD\", value: \"md\" },\n      { label: \"LG\", value: \"lg\" },\n      { label: \"XL\", value: \"xl\" },\n    ],\n  };\n};\n\n/**\n * Gap value mapping - use `as const satisfies` for compile-time validation\n * with literal type preservation.\n */\nexport const gapValues = {\n  none: 0,\n  xs: 1,\n  sm: 2,\n  md: 4,\n  lg: 6,\n  xl: 8,\n} as const satisfies Record<GapOptions, number>;\n"]}
+{"version":3,"sources":["../../src/registries/property-schema-types.ts","../../src/registries/field-helpers.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { IconDefinition } from \"@fortawesome/fontawesome-svg-core\";\nimport type {\n  WidgetType,\n  WidgetSchema,\n  AlignOptions,\n  ColorOptions,\n  FontSizeOptions,\n  SectionLayoutType,\n  StrictOmit,\n} from \"../types\";\n\n/**\n * Tab configuration for organizing properties\n */\nexport interface TabConfig {\n  /** Unique identifier for the tab */\n  id: string;\n  /** Display label for the tab */\n  label: string;\n}\n\n// ============================================================================\n// Property Field Types - Derive from constant for single source of truth\n// ============================================================================\n\n/**\n * Property field type constant - single source of truth for field types.\n * Use PROPERTY_FIELD_TYPES.text instead of \"text\" for type-safe comparisons.\n */\nexport const PROPERTY_FIELD_TYPES = {\n  text: \"text\",\n  textarea: \"textarea\",\n  number: \"number\",\n  boolean: \"boolean\",\n  select: \"select\",\n  color: \"color\",\n  range: \"range\",\n  dataSource: \"dataSource\",\n  resource: \"resource\",\n  alignment: \"alignment\",\n  slider: \"slider\",\n  colorPicker: \"colorPicker\",\n  sectionHeader: \"sectionHeader\",\n  separator: \"separator\",\n  buttonGroup: \"buttonGroup\",\n  colorSelect: \"colorSelect\",\n  sectionLayoutSelect: \"sectionLayoutSelect\",\n  background: \"background\",\n  contentPosition: \"contentPosition\",\n  textSizeSelect: \"textSizeSelect\",\n  cssUnit: \"cssUnit\",\n} as const;\n\n/**\n * Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.\n * @see deriving-typeof-for-object-keys pattern\n */\nexport type PropertyFieldType =\n  (typeof PROPERTY_FIELD_TYPES)[keyof typeof PROPERTY_FIELD_TYPES];\n\n/**\n * Runtime validation for property field types.\n * @param value - The value to check\n * @returns true if value is a valid PropertyFieldType\n */\nexport function isPropertyFieldType(value: string): value is PropertyFieldType {\n  return Object.values(PROPERTY_FIELD_TYPES).includes(\n    value as PropertyFieldType,\n  );\n}\n\n/**\n * Base schema for a property field\n */\nexport interface PropertyFieldSchema {\n  /** Property key in the widget props */\n  key: string;\n  /** Display label for the field */\n  label: string;\n  /** Field type determines the input control */\n  type: PropertyFieldType;\n  /** Optional description/help text */\n  description?: string;\n  /** Optional default value */\n  defaultValue?: unknown;\n  /** Optional tab ID (must match a TabConfig id if widget has tabsConfig) */\n  tab?: string;\n  /** Optional group for organizing fields within a tab */\n  group?: string;\n  /**\n   * @deprecated Use requiresKeyValue instead\n   */\n  requiresKeyToBeTrue?: string;\n  /** Optional requires a specific key to have a specific value */\n  requiresKeyValue?: { key: string; value: unknown };\n}\n\n/**\n * Text field schema\n */\nexport interface TextFieldSchema extends PropertyFieldSchema {\n  type: \"text\";\n  placeholder?: string;\n  maxLength?: number;\n}\n\n/**\n * Textarea field schema\n */\nexport interface TextareaFieldSchema extends PropertyFieldSchema {\n  type: \"textarea\";\n  placeholder?: string;\n  rows?: number;\n  maxLength?: number;\n}\n\n/**\n * Number field schema\n */\nexport interface NumberFieldSchema extends PropertyFieldSchema {\n  type: \"number\";\n  min?: number;\n  max?: number;\n  step?: number;\n}\n\n/**\n * Boolean field schema\n */\nexport interface BooleanFieldSchema extends PropertyFieldSchema {\n  type: \"boolean\";\n}\n\n/**\n * Select field schema with type-safe option values.\n * Uses StrictOmit to ensure \"defaultValue\" key exists on PropertyFieldSchema.\n */\nexport interface SelectFieldSchema<T extends string | number = string | number>\n  extends StrictOmit<PropertyFieldSchema, \"defaultValue\"> {\n  type: \"select\";\n  options: Array<{ label: string; value: T }>;\n  defaultValue?: T;\n}\n\n/**\n * Color field schema\n */\nexport interface ColorFieldSchema extends PropertyFieldSchema {\n  type: \"color\";\n}\n\n/**\n * Range slider field schema\n */\nexport interface RangeFieldSchema extends PropertyFieldSchema {\n  type: \"range\";\n  min: number;\n  max: number;\n  step?: number;\n}\n\n/**\n * Data source field schema for configuring widget data sources\n */\nexport interface DataSourceFieldSchema extends PropertyFieldSchema {\n  type: \"dataSource\";\n}\n\n/**\n * Resource field schema for selecting a single resource from the selection modal\n */\nexport interface ResourceFieldSchema extends PropertyFieldSchema {\n  type: \"resource\";\n  /** Optional filter to specific shareable types */\n  allowedTypes?: string[];\n}\n\n/**\n * Alignment field schema\n */\nexport interface AlignmentFieldSchema extends PropertyFieldSchema {\n  type: \"alignment\";\n  options: {\n    verticalEnabled: boolean;\n    horizontalEnabled: boolean;\n  };\n  defaultValue?: AlignOptions;\n}\n\n/**\n * Slider field schema with optional unit suffix (e.g., \"rem\", \"px\")\n */\nexport interface SliderFieldSchema extends PropertyFieldSchema {\n  type: \"slider\";\n  min: number;\n  max: number;\n  step?: number;\n  unit?: string;\n}\n\n/**\n * Color picker field schema with optional swatches\n */\nexport interface ColorPickerFieldSchema extends PropertyFieldSchema {\n  type: \"colorPicker\";\n  swatches?: string[];\n}\n\n/**\n * Section header field schema for visual grouping\n */\nexport interface SectionHeaderFieldSchema extends PropertyFieldSchema {\n  type: \"sectionHeader\";\n  subtitle?: string;\n}\n\n/**\n * Separator field schema for visual separation\n */\nexport interface SeparatorFieldSchema extends PropertyFieldSchema {\n  type: \"separator\";\n}\n\n/**\n * Button group field schema.\n * Uses StrictOmit to ensure \"defaultValue\" key exists on PropertyFieldSchema.\n */\nexport interface ButtonGroupFieldSchema<\n  T extends string | number = string | number,\n> extends StrictOmit<PropertyFieldSchema, \"defaultValue\"> {\n  type: \"buttonGroup\";\n  options: Array<{ label?: string; icon?: IconDefinition; value: T }>;\n  defaultValue?: T;\n}\n\n/**\n * Color select field schema\n */\nexport interface ColorSelectFieldSchema extends PropertyFieldSchema {\n  type: \"colorSelect\";\n  defaultValue?: ColorOptions;\n}\n\n/**\n * Section layout select field schema for visual masonry layout selector\n */\nexport interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {\n  type: \"sectionLayoutSelect\";\n  defaultValue?: SectionLayoutType;\n}\n\n/**\n * Background field combines resource selection and color properties.\n * Uses StrictOmit to exclude conflicting \"type\" discriminant from parents.\n */\nexport interface BackgroundFieldSchema\n  extends StrictOmit<ResourceFieldSchema, \"type\">,\n    StrictOmit<ColorFieldSchema, \"type\"> {\n  type: \"background\";\n}\n\n/**\n * Content position field schema for 3x3 grid position picker\n */\nexport interface ContentPositionFieldSchema extends PropertyFieldSchema {\n  type: \"contentPosition\";\n  defaultValue?: string;\n}\n\n/**\n * Text size select field schema for visual font size selector\n */\nexport interface TextSizeSelectFieldSchema extends PropertyFieldSchema {\n  type: \"textSizeSelect\";\n  defaultValue?: FontSizeOptions;\n}\n\n/**\n * CSS unit type for height/width fields\n */\nexport type CssUnit = \"px\" | \"rem\" | \"vh\";\n\n/**\n * CSS unit field schema for numeric values with selectable units (px, rem, vh)\n */\nexport interface CssUnitFieldSchema extends PropertyFieldSchema {\n  type: \"cssUnit\";\n  min?: number;\n  max?: number;\n  step?: number;\n  allowedUnits?: CssUnit[];\n  defaultUnit?: CssUnit;\n}\n\n/**\n * Union of all field schema types\n */\nexport type PropertyField =\n  | TextFieldSchema\n  | TextareaFieldSchema\n  | NumberFieldSchema\n  | BooleanFieldSchema\n  | SelectFieldSchema<string | number>\n  | ColorFieldSchema\n  | RangeFieldSchema\n  | DataSourceFieldSchema\n  | ResourceFieldSchema\n  | AlignmentFieldSchema\n  | SliderFieldSchema\n  | ColorPickerFieldSchema\n  | SectionHeaderFieldSchema\n  | SeparatorFieldSchema\n  | ButtonGroupFieldSchema<string | number>\n  | ColorSelectFieldSchema\n  | SectionLayoutSelectFieldSchema\n  | BackgroundFieldSchema\n  | ContentPositionFieldSchema\n  | TextSizeSelectFieldSchema\n  | CssUnitFieldSchema;\n\n/**\n * Schema for per-item configuration in custom data sources.\n * Widgets can define this to allow users to configure widget-specific\n * settings for each selected item (e.g., title, description, button).\n */\nexport interface ItemConfigSchema {\n  /** Fields available for per-item configuration */\n  fields: PropertyField[];\n  /** Optional description shown at top of item config panel */\n  description?: string;\n}\n\n/**\n * Schema for a widget's editable properties\n */\nexport interface WidgetPropertySchema {\n  /** Widget type this schema applies to */\n  widgetType: WidgetType;\n  /** Display name for the widget */\n  displayName: string;\n  /** Optional tab configuration - if present, tabs are enabled */\n  tabsConfig?: TabConfig[];\n  /** Editable property fields */\n  fields: PropertyField[];\n  /** Optional custom validator function */\n  validate?: (props: Record<string, unknown>) => string | null;\n  /** Props that can be populated from data sources */\n  dataSourceTargetProps?: string[];\n  /** Optional schema for per-item configurations in custom data sources */\n  itemConfigSchema?: ItemConfigSchema;\n}\n\n/**\n * Registry mapping widget types to their property schemas\n */\nexport type PropertySchemaRegistry = Record<WidgetType, WidgetPropertySchema>;\n\n/**\n * Group property fields by their group property\n */\nexport function groupPropertyFields(\n  fields: readonly PropertyField[],\n): Record<string, PropertyField[]> {\n  const grouped: Record<string, PropertyField[]> = {};\n\n  fields.forEach((field) => {\n    const group = field.group || \"General\";\n    if (!grouped[group]) {\n      grouped[group] = [];\n    }\n    grouped[group].push(field);\n  });\n\n  return grouped;\n}\n\n/**\n * Extract current values from widget props based on property fields\n */\nexport function extractPropertyValues(\n  widget: Readonly<WidgetSchema>,\n  fields: readonly PropertyField[],\n): Record<string, unknown> {\n  const values: Record<string, unknown> = {};\n\n  fields.forEach((field) => {\n    const value = widget.props[field.key];\n    values[field.key] = value !== undefined ? value : field.defaultValue;\n  });\n\n  return values;\n}\n\n/**\n * Apply property values to widget props\n */\nexport function applyPropertyValues(\n  widget: Readonly<WidgetSchema>,\n  values: Readonly<Record<string, unknown>>,\n): WidgetSchema {\n  return {\n    ...widget,\n    props: {\n      ...widget.props,\n      ...values,\n    },\n  };\n}\n","import type {\n  ButtonGroupFieldSchema,\n  ColorSelectFieldSchema,\n  CssUnitFieldSchema,\n  TextSizeSelectFieldSchema,\n} from \"./property-schema-types\";\nimport type {\n  BorderRadiusOptions,\n  PaddingOptions,\n  ButtonSizeOptions,\n  GapOptions,\n} from \"../types\";\nimport { faBan } from \"@fortawesome/pro-regular-svg-icons\";\n\nexport const getColorField = (\n  props: Readonly<Omit<ColorSelectFieldSchema, \"type\">>,\n): ColorSelectFieldSchema => {\n  return {\n    ...props,\n    type: \"colorSelect\",\n  };\n};\n\nexport const getBorderRadiusField = (\n  props: Readonly<\n    Omit<ButtonGroupFieldSchema<BorderRadiusOptions>, \"options\" | \"type\">\n  >,\n): ButtonGroupFieldSchema<BorderRadiusOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { icon: faBan, value: \"none\" },\n      { label: \"SM\", value: \"sm\" },\n      { label: \"MD\", value: \"md\" },\n      { label: \"LG\", value: \"lg\" },\n      { label: \"XL\", value: \"xl\" },\n      { label: \"FULL\", value: \"full\" },\n    ],\n  };\n};\n\nexport const getPaddingField = (\n  props: Readonly<\n    Omit<ButtonGroupFieldSchema<PaddingOptions>, \"options\" | \"type\">\n  >,\n): ButtonGroupFieldSchema<PaddingOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { icon: faBan, value: 0 },\n      { label: \"SM\", value: 2 },\n      { label: \"MD\", value: 4 },\n      { label: \"LG\", value: 6 },\n      { label: \"XL\", value: 8 },\n      { label: \"FULL\", value: 10 },\n    ],\n  };\n};\n\nexport const getButtonSizeField = (\n  props: Readonly<\n    Omit<ButtonGroupFieldSchema<ButtonSizeOptions>, \"options\" | \"type\">\n  >,\n): ButtonGroupFieldSchema<ButtonSizeOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { label: \"SM\", value: \"sm\" },\n      { label: \"MD\", value: \"default\" },\n      { label: \"LG\", value: \"lg\" },\n      { label: \"XL\", value: \"xl\" },\n    ],\n  };\n};\n\nexport const getFontSizeField = (\n  props: Readonly<Omit<TextSizeSelectFieldSchema, \"type\">>,\n): TextSizeSelectFieldSchema => {\n  return {\n    ...props,\n    type: \"textSizeSelect\",\n  };\n};\n\nexport const getGapField = (\n  props: Readonly<Omit<ButtonGroupFieldSchema<GapOptions>, \"options\" | \"type\">>,\n): ButtonGroupFieldSchema<GapOptions> => {\n  return {\n    ...props,\n    type: \"buttonGroup\",\n    options: [\n      { icon: faBan, value: \"none\" },\n      { label: \"XS\", value: \"xs\" },\n      { label: \"SM\", value: \"sm\" },\n      { label: \"MD\", value: \"md\" },\n      { label: \"LG\", value: \"lg\" },\n      { label: \"XL\", value: \"xl\" },\n    ],\n  };\n};\n\nexport const getHeightField = (\n  props: Readonly<Omit<CssUnitFieldSchema, \"type\">>,\n): CssUnitFieldSchema => {\n  return {\n    ...props,\n    type: \"cssUnit\",\n  };\n};\n\n/**\n * Gap value mapping - use `as const satisfies` for compile-time validation\n * with literal type preservation.\n */\nexport const gapValues = {\n  none: 0,\n  xs: 1,\n  sm: 2,\n  md: 4,\n  lg: 6,\n  xl: 8,\n} as const satisfies Record<GapOptions, number>;\n"]}

package/dist/shell/AppShellLayout.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
-var chunkBWHUEED3_cjs = require('../chunk-BWHUEED3.cjs');
-require('../chunk-CMXYKDHC.cjs');
+var chunkEMFSTGLP_cjs = require('../chunk-EMFSTGLP.cjs');
+require('../chunk-M54NWBRO.cjs');
 require('../chunk-5NYM4UTW.cjs');
 
 
 
 Object.defineProperty(exports, "AppShellLayout", {
   enumerable: true,
-  get: function () { return chunkBWHUEED3_cjs.AppShellLayout; }
+  get: function () { return chunkEMFSTGLP_cjs.AppShellLayout; }
 });
 //# sourceMappingURL=AppShellLayout.cjs.map
 //# sourceMappingURL=AppShellLayout.cjs.map

package/dist/shell/AppShellLayout.js

@@ -1,5 +1,5 @@
-export { AppShellLayout } from '../chunk-PZ6BM57A.js';
-import '../chunk-2IFFXFJL.js';
+export { AppShellLayout } from '../chunk-KZHNZ2NG.js';
+import '../chunk-4NBPTMT4.js';
 import '../chunk-HIDJYVKJ.js';
 //# sourceMappingURL=AppShellLayout.js.map
 //# sourceMappingURL=AppShellLayout.js.map

package/dist/shell/index.cjs

@@ -1,11 +1,76 @@
 'use strict';
 
 var chunkYXJMBVXO_cjs = require('../chunk-YXJMBVXO.cjs');
-var chunkBWHUEED3_cjs = require('../chunk-BWHUEED3.cjs');
-var chunkCMXYKDHC_cjs = require('../chunk-CMXYKDHC.cjs');
+var chunkEMFSTGLP_cjs = require('../chunk-EMFSTGLP.cjs');
+var chunkM54NWBRO_cjs = require('../chunk-M54NWBRO.cjs');
 var chunk5NYM4UTW_cjs = require('../chunk-5NYM4UTW.cjs');
+var reactFontawesome = require('@fortawesome/react-fontawesome');
+var proRegularSvgIcons = require('@fortawesome/pro-regular-svg-icons');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
 
-
+var ScreenHeaderWriteContext = react.createContext(null);
+var ScreenHeaderReadContext = react.createContext(null);
+var ScreenHeaderBreadcrumbsWriteContext = react.createContext(null);
+var ScreenHeaderBreadcrumbsReadContext = react.createContext(null);
+function ScreenHeaderProvider({ children }) {
+  const [actions, setActions] = react.useState(null);
+  const [breadcrumbs, setBreadcrumbs] = react.useState(null);
+  return /* @__PURE__ */ jsxRuntime.jsx(ScreenHeaderWriteContext.Provider, { value: setActions, children: /* @__PURE__ */ jsxRuntime.jsx(ScreenHeaderReadContext.Provider, { value: actions, children: /* @__PURE__ */ jsxRuntime.jsx(ScreenHeaderBreadcrumbsWriteContext.Provider, { value: setBreadcrumbs, children: /* @__PURE__ */ jsxRuntime.jsx(ScreenHeaderBreadcrumbsReadContext.Provider, { value: breadcrumbs, children }) }) }) });
+}
+function useScreenHeaderActions(actions) {
+  const setActions = react.useContext(ScreenHeaderWriteContext);
+  const setActionsRef = react.useRef(setActions);
+  setActionsRef.current = setActions;
+  react.useEffect(() => {
+    if (!setActions) return;
+    setActions(actions);
+  }, [actions, setActions]);
+  react.useEffect(() => {
+    return () => setActionsRef.current?.(null);
+  }, []);
+  return setActions !== null;
+}
+function useScreenHeaderBreadcrumbs(breadcrumbs) {
+  const setBreadcrumbs = react.useContext(ScreenHeaderBreadcrumbsWriteContext);
+  const setBreadcrumbsRef = react.useRef(setBreadcrumbs);
+  setBreadcrumbsRef.current = setBreadcrumbs;
+  react.useEffect(() => {
+    if (!setBreadcrumbs) return;
+    setBreadcrumbs(breadcrumbs);
+  }, [breadcrumbs, setBreadcrumbs]);
+  react.useEffect(() => {
+    return () => setBreadcrumbsRef.current?.(null);
+  }, []);
+  return setBreadcrumbs !== null;
+}
+function useScreenHeaderContext() {
+  const actions = react.useContext(ScreenHeaderReadContext);
+  const breadcrumbs = react.useContext(ScreenHeaderBreadcrumbsReadContext);
+  return { actions: actions ?? null, breadcrumbs: breadcrumbs ?? null };
+}
+function ScreenHeader({ title }) {
+  const { toggleSidebar, isMobile } = chunkM54NWBRO_cjs.useSidebar();
+  const { actions, breadcrumbs } = useScreenHeaderContext();
+  if (!title && !breadcrumbs) return null;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sticky top-0 z-[15] flex flex-row items-center border-b border-border bg-background px-4 py-3 md:px-6", children: [
+    !isMobile && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          onClick: toggleSidebar,
+          className: "-ml-1 inline-flex items-center justify-center rounded-md p-1 text-muted-foreground hover:text-foreground",
+          "aria-label": "Toggle Sidebar",
+          children: /* @__PURE__ */ jsxRuntime.jsx(reactFontawesome.FontAwesomeIcon, { icon: proRegularSvgIcons.faTableLayout, className: "size-4" })
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mx-2 h-4 w-px bg-border" })
+    ] }),
+    breadcrumbs ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "min-w-0 flex-1", children: breadcrumbs }) : /* @__PURE__ */ jsxRuntime.jsx("h1", { className: "text-lg font-semibold text-foreground", children: title }),
+    actions && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ml-auto flex items-center gap-2", children: actions })
+  ] });
+}
 
 Object.defineProperty(exports, "ThemeModeProvider", {
   enumerable: true,
@@ -21,103 +86,103 @@ Object.defineProperty(exports, "useThemeMode", {
 });
 Object.defineProperty(exports, "AppShellLayout", {
   enumerable: true,
-  get: function () { return chunkBWHUEED3_cjs.AppShellLayout; }
+  get: function () { return chunkEMFSTGLP_cjs.AppShellLayout; }
 });
 Object.defineProperty(exports, "Sidebar", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.Sidebar; }
+  get: function () { return chunkM54NWBRO_cjs.Sidebar; }
 });
 Object.defineProperty(exports, "SidebarContent", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarContent; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarContent; }
 });
 Object.defineProperty(exports, "SidebarContext", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarContext; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarContext; }
 });
 Object.defineProperty(exports, "SidebarFooter", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarFooter; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarFooter; }
 });
 Object.defineProperty(exports, "SidebarGroup", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarGroup; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarGroup; }
 });
 Object.defineProperty(exports, "SidebarGroupAction", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarGroupAction; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarGroupAction; }
 });
 Object.defineProperty(exports, "SidebarGroupContent", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarGroupContent; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarGroupContent; }
 });
 Object.defineProperty(exports, "SidebarGroupLabel", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarGroupLabel; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarGroupLabel; }
 });
 Object.defineProperty(exports, "SidebarHeader", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarHeader; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarHeader; }
 });
 Object.defineProperty(exports, "SidebarInput", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarInput; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarInput; }
 });
 Object.defineProperty(exports, "SidebarInset", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarInset; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarInset; }
 });
 Object.defineProperty(exports, "SidebarMenu", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenu; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenu; }
 });
 Object.defineProperty(exports, "SidebarMenuAction", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuAction; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuAction; }
 });
 Object.defineProperty(exports, "SidebarMenuBadge", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuBadge; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuBadge; }
 });
 Object.defineProperty(exports, "SidebarMenuButton", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuButton; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuButton; }
 });
 Object.defineProperty(exports, "SidebarMenuItem", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuItem; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuItem; }
 });
 Object.defineProperty(exports, "SidebarMenuSkeleton", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuSkeleton; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuSkeleton; }
 });
 Object.defineProperty(exports, "SidebarMenuSub", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuSub; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuSub; }
 });
 Object.defineProperty(exports, "SidebarMenuSubButton", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuSubButton; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuSubButton; }
 });
 Object.defineProperty(exports, "SidebarMenuSubItem", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarMenuSubItem; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarMenuSubItem; }
 });
 Object.defineProperty(exports, "SidebarProvider", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarProvider; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarProvider; }
 });
 Object.defineProperty(exports, "SidebarRail", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarRail; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarRail; }
 });
 Object.defineProperty(exports, "SidebarSeparator", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.SidebarSeparator; }
+  get: function () { return chunkM54NWBRO_cjs.SidebarSeparator; }
 });
 Object.defineProperty(exports, "useSidebar", {
   enumerable: true,
-  get: function () { return chunkCMXYKDHC_cjs.useSidebar; }
+  get: function () { return chunkM54NWBRO_cjs.useSidebar; }
 });
 Object.defineProperty(exports, "useIsMobile", {
   enumerable: true,
@@ -131,5 +196,10 @@ Object.defineProperty(exports, "useIsTablet", {
   enumerable: true,
   get: function () { return chunk5NYM4UTW_cjs.useIsTablet; }
 });
+exports.ScreenHeader = ScreenHeader;
+exports.ScreenHeaderProvider = ScreenHeaderProvider;
+exports.useScreenHeaderActions = useScreenHeaderActions;
+exports.useScreenHeaderBreadcrumbs = useScreenHeaderBreadcrumbs;
+exports.useScreenHeaderContext = useScreenHeaderContext;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/shell/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/shell/ScreenHeaderContext.tsx","../../src/shell/ScreenHeader.tsx"],"names":["createContext","useState","jsx","useContext","useRef","useEffect","useSidebar","jsxs","Fragment","FontAwesomeIcon","faTableLayout"],"mappings":"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","file":"index.cjs","sourcesContent":["\"use client\";\n\nimport {\n  createContext,\n  useContext,\n  useState,\n  useEffect,\n  useRef,\n  type ReactNode,\n} from \"react\";\n\ntype SetActions = (actions: ReactNode) => void;\ntype SetBreadcrumbs = (breadcrumbs: ReactNode) => void;\n\n/**\n * Split into separate read/write contexts so that components calling\n * useScreenHeaderActions (writers) don't re-render when the actions\n * state changes — only the ScreenHeader (reader) re-renders.\n */\nconst ScreenHeaderWriteContext = createContext<SetActions | null>(null);\nconst ScreenHeaderReadContext = createContext<ReactNode>(null);\n\nconst ScreenHeaderBreadcrumbsWriteContext =\n  createContext<SetBreadcrumbs | null>(null);\nconst ScreenHeaderBreadcrumbsReadContext = createContext<ReactNode>(null);\n\nexport function ScreenHeaderProvider({ children }: { children: ReactNode }) {\n  const [actions, setActions] = useState<ReactNode>(null);\n  const [breadcrumbs, setBreadcrumbs] = useState<ReactNode>(null);\n\n  return (\n    <ScreenHeaderWriteContext.Provider value={setActions}>\n      <ScreenHeaderReadContext.Provider value={actions}>\n        <ScreenHeaderBreadcrumbsWriteContext.Provider value={setBreadcrumbs}>\n          <ScreenHeaderBreadcrumbsReadContext.Provider value={breadcrumbs}>\n            {children}\n          </ScreenHeaderBreadcrumbsReadContext.Provider>\n        </ScreenHeaderBreadcrumbsWriteContext.Provider>\n      </ScreenHeaderReadContext.Provider>\n    </ScreenHeaderWriteContext.Provider>\n  );\n}\n\n/**\n * Sets actions to display in the ScreenHeader.\n * Returns `true` if inside a ScreenHeaderProvider (i.e., in the rep shell),\n * `false` otherwise. Pages can use this boolean to conditionally skip\n * rendering their own PageHeader.\n *\n * Cleans up actions on unmount so navigating away doesn't leave stale actions.\n */\nexport function useScreenHeaderActions(actions: ReactNode): boolean {\n  const setActions = useContext(ScreenHeaderWriteContext);\n  const setActionsRef = useRef(setActions);\n  setActionsRef.current = setActions;\n\n  // Update actions when the value changes\n  useEffect(() => {\n    if (!setActions) return;\n    setActions(actions);\n  }, [actions, setActions]);\n\n  // Clear actions only on unmount\n  useEffect(() => {\n    return () => setActionsRef.current?.(null);\n  }, []);\n\n  return setActions !== null;\n}\n\n/**\n * Sets breadcrumbs to display in the ScreenHeader (in place of the plain title).\n * Returns `true` if inside a ScreenHeaderProvider (i.e., in the rep shell),\n * `false` otherwise.\n *\n * Cleans up breadcrumbs on unmount so navigating away doesn't leave stale breadcrumbs.\n */\nexport function useScreenHeaderBreadcrumbs(breadcrumbs: ReactNode): boolean {\n  const setBreadcrumbs = useContext(ScreenHeaderBreadcrumbsWriteContext);\n  const setBreadcrumbsRef = useRef(setBreadcrumbs);\n  setBreadcrumbsRef.current = setBreadcrumbs;\n\n  // Update breadcrumbs when the value changes\n  useEffect(() => {\n    if (!setBreadcrumbs) return;\n    setBreadcrumbs(breadcrumbs);\n  }, [breadcrumbs, setBreadcrumbs]);\n\n  // Clear breadcrumbs only on unmount\n  useEffect(() => {\n    return () => setBreadcrumbsRef.current?.(null);\n  }, []);\n\n  return setBreadcrumbs !== null;\n}\n\n/**\n * Reads the current screen header actions and breadcrumbs. Used internally by ScreenHeader.\n */\nexport function useScreenHeaderContext(): {\n  actions: ReactNode;\n  breadcrumbs: ReactNode;\n} {\n  const actions = useContext(ScreenHeaderReadContext);\n  const breadcrumbs = useContext(ScreenHeaderBreadcrumbsReadContext);\n  return { actions: actions ?? null, breadcrumbs: breadcrumbs ?? null };\n}\n","\"use client\";\n\nimport { FontAwesomeIcon } from \"@fortawesome/react-fontawesome\";\nimport { faTableLayout } from \"@fortawesome/pro-regular-svg-icons\";\nimport { useSidebar } from \"./sidebar\";\nimport { useScreenHeaderContext } from \"./ScreenHeaderContext\";\n\nexport interface ScreenHeaderProps {\n  title?: string;\n}\n\nexport function ScreenHeader({ title }: ScreenHeaderProps) {\n  const { toggleSidebar, isMobile } = useSidebar();\n  const { actions, breadcrumbs } = useScreenHeaderContext();\n\n  if (!title && !breadcrumbs) return null;\n\n  return (\n    <div className=\"sticky top-0 z-[15] flex flex-row items-center border-b border-border bg-background px-4 py-3 md:px-6\">\n      {!isMobile && (\n        <>\n          <button\n            type=\"button\"\n            onClick={toggleSidebar}\n            className=\"-ml-1 inline-flex items-center justify-center rounded-md p-1 text-muted-foreground hover:text-foreground\"\n            aria-label=\"Toggle Sidebar\"\n          >\n            <FontAwesomeIcon icon={faTableLayout} className=\"size-4\" />\n          </button>\n          <div className=\"mx-2 h-4 w-px bg-border\" />\n        </>\n      )}\n      {breadcrumbs ? (\n        <div className=\"min-w-0 flex-1\">{breadcrumbs}</div>\n      ) : (\n        <h1 className=\"text-lg font-semibold text-foreground\">{title}</h1>\n      )}\n      {actions && (\n        <div className=\"ml-auto flex items-center gap-2\">{actions}</div>\n      )}\n    </div>\n  );\n}\n"]}

package/dist/shell/index.d.cts

@@ -1,8 +1,43 @@
 export { AppShellLayout, AppShellLayoutProps } from './AppShellLayout.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { Sidebar, SidebarContent, SidebarContext, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, useSidebar } from './sidebar.cjs';
 export { DisplayMode, ThemeMode, ThemeModeContextValue, ThemeModeProvider, getThemeModeAttribute, useThemeMode } from './ThemeModeContext.cjs';
+import { ReactNode } from 'react';
 export { useIsMobile, useIsMobileOrTablet, useIsTablet } from './use-mobile.cjs';
-import 'react/jsx-runtime';
-import 'react';
 import 'class-variance-authority/types';
 import 'class-variance-authority';
+
+interface ScreenHeaderProps {
+    title?: string;
+}
+declare function ScreenHeader({ title }: ScreenHeaderProps): react_jsx_runtime.JSX.Element | null;
+
+declare function ScreenHeaderProvider({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Sets actions to display in the ScreenHeader.
+ * Returns `true` if inside a ScreenHeaderProvider (i.e., in the rep shell),
+ * `false` otherwise. Pages can use this boolean to conditionally skip
+ * rendering their own PageHeader.
+ *
+ * Cleans up actions on unmount so navigating away doesn't leave stale actions.
+ */
+declare function useScreenHeaderActions(actions: ReactNode): boolean;
+/**
+ * Sets breadcrumbs to display in the ScreenHeader (in place of the plain title).
+ * Returns `true` if inside a ScreenHeaderProvider (i.e., in the rep shell),
+ * `false` otherwise.
+ *
+ * Cleans up breadcrumbs on unmount so navigating away doesn't leave stale breadcrumbs.
+ */
+declare function useScreenHeaderBreadcrumbs(breadcrumbs: ReactNode): boolean;
+/**
+ * Reads the current screen header actions and breadcrumbs. Used internally by ScreenHeader.
+ */
+declare function useScreenHeaderContext(): {
+    actions: ReactNode;
+    breadcrumbs: ReactNode;
+};
+
+export { ScreenHeader, type ScreenHeaderProps, ScreenHeaderProvider, useScreenHeaderActions, useScreenHeaderBreadcrumbs, useScreenHeaderContext };

package/dist/shell/index.d.ts

@@ -1,8 +1,43 @@
 export { AppShellLayout, AppShellLayoutProps } from './AppShellLayout.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { Sidebar, SidebarContent, SidebarContext, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, useSidebar } from './sidebar.js';
 export { DisplayMode, ThemeMode, ThemeModeContextValue, ThemeModeProvider, getThemeModeAttribute, useThemeMode } from './ThemeModeContext.js';
+import { ReactNode } from 'react';
 export { useIsMobile, useIsMobileOrTablet, useIsTablet } from './use-mobile.js';
-import 'react/jsx-runtime';
-import 'react';
 import 'class-variance-authority/types';
 import 'class-variance-authority';
+
+interface ScreenHeaderProps {
+    title?: string;
+}
+declare function ScreenHeader({ title }: ScreenHeaderProps): react_jsx_runtime.JSX.Element | null;
+
+declare function ScreenHeaderProvider({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Sets actions to display in the ScreenHeader.
+ * Returns `true` if inside a ScreenHeaderProvider (i.e., in the rep shell),
+ * `false` otherwise. Pages can use this boolean to conditionally skip
+ * rendering their own PageHeader.
+ *
+ * Cleans up actions on unmount so navigating away doesn't leave stale actions.
+ */
+declare function useScreenHeaderActions(actions: ReactNode): boolean;
+/**
+ * Sets breadcrumbs to display in the ScreenHeader (in place of the plain title).
+ * Returns `true` if inside a ScreenHeaderProvider (i.e., in the rep shell),
+ * `false` otherwise.
+ *
+ * Cleans up breadcrumbs on unmount so navigating away doesn't leave stale breadcrumbs.
+ */
+declare function useScreenHeaderBreadcrumbs(breadcrumbs: ReactNode): boolean;
+/**
+ * Reads the current screen header actions and breadcrumbs. Used internally by ScreenHeader.
+ */
+declare function useScreenHeaderContext(): {
+    actions: ReactNode;
+    breadcrumbs: ReactNode;
+};
+
+export { ScreenHeader, type ScreenHeaderProps, ScreenHeaderProvider, useScreenHeaderActions, useScreenHeaderBreadcrumbs, useScreenHeaderContext };

package/dist/shell/index.js

@@ -1,6 +1,76 @@
 export { ThemeModeProvider, getThemeModeAttribute, useThemeMode } from '../chunk-2SPTFZRC.js';
-export { AppShellLayout } from '../chunk-PZ6BM57A.js';
-export { Sidebar, SidebarContent, SidebarContext, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, useSidebar } from '../chunk-2IFFXFJL.js';
+export { AppShellLayout } from '../chunk-KZHNZ2NG.js';
+import { useSidebar } from '../chunk-4NBPTMT4.js';
+export { Sidebar, SidebarContent, SidebarContext, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, useSidebar } from '../chunk-4NBPTMT4.js';
 export { useIsMobile, useIsMobileOrTablet, useIsTablet } from '../chunk-HIDJYVKJ.js';
+import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
+import { faTableLayout } from '@fortawesome/pro-regular-svg-icons';
+import { createContext, useState, useContext, useRef, useEffect } from 'react';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+var ScreenHeaderWriteContext = createContext(null);
+var ScreenHeaderReadContext = createContext(null);
+var ScreenHeaderBreadcrumbsWriteContext = createContext(null);
+var ScreenHeaderBreadcrumbsReadContext = createContext(null);
+function ScreenHeaderProvider({ children }) {
+  const [actions, setActions] = useState(null);
+  const [breadcrumbs, setBreadcrumbs] = useState(null);
+  return /* @__PURE__ */ jsx(ScreenHeaderWriteContext.Provider, { value: setActions, children: /* @__PURE__ */ jsx(ScreenHeaderReadContext.Provider, { value: actions, children: /* @__PURE__ */ jsx(ScreenHeaderBreadcrumbsWriteContext.Provider, { value: setBreadcrumbs, children: /* @__PURE__ */ jsx(ScreenHeaderBreadcrumbsReadContext.Provider, { value: breadcrumbs, children }) }) }) });
+}
+function useScreenHeaderActions(actions) {
+  const setActions = useContext(ScreenHeaderWriteContext);
+  const setActionsRef = useRef(setActions);
+  setActionsRef.current = setActions;
+  useEffect(() => {
+    if (!setActions) return;
+    setActions(actions);
+  }, [actions, setActions]);
+  useEffect(() => {
+    return () => setActionsRef.current?.(null);
+  }, []);
+  return setActions !== null;
+}
+function useScreenHeaderBreadcrumbs(breadcrumbs) {
+  const setBreadcrumbs = useContext(ScreenHeaderBreadcrumbsWriteContext);
+  const setBreadcrumbsRef = useRef(setBreadcrumbs);
+  setBreadcrumbsRef.current = setBreadcrumbs;
+  useEffect(() => {
+    if (!setBreadcrumbs) return;
+    setBreadcrumbs(breadcrumbs);
+  }, [breadcrumbs, setBreadcrumbs]);
+  useEffect(() => {
+    return () => setBreadcrumbsRef.current?.(null);
+  }, []);
+  return setBreadcrumbs !== null;
+}
+function useScreenHeaderContext() {
+  const actions = useContext(ScreenHeaderReadContext);
+  const breadcrumbs = useContext(ScreenHeaderBreadcrumbsReadContext);
+  return { actions: actions ?? null, breadcrumbs: breadcrumbs ?? null };
+}
+function ScreenHeader({ title }) {
+  const { toggleSidebar, isMobile } = useSidebar();
+  const { actions, breadcrumbs } = useScreenHeaderContext();
+  if (!title && !breadcrumbs) return null;
+  return /* @__PURE__ */ jsxs("div", { className: "sticky top-0 z-[15] flex flex-row items-center border-b border-border bg-background px-4 py-3 md:px-6", children: [
+    !isMobile && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: toggleSidebar,
+          className: "-ml-1 inline-flex items-center justify-center rounded-md p-1 text-muted-foreground hover:text-foreground",
+          "aria-label": "Toggle Sidebar",
+          children: /* @__PURE__ */ jsx(FontAwesomeIcon, { icon: faTableLayout, className: "size-4" })
+        }
+      ),
+      /* @__PURE__ */ jsx("div", { className: "mx-2 h-4 w-px bg-border" })
+    ] }),
+    breadcrumbs ? /* @__PURE__ */ jsx("div", { className: "min-w-0 flex-1", children: breadcrumbs }) : /* @__PURE__ */ jsx("h1", { className: "text-lg font-semibold text-foreground", children: title }),
+    actions && /* @__PURE__ */ jsx("div", { className: "ml-auto flex items-center gap-2", children: actions })
+  ] });
+}
+
+export { ScreenHeader, ScreenHeaderProvider, useScreenHeaderActions, useScreenHeaderBreadcrumbs, useScreenHeaderContext };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map