@fluid-app/rep-core 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,227 @@
+import { a as WidgetSchema, S as ShareableItem } from '../shareable-item-DPmNZkE1.js';
+export { T as TypedWidgetSchema, e as WIDGET_TYPE_NAMES, W as WidgetPath, d as WidgetRegistry, b as WidgetType, c as WidgetTypeName, h as assertDefined, g as assertNever, f as isWidgetType, i as isWidgetTypeName } from '../shareable-item-DPmNZkE1.js';
+export { a as Theme, T as ThemeConfig } from '../theme-DrMUYZTO.js';
+import 'react';
+
+/**
+ * Navigation item in the sidebar/menu structure
+ */
+interface NavigationItem {
+    /** Database-generated identifier */
+    readonly id?: number;
+    /** URL slug for routing */
+    slug?: string;
+    /** Display label */
+    label: string;
+    /** Icon identifier (e.g., FontAwesome name) */
+    icon?: string;
+    /** Section grouping for quick links (e.g., "User", "Shareables") */
+    section?: string;
+    /** Associated screen ID */
+    screen_id?: number;
+    /** Sort order */
+    position?: number;
+    /** Parent navigation item ID (null for root items) */
+    parent_id?: number | null;
+    /** Nested navigation items */
+    children: NavigationItem[];
+}
+/**
+ * Screen definition with its component tree
+ */
+interface ScreenDefinition {
+    readonly id: number;
+    slug: string;
+    name: string;
+    component_tree: WidgetSchema[];
+}
+/**
+ * Navigation configuration for the rep portal
+ */
+interface Navigation {
+    readonly definition_id: number;
+    readonly id: number;
+    name: string;
+    navigation_items: NavigationItem[];
+    screens: ScreenDefinition[];
+}
+
+/**
+ * Color options constant - single source of truth for color values.
+ * Use COLOR_OPTIONS.primary instead of "primary" for type-safe comparisons.
+ */
+declare const COLOR_OPTIONS: {
+    readonly background: "background";
+    readonly foreground: "foreground";
+    readonly primary: "primary";
+    readonly secondary: "secondary";
+    readonly accent: "accent";
+    readonly muted: "muted";
+    readonly destructive: "destructive";
+};
+/**
+ * Union type of all color options, derived from COLOR_OPTIONS constant.
+ * @see deriving-typeof-for-object-keys pattern
+ */
+type ColorOptions = (typeof COLOR_OPTIONS)[keyof typeof COLOR_OPTIONS];
+declare const FONT_SIZE_OPTIONS: {
+    readonly "2xl": "2xl";
+    readonly xl: "xl";
+    readonly lg: "lg";
+    readonly md: "md";
+    readonly sm: "sm";
+    readonly xs: "xs";
+};
+type FontSizeOptions = (typeof FONT_SIZE_OPTIONS)[keyof typeof FONT_SIZE_OPTIONS];
+declare const BORDER_RADIUS_OPTIONS: {
+    readonly none: "none";
+    readonly sm: "sm";
+    readonly md: "md";
+    readonly lg: "lg";
+    readonly xl: "xl";
+    readonly full: "full";
+};
+type BorderRadiusOptions = (typeof BORDER_RADIUS_OPTIONS)[keyof typeof BORDER_RADIUS_OPTIONS];
+/** Padding values - numeric, so we use a tuple for derivation */
+declare const PADDING_VALUES: readonly [0, 2, 4, 6, 8, 10];
+type PaddingOptions = (typeof PADDING_VALUES)[number];
+declare const BUTTON_SIZE_OPTIONS: {
+    readonly sm: "sm";
+    readonly default: "default";
+    readonly lg: "lg";
+    readonly xl: "xl";
+};
+type ButtonSizeOptions = (typeof BUTTON_SIZE_OPTIONS)[keyof typeof BUTTON_SIZE_OPTIONS];
+declare const GAP_OPTIONS: {
+    readonly none: "none";
+    readonly xs: "xs";
+    readonly sm: "sm";
+    readonly md: "md";
+    readonly lg: "lg";
+    readonly xl: "xl";
+};
+type GapOptions = (typeof GAP_OPTIONS)[keyof typeof GAP_OPTIONS];
+declare const VERTICAL_ALIGN_OPTIONS: {
+    readonly top: "top";
+    readonly center: "center";
+    readonly bottom: "bottom";
+};
+type VerticalAlign = (typeof VERTICAL_ALIGN_OPTIONS)[keyof typeof VERTICAL_ALIGN_OPTIONS];
+declare const HORIZONTAL_ALIGN_OPTIONS: {
+    readonly left: "left";
+    readonly center: "center";
+    readonly right: "right";
+};
+type HorizontalAlign = (typeof HORIZONTAL_ALIGN_OPTIONS)[keyof typeof HORIZONTAL_ALIGN_OPTIONS];
+type AlignOptions = {
+    vertical?: VerticalAlign;
+    horizontal?: HorizontalAlign;
+};
+declare const BACKGROUND_TYPES: {
+    readonly solid: "solid";
+    readonly image: "image";
+};
+type BackgroundType = (typeof BACKGROUND_TYPES)[keyof typeof BACKGROUND_TYPES];
+interface BackgroundValue {
+    type: BackgroundType;
+    color?: ColorOptions;
+    resource?: ShareableItem;
+}
+/**
+ * Section layout configuration - single source of truth for layout types.
+ * SectionLayoutType is derived from these keys to prevent drift.
+ */
+declare const SECTION_LAYOUT_CONFIG: {
+    readonly "single-column": {
+        readonly columns: 1;
+        readonly widths: readonly ["1fr"];
+        readonly gridClasses: "";
+    };
+    readonly "2c-equal": {
+        readonly columns: 2;
+        readonly widths: readonly ["1fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-2";
+    };
+    readonly "2c-left-wider": {
+        readonly columns: 2;
+        readonly widths: readonly ["2fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-[2fr_1fr]";
+    };
+    readonly "2c-right-wider": {
+        readonly columns: 2;
+        readonly widths: readonly ["1fr", "2fr"];
+        readonly gridClasses: "@md:grid-cols-[1fr_2fr]";
+    };
+    readonly "2c-left-narrow": {
+        readonly columns: 2;
+        readonly widths: readonly ["1fr", "3fr"];
+        readonly gridClasses: "@md:grid-cols-[1fr_3fr]";
+    };
+    readonly "2c-right-narrow": {
+        readonly columns: 2;
+        readonly widths: readonly ["3fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-[3fr_1fr]";
+    };
+    readonly "3c-equal": {
+        readonly columns: 3;
+        readonly widths: readonly ["1fr", "1fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-3";
+    };
+    readonly "3c-middle-wider": {
+        readonly columns: 3;
+        readonly widths: readonly ["1fr", "2fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-[1fr_2fr_1fr]";
+    };
+};
+/**
+ * Union type of all section layout types, derived from SECTION_LAYOUT_CONFIG keys.
+ * @see deriving-typeof-for-object-keys pattern
+ */
+type SectionLayoutType = keyof typeof SECTION_LAYOUT_CONFIG;
+/** @deprecated Use SECTION_LAYOUT_CONFIG instead */
+declare const sectionLayoutConfig: {
+    readonly "single-column": {
+        readonly columns: 1;
+        readonly widths: readonly ["1fr"];
+        readonly gridClasses: "";
+    };
+    readonly "2c-equal": {
+        readonly columns: 2;
+        readonly widths: readonly ["1fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-2";
+    };
+    readonly "2c-left-wider": {
+        readonly columns: 2;
+        readonly widths: readonly ["2fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-[2fr_1fr]";
+    };
+    readonly "2c-right-wider": {
+        readonly columns: 2;
+        readonly widths: readonly ["1fr", "2fr"];
+        readonly gridClasses: "@md:grid-cols-[1fr_2fr]";
+    };
+    readonly "2c-left-narrow": {
+        readonly columns: 2;
+        readonly widths: readonly ["1fr", "3fr"];
+        readonly gridClasses: "@md:grid-cols-[1fr_3fr]";
+    };
+    readonly "2c-right-narrow": {
+        readonly columns: 2;
+        readonly widths: readonly ["3fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-[3fr_1fr]";
+    };
+    readonly "3c-equal": {
+        readonly columns: 3;
+        readonly widths: readonly ["1fr", "1fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-3";
+    };
+    readonly "3c-middle-wider": {
+        readonly columns: 3;
+        readonly widths: readonly ["1fr", "2fr", "1fr"];
+        readonly gridClasses: "@md:grid-cols-[1fr_2fr_1fr]";
+    };
+};
+
+type StrictOmit<T, K extends keyof T> = Omit<T, K>;
+
+export { type AlignOptions, BACKGROUND_TYPES, BORDER_RADIUS_OPTIONS, BUTTON_SIZE_OPTIONS, type BackgroundType, type BackgroundValue, type BorderRadiusOptions, type ButtonSizeOptions, COLOR_OPTIONS, type ColorOptions, FONT_SIZE_OPTIONS, type FontSizeOptions, GAP_OPTIONS, type GapOptions, HORIZONTAL_ALIGN_OPTIONS, type HorizontalAlign, type Navigation, type NavigationItem, PADDING_VALUES, type PaddingOptions, SECTION_LAYOUT_CONFIG, type ScreenDefinition, type SectionLayoutType, ShareableItem, type StrictOmit, VERTICAL_ALIGN_OPTIONS, type VerticalAlign, WidgetSchema, sectionLayoutConfig };

package/dist/types/index.js

@@ -0,0 +1,3 @@
+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 } from '../chunk-EWR5EIBP.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/widget-utils/index.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+var chunk6QLUUNJL_cjs = require('../chunk-6QLUUNJL.cjs');
+
+// src/widget-utils/widget-utils.ts
+function generateWidgetId(type) {
+  const uuid = crypto.randomUUID();
+  return type ? `${type}-${uuid}` : uuid;
+}
+function pathToId(path) {
+  return path.join("-");
+}
+function idToPath(id) {
+  return id.split("-").map((segment) => parseInt(segment, 10));
+}
+function ensureWidgetIds(widgets) {
+  return widgets?.map((widget, index) => {
+    if (!widget) return null;
+    return {
+      ...widget,
+      id: widget.id || `widget-${index}-${crypto.randomUUID()}`
+    };
+  });
+}
+function deepCloneWidget(widget) {
+  if (chunk6QLUUNJL_cjs.isWidgetType(widget, chunk6QLUUNJL_cjs.WIDGET_TYPE_NAMES.Layout) && Array.isArray(widget.props.children)) {
+    return {
+      type: widget.type,
+      props: {
+        ...widget.props,
+        children: widget.props.children.map((child) => child ? deepCloneWidget(child) : null)
+      },
+      id: generateWidgetId(widget.type)
+    };
+  }
+  return {
+    type: widget.type,
+    props: { ...widget.props },
+    id: generateWidgetId(widget.type)
+  };
+}
+function deepCloneWidgets(widgets) {
+  return widgets.map((widget) => deepCloneWidget(widget));
+}
+function getWidgetByPath(screen, path) {
+  if (path.length === 0 || path[0] === void 0) return null;
+  let current = screen[path[0]] ?? null;
+  for (let i = 1; i < path.length; i++) {
+    if (!chunk6QLUUNJL_cjs.isWidgetType(current, chunk6QLUUNJL_cjs.WIDGET_TYPE_NAMES.Layout)) return null;
+    const children = current.props.children ?? [];
+    const index = path[i];
+    if (index === void 0) return null;
+    current = children[index] ?? null;
+  }
+  return current;
+}
+function groupChildrenByColumn(children, columnCount) {
+  const columns = Array.from(
+    { length: columnCount },
+    () => []
+  );
+  const nonNullChildren = children.filter(
+    (child) => child !== null
+  );
+  for (const child of nonNullChildren) {
+    const colIndex = Math.min(child.columnIndex ?? 0, columnCount - 1);
+    const column = columns[colIndex];
+    if (column) {
+      column.push(child);
+    }
+  }
+  return columns;
+}
+
+// src/widget-utils/utils.ts
+function createWidgetRegistry(registry) {
+  return registry;
+}
+function createScreen(registry, widgets) {
+  widgets.forEach((widget) => {
+    if (!(widget.type in registry)) {
+      throw new Error(
+        `Widget type "${String(widget.type)}" not found in registry`
+      );
+    }
+  });
+  return widgets;
+}
+function createWidgetFromShareable(item) {
+  const isVideo = item.kind === "video" || !!item.videoUrl;
+  if (isVideo && item.videoUrl) {
+    return {
+      type: "VideoWidget",
+      props: {
+        src: item.videoUrl,
+        poster: item.imageUrl,
+        caption: item.title
+      }
+    };
+  }
+  return {
+    type: "ImageWidget",
+    props: {
+      src: item.imageUrl,
+      alt: item.title || "Image",
+      objectFit: "cover"
+    }
+  };
+}
+
+exports.createScreen = createScreen;
+exports.createWidgetFromShareable = createWidgetFromShareable;
+exports.createWidgetRegistry = createWidgetRegistry;
+exports.deepCloneWidget = deepCloneWidget;
+exports.deepCloneWidgets = deepCloneWidgets;
+exports.ensureWidgetIds = ensureWidgetIds;
+exports.generateWidgetId = generateWidgetId;
+exports.getWidgetByPath = getWidgetByPath;
+exports.groupChildrenByColumn = groupChildrenByColumn;
+exports.idToPath = idToPath;
+exports.pathToId = pathToId;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/widget-utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/widget-utils/widget-utils.ts","../../src/widget-utils/utils.ts"],"names":["isWidgetType","WIDGET_TYPE_NAMES"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { WidgetSchema, WidgetPath } from \"../types\";\nimport { WIDGET_TYPE_NAMES, isWidgetType } from \"../types\";\n\n/**\n * Generates a unique ID for a widget\n */\nexport function generateWidgetId(type?: string): string {\n  const uuid = crypto.randomUUID();\n  return type ? `${type}-${uuid}` : uuid;\n}\n\n/**\n * Converts a widget path to a unique string identifier\n */\nexport function pathToId(path: WidgetPath): string {\n  return path.join(\"-\");\n}\n\n/**\n * Converts a path string back to a WidgetPath array\n */\nexport function idToPath(id: string): WidgetPath {\n  return id.split(\"-\").map((segment) => parseInt(segment, 10));\n}\n\n/**\n * Ensures all widgets in an array have valid IDs\n * Note: Handles null values for sparse arrays (e.g., grid layouts with empty cells)\n */\nexport function ensureWidgetIds(\n  widgets: readonly (WidgetSchema | null)[],\n): (WidgetSchema | null)[] {\n  return widgets?.map((widget, index) => {\n    if (!widget) return null;\n    return {\n      ...widget,\n      id: widget.id || `widget-${index}-${crypto.randomUUID()}`,\n    };\n  });\n}\n\n/**\n * Deep clones a widget and regenerates all IDs (including nested children)\n */\nexport function deepCloneWidget(widget: WidgetSchema): WidgetSchema {\n  // Handle LayoutWidget children recursively\n  // Use type guard for discriminated union narrowing (narrowing-discriminated-unions rule)\n  if (\n    isWidgetType(widget, WIDGET_TYPE_NAMES.Layout) &&\n    Array.isArray(widget.props.children)\n  ) {\n    // Build cloned widget with recursively cloned children\n    return {\n      type: widget.type,\n      props: {\n        ...widget.props,\n        children: (\n          widget.props.children as readonly (WidgetSchema | null)[]\n        ).map((child) => (child ? deepCloneWidget(child) : null)),\n      },\n      id: generateWidgetId(widget.type),\n    };\n  }\n\n  // Clone non-container widget\n  return {\n    type: widget.type,\n    props: { ...widget.props },\n    id: generateWidgetId(widget.type),\n  };\n}\n\n/**\n * Deep clones an array of widgets and regenerates all IDs\n */\nexport function deepCloneWidgets(\n  widgets: readonly WidgetSchema[],\n): WidgetSchema[] {\n  return widgets.map((widget) => deepCloneWidget(widget));\n}\n\n/**\n * Gets a widget at a specific path in the widget tree\n */\nexport function getWidgetByPath(\n  screen: readonly (WidgetSchema | null)[],\n  path: WidgetPath,\n): WidgetSchema | null {\n  if (path.length === 0 || path[0] === undefined) return null;\n\n  let current: WidgetSchema | null = screen[path[0]] ?? null;\n\n  for (let i = 1; i < path.length; i++) {\n    // Use type guard for discriminated union narrowing (narrowing-discriminated-unions rule)\n    if (!isWidgetType(current, WIDGET_TYPE_NAMES.Layout)) return null;\n\n    const children = (current.props.children ??\n      []) as readonly (WidgetSchema | null)[];\n    const index = path[i];\n    if (index === undefined) return null;\n    current = children[index] ?? null;\n  }\n\n  return current;\n}\n\n/**\n * Groups children by column index.\n * Accepts nullable children (sparse arrays from grid layouts) and filters them out.\n */\nexport function groupChildrenByColumn(\n  children: readonly (WidgetSchema | null)[],\n  columnCount: number,\n): WidgetSchema[][] {\n  // Use explicit type annotation to avoid never[] inference (narrowing-empty-array-type rule)\n  const columns: WidgetSchema[][] = Array.from(\n    { length: columnCount },\n    (): WidgetSchema[] => [],\n  );\n\n  // Filter out nulls first, then process (truthiness narrowing rule)\n  // This avoids the narrowing-callback-scope issue since we work with non-null array\n  const nonNullChildren = children.filter(\n    (child): child is WidgetSchema => child !== null,\n  );\n\n  for (const child of nonNullChildren) {\n    // Default to column 0 if no columnIndex specified\n    const colIndex = Math.min(child.columnIndex ?? 0, columnCount - 1);\n    const column = columns[colIndex];\n    if (column) {\n      column.push(child);\n    }\n  }\n\n  return columns;\n}\n","import type { ComponentType } from \"react\";\nimport type { WidgetSchema, TypedWidgetSchema } from \"../types\";\nimport type { ShareableItem } from \"../types/shareable-item\";\n\nexport function createWidgetRegistry<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  T extends Record<string, ComponentType<any>>,\n>(registry: T): T {\n  // Return the registry with its original type intact for type inference\n  return registry;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createScreen<T extends Record<string, ComponentType<any>>>(\n  registry: T,\n  widgets: TypedWidgetSchema<T>[],\n): TypedWidgetSchema<T>[] {\n  // Validate that all widget types exist in the registry at runtime\n  widgets.forEach((widget) => {\n    if (!(widget.type in registry)) {\n      throw new Error(\n        `Widget type \"${String(widget.type)}\" not found in registry`,\n      );\n    }\n  });\n  return widgets;\n}\n\n// Helper to create WidgetSchema from shareable item\nexport function createWidgetFromShareable(item: ShareableItem): WidgetSchema {\n  const isVideo = item.kind === \"video\" || !!item.videoUrl;\n\n  if (isVideo && item.videoUrl) {\n    return {\n      type: \"VideoWidget\",\n      props: {\n        src: item.videoUrl,\n        poster: item.imageUrl,\n        caption: item.title,\n      },\n    };\n  }\n\n  return {\n    type: \"ImageWidget\",\n    props: {\n      src: item.imageUrl,\n      alt: item.title || \"Image\",\n      objectFit: \"cover\",\n    },\n  };\n}\n"]}

package/dist/widget-utils/index.d.cts

@@ -0,0 +1,43 @@
+import { W as WidgetPath, a as WidgetSchema, T as TypedWidgetSchema, S as ShareableItem } from '../shareable-item-DPmNZkE1.cjs';
+import { ComponentType } from 'react';
+
+/**
+ * Generates a unique ID for a widget
+ */
+declare function generateWidgetId(type?: string): string;
+/**
+ * Converts a widget path to a unique string identifier
+ */
+declare function pathToId(path: WidgetPath): string;
+/**
+ * Converts a path string back to a WidgetPath array
+ */
+declare function idToPath(id: string): WidgetPath;
+/**
+ * Ensures all widgets in an array have valid IDs
+ * Note: Handles null values for sparse arrays (e.g., grid layouts with empty cells)
+ */
+declare function ensureWidgetIds(widgets: readonly (WidgetSchema | null)[]): (WidgetSchema | null)[];
+/**
+ * Deep clones a widget and regenerates all IDs (including nested children)
+ */
+declare function deepCloneWidget(widget: WidgetSchema): WidgetSchema;
+/**
+ * Deep clones an array of widgets and regenerates all IDs
+ */
+declare function deepCloneWidgets(widgets: readonly WidgetSchema[]): WidgetSchema[];
+/**
+ * Gets a widget at a specific path in the widget tree
+ */
+declare function getWidgetByPath(screen: readonly (WidgetSchema | null)[], path: WidgetPath): WidgetSchema | null;
+/**
+ * Groups children by column index.
+ * Accepts nullable children (sparse arrays from grid layouts) and filters them out.
+ */
+declare function groupChildrenByColumn(children: readonly (WidgetSchema | null)[], columnCount: number): WidgetSchema[][];
+
+declare function createWidgetRegistry<T extends Record<string, ComponentType<any>>>(registry: T): T;
+declare function createScreen<T extends Record<string, ComponentType<any>>>(registry: T, widgets: TypedWidgetSchema<T>[]): TypedWidgetSchema<T>[];
+declare function createWidgetFromShareable(item: ShareableItem): WidgetSchema;
+
+export { createScreen, createWidgetFromShareable, createWidgetRegistry, deepCloneWidget, deepCloneWidgets, ensureWidgetIds, generateWidgetId, getWidgetByPath, groupChildrenByColumn, idToPath, pathToId };

package/dist/widget-utils/index.d.ts

@@ -0,0 +1,43 @@
+import { W as WidgetPath, a as WidgetSchema, T as TypedWidgetSchema, S as ShareableItem } from '../shareable-item-DPmNZkE1.js';
+import { ComponentType } from 'react';
+
+/**
+ * Generates a unique ID for a widget
+ */
+declare function generateWidgetId(type?: string): string;
+/**
+ * Converts a widget path to a unique string identifier
+ */
+declare function pathToId(path: WidgetPath): string;
+/**
+ * Converts a path string back to a WidgetPath array
+ */
+declare function idToPath(id: string): WidgetPath;
+/**
+ * Ensures all widgets in an array have valid IDs
+ * Note: Handles null values for sparse arrays (e.g., grid layouts with empty cells)
+ */
+declare function ensureWidgetIds(widgets: readonly (WidgetSchema | null)[]): (WidgetSchema | null)[];
+/**
+ * Deep clones a widget and regenerates all IDs (including nested children)
+ */
+declare function deepCloneWidget(widget: WidgetSchema): WidgetSchema;
+/**
+ * Deep clones an array of widgets and regenerates all IDs
+ */
+declare function deepCloneWidgets(widgets: readonly WidgetSchema[]): WidgetSchema[];
+/**
+ * Gets a widget at a specific path in the widget tree
+ */
+declare function getWidgetByPath(screen: readonly (WidgetSchema | null)[], path: WidgetPath): WidgetSchema | null;
+/**
+ * Groups children by column index.
+ * Accepts nullable children (sparse arrays from grid layouts) and filters them out.
+ */
+declare function groupChildrenByColumn(children: readonly (WidgetSchema | null)[], columnCount: number): WidgetSchema[][];
+
+declare function createWidgetRegistry<T extends Record<string, ComponentType<any>>>(registry: T): T;
+declare function createScreen<T extends Record<string, ComponentType<any>>>(registry: T, widgets: TypedWidgetSchema<T>[]): TypedWidgetSchema<T>[];
+declare function createWidgetFromShareable(item: ShareableItem): WidgetSchema;
+
+export { createScreen, createWidgetFromShareable, createWidgetRegistry, deepCloneWidget, deepCloneWidgets, ensureWidgetIds, generateWidgetId, getWidgetByPath, groupChildrenByColumn, idToPath, pathToId };

package/dist/widget-utils/index.js

@@ -0,0 +1,111 @@
+import { isWidgetType, WIDGET_TYPE_NAMES } from '../chunk-EWR5EIBP.js';
+
+// src/widget-utils/widget-utils.ts
+function generateWidgetId(type) {
+  const uuid = crypto.randomUUID();
+  return type ? `${type}-${uuid}` : uuid;
+}
+function pathToId(path) {
+  return path.join("-");
+}
+function idToPath(id) {
+  return id.split("-").map((segment) => parseInt(segment, 10));
+}
+function ensureWidgetIds(widgets) {
+  return widgets?.map((widget, index) => {
+    if (!widget) return null;
+    return {
+      ...widget,
+      id: widget.id || `widget-${index}-${crypto.randomUUID()}`
+    };
+  });
+}
+function deepCloneWidget(widget) {
+  if (isWidgetType(widget, WIDGET_TYPE_NAMES.Layout) && Array.isArray(widget.props.children)) {
+    return {
+      type: widget.type,
+      props: {
+        ...widget.props,
+        children: widget.props.children.map((child) => child ? deepCloneWidget(child) : null)
+      },
+      id: generateWidgetId(widget.type)
+    };
+  }
+  return {
+    type: widget.type,
+    props: { ...widget.props },
+    id: generateWidgetId(widget.type)
+  };
+}
+function deepCloneWidgets(widgets) {
+  return widgets.map((widget) => deepCloneWidget(widget));
+}
+function getWidgetByPath(screen, path) {
+  if (path.length === 0 || path[0] === void 0) return null;
+  let current = screen[path[0]] ?? null;
+  for (let i = 1; i < path.length; i++) {
+    if (!isWidgetType(current, WIDGET_TYPE_NAMES.Layout)) return null;
+    const children = current.props.children ?? [];
+    const index = path[i];
+    if (index === void 0) return null;
+    current = children[index] ?? null;
+  }
+  return current;
+}
+function groupChildrenByColumn(children, columnCount) {
+  const columns = Array.from(
+    { length: columnCount },
+    () => []
+  );
+  const nonNullChildren = children.filter(
+    (child) => child !== null
+  );
+  for (const child of nonNullChildren) {
+    const colIndex = Math.min(child.columnIndex ?? 0, columnCount - 1);
+    const column = columns[colIndex];
+    if (column) {
+      column.push(child);
+    }
+  }
+  return columns;
+}
+
+// src/widget-utils/utils.ts
+function createWidgetRegistry(registry) {
+  return registry;
+}
+function createScreen(registry, widgets) {
+  widgets.forEach((widget) => {
+    if (!(widget.type in registry)) {
+      throw new Error(
+        `Widget type "${String(widget.type)}" not found in registry`
+      );
+    }
+  });
+  return widgets;
+}
+function createWidgetFromShareable(item) {
+  const isVideo = item.kind === "video" || !!item.videoUrl;
+  if (isVideo && item.videoUrl) {
+    return {
+      type: "VideoWidget",
+      props: {
+        src: item.videoUrl,
+        poster: item.imageUrl,
+        caption: item.title
+      }
+    };
+  }
+  return {
+    type: "ImageWidget",
+    props: {
+      src: item.imageUrl,
+      alt: item.title || "Image",
+      objectFit: "cover"
+    }
+  };
+}
+
+export { createScreen, createWidgetFromShareable, createWidgetRegistry, deepCloneWidget, deepCloneWidgets, ensureWidgetIds, generateWidgetId, getWidgetByPath, groupChildrenByColumn, idToPath, pathToId };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/widget-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/widget-utils/widget-utils.ts","../../src/widget-utils/utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { WidgetSchema, WidgetPath } from \"../types\";\nimport { WIDGET_TYPE_NAMES, isWidgetType } from \"../types\";\n\n/**\n * Generates a unique ID for a widget\n */\nexport function generateWidgetId(type?: string): string {\n  const uuid = crypto.randomUUID();\n  return type ? `${type}-${uuid}` : uuid;\n}\n\n/**\n * Converts a widget path to a unique string identifier\n */\nexport function pathToId(path: WidgetPath): string {\n  return path.join(\"-\");\n}\n\n/**\n * Converts a path string back to a WidgetPath array\n */\nexport function idToPath(id: string): WidgetPath {\n  return id.split(\"-\").map((segment) => parseInt(segment, 10));\n}\n\n/**\n * Ensures all widgets in an array have valid IDs\n * Note: Handles null values for sparse arrays (e.g., grid layouts with empty cells)\n */\nexport function ensureWidgetIds(\n  widgets: readonly (WidgetSchema | null)[],\n): (WidgetSchema | null)[] {\n  return widgets?.map((widget, index) => {\n    if (!widget) return null;\n    return {\n      ...widget,\n      id: widget.id || `widget-${index}-${crypto.randomUUID()}`,\n    };\n  });\n}\n\n/**\n * Deep clones a widget and regenerates all IDs (including nested children)\n */\nexport function deepCloneWidget(widget: WidgetSchema): WidgetSchema {\n  // Handle LayoutWidget children recursively\n  // Use type guard for discriminated union narrowing (narrowing-discriminated-unions rule)\n  if (\n    isWidgetType(widget, WIDGET_TYPE_NAMES.Layout) &&\n    Array.isArray(widget.props.children)\n  ) {\n    // Build cloned widget with recursively cloned children\n    return {\n      type: widget.type,\n      props: {\n        ...widget.props,\n        children: (\n          widget.props.children as readonly (WidgetSchema | null)[]\n        ).map((child) => (child ? deepCloneWidget(child) : null)),\n      },\n      id: generateWidgetId(widget.type),\n    };\n  }\n\n  // Clone non-container widget\n  return {\n    type: widget.type,\n    props: { ...widget.props },\n    id: generateWidgetId(widget.type),\n  };\n}\n\n/**\n * Deep clones an array of widgets and regenerates all IDs\n */\nexport function deepCloneWidgets(\n  widgets: readonly WidgetSchema[],\n): WidgetSchema[] {\n  return widgets.map((widget) => deepCloneWidget(widget));\n}\n\n/**\n * Gets a widget at a specific path in the widget tree\n */\nexport function getWidgetByPath(\n  screen: readonly (WidgetSchema | null)[],\n  path: WidgetPath,\n): WidgetSchema | null {\n  if (path.length === 0 || path[0] === undefined) return null;\n\n  let current: WidgetSchema | null = screen[path[0]] ?? null;\n\n  for (let i = 1; i < path.length; i++) {\n    // Use type guard for discriminated union narrowing (narrowing-discriminated-unions rule)\n    if (!isWidgetType(current, WIDGET_TYPE_NAMES.Layout)) return null;\n\n    const children = (current.props.children ??\n      []) as readonly (WidgetSchema | null)[];\n    const index = path[i];\n    if (index === undefined) return null;\n    current = children[index] ?? null;\n  }\n\n  return current;\n}\n\n/**\n * Groups children by column index.\n * Accepts nullable children (sparse arrays from grid layouts) and filters them out.\n */\nexport function groupChildrenByColumn(\n  children: readonly (WidgetSchema | null)[],\n  columnCount: number,\n): WidgetSchema[][] {\n  // Use explicit type annotation to avoid never[] inference (narrowing-empty-array-type rule)\n  const columns: WidgetSchema[][] = Array.from(\n    { length: columnCount },\n    (): WidgetSchema[] => [],\n  );\n\n  // Filter out nulls first, then process (truthiness narrowing rule)\n  // This avoids the narrowing-callback-scope issue since we work with non-null array\n  const nonNullChildren = children.filter(\n    (child): child is WidgetSchema => child !== null,\n  );\n\n  for (const child of nonNullChildren) {\n    // Default to column 0 if no columnIndex specified\n    const colIndex = Math.min(child.columnIndex ?? 0, columnCount - 1);\n    const column = columns[colIndex];\n    if (column) {\n      column.push(child);\n    }\n  }\n\n  return columns;\n}\n","import type { ComponentType } from \"react\";\nimport type { WidgetSchema, TypedWidgetSchema } from \"../types\";\nimport type { ShareableItem } from \"../types/shareable-item\";\n\nexport function createWidgetRegistry<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  T extends Record<string, ComponentType<any>>,\n>(registry: T): T {\n  // Return the registry with its original type intact for type inference\n  return registry;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createScreen<T extends Record<string, ComponentType<any>>>(\n  registry: T,\n  widgets: TypedWidgetSchema<T>[],\n): TypedWidgetSchema<T>[] {\n  // Validate that all widget types exist in the registry at runtime\n  widgets.forEach((widget) => {\n    if (!(widget.type in registry)) {\n      throw new Error(\n        `Widget type \"${String(widget.type)}\" not found in registry`,\n      );\n    }\n  });\n  return widgets;\n}\n\n// Helper to create WidgetSchema from shareable item\nexport function createWidgetFromShareable(item: ShareableItem): WidgetSchema {\n  const isVideo = item.kind === \"video\" || !!item.videoUrl;\n\n  if (isVideo && item.videoUrl) {\n    return {\n      type: \"VideoWidget\",\n      props: {\n        src: item.videoUrl,\n        poster: item.imageUrl,\n        caption: item.title,\n      },\n    };\n  }\n\n  return {\n    type: \"ImageWidget\",\n    props: {\n      src: item.imageUrl,\n      alt: item.title || \"Image\",\n      objectFit: \"cover\",\n    },\n  };\n}\n"]}