@fluid-app/rep-core 0.1.0

package/dist/chunk-6QLUUNJL.cjs

@@ -0,0 +1,153 @@
+'use strict';
+
+// src/types/widget-schema.ts
+var WIDGET_TYPE_NAMES = {
+  Alert: "AlertWidget",
+  Calendar: "CalendarWidget",
+  Carousel: "CarouselWidget",
+  CatchUp: "CatchUpWidget",
+  Chart: "ChartWidget",
+  Container: "ContainerWidget",
+  Embed: "EmbedWidget",
+  Image: "ImageWidget",
+  Layout: "LayoutWidget",
+  List: "ListWidget",
+  MySite: "MySiteWidget",
+  Nested: "NestedWidget",
+  QuickShare: "QuickShareWidget",
+  RecentActivity: "RecentActivityWidget",
+  Spacer: "SpacerWidget",
+  Table: "TableWidget",
+  Text: "TextWidget",
+  ToDo: "ToDoWidget",
+  Video: "VideoWidget"
+};
+function isWidgetTypeName(type) {
+  return Object.values(WIDGET_TYPE_NAMES).includes(type);
+}
+function isWidgetType(widget, typeName) {
+  return widget != null && widget.type === typeName;
+}
+function assertNever(value, context) {
+  const message = context ? `Unexpected ${context}: ${String(value)}` : `Unexpected value: ${String(value)}`;
+  throw new Error(message);
+}
+function assertDefined(value, name) {
+  if (value == null) {
+    throw new Error(name ? `${name} is required` : "Value is required");
+  }
+}
+
+// src/types/field-types.ts
+var COLOR_OPTIONS = {
+  background: "background",
+  foreground: "foreground",
+  primary: "primary",
+  secondary: "secondary",
+  accent: "accent",
+  muted: "muted",
+  destructive: "destructive"
+};
+var FONT_SIZE_OPTIONS = {
+  "2xl": "2xl",
+  xl: "xl",
+  lg: "lg",
+  md: "md",
+  sm: "sm",
+  xs: "xs"
+};
+var BORDER_RADIUS_OPTIONS = {
+  none: "none",
+  sm: "sm",
+  md: "md",
+  lg: "lg",
+  xl: "xl",
+  full: "full"
+};
+var PADDING_VALUES = [0, 2, 4, 6, 8, 10];
+var BUTTON_SIZE_OPTIONS = {
+  sm: "sm",
+  default: "default",
+  lg: "lg",
+  xl: "xl"
+};
+var GAP_OPTIONS = {
+  none: "none",
+  xs: "xs",
+  sm: "sm",
+  md: "md",
+  lg: "lg",
+  xl: "xl"
+};
+var VERTICAL_ALIGN_OPTIONS = {
+  top: "top",
+  center: "center",
+  bottom: "bottom"
+};
+var HORIZONTAL_ALIGN_OPTIONS = {
+  left: "left",
+  center: "center",
+  right: "right"
+};
+var BACKGROUND_TYPES = {
+  solid: "solid",
+  image: "image"
+};
+var SECTION_LAYOUT_CONFIG = {
+  "single-column": { columns: 1, widths: ["1fr"], gridClasses: "" },
+  "2c-equal": {
+    columns: 2,
+    widths: ["1fr", "1fr"],
+    gridClasses: "@md:grid-cols-2"
+  },
+  "2c-left-wider": {
+    columns: 2,
+    widths: ["2fr", "1fr"],
+    gridClasses: "@md:grid-cols-[2fr_1fr]"
+  },
+  "2c-right-wider": {
+    columns: 2,
+    widths: ["1fr", "2fr"],
+    gridClasses: "@md:grid-cols-[1fr_2fr]"
+  },
+  "2c-left-narrow": {
+    columns: 2,
+    widths: ["1fr", "3fr"],
+    gridClasses: "@md:grid-cols-[1fr_3fr]"
+  },
+  "2c-right-narrow": {
+    columns: 2,
+    widths: ["3fr", "1fr"],
+    gridClasses: "@md:grid-cols-[3fr_1fr]"
+  },
+  "3c-equal": {
+    columns: 3,
+    widths: ["1fr", "1fr", "1fr"],
+    gridClasses: "@md:grid-cols-3"
+  },
+  "3c-middle-wider": {
+    columns: 3,
+    widths: ["1fr", "2fr", "1fr"],
+    gridClasses: "@md:grid-cols-[1fr_2fr_1fr]"
+  }
+};
+var sectionLayoutConfig = SECTION_LAYOUT_CONFIG;
+
+exports.BACKGROUND_TYPES = BACKGROUND_TYPES;
+exports.BORDER_RADIUS_OPTIONS = BORDER_RADIUS_OPTIONS;
+exports.BUTTON_SIZE_OPTIONS = BUTTON_SIZE_OPTIONS;
+exports.COLOR_OPTIONS = COLOR_OPTIONS;
+exports.FONT_SIZE_OPTIONS = FONT_SIZE_OPTIONS;
+exports.GAP_OPTIONS = GAP_OPTIONS;
+exports.HORIZONTAL_ALIGN_OPTIONS = HORIZONTAL_ALIGN_OPTIONS;
+exports.PADDING_VALUES = PADDING_VALUES;
+exports.SECTION_LAYOUT_CONFIG = SECTION_LAYOUT_CONFIG;
+exports.VERTICAL_ALIGN_OPTIONS = VERTICAL_ALIGN_OPTIONS;
+exports.WIDGET_TYPE_NAMES = WIDGET_TYPE_NAMES;
+exports.assertDefined = assertDefined;
+exports.assertNever = assertNever;
+exports.isWidgetType = isWidgetType;
+exports.isWidgetTypeName = isWidgetTypeName;
+exports.sectionLayoutConfig = sectionLayoutConfig;
+//# sourceMappingURL=chunk-6QLUUNJL.cjs.map
+//# sourceMappingURL=chunk-6QLUUNJL.cjs.map

package/dist/chunk-6QLUUNJL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/widget-schema.ts","../src/types/field-types.ts"],"names":[],"mappings":";;;AAOO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,KAAA,EAAO,aAAA;AAAA,EACP,QAAA,EAAU,gBAAA;AAAA,EACV,QAAA,EAAU,gBAAA;AAAA,EACV,OAAA,EAAS,eAAA;AAAA,EACT,KAAA,EAAO,aAAA;AAAA,EACP,SAAA,EAAW,iBAAA;AAAA,EACX,KAAA,EAAO,aAAA;AAAA,EACP,KAAA,EAAO,aAAA;AAAA,EACP,MAAA,EAAQ,cAAA;AAAA,EACR,IAAA,EAAM,YAAA;AAAA,EACN,MAAA,EAAQ,cAAA;AAAA,EACR,MAAA,EAAQ,cAAA;AAAA,EACR,UAAA,EAAY,kBAAA;AAAA,EACZ,cAAA,EAAgB,sBAAA;AAAA,EAChB,MAAA,EAAQ,cAAA;AAAA,EACR,KAAA,EAAO,aAAA;AAAA,EACP,IAAA,EAAM,YAAA;AAAA,EACN,IAAA,EAAM,YAAA;AAAA,EACN,KAAA,EAAO;AACT;AAkEO,SAAS,iBAAiB,IAAA,EAAsC;AAIrE,EAAA,OAAO,MAAA,CAAO,MAAA,CAAO,iBAAiB,CAAA,CAAE,SAAS,IAAsB,CAAA;AACzE;AAYO,SAAS,YAAA,CACd,QACA,QAAA,EAC+C;AAC/C,EAAA,OAAO,MAAA,IAAU,IAAA,IAAQ,MAAA,CAAO,IAAA,KAAS,QAAA;AAC3C;AAcO,SAAS,WAAA,CAAY,OAAc,OAAA,EAAyB;AACjE,EAAA,MAAM,OAAA,GAAU,OAAA,GACZ,CAAA,WAAA,EAAc,OAAO,CAAA,EAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA,GACvC,CAAA,kBAAA,EAAqB,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA;AACtC,EAAA,MAAM,IAAI,MAAM,OAAO,CAAA;AACzB;AAWO,SAAS,aAAA,CACd,OACA,IAAA,EACoB;AACpB,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,MAAM,IAAI,KAAA,CAAM,IAAA,GAAO,CAAA,EAAG,IAAI,iBAAiB,mBAAmB,CAAA;AAAA,EACpE;AACF;;;AC9IO,IAAM,aAAA,GAAgB;AAAA,EAC3B,UAAA,EAAY,YAAA;AAAA,EACZ,UAAA,EAAY,YAAA;AAAA,EACZ,OAAA,EAAS,SAAA;AAAA,EACT,SAAA,EAAW,WAAA;AAAA,EACX,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,WAAA,EAAa;AACf;AAYO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,KAAA,EAAO,KAAA;AAAA,EACP,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI;AACN;AAKO,IAAM,qBAAA,GAAwB;AAAA,EACnC,IAAA,EAAM,MAAA;AAAA,EACN,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,IAAA,EAAM;AACR;AAMO,IAAM,iBAAiB,CAAC,CAAA,EAAG,GAAG,CAAA,EAAG,CAAA,EAAG,GAAG,EAAE;AAGzC,IAAM,mBAAA,GAAsB;AAAA,EACjC,EAAA,EAAI,IAAA;AAAA,EACJ,OAAA,EAAS,SAAA;AAAA,EACT,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI;AACN;AAKO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA,EAAM,MAAA;AAAA,EACN,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI;AACN;AAQO,IAAM,sBAAA,GAAyB;AAAA,EACpC,GAAA,EAAK,KAAA;AAAA,EACL,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ;AACV;AAKO,IAAM,wBAAA,GAA2B;AAAA,EACtC,IAAA,EAAM,MAAA;AAAA,EACN,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO;AACT;AAcO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,KAAA,EAAO,OAAA;AAAA,EACP,KAAA,EAAO;AACT;AAkBO,IAAM,qBAAA,GAAwB;AAAA,EACnC,eAAA,EAAiB,EAAE,OAAA,EAAS,CAAA,EAAG,QAAQ,CAAC,KAAK,CAAA,EAAG,WAAA,EAAa,EAAA,EAAG;AAAA,EAChE,UAAA,EAAY;AAAA,IACV,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,gBAAA,EAAkB;AAAA,IAChB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,gBAAA,EAAkB;AAAA,IAChB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,iBAAA,EAAmB;AAAA,IACjB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,UAAA,EAAY;AAAA,IACV,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAA,EAAO,KAAK,CAAA;AAAA,IAC5B,WAAA,EAAa;AAAA,GACf;AAAA,EACA,iBAAA,EAAmB;AAAA,IACjB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAA,EAAO,KAAK,CAAA;AAAA,IAC5B,WAAA,EAAa;AAAA;AAEjB;AAgBO,IAAM,mBAAA,GAAsB","file":"chunk-6QLUUNJL.cjs","sourcesContent":["import type { ComponentType } from \"react\";\n\n/**\n * Widget type names as a const object.\n * This serves as the single source of truth for widget discriminants.\n * Use `as const` for literal type inference (safety-as-const-deep-readonly rule).\n */\nexport const WIDGET_TYPE_NAMES = {\n  Alert: \"AlertWidget\",\n  Calendar: \"CalendarWidget\",\n  Carousel: \"CarouselWidget\",\n  CatchUp: \"CatchUpWidget\",\n  Chart: \"ChartWidget\",\n  Container: \"ContainerWidget\",\n  Embed: \"EmbedWidget\",\n  Image: \"ImageWidget\",\n  Layout: \"LayoutWidget\",\n  List: \"ListWidget\",\n  MySite: \"MySiteWidget\",\n  Nested: \"NestedWidget\",\n  QuickShare: \"QuickShareWidget\",\n  RecentActivity: \"RecentActivityWidget\",\n  Spacer: \"SpacerWidget\",\n  Table: \"TableWidget\",\n  Text: \"TextWidget\",\n  ToDo: \"ToDoWidget\",\n  Video: \"VideoWidget\",\n} as const;\n\n/**\n * Union of all known widget type names.\n * Derived from WIDGET_TYPE_NAMES to avoid duplication (deriving-typeof-for-object-keys rule).\n */\nexport type WidgetTypeName =\n  (typeof WIDGET_TYPE_NAMES)[keyof typeof WIDGET_TYPE_NAMES];\n\n/**\n * Legacy alias for backwards compatibility.\n * Prefer using WidgetTypeName for new code when you need the union type.\n */\nexport type WidgetType = string;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type WidgetRegistry = Record<WidgetType, ComponentType<any>>;\n\n/**\n * Base widget schema with loose typing for runtime data.\n * Use TypedWidgetSchema<T> when you have a known registry for better type safety.\n */\nexport type WidgetSchema = {\n  readonly type: WidgetType;\n  readonly props: Readonly<Record<string, unknown>>;\n  readonly id?: string; // Optional unique identifier for drag-and-drop\n  /** Column index for masonry layouts (0-indexed) */\n  readonly columnIndex?: number;\n};\n\n/**\n * Type-safe widget schema based on registry.\n * Uses discriminated unions - the `type` field serves as discriminant.\n * When narrowed (e.g., `if (widget.type === \"AlertWidget\")`),\n * TypeScript automatically knows the correct props type.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type TypedWidgetSchema<T extends Record<string, ComponentType<any>>> = {\n  [K in keyof T]: {\n    readonly type: K;\n    readonly props: Readonly<React.ComponentProps<T[K]>>;\n    readonly id?: string;\n    /** Column index for masonry layouts (0-indexed) */\n    readonly columnIndex?: number;\n  };\n}[keyof T];\n\n/**\n * Widget path in the tree - array of indices.\n * Readonly tuple to prevent accidental mutation.\n */\nexport type WidgetPath = readonly number[];\n\n// ============================================================================\n// Type Guards and Assertion Functions\n// ============================================================================\n\n/**\n * Type predicate to check if a string is a known widget type name.\n * Use for runtime validation of widget types.\n *\n * @example\n * if (isWidgetTypeName(widget.type)) {\n *   // TypeScript knows widget.type is WidgetTypeName\n * }\n */\nexport function isWidgetTypeName(type: string): type is WidgetTypeName {\n  // Type assertion required in type guard: Object.values() returns string[], but we\n  // need to check against WidgetTypeName values. The assertion is safe because we're\n  // checking membership, and the return type predicate ensures correct narrowing.\n  return Object.values(WIDGET_TYPE_NAMES).includes(type as WidgetTypeName);\n}\n\n/**\n * Type predicate to check if a widget has a specific type.\n * Enables type-safe widget narrowing without `as` assertions.\n *\n * @example\n * if (isWidgetType(widget, \"LayoutWidget\")) {\n *   // TypeScript knows widget.type === \"LayoutWidget\"\n *   // and widget.props is LayoutWidget props\n * }\n */\nexport function isWidgetType<T extends WidgetTypeName>(\n  widget: WidgetSchema | null | undefined,\n  typeName: T,\n): widget is WidgetSchema & { readonly type: T } {\n  return widget != null && widget.type === typeName;\n}\n\n/**\n * Helper for exhaustive switch statements on widget types.\n * Use in the default case to ensure all widget types are handled.\n *\n * @example\n * switch (widget.type) {\n *   case \"AlertWidget\": return handleAlert();\n *   case \"TextWidget\": return handleText();\n *   // ... all other widget types\n *   default: return assertNever(widget.type, \"widget type\");\n * }\n */\nexport function assertNever(value: never, context?: string): never {\n  const message = context\n    ? `Unexpected ${context}: ${String(value)}`\n    : `Unexpected value: ${String(value)}`;\n  throw new Error(message);\n}\n\n/**\n * Assertion function that throws if value is undefined.\n * Narrows the type to exclude undefined.\n *\n * @example\n * const widget = screen[0];\n * assertDefined(widget, \"widget at index 0\");\n * // TypeScript knows widget is defined here\n */\nexport function assertDefined<T>(\n  value: T | undefined | null,\n  name?: string,\n): asserts value is T {\n  if (value == null) {\n    throw new Error(name ? `${name} is required` : \"Value is required\");\n  }\n}\n","import type { ShareableItem } from \"./shareable-item\";\n\n// ============================================================================\n// Color Options - Derive type from constant for single source of truth\n// ============================================================================\n\n/**\n * Color options constant - single source of truth for color values.\n * Use COLOR_OPTIONS.primary instead of \"primary\" for type-safe comparisons.\n */\nexport const COLOR_OPTIONS = {\n  background: \"background\",\n  foreground: \"foreground\",\n  primary: \"primary\",\n  secondary: \"secondary\",\n  accent: \"accent\",\n  muted: \"muted\",\n  destructive: \"destructive\",\n} as const;\n\n/**\n * Union type of all color options, derived from COLOR_OPTIONS constant.\n * @see deriving-typeof-for-object-keys pattern\n */\nexport type ColorOptions = (typeof COLOR_OPTIONS)[keyof typeof COLOR_OPTIONS];\n\n// ============================================================================\n// Size Options - Derive types from constants for single source of truth\n// ============================================================================\n\nexport const FONT_SIZE_OPTIONS = {\n  \"2xl\": \"2xl\",\n  xl: \"xl\",\n  lg: \"lg\",\n  md: \"md\",\n  sm: \"sm\",\n  xs: \"xs\",\n} as const;\n\nexport type FontSizeOptions =\n  (typeof FONT_SIZE_OPTIONS)[keyof typeof FONT_SIZE_OPTIONS];\n\nexport const BORDER_RADIUS_OPTIONS = {\n  none: \"none\",\n  sm: \"sm\",\n  md: \"md\",\n  lg: \"lg\",\n  xl: \"xl\",\n  full: \"full\",\n} as const;\n\nexport type BorderRadiusOptions =\n  (typeof BORDER_RADIUS_OPTIONS)[keyof typeof BORDER_RADIUS_OPTIONS];\n\n/** Padding values - numeric, so we use a tuple for derivation */\nexport const PADDING_VALUES = [0, 2, 4, 6, 8, 10] as const;\nexport type PaddingOptions = (typeof PADDING_VALUES)[number];\n\nexport const BUTTON_SIZE_OPTIONS = {\n  sm: \"sm\",\n  default: \"default\",\n  lg: \"lg\",\n  xl: \"xl\",\n} as const;\n\nexport type ButtonSizeOptions =\n  (typeof BUTTON_SIZE_OPTIONS)[keyof typeof BUTTON_SIZE_OPTIONS];\n\nexport const GAP_OPTIONS = {\n  none: \"none\",\n  xs: \"xs\",\n  sm: \"sm\",\n  md: \"md\",\n  lg: \"lg\",\n  xl: \"xl\",\n} as const;\n\nexport type GapOptions = (typeof GAP_OPTIONS)[keyof typeof GAP_OPTIONS];\n\n// ============================================================================\n// Alignment Options - Derive from constants\n// ============================================================================\n\nexport const VERTICAL_ALIGN_OPTIONS = {\n  top: \"top\",\n  center: \"center\",\n  bottom: \"bottom\",\n} as const;\n\nexport type VerticalAlign =\n  (typeof VERTICAL_ALIGN_OPTIONS)[keyof typeof VERTICAL_ALIGN_OPTIONS];\n\nexport const HORIZONTAL_ALIGN_OPTIONS = {\n  left: \"left\",\n  center: \"center\",\n  right: \"right\",\n} as const;\n\nexport type HorizontalAlign =\n  (typeof HORIZONTAL_ALIGN_OPTIONS)[keyof typeof HORIZONTAL_ALIGN_OPTIONS];\n\nexport type AlignOptions = {\n  vertical?: VerticalAlign;\n  horizontal?: HorizontalAlign;\n};\n\n// ============================================================================\n// Background Options - Derive from constant\n// ============================================================================\n\nexport const BACKGROUND_TYPES = {\n  solid: \"solid\",\n  image: \"image\",\n} as const;\n\nexport type BackgroundType =\n  (typeof BACKGROUND_TYPES)[keyof typeof BACKGROUND_TYPES];\nexport interface BackgroundValue {\n  type: BackgroundType;\n  color?: ColorOptions;\n  resource?: ShareableItem;\n}\n\n// ============================================================================\n// Section Layout - Derive type from config keys (single source of truth)\n// ============================================================================\n\n/**\n * Section layout configuration - single source of truth for layout types.\n * SectionLayoutType is derived from these keys to prevent drift.\n */\nexport const SECTION_LAYOUT_CONFIG = {\n  \"single-column\": { columns: 1, widths: [\"1fr\"], gridClasses: \"\" },\n  \"2c-equal\": {\n    columns: 2,\n    widths: [\"1fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-2\",\n  },\n  \"2c-left-wider\": {\n    columns: 2,\n    widths: [\"2fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-[2fr_1fr]\",\n  },\n  \"2c-right-wider\": {\n    columns: 2,\n    widths: [\"1fr\", \"2fr\"],\n    gridClasses: \"@md:grid-cols-[1fr_2fr]\",\n  },\n  \"2c-left-narrow\": {\n    columns: 2,\n    widths: [\"1fr\", \"3fr\"],\n    gridClasses: \"@md:grid-cols-[1fr_3fr]\",\n  },\n  \"2c-right-narrow\": {\n    columns: 2,\n    widths: [\"3fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-[3fr_1fr]\",\n  },\n  \"3c-equal\": {\n    columns: 3,\n    widths: [\"1fr\", \"1fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-3\",\n  },\n  \"3c-middle-wider\": {\n    columns: 3,\n    widths: [\"1fr\", \"2fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-[1fr_2fr_1fr]\",\n  },\n} as const satisfies Record<\n  string,\n  {\n    readonly columns: number;\n    readonly widths: readonly string[];\n    readonly gridClasses: string;\n  }\n>;\n\n/**\n * Union type of all section layout types, derived from SECTION_LAYOUT_CONFIG keys.\n * @see deriving-typeof-for-object-keys pattern\n */\nexport type SectionLayoutType = keyof typeof SECTION_LAYOUT_CONFIG;\n\n/** @deprecated Use SECTION_LAYOUT_CONFIG instead */\nexport const sectionLayoutConfig = SECTION_LAYOUT_CONFIG;\n"]}

package/dist/chunk-EWR5EIBP.js

@@ -0,0 +1,136 @@
+// src/types/widget-schema.ts
+var WIDGET_TYPE_NAMES = {
+  Alert: "AlertWidget",
+  Calendar: "CalendarWidget",
+  Carousel: "CarouselWidget",
+  CatchUp: "CatchUpWidget",
+  Chart: "ChartWidget",
+  Container: "ContainerWidget",
+  Embed: "EmbedWidget",
+  Image: "ImageWidget",
+  Layout: "LayoutWidget",
+  List: "ListWidget",
+  MySite: "MySiteWidget",
+  Nested: "NestedWidget",
+  QuickShare: "QuickShareWidget",
+  RecentActivity: "RecentActivityWidget",
+  Spacer: "SpacerWidget",
+  Table: "TableWidget",
+  Text: "TextWidget",
+  ToDo: "ToDoWidget",
+  Video: "VideoWidget"
+};
+function isWidgetTypeName(type) {
+  return Object.values(WIDGET_TYPE_NAMES).includes(type);
+}
+function isWidgetType(widget, typeName) {
+  return widget != null && widget.type === typeName;
+}
+function assertNever(value, context) {
+  const message = context ? `Unexpected ${context}: ${String(value)}` : `Unexpected value: ${String(value)}`;
+  throw new Error(message);
+}
+function assertDefined(value, name) {
+  if (value == null) {
+    throw new Error(name ? `${name} is required` : "Value is required");
+  }
+}
+
+// src/types/field-types.ts
+var COLOR_OPTIONS = {
+  background: "background",
+  foreground: "foreground",
+  primary: "primary",
+  secondary: "secondary",
+  accent: "accent",
+  muted: "muted",
+  destructive: "destructive"
+};
+var FONT_SIZE_OPTIONS = {
+  "2xl": "2xl",
+  xl: "xl",
+  lg: "lg",
+  md: "md",
+  sm: "sm",
+  xs: "xs"
+};
+var BORDER_RADIUS_OPTIONS = {
+  none: "none",
+  sm: "sm",
+  md: "md",
+  lg: "lg",
+  xl: "xl",
+  full: "full"
+};
+var PADDING_VALUES = [0, 2, 4, 6, 8, 10];
+var BUTTON_SIZE_OPTIONS = {
+  sm: "sm",
+  default: "default",
+  lg: "lg",
+  xl: "xl"
+};
+var GAP_OPTIONS = {
+  none: "none",
+  xs: "xs",
+  sm: "sm",
+  md: "md",
+  lg: "lg",
+  xl: "xl"
+};
+var VERTICAL_ALIGN_OPTIONS = {
+  top: "top",
+  center: "center",
+  bottom: "bottom"
+};
+var HORIZONTAL_ALIGN_OPTIONS = {
+  left: "left",
+  center: "center",
+  right: "right"
+};
+var BACKGROUND_TYPES = {
+  solid: "solid",
+  image: "image"
+};
+var SECTION_LAYOUT_CONFIG = {
+  "single-column": { columns: 1, widths: ["1fr"], gridClasses: "" },
+  "2c-equal": {
+    columns: 2,
+    widths: ["1fr", "1fr"],
+    gridClasses: "@md:grid-cols-2"
+  },
+  "2c-left-wider": {
+    columns: 2,
+    widths: ["2fr", "1fr"],
+    gridClasses: "@md:grid-cols-[2fr_1fr]"
+  },
+  "2c-right-wider": {
+    columns: 2,
+    widths: ["1fr", "2fr"],
+    gridClasses: "@md:grid-cols-[1fr_2fr]"
+  },
+  "2c-left-narrow": {
+    columns: 2,
+    widths: ["1fr", "3fr"],
+    gridClasses: "@md:grid-cols-[1fr_3fr]"
+  },
+  "2c-right-narrow": {
+    columns: 2,
+    widths: ["3fr", "1fr"],
+    gridClasses: "@md:grid-cols-[3fr_1fr]"
+  },
+  "3c-equal": {
+    columns: 3,
+    widths: ["1fr", "1fr", "1fr"],
+    gridClasses: "@md:grid-cols-3"
+  },
+  "3c-middle-wider": {
+    columns: 3,
+    widths: ["1fr", "2fr", "1fr"],
+    gridClasses: "@md:grid-cols-[1fr_2fr_1fr]"
+  }
+};
+var sectionLayoutConfig = SECTION_LAYOUT_CONFIG;
+
+export { BACKGROUND_TYPES, BORDER_RADIUS_OPTIONS, BUTTON_SIZE_OPTIONS, COLOR_OPTIONS, FONT_SIZE_OPTIONS, GAP_OPTIONS, HORIZONTAL_ALIGN_OPTIONS, PADDING_VALUES, SECTION_LAYOUT_CONFIG, VERTICAL_ALIGN_OPTIONS, WIDGET_TYPE_NAMES, assertDefined, assertNever, isWidgetType, isWidgetTypeName, sectionLayoutConfig };
+//# sourceMappingURL=chunk-EWR5EIBP.js.map
+//# sourceMappingURL=chunk-EWR5EIBP.js.map

package/dist/chunk-EWR5EIBP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/widget-schema.ts","../src/types/field-types.ts"],"names":[],"mappings":";AAOO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,KAAA,EAAO,aAAA;AAAA,EACP,QAAA,EAAU,gBAAA;AAAA,EACV,QAAA,EAAU,gBAAA;AAAA,EACV,OAAA,EAAS,eAAA;AAAA,EACT,KAAA,EAAO,aAAA;AAAA,EACP,SAAA,EAAW,iBAAA;AAAA,EACX,KAAA,EAAO,aAAA;AAAA,EACP,KAAA,EAAO,aAAA;AAAA,EACP,MAAA,EAAQ,cAAA;AAAA,EACR,IAAA,EAAM,YAAA;AAAA,EACN,MAAA,EAAQ,cAAA;AAAA,EACR,MAAA,EAAQ,cAAA;AAAA,EACR,UAAA,EAAY,kBAAA;AAAA,EACZ,cAAA,EAAgB,sBAAA;AAAA,EAChB,MAAA,EAAQ,cAAA;AAAA,EACR,KAAA,EAAO,aAAA;AAAA,EACP,IAAA,EAAM,YAAA;AAAA,EACN,IAAA,EAAM,YAAA;AAAA,EACN,KAAA,EAAO;AACT;AAkEO,SAAS,iBAAiB,IAAA,EAAsC;AAIrE,EAAA,OAAO,MAAA,CAAO,MAAA,CAAO,iBAAiB,CAAA,CAAE,SAAS,IAAsB,CAAA;AACzE;AAYO,SAAS,YAAA,CACd,QACA,QAAA,EAC+C;AAC/C,EAAA,OAAO,MAAA,IAAU,IAAA,IAAQ,MAAA,CAAO,IAAA,KAAS,QAAA;AAC3C;AAcO,SAAS,WAAA,CAAY,OAAc,OAAA,EAAyB;AACjE,EAAA,MAAM,OAAA,GAAU,OAAA,GACZ,CAAA,WAAA,EAAc,OAAO,CAAA,EAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA,GACvC,CAAA,kBAAA,EAAqB,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA;AACtC,EAAA,MAAM,IAAI,MAAM,OAAO,CAAA;AACzB;AAWO,SAAS,aAAA,CACd,OACA,IAAA,EACoB;AACpB,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,MAAM,IAAI,KAAA,CAAM,IAAA,GAAO,CAAA,EAAG,IAAI,iBAAiB,mBAAmB,CAAA;AAAA,EACpE;AACF;;;AC9IO,IAAM,aAAA,GAAgB;AAAA,EAC3B,UAAA,EAAY,YAAA;AAAA,EACZ,UAAA,EAAY,YAAA;AAAA,EACZ,OAAA,EAAS,SAAA;AAAA,EACT,SAAA,EAAW,WAAA;AAAA,EACX,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,WAAA,EAAa;AACf;AAYO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,KAAA,EAAO,KAAA;AAAA,EACP,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI;AACN;AAKO,IAAM,qBAAA,GAAwB;AAAA,EACnC,IAAA,EAAM,MAAA;AAAA,EACN,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,IAAA,EAAM;AACR;AAMO,IAAM,iBAAiB,CAAC,CAAA,EAAG,GAAG,CAAA,EAAG,CAAA,EAAG,GAAG,EAAE;AAGzC,IAAM,mBAAA,GAAsB;AAAA,EACjC,EAAA,EAAI,IAAA;AAAA,EACJ,OAAA,EAAS,SAAA;AAAA,EACT,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI;AACN;AAKO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA,EAAM,MAAA;AAAA,EACN,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI;AACN;AAQO,IAAM,sBAAA,GAAyB;AAAA,EACpC,GAAA,EAAK,KAAA;AAAA,EACL,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ;AACV;AAKO,IAAM,wBAAA,GAA2B;AAAA,EACtC,IAAA,EAAM,MAAA;AAAA,EACN,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO;AACT;AAcO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,KAAA,EAAO,OAAA;AAAA,EACP,KAAA,EAAO;AACT;AAkBO,IAAM,qBAAA,GAAwB;AAAA,EACnC,eAAA,EAAiB,EAAE,OAAA,EAAS,CAAA,EAAG,QAAQ,CAAC,KAAK,CAAA,EAAG,WAAA,EAAa,EAAA,EAAG;AAAA,EAChE,UAAA,EAAY;AAAA,IACV,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,gBAAA,EAAkB;AAAA,IAChB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,gBAAA,EAAkB;AAAA,IAChB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,iBAAA,EAAmB;AAAA,IACjB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAK,CAAA;AAAA,IACrB,WAAA,EAAa;AAAA,GACf;AAAA,EACA,UAAA,EAAY;AAAA,IACV,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAA,EAAO,KAAK,CAAA;AAAA,IAC5B,WAAA,EAAa;AAAA,GACf;AAAA,EACA,iBAAA,EAAmB;AAAA,IACjB,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAA,EAAO,KAAK,CAAA;AAAA,IAC5B,WAAA,EAAa;AAAA;AAEjB;AAgBO,IAAM,mBAAA,GAAsB","file":"chunk-EWR5EIBP.js","sourcesContent":["import type { ComponentType } from \"react\";\n\n/**\n * Widget type names as a const object.\n * This serves as the single source of truth for widget discriminants.\n * Use `as const` for literal type inference (safety-as-const-deep-readonly rule).\n */\nexport const WIDGET_TYPE_NAMES = {\n  Alert: \"AlertWidget\",\n  Calendar: \"CalendarWidget\",\n  Carousel: \"CarouselWidget\",\n  CatchUp: \"CatchUpWidget\",\n  Chart: \"ChartWidget\",\n  Container: \"ContainerWidget\",\n  Embed: \"EmbedWidget\",\n  Image: \"ImageWidget\",\n  Layout: \"LayoutWidget\",\n  List: \"ListWidget\",\n  MySite: \"MySiteWidget\",\n  Nested: \"NestedWidget\",\n  QuickShare: \"QuickShareWidget\",\n  RecentActivity: \"RecentActivityWidget\",\n  Spacer: \"SpacerWidget\",\n  Table: \"TableWidget\",\n  Text: \"TextWidget\",\n  ToDo: \"ToDoWidget\",\n  Video: \"VideoWidget\",\n} as const;\n\n/**\n * Union of all known widget type names.\n * Derived from WIDGET_TYPE_NAMES to avoid duplication (deriving-typeof-for-object-keys rule).\n */\nexport type WidgetTypeName =\n  (typeof WIDGET_TYPE_NAMES)[keyof typeof WIDGET_TYPE_NAMES];\n\n/**\n * Legacy alias for backwards compatibility.\n * Prefer using WidgetTypeName for new code when you need the union type.\n */\nexport type WidgetType = string;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type WidgetRegistry = Record<WidgetType, ComponentType<any>>;\n\n/**\n * Base widget schema with loose typing for runtime data.\n * Use TypedWidgetSchema<T> when you have a known registry for better type safety.\n */\nexport type WidgetSchema = {\n  readonly type: WidgetType;\n  readonly props: Readonly<Record<string, unknown>>;\n  readonly id?: string; // Optional unique identifier for drag-and-drop\n  /** Column index for masonry layouts (0-indexed) */\n  readonly columnIndex?: number;\n};\n\n/**\n * Type-safe widget schema based on registry.\n * Uses discriminated unions - the `type` field serves as discriminant.\n * When narrowed (e.g., `if (widget.type === \"AlertWidget\")`),\n * TypeScript automatically knows the correct props type.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type TypedWidgetSchema<T extends Record<string, ComponentType<any>>> = {\n  [K in keyof T]: {\n    readonly type: K;\n    readonly props: Readonly<React.ComponentProps<T[K]>>;\n    readonly id?: string;\n    /** Column index for masonry layouts (0-indexed) */\n    readonly columnIndex?: number;\n  };\n}[keyof T];\n\n/**\n * Widget path in the tree - array of indices.\n * Readonly tuple to prevent accidental mutation.\n */\nexport type WidgetPath = readonly number[];\n\n// ============================================================================\n// Type Guards and Assertion Functions\n// ============================================================================\n\n/**\n * Type predicate to check if a string is a known widget type name.\n * Use for runtime validation of widget types.\n *\n * @example\n * if (isWidgetTypeName(widget.type)) {\n *   // TypeScript knows widget.type is WidgetTypeName\n * }\n */\nexport function isWidgetTypeName(type: string): type is WidgetTypeName {\n  // Type assertion required in type guard: Object.values() returns string[], but we\n  // need to check against WidgetTypeName values. The assertion is safe because we're\n  // checking membership, and the return type predicate ensures correct narrowing.\n  return Object.values(WIDGET_TYPE_NAMES).includes(type as WidgetTypeName);\n}\n\n/**\n * Type predicate to check if a widget has a specific type.\n * Enables type-safe widget narrowing without `as` assertions.\n *\n * @example\n * if (isWidgetType(widget, \"LayoutWidget\")) {\n *   // TypeScript knows widget.type === \"LayoutWidget\"\n *   // and widget.props is LayoutWidget props\n * }\n */\nexport function isWidgetType<T extends WidgetTypeName>(\n  widget: WidgetSchema | null | undefined,\n  typeName: T,\n): widget is WidgetSchema & { readonly type: T } {\n  return widget != null && widget.type === typeName;\n}\n\n/**\n * Helper for exhaustive switch statements on widget types.\n * Use in the default case to ensure all widget types are handled.\n *\n * @example\n * switch (widget.type) {\n *   case \"AlertWidget\": return handleAlert();\n *   case \"TextWidget\": return handleText();\n *   // ... all other widget types\n *   default: return assertNever(widget.type, \"widget type\");\n * }\n */\nexport function assertNever(value: never, context?: string): never {\n  const message = context\n    ? `Unexpected ${context}: ${String(value)}`\n    : `Unexpected value: ${String(value)}`;\n  throw new Error(message);\n}\n\n/**\n * Assertion function that throws if value is undefined.\n * Narrows the type to exclude undefined.\n *\n * @example\n * const widget = screen[0];\n * assertDefined(widget, \"widget at index 0\");\n * // TypeScript knows widget is defined here\n */\nexport function assertDefined<T>(\n  value: T | undefined | null,\n  name?: string,\n): asserts value is T {\n  if (value == null) {\n    throw new Error(name ? `${name} is required` : \"Value is required\");\n  }\n}\n","import type { ShareableItem } from \"./shareable-item\";\n\n// ============================================================================\n// Color Options - Derive type from constant for single source of truth\n// ============================================================================\n\n/**\n * Color options constant - single source of truth for color values.\n * Use COLOR_OPTIONS.primary instead of \"primary\" for type-safe comparisons.\n */\nexport const COLOR_OPTIONS = {\n  background: \"background\",\n  foreground: \"foreground\",\n  primary: \"primary\",\n  secondary: \"secondary\",\n  accent: \"accent\",\n  muted: \"muted\",\n  destructive: \"destructive\",\n} as const;\n\n/**\n * Union type of all color options, derived from COLOR_OPTIONS constant.\n * @see deriving-typeof-for-object-keys pattern\n */\nexport type ColorOptions = (typeof COLOR_OPTIONS)[keyof typeof COLOR_OPTIONS];\n\n// ============================================================================\n// Size Options - Derive types from constants for single source of truth\n// ============================================================================\n\nexport const FONT_SIZE_OPTIONS = {\n  \"2xl\": \"2xl\",\n  xl: \"xl\",\n  lg: \"lg\",\n  md: \"md\",\n  sm: \"sm\",\n  xs: \"xs\",\n} as const;\n\nexport type FontSizeOptions =\n  (typeof FONT_SIZE_OPTIONS)[keyof typeof FONT_SIZE_OPTIONS];\n\nexport const BORDER_RADIUS_OPTIONS = {\n  none: \"none\",\n  sm: \"sm\",\n  md: \"md\",\n  lg: \"lg\",\n  xl: \"xl\",\n  full: \"full\",\n} as const;\n\nexport type BorderRadiusOptions =\n  (typeof BORDER_RADIUS_OPTIONS)[keyof typeof BORDER_RADIUS_OPTIONS];\n\n/** Padding values - numeric, so we use a tuple for derivation */\nexport const PADDING_VALUES = [0, 2, 4, 6, 8, 10] as const;\nexport type PaddingOptions = (typeof PADDING_VALUES)[number];\n\nexport const BUTTON_SIZE_OPTIONS = {\n  sm: \"sm\",\n  default: \"default\",\n  lg: \"lg\",\n  xl: \"xl\",\n} as const;\n\nexport type ButtonSizeOptions =\n  (typeof BUTTON_SIZE_OPTIONS)[keyof typeof BUTTON_SIZE_OPTIONS];\n\nexport const GAP_OPTIONS = {\n  none: \"none\",\n  xs: \"xs\",\n  sm: \"sm\",\n  md: \"md\",\n  lg: \"lg\",\n  xl: \"xl\",\n} as const;\n\nexport type GapOptions = (typeof GAP_OPTIONS)[keyof typeof GAP_OPTIONS];\n\n// ============================================================================\n// Alignment Options - Derive from constants\n// ============================================================================\n\nexport const VERTICAL_ALIGN_OPTIONS = {\n  top: \"top\",\n  center: \"center\",\n  bottom: \"bottom\",\n} as const;\n\nexport type VerticalAlign =\n  (typeof VERTICAL_ALIGN_OPTIONS)[keyof typeof VERTICAL_ALIGN_OPTIONS];\n\nexport const HORIZONTAL_ALIGN_OPTIONS = {\n  left: \"left\",\n  center: \"center\",\n  right: \"right\",\n} as const;\n\nexport type HorizontalAlign =\n  (typeof HORIZONTAL_ALIGN_OPTIONS)[keyof typeof HORIZONTAL_ALIGN_OPTIONS];\n\nexport type AlignOptions = {\n  vertical?: VerticalAlign;\n  horizontal?: HorizontalAlign;\n};\n\n// ============================================================================\n// Background Options - Derive from constant\n// ============================================================================\n\nexport const BACKGROUND_TYPES = {\n  solid: \"solid\",\n  image: \"image\",\n} as const;\n\nexport type BackgroundType =\n  (typeof BACKGROUND_TYPES)[keyof typeof BACKGROUND_TYPES];\nexport interface BackgroundValue {\n  type: BackgroundType;\n  color?: ColorOptions;\n  resource?: ShareableItem;\n}\n\n// ============================================================================\n// Section Layout - Derive type from config keys (single source of truth)\n// ============================================================================\n\n/**\n * Section layout configuration - single source of truth for layout types.\n * SectionLayoutType is derived from these keys to prevent drift.\n */\nexport const SECTION_LAYOUT_CONFIG = {\n  \"single-column\": { columns: 1, widths: [\"1fr\"], gridClasses: \"\" },\n  \"2c-equal\": {\n    columns: 2,\n    widths: [\"1fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-2\",\n  },\n  \"2c-left-wider\": {\n    columns: 2,\n    widths: [\"2fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-[2fr_1fr]\",\n  },\n  \"2c-right-wider\": {\n    columns: 2,\n    widths: [\"1fr\", \"2fr\"],\n    gridClasses: \"@md:grid-cols-[1fr_2fr]\",\n  },\n  \"2c-left-narrow\": {\n    columns: 2,\n    widths: [\"1fr\", \"3fr\"],\n    gridClasses: \"@md:grid-cols-[1fr_3fr]\",\n  },\n  \"2c-right-narrow\": {\n    columns: 2,\n    widths: [\"3fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-[3fr_1fr]\",\n  },\n  \"3c-equal\": {\n    columns: 3,\n    widths: [\"1fr\", \"1fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-3\",\n  },\n  \"3c-middle-wider\": {\n    columns: 3,\n    widths: [\"1fr\", \"2fr\", \"1fr\"],\n    gridClasses: \"@md:grid-cols-[1fr_2fr_1fr]\",\n  },\n} as const satisfies Record<\n  string,\n  {\n    readonly columns: number;\n    readonly widths: readonly string[];\n    readonly gridClasses: string;\n  }\n>;\n\n/**\n * Union type of all section layout types, derived from SECTION_LAYOUT_CONFIG keys.\n * @see deriving-typeof-for-object-keys pattern\n */\nexport type SectionLayoutType = keyof typeof SECTION_LAYOUT_CONFIG;\n\n/** @deprecated Use SECTION_LAYOUT_CONFIG instead */\nexport const sectionLayoutConfig = SECTION_LAYOUT_CONFIG;\n"]}

package/dist/data-sources/context.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/data-sources/context.tsx
+var DataSourceContext = react.createContext({});
+function DataSourceProvider({
+  baseUrl,
+  getApiHeaders,
+  children
+}) {
+  const value = react.useMemo(
+    () => ({ baseUrl, getApiHeaders }),
+    [baseUrl, getApiHeaders]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(DataSourceContext.Provider, { value, children });
+}
+function useDataSourceConfig() {
+  return react.useContext(DataSourceContext);
+}
+
+exports.DataSourceProvider = DataSourceProvider;
+exports.useDataSourceConfig = useDataSourceConfig;
+//# sourceMappingURL=context.cjs.map
+//# sourceMappingURL=context.cjs.map

package/dist/data-sources/context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data-sources/context.tsx"],"names":["createContext","useMemo","jsx","useContext"],"mappings":";;;;;;AAOA,IAAM,iBAAA,GAAoBA,mBAAA,CAAsC,EAAE,CAAA;AAQ3D,SAAS,kBAAA,CAAmB;AAAA,EACjC,OAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA,EAA4B;AAC1B,EAAA,MAAM,KAAA,GAAQC,aAAA;AAAA,IACZ,OAAO,EAAE,OAAA,EAAS,aAAA,EAAc,CAAA;AAAA,IAChC,CAAC,SAAS,aAAa;AAAA,GACzB;AAEA,EAAA,uBACEC,cAAA,CAAC,iBAAA,CAAkB,QAAA,EAAlB,EAA2B,OACzB,QAAA,EACH,CAAA;AAEJ;AAEO,SAAS,mBAAA,GAA8C;AAC5D,EAAA,OAAOC,iBAAW,iBAAiB,CAAA;AACrC","file":"context.cjs","sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from \"react\";\n\nexport interface DataSourceContextValue {\n  baseUrl?: string | undefined;\n  getApiHeaders?: (() => Record<string, string>) | undefined;\n}\n\nconst DataSourceContext = createContext<DataSourceContextValue>({});\n\nexport interface DataSourceProviderProps {\n  baseUrl?: string;\n  getApiHeaders?: () => Record<string, string>;\n  children: ReactNode;\n}\n\nexport function DataSourceProvider({\n  baseUrl,\n  getApiHeaders,\n  children,\n}: DataSourceProviderProps) {\n  const value = useMemo(\n    () => ({ baseUrl, getApiHeaders }),\n    [baseUrl, getApiHeaders],\n  );\n\n  return (\n    <DataSourceContext.Provider value={value}>\n      {children}\n    </DataSourceContext.Provider>\n  );\n}\n\nexport function useDataSourceConfig(): DataSourceContextValue {\n  return useContext(DataSourceContext);\n}\n"]}

package/dist/data-sources/context.d.cts

@@ -0,0 +1,16 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface DataSourceContextValue {
+    baseUrl?: string | undefined;
+    getApiHeaders?: (() => Record<string, string>) | undefined;
+}
+interface DataSourceProviderProps {
+    baseUrl?: string;
+    getApiHeaders?: () => Record<string, string>;
+    children: ReactNode;
+}
+declare function DataSourceProvider({ baseUrl, getApiHeaders, children, }: DataSourceProviderProps): react_jsx_runtime.JSX.Element;
+declare function useDataSourceConfig(): DataSourceContextValue;
+
+export { type DataSourceContextValue, DataSourceProvider, type DataSourceProviderProps, useDataSourceConfig };

package/dist/data-sources/context.d.ts

@@ -0,0 +1,16 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface DataSourceContextValue {
+    baseUrl?: string | undefined;
+    getApiHeaders?: (() => Record<string, string>) | undefined;
+}
+interface DataSourceProviderProps {
+    baseUrl?: string;
+    getApiHeaders?: () => Record<string, string>;
+    children: ReactNode;
+}
+declare function DataSourceProvider({ baseUrl, getApiHeaders, children, }: DataSourceProviderProps): react_jsx_runtime.JSX.Element;
+declare function useDataSourceConfig(): DataSourceContextValue;
+
+export { type DataSourceContextValue, DataSourceProvider, type DataSourceProviderProps, useDataSourceConfig };

package/dist/data-sources/context.js

@@ -0,0 +1,23 @@
+import { createContext, useMemo, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/data-sources/context.tsx
+var DataSourceContext = createContext({});
+function DataSourceProvider({
+  baseUrl,
+  getApiHeaders,
+  children
+}) {
+  const value = useMemo(
+    () => ({ baseUrl, getApiHeaders }),
+    [baseUrl, getApiHeaders]
+  );
+  return /* @__PURE__ */ jsx(DataSourceContext.Provider, { value, children });
+}
+function useDataSourceConfig() {
+  return useContext(DataSourceContext);
+}
+
+export { DataSourceProvider, useDataSourceConfig };
+//# sourceMappingURL=context.js.map
+//# sourceMappingURL=context.js.map

package/dist/data-sources/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data-sources/context.tsx"],"names":[],"mappings":";;;;AAOA,IAAM,iBAAA,GAAoB,aAAA,CAAsC,EAAE,CAAA;AAQ3D,SAAS,kBAAA,CAAmB;AAAA,EACjC,OAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA,EAA4B;AAC1B,EAAA,MAAM,KAAA,GAAQ,OAAA;AAAA,IACZ,OAAO,EAAE,OAAA,EAAS,aAAA,EAAc,CAAA;AAAA,IAChC,CAAC,SAAS,aAAa;AAAA,GACzB;AAEA,EAAA,uBACE,GAAA,CAAC,iBAAA,CAAkB,QAAA,EAAlB,EAA2B,OACzB,QAAA,EACH,CAAA;AAEJ;AAEO,SAAS,mBAAA,GAA8C;AAC5D,EAAA,OAAO,WAAW,iBAAiB,CAAA;AACrC","file":"context.js","sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from \"react\";\n\nexport interface DataSourceContextValue {\n  baseUrl?: string | undefined;\n  getApiHeaders?: (() => Record<string, string>) | undefined;\n}\n\nconst DataSourceContext = createContext<DataSourceContextValue>({});\n\nexport interface DataSourceProviderProps {\n  baseUrl?: string;\n  getApiHeaders?: () => Record<string, string>;\n  children: ReactNode;\n}\n\nexport function DataSourceProvider({\n  baseUrl,\n  getApiHeaders,\n  children,\n}: DataSourceProviderProps) {\n  const value = useMemo(\n    () => ({ baseUrl, getApiHeaders }),\n    [baseUrl, getApiHeaders],\n  );\n\n  return (\n    <DataSourceContext.Provider value={value}>\n      {children}\n    </DataSourceContext.Provider>\n  );\n}\n\nexport function useDataSourceConfig(): DataSourceContextValue {\n  return useContext(DataSourceContext);\n}\n"]}

package/dist/data-sources/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/data-sources/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/data-sources/types.d.cts

@@ -0,0 +1,122 @@
+type DataSourceType = "api" | "custom" | "static";
+type StaticSourceType = "collections" | "categories" | "tags";
+type ShareableType = "Medium" | "Page" | "EnrollmentPack" | "Library" | "Product";
+interface SelectedItem {
+    /** The unique ID of the selected item */
+    id: string | number;
+    /** The type of shareable content */
+    shareableType: ShareableType;
+    /** Optional cached data for preview/display purposes in the editor UI */
+    cachedData?: {
+        title?: string;
+        imageUrl?: string;
+        kind?: string;
+    };
+    /** Widget-specific per-item configuration overrides */
+    widgetConfig?: Record<string, unknown>;
+}
+interface ApiDataSource {
+    type: "api";
+    /** API endpoint URL (can include {variable} placeholders, e.g., /api/reps/{rep_id}/items) */
+    endpoint: string;
+    /** HTTP method (defaults to GET) */
+    method?: "GET" | "POST" | "PUT" | "DELETE";
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body for POST/PUT (will be JSON.stringify'd) */
+    body?: unknown;
+    /**
+     * Path to extract from response using dot notation
+     * e.g., "data.items" extracts response.data.items
+     */
+    resultPath?: string;
+    /**
+     * Which widget props this source populates
+     * e.g., ['data'] means the fetched result goes to props.data
+     */
+    targetProps: string[];
+    /**
+     * Name of a registered transform function to process the data
+     * Transform is applied after resultPath extraction
+     */
+    transform?: string;
+    /** Per-source variables for endpoint template interpolation (e.g., { limit: "10" }) */
+    variables?: Record<string, string>;
+    /**
+     * Auto-refresh interval in milliseconds
+     * 0 or undefined = no auto-refresh
+     */
+    refreshInterval?: number;
+}
+interface CustomDataSource {
+    type: "custom";
+    /** Array of selected items to fetch */
+    selectedItems: SelectedItem[];
+    /**
+     * Which widget props this source populates
+     * e.g., ['slides'] means the fetched results go to props.slides
+     */
+    targetProps: string[];
+    /**
+     * Name of a registered transform function to process the data
+     * Transform is applied after all items are fetched
+     */
+    transform?: string;
+    /**
+     * Auto-refresh interval in milliseconds
+     * 0 or undefined = no auto-refresh
+     */
+    refreshInterval?: number;
+}
+interface StaticDataSource {
+    type: "static";
+    /** The type of static data (collections, categories, tags) */
+    staticType: StaticSourceType;
+    /** The selected item ID */
+    selectedId: string | number;
+    /** Cached data for preview/display in editor UI */
+    cachedData?: {
+        title?: string;
+        imageUrl?: string;
+    };
+    /**
+     * Which widget props this source populates
+     */
+    targetProps: string[];
+    /**
+     * Name of a registered transform function to process the data
+     */
+    transform?: string;
+    /**
+     * Auto-refresh interval in milliseconds
+     * 0 or undefined = no auto-refresh
+     */
+    refreshInterval?: number;
+}
+type DataSource = ApiDataSource | CustomDataSource | StaticDataSource;
+interface DataSourceConfig {
+    /** Array of data sources (usually just one, but supports multiple) */
+    sources: DataSource[];
+    /** Loading state configuration */
+    loading?: {
+        /** Show skeleton placeholder while loading (default: true) */
+        showSkeleton?: boolean;
+    };
+    /** Error handling configuration */
+    error?: {
+        /** Fallback props to use when fetch fails */
+        fallback?: Record<string, unknown>;
+        /** Number of retry attempts (default: 0) */
+        retryCount?: number;
+        /** Delay between retries in ms (default: 1000) */
+        retryDelay?: number;
+    };
+}
+/** Item returned by static data fetchers */
+interface StaticItem {
+    id: string | number;
+    title: string;
+    imageUrl?: string;
+}
+
+export type { ApiDataSource, CustomDataSource, DataSource, DataSourceConfig, DataSourceType, SelectedItem, ShareableType, StaticDataSource, StaticItem, StaticSourceType };