@fluid-app/rep-core 0.1.14 → 0.1.15

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

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

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

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

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

@@ -1,157 +0,0 @@
-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 | undefined;
-}
-/** Context passed to fetchers and transforms */
-interface DataSourceContext {
-    /** The widget's unique ID */
-    widgetId: string;
-    /** The widget type (e.g., "ChartWidget") */
-    widgetType: string;
-    /** AbortSignal for request cancellation */
-    signal: AbortSignal;
-    /** Base URL for API calls (e.g., "https://api.fluid.app/api") */
-    baseUrl?: string | undefined;
-    /** Get API headers function */
-    getApiHeaders?: (() => Record<string, string>) | undefined;
-    /** Dynamic variables for endpoint path substitution (e.g., { rep_id: "123" }) */
-    variables?: Record<string, string> | undefined;
-}
-/** Function signature for data fetchers */
-type DataFetcher<T extends DataSource = DataSource> = (source: T, context: DataSourceContext) => Promise<unknown>;
-/** Function signature for data transforms */
-type DataTransformer = (data: unknown, source?: DataSource, context?: DataSourceContext) => unknown;
-/** The data source registry configuration */
-interface DataSourceRegistry {
-    fetchers: Record<DataSourceType, DataFetcher>;
-    transformers: Record<string, DataTransformer>;
-}
-/** Result from useWidgetData hook */
-interface WidgetDataResult<T = unknown> {
-    /** The resolved data (undefined while loading) */
-    data: T | undefined;
-    /** True while any source is loading */
-    isLoading: boolean;
-    /** Error if any source failed */
-    error: Error | null;
-    /** Manually trigger a refetch */
-    refetch: () => void;
-}
-
-export type { ApiDataSource, CustomDataSource, DataFetcher, DataSource, DataSourceConfig, DataSourceContext, DataSourceRegistry, DataSourceType, DataTransformer, SelectedItem, ShareableType, StaticDataSource, StaticItem, StaticSourceType, WidgetDataResult };

package/dist/data-sources/types.js

@@ -1,3 +0,0 @@
-
-//# sourceMappingURL=types.js.map
-//# sourceMappingURL=types.js.map

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

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

package/dist/data-sources/use-widget-data.d.ts

@@ -1,16 +0,0 @@
-import { a as WidgetSchema } from '../widget-schema-D-ca3--K.js';
-import { DataSourceRegistry, WidgetDataResult } from './types.js';
-import 'react';
-
-interface UseWidgetDataOptions {
-    /** Override the default registry from context */
-    registry?: DataSourceRegistry | undefined;
-    /** Base URL for API calls (e.g., "https://api.fluid.app/api") */
-    baseUrl?: string | undefined;
-}
-/**
- * Hook that fetches and resolves data sources for a widget using React Query.
- */
-declare function useWidgetData<T = Record<string, unknown>>(widget: WidgetSchema, options?: UseWidgetDataOptions): WidgetDataResult<T>;
-
-export { useWidgetData };

package/dist/data-sources/use-widget-data.js

@@ -1,10 +0,0 @@
-export { useWidgetData } from '../chunk-MNVDL4FX.js';
-import '../chunk-VSZWXSQA.js';
-import '../chunk-3I5Y3PEO.js';
-import '../chunk-LBLHDGMT.js';
-import '../chunk-VRF7QEID.js';
-import '../chunk-WYOHFNNW.js';
-import '../chunk-PVTQWD4I.js';
-import '../chunk-KW5E2H5T.js';
-//# sourceMappingURL=use-widget-data.js.map
-//# sourceMappingURL=use-widget-data.js.map

package/dist/data-sources/use-widget-data.js.map

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

package/dist/registries/index.js

@@ -1,144 +0,0 @@
-import { faBan } from '@fortawesome/pro-regular-svg-icons';
-
-// src/registries/property-schema-types.ts
-var PROPERTY_FIELD_TYPES = {
-  text: "text",
-  textarea: "textarea",
-  number: "number",
-  boolean: "boolean",
-  select: "select",
-  color: "color",
-  range: "range",
-  dataSource: "dataSource",
-  resource: "resource",
-  image: "image",
-  alignment: "alignment",
-  slider: "slider",
-  colorPicker: "colorPicker",
-  sectionHeader: "sectionHeader",
-  separator: "separator",
-  buttonGroup: "buttonGroup",
-  colorSelect: "colorSelect",
-  sectionLayoutSelect: "sectionLayoutSelect",
-  background: "background",
-  contentPosition: "contentPosition",
-  textSizeSelect: "textSizeSelect",
-  cssUnit: "cssUnit"
-};
-function isPropertyFieldType(value) {
-  return Object.values(PROPERTY_FIELD_TYPES).includes(
-    value
-  );
-}
-function groupPropertyFields(fields) {
-  const grouped = {};
-  fields.forEach((field) => {
-    const group = field.group || "General";
-    if (!grouped[group]) {
-      grouped[group] = [];
-    }
-    grouped[group].push(field);
-  });
-  return grouped;
-}
-function extractPropertyValues(widget, fields) {
-  const values = {};
-  fields.forEach((field) => {
-    const value = widget.props[field.key];
-    values[field.key] = value !== void 0 ? value : field.defaultValue;
-  });
-  return values;
-}
-function applyPropertyValues(widget, values) {
-  return {
-    ...widget,
-    props: {
-      ...widget.props,
-      ...values
-    }
-  };
-}
-var getColorField = (props) => {
-  return {
-    ...props,
-    type: "colorSelect"
-  };
-};
-var getBorderRadiusField = (props) => {
-  return {
-    ...props,
-    type: "buttonGroup",
-    options: [
-      { icon: faBan, value: "none" },
-      { label: "SM", value: "sm" },
-      { label: "MD", value: "md" },
-      { label: "LG", value: "lg" },
-      { label: "XL", value: "xl" },
-      { label: "FULL", value: "full" }
-    ]
-  };
-};
-var getPaddingField = (props) => {
-  return {
-    ...props,
-    type: "buttonGroup",
-    options: [
-      { icon: faBan, value: 0 },
-      { label: "SM", value: 2 },
-      { label: "MD", value: 4 },
-      { label: "LG", value: 6 },
-      { label: "XL", value: 8 },
-      { label: "FULL", value: 10 }
-    ]
-  };
-};
-var getButtonSizeField = (props) => {
-  return {
-    ...props,
-    type: "buttonGroup",
-    options: [
-      { label: "SM", value: "sm" },
-      { label: "MD", value: "default" },
-      { label: "LG", value: "lg" },
-      { label: "XL", value: "xl" }
-    ]
-  };
-};
-var getFontSizeField = (props) => {
-  return {
-    ...props,
-    type: "textSizeSelect"
-  };
-};
-var getGapField = (props) => {
-  return {
-    ...props,
-    type: "buttonGroup",
-    options: [
-      { icon: faBan, value: "none" },
-      { label: "XS", value: "xs" },
-      { label: "SM", value: "sm" },
-      { label: "MD", value: "md" },
-      { label: "LG", value: "lg" },
-      { label: "XL", value: "xl" }
-    ]
-  };
-};
-var getHeightField = (props) => {
-  return {
-    ...props,
-    type: "cssUnit"
-  };
-};
-var gapValues = {
-  none: 0,
-  xs: 1,
-  sm: 2,
-  md: 4,
-  lg: 6,
-  xl: 8
-};
-
-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 +0,0 @@
-{"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  image: \"image\",\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<\n  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 * Image field schema for selecting a single image from the image picker\n */\nexport interface ImageFieldSchema extends PropertyFieldSchema {\n  type: \"image\";\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\n    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  | ImageFieldSchema\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/shareable-item-DkgWpwoU.d.cts

@@ -1,21 +0,0 @@
-/**
- * Base props for a shareable item.
- * Uses structural typing to be compatible with various modal implementations.
- * The index signature allows additional properties from consuming apps.
- */
-interface ShareableItem {
-    id: string | number;
-    title?: string | null;
-    image_url?: string | null;
-    imageUrl?: string | null;
-    kind?: string | null;
-    type?: string | null;
-    shareableType?: string | null;
-    share_link?: string | null;
-    videoUrl?: string;
-    price?: string | number | null;
-    display_price?: string | null;
-    [key: string]: unknown;
-}
-
-export type { ShareableItem as S };

package/dist/shareable-item-DkgWpwoU.d.ts

@@ -1,21 +0,0 @@
-/**
- * Base props for a shareable item.
- * Uses structural typing to be compatible with various modal implementations.
- * The index signature allows additional properties from consuming apps.
- */
-interface ShareableItem {
-    id: string | number;
-    title?: string | null;
-    image_url?: string | null;
-    imageUrl?: string | null;
-    kind?: string | null;
-    type?: string | null;
-    shareableType?: string | null;
-    share_link?: string | null;
-    videoUrl?: string;
-    price?: string | number | null;
-    display_price?: string | null;
-    [key: string]: unknown;
-}
-
-export type { ShareableItem as S };

package/dist/shell/AppShellLayout.d.ts

@@ -1,30 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React from 'react';
-
-interface AppShellLayoutProps {
-    /** Navigation content rendered inside the sidebar's scrollable area */
-    sidebarContent: React.ReactNode;
-    /** Header content rendered above the main content area */
-    headerContent: React.ReactNode;
-    /** Main page content */
-    children: React.ReactNode;
-    /** Optional slot at the top of the sidebar (e.g. logo, search) */
-    sidebarHeader?: React.ReactNode;
-    /** Optional slot at the bottom of the sidebar (e.g. user info) */
-    sidebarFooter?: React.ReactNode;
-    /** Content rendered after SidebarInset (e.g. MobileBottomNav) */
-    afterContent?: React.ReactNode;
-    /** Enable bottom nav mode (hides sidebar on mobile, adds bottom padding) */
-    useBottomNav?: boolean;
-}
-/**
- * Pure visual frame that replicates the RepApp layout:
- * - 13rem collapsible sidebar
- * - 52px header area
- * - rounded-xl bg-background shadow-lg content area with bg-muted gutters
- *
- * This component handles zero business logic — it simply provides the visual shell.
- */
-declare function AppShellLayout({ sidebarContent, headerContent, children, sidebarHeader, sidebarFooter, afterContent, useBottomNav, }: AppShellLayoutProps): react_jsx_runtime.JSX.Element;
-
-export { AppShellLayout, type AppShellLayoutProps };

package/dist/shell/AppShellLayout.js

@@ -1,5 +0,0 @@
-export { AppShellLayout } from '../chunk-UUNEVOA5.js';
-import '../chunk-3ZRE7GX6.js';
-import '../chunk-HIDJYVKJ.js';
-//# sourceMappingURL=AppShellLayout.js.map
-//# sourceMappingURL=AppShellLayout.js.map

package/dist/shell/AppShellLayout.js.map

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

package/dist/shell/ThemeModeContext.d.ts

@@ -1,27 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-
-type ThemeMode = "auto" | "light" | "dark";
-type DisplayMode = "light" | "dark";
-interface ThemeModeContextValue {
-    mode: ThemeMode;
-    displayMode: DisplayMode;
-    setMode: (mode: ThemeMode) => void;
-    autoModeEnabled: boolean;
-    cycleMode: () => void;
-    dataAttribute: string | undefined;
-}
-interface ThemeModeProviderProps {
-    children: ReactNode;
-    mode: ThemeMode;
-    onModeChange: (mode: ThemeMode) => void;
-    /** When false, auto mode is skipped in the cycle (light↔dark only). Default true. */
-    autoModeEnabled?: boolean;
-}
-declare function ThemeModeProvider({ children, mode, onModeChange, autoModeEnabled, }: ThemeModeProviderProps): react_jsx_runtime.JSX.Element;
-/** Access the current theme mode, setter, and cycle helper. Must be used within a `ThemeModeProvider`. */
-declare function useThemeMode(): ThemeModeContextValue;
-/** Maps a ThemeMode to the value for `data-theme-mode`. Returns undefined for "auto". */
-declare function getThemeModeAttribute(mode: ThemeMode): string | undefined;
-
-export { type DisplayMode, type ThemeMode, type ThemeModeContextValue, ThemeModeProvider, getThemeModeAttribute, useThemeMode };

package/dist/shell/ThemeModeContext.js

@@ -1,3 +0,0 @@
-export { ThemeModeProvider, getThemeModeAttribute, useThemeMode } from '../chunk-2SPTFZRC.js';
-//# sourceMappingURL=ThemeModeContext.js.map
-//# sourceMappingURL=ThemeModeContext.js.map

package/dist/shell/ThemeModeContext.js.map

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

package/dist/shell/index.cjs.map

@@ -1 +0,0 @@
-{"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=\"border-border bg-background sticky top-0 z-10 flex flex-row items-center border-b px-4 py-3 md:px-6\">\n      {!isMobile && (\n        <>\n          <button\n            type=\"button\"\n            onClick={toggleSidebar}\n            className=\"text-muted-foreground hover:text-foreground -ml-1 inline-flex items-center justify-center rounded-md p-1\"\n            aria-label=\"Toggle Sidebar\"\n          >\n            <FontAwesomeIcon icon={faTableLayout} className=\"size-4\" />\n          </button>\n          <div className=\"bg-border mx-2 h-4 w-px\" />\n        </>\n      )}\n      {breadcrumbs ? (\n        <div className=\"min-w-0 flex-1\">{breadcrumbs}</div>\n      ) : (\n        <h1 className=\"text-foreground text-lg font-semibold\">{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.ts

@@ -1,43 +0,0 @@
-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 '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 };