@fluid-app/portal-sdk 0.1.469 → 0.1.471

package/dist/{build-remote-widget-plugin-manifests-BsgLYqar.d.mts → portal-function-DgqXwF13.d.mts}

@@ -1,7 +1,6 @@
-import { m as RemoteDomWidgetPackageDescriptor } from "./portal-function-85qUlAVz.mjs";
-import { r as WidgetRegistryWarningSink, t as RemoteDomWidgetRegistryOptions } from "./build-widget-registry-BwiPIMcu.mjs";
 import Color from "colorjs.io";
 import { LucideIcon } from "lucide-react";
+import { RemoteDomSerializableValue } from "@fluid-app/widget-runtime/worker";
 
 //#region ../core/src/data-sources/types.d.ts
 type StaticSourceType = "collections" | "categories" | "tags";
@@ -116,1062 +115,1093 @@ interface DataSourceConfig {
   };
 }
 //#endregion
-//#region ../core/src/remote-widget-network-access.d.ts
-interface RemoteWidgetNetworkAccessGrant {
-  readonly packageId: string;
-  readonly packageVersion: string;
-  readonly capabilityVersion: string;
-}
-interface RemoteWidgetCapabilityGrants {
-  readonly networkAccess?: RemoteWidgetNetworkAccessGrant;
-}
-//#endregion
-//#region ../core/src/types/widget-schema.d.ts
+//#region ../core/src/registries/property-schema-types.d.ts
 /**
-* Generic component type — avoids React dependency in core.
-* Accepts both function components and class component constructors.
+* Tab configuration for organizing properties
 */
-type AnyComponent = ((props: any) => any) | (new (props: any) => any);
+interface TabConfig {
+  /** Unique identifier for the tab */
+  id: string;
+  /** Display label for the tab */
+  label: string;
+}
 /**
-* Widget type names as a const object.
-* This serves as the single source of truth for widget discriminants.
-* Use `as const` for literal type inference (safety-as-const-deep-readonly rule).
+* Property field type constant - single source of truth for field types.
+* Use PROPERTY_FIELD_TYPES.text instead of "text" for type-safe comparisons.
 */
-declare const WIDGET_TYPE_NAMES: {
-  readonly Alert: "AlertWidget";
-  readonly BulletList: "BulletListWidget";
-  readonly Calendar: "CalendarWidget";
-  readonly Card: "CardWidget";
-  readonly Carousel: "CarouselWidget";
-  readonly CatchUp: "CatchUpWidget";
-  readonly Chart: "ChartWidget";
-  readonly Container: "ContainerWidget";
-  readonly Embed: "EmbedWidget";
-  readonly Image: "ImageWidget";
-  readonly Layout: "LayoutWidget";
-  readonly Link: "LinkWidget";
-  readonly List: "ListWidget";
-  readonly MySite: "MySiteWidget";
-  readonly Nested: "NestedWidget";
-  readonly Points: "PointsWidget";
-  readonly QuickLinks: "QuickLinksWidget";
-  readonly QuickShare: "QuickShareWidget";
-  readonly RecentActivity: "RecentActivityWidget";
-  readonly Separator: "SeparatorWidget";
-  readonly Shop: "ShopWidget";
-  readonly Spacer: "SpacerWidget";
-  readonly Table: "TableWidget";
-  readonly Text: "TextWidget";
-  readonly ToDo: "ToDoWidget";
-  readonly Video: "VideoWidget";
+declare const PROPERTY_FIELD_TYPES: {
+  readonly text: "text";
+  readonly textarea: "textarea";
+  readonly number: "number";
+  readonly boolean: "boolean";
+  readonly select: "select"; /** @deprecated Use `colorSelect` for semantic portal-theme colors. */
+  readonly color: "color";
+  readonly range: "range";
+  readonly dataSource: "dataSource";
+  readonly resource: "resource";
+  readonly image: "image";
+  readonly alignment: "alignment";
+  readonly slider: "slider";
+  readonly colorPicker: "colorPicker";
+  readonly sectionHeader: "sectionHeader";
+  readonly separator: "separator";
+  readonly buttonGroup: "buttonGroup";
+  readonly colorSelect: "colorSelect";
+  readonly sectionLayoutSelect: "sectionLayoutSelect";
+  readonly background: "background";
+  readonly contentPosition: "contentPosition";
+  readonly textSizeSelect: "textSizeSelect";
+  readonly cssUnit: "cssUnit";
+  readonly fontPicker: "fontPicker";
+  readonly stringArray: "stringArray";
+  readonly borderRadius: "borderRadius";
+  readonly screenPicker: "screenPicker";
 };
 /**
-* Union of all known widget type names.
-* Derived from WIDGET_TYPE_NAMES to avoid duplication (deriving-typeof-for-object-keys rule).
+* Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.
+* @see deriving-typeof-for-object-keys pattern
 */
-type WidgetTypeName = (typeof WIDGET_TYPE_NAMES)[keyof typeof WIDGET_TYPE_NAMES];
+type PropertyFieldType = (typeof PROPERTY_FIELD_TYPES)[keyof typeof PROPERTY_FIELD_TYPES];
 /**
-* Legacy alias for backwards compatibility.
-* Prefer using WidgetTypeName for new code when you need the union type.
+* Runtime validation for property field types.
+* @param value - The value to check
+* @returns true if value is a valid PropertyFieldType
 */
-type WidgetType = string;
-type WidgetRegistry = Record<WidgetType, AnyComponent>;
+declare function isPropertyFieldType(value: string): value is PropertyFieldType;
 /**
-* Base widget schema with loose typing for runtime data.
-* Use TypedWidgetSchema<T> when you have a known registry for better type safety.
+* Base schema for a property field
 */
-type WidgetSchema = {
-  readonly type: WidgetType;
-  readonly props: Readonly<Record<string, unknown>>;
-  readonly id?: string; /** Optional data source configuration for data-bound widgets */
-  readonly dataSource?: DataSourceConfig | undefined; /** Column index for masonry layouts (0-indexed) */
-  readonly columnIndex?: number; /** Host-approved capabilities for a specific remote widget package version. */
-  readonly capabilityGrants?: RemoteWidgetCapabilityGrants;
-};
+interface PropertyFieldSchema {
+  /** Property key in the widget props */
+  key: string;
+  /** Display label for the field */
+  label: string;
+  /** Field type determines the input control */
+  type: PropertyFieldType;
+  /** Optional description/help text */
+  description?: string;
+  /** Optional default value */
+  defaultValue?: unknown;
+  /** Optional tab ID (must match a TabConfig id if widget has tabsConfig) */
+  tab?: string;
+  /** Optional group for organizing fields within a tab */
+  group?: string;
+  /**
+  * When true, this field is treated as an override of a value that can
+  * otherwise be inherited from the active theme (e.g. border radius,
+  * padding, border width). Advanced fields are automatically bucketed
+  * into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+  * rendered collapsed by default so the default surface area stays
+  * minimal.
+  */
+  advanced?: boolean;
+  /**
+  * @deprecated Use requiresKeyValue instead
+  */
+  requiresKeyToBeTrue?: string;
+  /** Optional requires a specific key to have a specific value. Supports single condition or array (AND logic). */
+  requiresKeyValue?: {
+    key: string;
+    value: unknown;
+  } | Array<{
+    key: string;
+    value: unknown;
+  }>;
+}
 /**
-* Type-safe widget schema based on registry.
-* Uses discriminated unions - the `type` field serves as discriminant.
-* When narrowed (e.g., `if (widget.type === "AlertWidget")`),
-* TypeScript automatically knows the correct props type.
+* Text field schema
 */
-type TypedWidgetSchema<T extends Record<string, AnyComponent>> = { [K in keyof T]: {
-  readonly type: K;
-  readonly props: Readonly<T[K] extends ((props: infer P) => any) ? P : T[K] extends (new (props: infer P) => any) ? P : never>;
-  readonly id?: string;
-  readonly dataSource?: DataSourceConfig | undefined; /** Column index for masonry layouts (0-indexed) */
-  readonly columnIndex?: number;
-  readonly capabilityGrants?: RemoteWidgetCapabilityGrants;
-} }[keyof T];
+interface TextFieldSchema extends PropertyFieldSchema {
+  type: "text";
+  placeholder?: string;
+  maxLength?: number;
+  /**
+  * Optional quick-insert chips rendered below the input. Clicking a chip
+  * inserts `{{value}}` at the caret. Used for URL template tokens
+  * (e.g. `{{username}}`, `{{replicated_url || /signup}}`) so admins
+  * don't have to remember the exact spelling.
+  */
+  tokenSuggestions?: ReadonlyArray<{
+    /** Chip label shown to the admin (e.g. `username`). */label: string; /** Token body inserted between `{{` and `}}` (e.g. `username || /signup`). */
+    value: string;
+  }>;
+}
 /**
-* Widget path in the tree - array of indices.
-* Readonly tuple to prevent accidental mutation.
+* Textarea field schema
 */
-type WidgetPath = readonly number[];
+interface TextareaFieldSchema extends PropertyFieldSchema {
+  type: "textarea";
+  placeholder?: string;
+  rows?: number;
+  maxLength?: number;
+}
 /**
-* Type predicate to check if a string is a known widget type name.
-* Use for runtime validation of widget types.
-*
-* @example
-* if (isWidgetTypeName(widget.type)) {
-*   // TypeScript knows widget.type is WidgetTypeName
-* }
+* Number field schema
 */
-declare function isWidgetTypeName(type: string): type is WidgetTypeName;
+interface NumberFieldSchema extends PropertyFieldSchema {
+  type: "number";
+  min?: number;
+  max?: number;
+  step?: number;
+}
 /**
-* Type predicate to check if a widget has a specific type.
-* Enables type-safe widget narrowing without `as` assertions.
-*
-* @example
-* if (isWidgetType(widget, "LayoutWidget")) {
-*   // TypeScript knows widget.type === "LayoutWidget"
-*   // and widget.props is LayoutWidget props
-* }
+* Boolean field schema
 */
-declare function isWidgetType<T extends WidgetTypeName>(widget: WidgetSchema | null | undefined, typeName: T): widget is WidgetSchema & {
-  readonly type: T;
-};
+interface BooleanFieldSchema extends PropertyFieldSchema {
+  type: "boolean";
+}
 /**
-* Helper for exhaustive switch statements on widget types.
-* Use in the default case to ensure all widget types are handled.
-*
-* @example
-* switch (widget.type) {
-*   case "AlertWidget": return handleAlert();
-*   case "TextWidget": return handleText();
-*   // ... all other widget types
-*   default: return assertNever(widget.type, "widget type");
-* }
+* Select field schema with type-safe option values.
+* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
 */
-declare function assertNever(value: never, context?: string): never;
+interface SelectFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
+  type: "select";
+  options: Array<{
+    label: string;
+    value: T;
+  }>;
+  defaultValue?: T;
+}
 /**
-* Assertion function that throws if value is undefined.
-* Narrows the type to exclude undefined.
+* Legacy free-form color field schema.
 *
-* @example
-* const widget = screen[0];
-* assertDefined(widget, "widget at index 0");
-* // TypeScript knows widget is defined here
+* @deprecated Use {@link ColorSelectFieldSchema} (`type: "colorSelect"`) so
+* widget authors select a semantic color token supplied by the portal theme.
 */
-declare function assertDefined<T>(value: T | undefined | null, name?: string): asserts value is T;
-//#endregion
-//#region ../../platform/theme-engine/src/types.d.ts
-declare const SEMANTIC_COLOR_NAMES: readonly ["background", "foreground", "primary", "secondary", "accent", "muted", "destructive"];
-type SemanticColorName = (typeof SEMANTIC_COLOR_NAMES)[number];
-declare const FONT_SIZE_KEYS: readonly ["extraSmall", "small", "regular", "large", "extraLarge", "giant"];
-type FontSizeKey = (typeof FONT_SIZE_KEYS)[number];
-declare const FONT_FAMILY_KEYS: readonly ["header", "body"];
-type FontFamilyKey = (typeof FONT_FAMILY_KEYS)[number];
-declare const RADIUS_KEYS: readonly ["small", "medium", "large", "extraLarge"];
-type RadiusKey = (typeof RADIUS_KEYS)[number];
-/** Author-time color input (what the user configures) */
-interface ThemeColorInput {
-  base: Color;
-  foreground: Color;
+interface ColorFieldSchema extends PropertyFieldSchema {
+  type: "color";
 }
-/** Complete theme definition — stored in-memory with Color objects */
-interface ThemeDefinition {
-  id: string;
-  name: string;
-  /** Light mode — always fully specified */
-  light: Record<SemanticColorName, ThemeColorInput>;
-  /**
-  * Dark mode — only user-overridden colors.
-  * Missing keys are auto-derived from `light` at resolve time.
-  */
-  dark: Partial<Record<SemanticColorName, Partial<ThemeColorInput>>>;
-  fontSizes: Record<FontSizeKey, string>;
-  fontFamilies: Record<FontFamilyKey, string>;
-  spacing: string;
-  radii: Record<RadiusKey, string>;
-  /** When true, theme colors are re-derived from brand guidelines on every load */
-  syncWithBrandColors?: boolean;
-}
-/** Resolved semantic color */
-interface ResolvedSemanticColor {
-  base: Color;
-  foreground: Color;
-}
-/** Complete resolved color set for one mode */
-type ResolvedColorSet = Record<SemanticColorName, ResolvedSemanticColor>;
-/** Fully resolved theme — all colors materialised for both modes */
-interface ResolvedTheme {
-  id: string;
-  name: string;
-  light: ResolvedColorSet;
-  dark: ResolvedColorSet;
-  fontSizes: ThemeDefinition["fontSizes"];
-  fontFamilies: ThemeDefinition["fontFamilies"];
-  spacing: string;
-  radii: ThemeDefinition["radii"];
-}
-/** Plain OKLCH triplet for JSON serialisation (no Color dependency) */
-interface OklchPlain {
-  l: number;
-  c: number;
-  h: number;
+/**
+* Range slider field schema
+*/
+interface RangeFieldSchema extends PropertyFieldSchema {
+  type: "range";
+  min: number;
+  max: number;
+  step?: number;
 }
-/** Serialised color pair as stored in the backend payload */
-interface ThemeColorPlain {
-  base: OklchPlain;
-  foreground: OklchPlain;
+/**
+* Data source field schema for configuring widget data sources
+*/
+interface DataSourceFieldSchema extends PropertyFieldSchema {
+  /** Identifies this field as the data-source editor. */
+  type: "dataSource";
+  /** Widget props that this data-source editor can populate. */
+  targetProps?: ReadonlyArray<{
+    /** Widget prop key populated with the resolved data-source result. */key: string; /** Description emitted for this prop in the portal JSON Schema and types. */
+    description: string;
+  }>;
 }
-/** Backend payload — plain JSON, no Color objects */
-interface ThemePayload {
-  [key: string]: unknown;
-  id: string;
-  name: string;
-  light: Record<SemanticColorName, ThemeColorPlain>;
-  dark: Partial<Record<SemanticColorName, {
-    base?: OklchPlain;
-    foreground?: OklchPlain;
-  }>>;
-  fontSizes: Record<FontSizeKey, string>;
-  fontFamilies: Record<FontFamilyKey, string>;
-  spacing: string;
-  radii: Record<RadiusKey, string>;
-  syncWithBrandColors?: boolean;
+/**
+* Resource field schema for selecting a single resource from the selection modal
+*/
+interface ResourceFieldSchema extends PropertyFieldSchema {
+  type: "resource";
+  /** Optional filter to specific shareable types */
+  allowedTypes?: string[];
 }
-//#endregion
-//#region ../../platform/theme-engine/src/color-engine.d.ts
 /**
-* Attempt to convert any string into a Color using colorjs.io.
-* If the string is exactly 6 hex digits it is assumed to be a bare hex value
-* (e.g. "3b82f6") and a "#" prefix is added before parsing. Six-letter
-* named colours like "orange" or "maroon" are left untouched.
-*
-* @returns the parsed Color, or a neutral gray (`oklch(0.5 0 0)`) on failure
+* Image field schema for selecting a single asset (image or video) from the
+* image picker. Despite the legacy "image" name, this field supports video
+* picking via the `accept` parameter — `VideoWidget`, `ListWidget` Featured
+* Asset, and `NestedWidget` Primary Media all use it for video-or-mixed
+* content.
 */
-declare function parseColor(value: string): Color;
+interface ImageFieldSchema extends PropertyFieldSchema {
+  type: "image";
+  /**
+  * Restricts which MIME categories the picker offers. Defaults to "image".
+  */
+  accept?: "image" | "video" | "any";
+}
 /**
-* Returns either the original foreground or a corrected lightness variant,
-* whichever provides better contrast against `color`.
-* Inversion triggers when the |APCA contrast| is below 50 — APCA is signed
-* (negative for dark-on-light, positive for light-on-dark), so comparing the
-* absolute value avoids flipping dark text that already contrasts well on a
-* medium background.
+* Alignment field schema
 */
-declare function getForegroundColor(foreground: Color, color: Color): Color;
+interface AlignmentFieldSchema extends PropertyFieldSchema {
+  type: "alignment";
+  options: {
+    verticalEnabled: boolean;
+    horizontalEnabled: boolean;
+  };
+  defaultValue?: AlignOptions;
+}
 /**
-* Derive a dark-mode ThemeColorInput from its light-mode counterpart.
+* Slider field schema with optional unit suffix (e.g., "rem", "px")
 */
-declare function deriveDarkVariant(name: SemanticColorName, light: ThemeColorInput): ThemeColorInput;
+interface SliderFieldSchema extends PropertyFieldSchema {
+  type: "slider";
+  min: number;
+  max: number;
+  step?: number;
+  unit?: string;
+}
 /**
-* Merge auto-derived dark colors with any user-specified overrides.
-* For each semantic color, if the user has fully overridden both base and
-* foreground those are used; otherwise the missing channels are derived.
+* Color picker field schema with optional swatches
 */
-declare function mergeDarkOverrides(def: ThemeDefinition): Record<SemanticColorName, ThemeColorInput>;
+interface ColorPickerFieldSchema extends PropertyFieldSchema {
+  type: "colorPicker";
+  swatches?: string[];
+}
 /**
-* Resolve a ThemeDefinition into a complete ResolvedTheme.
-* Dark mode colors are derived from light where not overridden.
+* Section header field schema for visual grouping
 */
-declare function resolveTheme(def: ThemeDefinition): ResolvedTheme;
-//#endregion
-//#region ../../platform/theme-engine/src/css-generator.d.ts
-interface GenerateThemeCSSOptions {
-  /** Whether or not to allow prefers-color-scheme to choose the theme mode */
-  disableAutoTheme?: boolean;
-  /** Whether to emit Tailwind built-in color overrides (default true) */
-  mapTailwindColors?: boolean;
+interface SectionHeaderFieldSchema extends PropertyFieldSchema {
+  type: "sectionHeader";
+  subtitle?: string;
 }
 /**
-* Generate a complete CSS string for a resolved theme.
-* Outputs 2–3 blocks: light default, dark explicit via `[data-theme-mode="dark"]`,
-* and (unless `disableAutoTheme`) a `prefers-color-scheme: dark` media query block.
+* Separator field schema for visual separation
 */
-declare function generateThemeCSS(theme: ResolvedTheme, options?: GenerateThemeCSSOptions): string;
-//#endregion
-//#region ../../platform/theme-engine/src/serialisation.d.ts
+interface SeparatorFieldSchema extends PropertyFieldSchema {
+  type: "separator";
+}
 /**
-* Serialise a ThemeDefinition (with Color objects) to a plain JSON payload
-* suitable for backend storage.
+* Button group field schema.
+* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
 */
-declare function serialiseTheme(def: ThemeDefinition): ThemePayload;
+interface ButtonGroupFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
+  type: "buttonGroup";
+  options: Array<{
+    label?: string;
+    ariaLabel?: string;
+    icon?: LucideIcon;
+    value: T;
+  }>;
+  defaultValue?: T;
+}
 /**
-* Deserialise a backend payload into a ThemeDefinition with Color objects.
-* Accepts `Record<string, unknown>` because API data is untyped at the boundary.
-* Falls back to default colors for any missing light-mode entries.
+* Semantic theme-color token selector. Prefer this field over free-form color
+* controls so widgets continue to work across portal themes and color modes.
 */
-declare function deserialiseTheme(payload: Record<string, unknown>): ThemeDefinition;
-//#endregion
-//#region ../../platform/theme-engine/src/transforms.d.ts
-/** Shape of a raw theme from the FluidOS API */
-interface RawApiTheme {
-  id: number;
-  config?: Record<string, unknown> | null;
-  active?: boolean | null;
-  name?: string | null;
+interface ColorSelectFieldSchema extends PropertyFieldSchema {
+  type: "colorSelect";
+  defaultValue?: ColorOptions;
+  excludeColors?: ColorOptions[];
 }
 /**
-* Build a ThemeDefinition from a single API theme object.
-* Handles both new structured format and legacy flat format.
+* Section layout select field schema for visual masonry layout selector
 */
-declare function buildThemeDefinition(theme: RawApiTheme): ThemeDefinition;
+interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {
+  type: "sectionLayoutSelect";
+  defaultValue?: SectionLayoutType;
+}
 /**
-* Transform raw API themes to ThemeDefinition[].
-* Catches and logs errors per theme (graceful degradation).
+* Background field combines resource selection and color properties.
+* Uses StrictOmit to exclude conflicting "type" discriminant from parents.
 */
-declare function transformThemes(themes: RawApiTheme[]): ThemeDefinition[];
+interface BackgroundFieldSchema extends StrictOmit<ResourceFieldSchema, "type">, StrictOmit<ColorFieldSchema, "type"> {
+  type: "background";
+}
 /**
-* Get the active theme ID from a list of raw API themes.
-* Falls back to the first theme if none is marked active.
+* Content position field schema for 3x3 grid position picker
 */
-declare function getActiveThemeId(themes: RawApiTheme[]): string | undefined;
-//#endregion
-//#region ../../platform/theme-engine/src/theme-applicator.d.ts
+interface ContentPositionFieldSchema extends PropertyFieldSchema {
+  type: "contentPosition";
+  defaultValue?: string;
+}
 /**
-* Inject or update a `<style>` element in `<head>` for the given theme.
-* The element ID is deterministic (`theme-style-{themeId}`) so repeated calls
-* for the same theme are idempotent — the existing element is updated in place.
-* Also loads Google Fonts referenced by the theme's font families.
-* No-op when `document` is unavailable (SSR).
+* Text size select field schema for visual font size selector
 */
-declare function applyTheme(theme: ResolvedTheme, options?: GenerateThemeCSSOptions): void;
-/** Remove an injected theme stylesheet and clean up font link ownership. No-op during SSR. */
-declare function removeTheme(themeId: string): void;
-/** Remove all injected theme stylesheets and font links. No-op during SSR. */
-declare function removeAllThemes(): void;
-//#endregion
-//#region ../../platform/theme-engine/src/defaults.d.ts
-declare const DEFAULT_FONT_SIZES: Record<FontSizeKey, string>;
-declare const DEFAULT_FONT_FAMILIES: Record<FontFamilyKey, string>;
-declare const DEFAULT_SPACING = "0.25rem";
-declare const DEFAULT_RADII: Record<RadiusKey, string>;
-declare const DEFAULT_COLORS: {
-  readonly background: "#ffffff";
-  readonly foreground: "#1a1a1a";
-  readonly primary: "#3b82f6";
-  readonly secondary: "#6b7280";
-  readonly accent: "#10b981";
-  readonly muted: "#f3f4f6";
-  readonly destructive: "#ef4444";
-  readonly mutedForeground: "#6b7280";
-};
-declare const DEFAULT_THEME_ID = "default";
-declare const DEFAULT_THEME_NAME = "Default Theme";
+interface TextSizeSelectFieldSchema extends PropertyFieldSchema {
+  type: "textSizeSelect";
+  defaultValue?: FontSizeOptions;
+}
 /**
-* Build a fresh ThemeDefinition populated with all defaults.
-* Returns a new object each call because Color instances are mutable — do not cache the result.
+* CSS unit type for height/width fields
 */
-declare function getDefaultThemeDefinition(): ThemeDefinition;
-//#endregion
-//#region ../core/src/types/navigation.d.ts
+type CssUnit = "px" | "rem" | "vh" | "%";
 /**
-* Navigation item in the sidebar/menu structure.
-*
-* Field types match the FluidOS API schema (`FluidOSNavigationItem`).
-* Differences from the raw API type:
-* - `id` is optional (system/default items may not have one)
-* - `label` is required (transforms default null to "Untitled")
-* - `section` is a frontend-only extension (not in API)
-* - Nullable fields use `undefined` instead of `null` (except `parent_id`)
+* CSS unit field schema for numeric values with selectable units (px, rem, vh, %)
 */
-interface NavigationItem {
-  /** Database-generated identifier — optional because system/default items may not have one */
-  readonly id?: number;
-  /** URL slug for routing (`| undefined` for exactOptionalPropertyTypes compat) */
-  slug?: string | undefined;
-  /** Display label — required; transforms default null API values to "Untitled" */
-  label: string;
-  /** Icon identifier (e.g., FontAwesome name) */
-  icon?: string | undefined;
-  /** Section grouping for quick links (frontend-only, not in API) */
-  section?: string;
-  /** Associated screen ID */
-  screen_id?: number | undefined;
-  /** Sort order */
-  position?: number | undefined;
-  /** Parent navigation item ID (null for root items) */
-  parent_id?: number | null;
-  /** Origin of this navigation item */
-  source?: "user" | "system" | "code";
-  /** Nested navigation items */
-  children: NavigationItem[];
+interface CssUnitFieldSchema extends PropertyFieldSchema {
+  type: "cssUnit";
+  minByUnit?: Partial<Record<CssUnit, number>>;
+  maxByUnit?: Partial<Record<CssUnit, number>>;
+  stepByUnit?: Partial<Record<CssUnit, number>>;
+  allowedUnits?: CssUnit[];
+  defaultUnit?: CssUnit;
 }
 /**
-* Screen definition with its component tree
+* Font picker field schema for Google Fonts selection
 */
-interface ScreenDefinition {
-  readonly id: number;
-  slug: string;
-  name: string;
-  component_tree: WidgetSchema[];
+interface FontPickerFieldSchema extends PropertyFieldSchema {
+  type: "fontPicker";
+  placeholder?: string;
 }
 /**
-* Navigation configuration for the portal
+* String array field schema for managing lists of text items
 */
-interface Navigation {
-  readonly definition_id: number;
-  readonly id: number;
-  name: string;
-  navigation_items: NavigationItem[];
-  screens: ScreenDefinition[];
-}
-/** A portal app profile — themes, navigation, and definition reference. */
-interface RepAppProfile {
-  name: string;
-  themes: ThemeDefinition[];
-  activeThemeId?: string;
-  navigation: Navigation;
-  mobile_navigation?: Navigation;
-  definition_id: number;
-}
-/** Full portal app data returned by the fluidos API or builder preview. */
-interface RepAppData {
-  definition_id: number;
-  published_version: number;
-  screens: ScreenDefinition[];
-  profile: RepAppProfile;
-}
-/** Wrapper for the `/fluid_os/definitions/active` API response. */
-interface RepAppManifest {
-  manifest: RepAppData;
+interface StringArrayFieldSchema extends PropertyFieldSchema {
+  type: "stringArray";
+  placeholder?: string;
+  defaultValue?: string[];
 }
-//#endregion
-//#region ../core/src/types/shareable-item.d.ts
 /**
-* 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.
+* Border radius composite field schema for controlling 4 corners with a single field.
+* Maps to 4 individual widget prop keys (topLeft, topRight, bottomLeft, bottomRight).
 */
-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;
+interface BorderRadiusFieldSchema extends PropertyFieldSchema {
+  type: "borderRadius";
+  keys: {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+  };
+  defaultValue?: BorderRadiusOptions;
 }
-//#endregion
-//#region ../core/src/types/field-types.d.ts
 /**
-* 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 border: "border";
-  readonly destructive: "destructive";
-  readonly transparent: "transparent";
-};
-/**
-* Union type of all color options, derived from COLOR_OPTIONS constant.
-* @see deriving-typeof-for-object-keys pattern
+* Screen picker field schema for selecting a portal screen (navigation, system, or available)
 */
-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 FONT_WEIGHT_OPTIONS: {
-  readonly normal: "normal";
-  readonly medium: "medium";
-  readonly semibold: "semibold";
-  readonly bold: "bold";
-};
-type FontWeightOptions = (typeof FONT_WEIGHT_OPTIONS)[keyof typeof FONT_WEIGHT_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];
-declare const BORDER_WIDTH_OPTIONS: {
-  readonly none: "none";
-  readonly thin: "thin";
-  readonly medium: "medium";
-  readonly thick: "thick";
-};
-type BorderWidthOptions = (typeof BORDER_WIDTH_OPTIONS)[keyof typeof BORDER_WIDTH_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;
+interface ScreenPickerFieldSchema extends PropertyFieldSchema {
+  type: "screenPicker";
+  /** Whether to include system navigation items in the picker */
+  includeSystemItems?: boolean;
 }
 /**
-* 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-[minmax(0,1fr)_minmax(0,1fr)]";
-  };
-  readonly "2c-left-wider": {
-    readonly columns: 2;
-    readonly widths: readonly ["2fr", "1fr"];
-    readonly gridClasses: "@md:grid-cols-[minmax(0,2fr)_minmax(0,1fr)]";
-  };
-  readonly "2c-right-wider": {
-    readonly columns: 2;
-    readonly widths: readonly ["1fr", "2fr"];
-    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,2fr)]";
-  };
-  readonly "2c-left-narrow": {
-    readonly columns: 2;
-    readonly widths: readonly ["1fr", "3fr"];
-    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,3fr)]";
-  };
-  readonly "2c-right-narrow": {
-    readonly columns: 2;
-    readonly widths: readonly ["3fr", "1fr"];
-    readonly gridClasses: "@md:grid-cols-[minmax(0,3fr)_minmax(0,1fr)]";
-  };
-  readonly "3c-equal": {
-    readonly columns: 3;
-    readonly widths: readonly ["1fr", "1fr", "1fr"];
-    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,1fr)_minmax(0,1fr)]";
-  };
-  readonly "3c-middle-wider": {
-    readonly columns: 3;
-    readonly widths: readonly ["1fr", "2fr", "1fr"];
-    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,2fr)_minmax(0,1fr)]";
-  };
-};
-/**
-* Union type of all section layout types, derived from SECTION_LAYOUT_CONFIG keys.
-* @see deriving-typeof-for-object-keys pattern
+* Union of all field schema types
 */
-type SectionLayoutType = keyof typeof SECTION_LAYOUT_CONFIG;
-/** @deprecated Use SECTION_LAYOUT_CONFIG instead */
-declare const sectionLayoutConfig: typeof SECTION_LAYOUT_CONFIG;
-//#endregion
-//#region ../core/src/types/index.d.ts
-type StrictOmit<T, K extends keyof T> = Omit<T, K>;
-//#endregion
-//#region ../core/src/registries/property-schema-types.d.ts
+type PropertyField = TextFieldSchema | TextareaFieldSchema | NumberFieldSchema | BooleanFieldSchema | SelectFieldSchema<string | number> | ColorFieldSchema | RangeFieldSchema | DataSourceFieldSchema | ResourceFieldSchema | ImageFieldSchema | AlignmentFieldSchema | SliderFieldSchema | ColorPickerFieldSchema | SectionHeaderFieldSchema | SeparatorFieldSchema | ButtonGroupFieldSchema<string | number> | ColorSelectFieldSchema | SectionLayoutSelectFieldSchema | BackgroundFieldSchema | ContentPositionFieldSchema | TextSizeSelectFieldSchema | CssUnitFieldSchema | FontPickerFieldSchema | StringArrayFieldSchema | BorderRadiusFieldSchema | ScreenPickerFieldSchema;
 /**
-* Tab configuration for organizing properties
+* Schema for per-item configuration in custom data sources.
+* Widgets can define this to allow users to configure widget-specific
+* settings for each selected item (e.g., title, description, button).
 */
-interface TabConfig {
-  /** Unique identifier for the tab */
-  id: string;
-  /** Display label for the tab */
-  label: string;
+interface ItemConfigSchema {
+  /** Fields available for per-item configuration */
+  fields: PropertyField[];
+  /** Optional description shown at top of item config panel */
+  description?: string;
 }
 /**
-* Property field type constant - single source of truth for field types.
-* Use PROPERTY_FIELD_TYPES.text instead of "text" for type-safe comparisons.
-*/
-declare const PROPERTY_FIELD_TYPES: {
-  readonly text: "text";
-  readonly textarea: "textarea";
-  readonly number: "number";
-  readonly boolean: "boolean";
-  readonly select: "select";
-  readonly color: "color";
-  readonly range: "range";
-  readonly dataSource: "dataSource";
-  readonly resource: "resource";
-  readonly image: "image";
-  readonly alignment: "alignment";
-  readonly slider: "slider";
-  readonly colorPicker: "colorPicker";
-  readonly sectionHeader: "sectionHeader";
-  readonly separator: "separator";
-  readonly buttonGroup: "buttonGroup";
-  readonly colorSelect: "colorSelect";
-  readonly sectionLayoutSelect: "sectionLayoutSelect";
-  readonly background: "background";
-  readonly contentPosition: "contentPosition";
-  readonly textSizeSelect: "textSizeSelect";
-  readonly cssUnit: "cssUnit";
-  readonly fontPicker: "fontPicker";
-  readonly stringArray: "stringArray";
-  readonly borderRadius: "borderRadius";
-  readonly screenPicker: "screenPicker";
-};
-/**
-* Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.
-* @see deriving-typeof-for-object-keys pattern
-*/
-type PropertyFieldType = (typeof PROPERTY_FIELD_TYPES)[keyof typeof PROPERTY_FIELD_TYPES];
-/**
-* Runtime validation for property field types.
-* @param value - The value to check
-* @returns true if value is a valid PropertyFieldType
-*/
-declare function isPropertyFieldType(value: string): value is PropertyFieldType;
-/**
-* Base schema for a property field
+* Schema for a widget's editable properties
 */
-interface PropertyFieldSchema {
-  /** Property key in the widget props */
-  key: string;
-  /** Display label for the field */
-  label: string;
-  /** Field type determines the input control */
-  type: PropertyFieldType;
-  /** Optional description/help text */
-  description?: string;
-  /** Optional default value */
-  defaultValue?: unknown;
-  /** Optional tab ID (must match a TabConfig id if widget has tabsConfig) */
-  tab?: string;
-  /** Optional group for organizing fields within a tab */
-  group?: string;
-  /**
-  * When true, this field is treated as an override of a value that can
-  * otherwise be inherited from the active theme (e.g. border radius,
-  * padding, border width). Advanced fields are automatically bucketed
-  * into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
-  * rendered collapsed by default so the default surface area stays
-  * minimal.
-  */
-  advanced?: boolean;
-  /**
-  * @deprecated Use requiresKeyValue instead
-  */
-  requiresKeyToBeTrue?: string;
-  /** Optional requires a specific key to have a specific value. Supports single condition or array (AND logic). */
-  requiresKeyValue?: {
-    key: string;
-    value: unknown;
-  } | Array<{
-    key: string;
-    value: unknown;
-  }>;
+interface WidgetPropertySchema {
+  /** Widget type this schema applies to */
+  widgetType: WidgetType;
+  /** Display name for the widget */
+  displayName: string;
+  /** Optional tab configuration - if present, tabs are enabled */
+  tabsConfig?: TabConfig[];
+  /** Editable property fields */
+  fields: PropertyField[];
+  /** Optional custom validator function */
+  validate?: (props: Record<string, unknown>) => string | null;
+  /** Props that can be populated from data sources */
+  dataSourceTargetProps?: string[];
+  /** Optional schema for per-item configurations in custom data sources */
+  itemConfigSchema?: ItemConfigSchema;
 }
 /**
-* Text field schema
+* Group property fields by their group property.
+*
+* Fields flagged with `advanced: true` are collected into the
+* `CUSTOM_STYLING_GROUP` bucket regardless of their declared `group`,
+* and that bucket is always placed last so it renders at the bottom of
+* the tab. Non-advanced fields keep their author-declared group and
+* their relative insertion order, including fields that explicitly use
+* `CUSTOM_STYLING_GROUP`.
 */
-interface TextFieldSchema extends PropertyFieldSchema {
-  type: "text";
-  placeholder?: string;
-  maxLength?: number;
-  /**
-  * Optional quick-insert chips rendered below the input. Clicking a chip
-  * inserts `{{value}}` at the caret. Used for URL template tokens
-  * (e.g. `{{username}}`, `{{replicated_url || /signup}}`) so admins
-  * don't have to remember the exact spelling.
-  */
-  tokenSuggestions?: ReadonlyArray<{
-    /** Chip label shown to the admin (e.g. `username`). */label: string; /** Token body inserted between `{{` and `}}` (e.g. `username || /signup`). */
-    value: string;
-  }>;
-}
+declare function groupPropertyFields(fields: readonly PropertyField[]): Record<string, PropertyField[]>;
 /**
-* Textarea field schema
+* Extract current values from widget props based on property fields
 */
-interface TextareaFieldSchema extends PropertyFieldSchema {
-  type: "textarea";
-  placeholder?: string;
-  rows?: number;
-  maxLength?: number;
-}
+declare function extractPropertyValues(widget: Readonly<WidgetSchema>, fields: readonly PropertyField[]): Record<string, unknown>;
 /**
-* Number field schema
+* Apply property values to widget props
 */
-interface NumberFieldSchema extends PropertyFieldSchema {
-  type: "number";
-  min?: number;
-  max?: number;
-  step?: number;
+declare function applyPropertyValues(widget: Readonly<WidgetSchema>, values: Readonly<Record<string, unknown>>): WidgetSchema;
+//#endregion
+//#region ../core/src/remote-dom-widget-package.d.ts
+declare const REMOTE_DOM_WIDGET_MANIFEST_VERSION: 1;
+declare const REMOTE_DOM_WIDGET_RUNTIME: "remote-dom";
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | readonly JsonValue[] | JsonObject;
+interface JsonObject {
+  readonly [key: string]: JsonValue;
 }
+type SerializableValue<Value> = unknown extends Value ? JsonValue : Value extends JsonValue ? Value : Value extends readonly (infer Item)[] ? readonly SerializableValue<Item>[] : Value extends object ? { readonly [Key in keyof Value as NonNullable<Value[Key]> extends ((...args: never[]) => unknown) ? never : Key]: SerializableValue<Value[Key]> } : never;
 /**
-* Boolean field schema
-*/
-interface BooleanFieldSchema extends PropertyFieldSchema {
-  type: "boolean";
+* A property field that can be included in published widget metadata.
+*
+* The legacy `color` field is deprecated. Use `colorSelect` so the value is a
+* semantic color token supplied by the portal theme.
+*/
+type WidgetSourcePropertyField = PropertyField extends infer Field ? Field extends ButtonGroupFieldSchema ? Omit<SerializableValue<Field>, "options"> & {
+  /** Serializable button choices. Runtime icon components are not supported. */readonly options: readonly {
+    readonly label?: string;
+    readonly ariaLabel?: string;
+    readonly value: string | number;
+  }[];
+} : SerializableValue<Field> : never;
+/**
+* JSON-serializable property editor schema accepted by widget source metadata.
+* The build adds `widgetType`; authors must not supply it.
+*/
+interface WidgetSourcePropertySchema {
+  /** Optional tabs used to organize the property editor. */
+  readonly tabsConfig?: SerializableValue<NonNullable<WidgetPropertySchema["tabsConfig"]>>;
+  /** Editable fields shown in the property editor. */
+  readonly fields: readonly WidgetSourcePropertyField[];
+  /** Widget props that data sources can populate. */
+  readonly dataSourceTargetProps?: readonly string[];
+  /** Optional per-item fields for custom data-source selections. */
+  readonly itemConfigSchema?: {
+    /** Fields available for each selected item. */readonly fields: readonly WidgetSourcePropertyField[]; /** Help text shown above the per-item editor. */
+    readonly description?: string;
+  };
+}
+interface RemoteDomWidgetCapabilityDeclaration {
+  readonly name: string;
+  readonly version: string;
+}
+interface RemoteDomWidgetDefinition {
+  readonly type: string;
+  readonly displayName: string;
+  readonly description: string;
+  readonly icon: string;
+  readonly category: string;
+  readonly propertySchema: JsonObject;
+  readonly defaultProps: JsonObject;
+  readonly container: "inline" | "block" | "card" | "fullscreen";
+  readonly resizable: boolean | "horizontal" | "vertical" | "both";
+  readonly minSdkVersion: string;
+  readonly capabilities: readonly RemoteDomWidgetCapabilityDeclaration[];
 }
 /**
-* Select field schema with type-safe option values.
-* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
+* Canonical package contract shared by the CLI, catalog APIs, and portal hosts.
+* Catalog producers resolve every artifact to its public URL before returning
+* this descriptor; consumers do not translate legacy manifest shapes.
 */
-interface SelectFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
-  type: "select";
-  options: Array<{
-    label: string;
-    value: T;
-  }>;
-  defaultValue?: T;
+interface RemoteDomWidgetPackageDescriptor {
+  readonly manifestVersion: typeof REMOTE_DOM_WIDGET_MANIFEST_VERSION;
+  readonly runtime: typeof REMOTE_DOM_WIDGET_RUNTIME;
+  readonly packageId: string;
+  readonly source: "company" | "droplet";
+  readonly version: string;
+  readonly workerEntryUrl: string;
+  readonly cssUrls: readonly string[];
+  readonly assetUrls: readonly string[];
+  readonly widgets: readonly RemoteDomWidgetDefinition[];
+}
+//#endregion
+//#region ../core/src/remote-widget-network-access.d.ts
+interface RemoteWidgetNetworkAccessGrant {
+  readonly packageId: string;
+  readonly packageVersion: string;
+  readonly capabilityVersion: string;
 }
+interface RemoteWidgetCapabilityGrants {
+  readonly networkAccess?: RemoteWidgetNetworkAccessGrant;
+}
+//#endregion
+//#region ../core/src/types/widget-schema.d.ts
 /**
-* Color field schema
+* Generic component type — avoids React dependency in core.
+* Accepts both function components and class component constructors.
 */
-interface ColorFieldSchema extends PropertyFieldSchema {
-  type: "color";
-}
+type AnyComponent = ((props: any) => any) | (new (props: any) => any);
 /**
-* Range slider field schema
+* Widget type names as a const object.
+* This serves as the single source of truth for widget discriminants.
+* Use `as const` for literal type inference (safety-as-const-deep-readonly rule).
 */
-interface RangeFieldSchema extends PropertyFieldSchema {
-  type: "range";
-  min: number;
-  max: number;
-  step?: number;
-}
+declare const WIDGET_TYPE_NAMES: {
+  readonly Alert: "AlertWidget";
+  readonly BulletList: "BulletListWidget";
+  readonly Calendar: "CalendarWidget";
+  readonly Card: "CardWidget";
+  readonly Carousel: "CarouselWidget";
+  readonly CatchUp: "CatchUpWidget";
+  readonly Chart: "ChartWidget";
+  readonly Container: "ContainerWidget";
+  readonly Embed: "EmbedWidget";
+  readonly Image: "ImageWidget";
+  readonly Layout: "LayoutWidget";
+  readonly Link: "LinkWidget";
+  readonly List: "ListWidget";
+  readonly MySite: "MySiteWidget";
+  readonly Nested: "NestedWidget";
+  readonly Points: "PointsWidget";
+  readonly QuickLinks: "QuickLinksWidget";
+  readonly QuickShare: "QuickShareWidget";
+  readonly RecentActivity: "RecentActivityWidget";
+  readonly Separator: "SeparatorWidget";
+  readonly Shop: "ShopWidget";
+  readonly Spacer: "SpacerWidget";
+  readonly Table: "TableWidget";
+  readonly Text: "TextWidget";
+  readonly ToDo: "ToDoWidget";
+  readonly Video: "VideoWidget";
+};
 /**
-* Data source field schema for configuring widget data sources
+* Union of all known widget type names.
+* Derived from WIDGET_TYPE_NAMES to avoid duplication (deriving-typeof-for-object-keys rule).
 */
-interface DataSourceFieldSchema extends PropertyFieldSchema {
-  type: "dataSource";
-}
+type WidgetTypeName = (typeof WIDGET_TYPE_NAMES)[keyof typeof WIDGET_TYPE_NAMES];
 /**
-* Resource field schema for selecting a single resource from the selection modal
+* Legacy alias for backwards compatibility.
+* Prefer using WidgetTypeName for new code when you need the union type.
 */
-interface ResourceFieldSchema extends PropertyFieldSchema {
-  type: "resource";
-  /** Optional filter to specific shareable types */
-  allowedTypes?: string[];
-}
+type WidgetType = string;
+type WidgetRegistry = Record<WidgetType, AnyComponent>;
 /**
-* Image field schema for selecting a single asset (image or video) from the
-* image picker. Despite the legacy "image" name, this field supports video
-* picking via the `accept` parameter — `VideoWidget`, `ListWidget` Featured
-* Asset, and `NestedWidget` Primary Media all use it for video-or-mixed
-* content.
+* Base widget schema with loose typing for runtime data.
+* Use TypedWidgetSchema<T> when you have a known registry for better type safety.
 */
-interface ImageFieldSchema extends PropertyFieldSchema {
-  type: "image";
+type WidgetSchema = {
+  readonly type: WidgetType;
+  readonly props: Readonly<Record<string, unknown>>;
+  readonly id?: string; /** Optional data source configuration for data-bound widgets */
+  readonly dataSource?: DataSourceConfig | undefined; /** Column index for masonry layouts (0-indexed) */
+  readonly columnIndex?: number; /** Host-approved capabilities for a specific remote widget package version. */
+  readonly capabilityGrants?: RemoteWidgetCapabilityGrants;
+};
+/**
+* Type-safe widget schema based on registry.
+* Uses discriminated unions - the `type` field serves as discriminant.
+* When narrowed (e.g., `if (widget.type === "AlertWidget")`),
+* TypeScript automatically knows the correct props type.
+*/
+type TypedWidgetSchema<T extends Record<string, AnyComponent>> = { [K in keyof T]: {
+  readonly type: K;
+  readonly props: Readonly<T[K] extends ((props: infer P) => any) ? P : T[K] extends (new (props: infer P) => any) ? P : never>;
+  readonly id?: string;
+  readonly dataSource?: DataSourceConfig | undefined; /** Column index for masonry layouts (0-indexed) */
+  readonly columnIndex?: number;
+  readonly capabilityGrants?: RemoteWidgetCapabilityGrants;
+} }[keyof T];
+/**
+* Widget path in the tree - array of indices.
+* Readonly tuple to prevent accidental mutation.
+*/
+type WidgetPath = readonly number[];
+/**
+* Type predicate to check if a string is a known widget type name.
+* Use for runtime validation of widget types.
+*
+* @example
+* if (isWidgetTypeName(widget.type)) {
+*   // TypeScript knows widget.type is WidgetTypeName
+* }
+*/
+declare function isWidgetTypeName(type: string): type is WidgetTypeName;
+/**
+* Type predicate to check if a widget has a specific type.
+* Enables type-safe widget narrowing without `as` assertions.
+*
+* @example
+* if (isWidgetType(widget, "LayoutWidget")) {
+*   // TypeScript knows widget.type === "LayoutWidget"
+*   // and widget.props is LayoutWidget props
+* }
+*/
+declare function isWidgetType<T extends WidgetTypeName>(widget: WidgetSchema | null | undefined, typeName: T): widget is WidgetSchema & {
+  readonly type: T;
+};
+/**
+* Helper for exhaustive switch statements on widget types.
+* Use in the default case to ensure all widget types are handled.
+*
+* @example
+* switch (widget.type) {
+*   case "AlertWidget": return handleAlert();
+*   case "TextWidget": return handleText();
+*   // ... all other widget types
+*   default: return assertNever(widget.type, "widget type");
+* }
+*/
+declare function assertNever(value: never, context?: string): never;
+/**
+* Assertion function that throws if value is undefined.
+* Narrows the type to exclude undefined.
+*
+* @example
+* const widget = screen[0];
+* assertDefined(widget, "widget at index 0");
+* // TypeScript knows widget is defined here
+*/
+declare function assertDefined<T>(value: T | undefined | null, name?: string): asserts value is T;
+//#endregion
+//#region ../../platform/theme-engine/src/types.d.ts
+declare const SEMANTIC_COLOR_NAMES: readonly ["background", "foreground", "primary", "secondary", "accent", "muted", "destructive"];
+type SemanticColorName = (typeof SEMANTIC_COLOR_NAMES)[number];
+declare const FONT_SIZE_KEYS: readonly ["extraSmall", "small", "regular", "large", "extraLarge", "giant"];
+type FontSizeKey = (typeof FONT_SIZE_KEYS)[number];
+declare const FONT_FAMILY_KEYS: readonly ["header", "body"];
+type FontFamilyKey = (typeof FONT_FAMILY_KEYS)[number];
+declare const RADIUS_KEYS: readonly ["small", "medium", "large", "extraLarge"];
+type RadiusKey = (typeof RADIUS_KEYS)[number];
+/** Author-time color input (what the user configures) */
+interface ThemeColorInput {
+  base: Color;
+  foreground: Color;
+}
+/** Complete theme definition — stored in-memory with Color objects */
+interface ThemeDefinition {
+  id: string;
+  name: string;
+  /** Light mode — always fully specified */
+  light: Record<SemanticColorName, ThemeColorInput>;
   /**
-  * Restricts which MIME categories the picker offers. Defaults to "image".
+  * Dark mode — only user-overridden colors.
+  * Missing keys are auto-derived from `light` at resolve time.
   */
-  accept?: "image" | "video" | "any";
+  dark: Partial<Record<SemanticColorName, Partial<ThemeColorInput>>>;
+  fontSizes: Record<FontSizeKey, string>;
+  fontFamilies: Record<FontFamilyKey, string>;
+  spacing: string;
+  radii: Record<RadiusKey, string>;
+  /** When true, theme colors are re-derived from brand guidelines on every load */
+  syncWithBrandColors?: boolean;
+}
+/** Resolved semantic color */
+interface ResolvedSemanticColor {
+  base: Color;
+  foreground: Color;
+}
+/** Complete resolved color set for one mode */
+type ResolvedColorSet = Record<SemanticColorName, ResolvedSemanticColor>;
+/** Fully resolved theme — all colors materialised for both modes */
+interface ResolvedTheme {
+  id: string;
+  name: string;
+  light: ResolvedColorSet;
+  dark: ResolvedColorSet;
+  fontSizes: ThemeDefinition["fontSizes"];
+  fontFamilies: ThemeDefinition["fontFamilies"];
+  spacing: string;
+  radii: ThemeDefinition["radii"];
 }
-/**
-* Alignment field schema
-*/
-interface AlignmentFieldSchema extends PropertyFieldSchema {
-  type: "alignment";
-  options: {
-    verticalEnabled: boolean;
-    horizontalEnabled: boolean;
-  };
-  defaultValue?: AlignOptions;
+/** Plain OKLCH triplet for JSON serialisation (no Color dependency) */
+interface OklchPlain {
+  l: number;
+  c: number;
+  h: number;
 }
-/**
-* Slider field schema with optional unit suffix (e.g., "rem", "px")
-*/
-interface SliderFieldSchema extends PropertyFieldSchema {
-  type: "slider";
-  min: number;
-  max: number;
-  step?: number;
-  unit?: string;
+/** Serialised color pair as stored in the backend payload */
+interface ThemeColorPlain {
+  base: OklchPlain;
+  foreground: OklchPlain;
+}
+/** Backend payload — plain JSON, no Color objects */
+interface ThemePayload {
+  [key: string]: unknown;
+  id: string;
+  name: string;
+  light: Record<SemanticColorName, ThemeColorPlain>;
+  dark: Partial<Record<SemanticColorName, {
+    base?: OklchPlain;
+    foreground?: OklchPlain;
+  }>>;
+  fontSizes: Record<FontSizeKey, string>;
+  fontFamilies: Record<FontFamilyKey, string>;
+  spacing: string;
+  radii: Record<RadiusKey, string>;
+  syncWithBrandColors?: boolean;
 }
+//#endregion
+//#region ../../platform/theme-engine/src/color-engine.d.ts
 /**
-* Color picker field schema with optional swatches
+* Attempt to convert any string into a Color using colorjs.io.
+* If the string is exactly 6 hex digits it is assumed to be a bare hex value
+* (e.g. "3b82f6") and a "#" prefix is added before parsing. Six-letter
+* named colours like "orange" or "maroon" are left untouched.
+*
+* @returns the parsed Color, or a neutral gray (`oklch(0.5 0 0)`) on failure
 */
-interface ColorPickerFieldSchema extends PropertyFieldSchema {
-  type: "colorPicker";
-  swatches?: string[];
-}
+declare function parseColor(value: string): Color;
 /**
-* Section header field schema for visual grouping
+* Returns either the original foreground or a corrected lightness variant,
+* whichever provides better contrast against `color`.
+* Inversion triggers when the |APCA contrast| is below 50 — APCA is signed
+* (negative for dark-on-light, positive for light-on-dark), so comparing the
+* absolute value avoids flipping dark text that already contrasts well on a
+* medium background.
 */
-interface SectionHeaderFieldSchema extends PropertyFieldSchema {
-  type: "sectionHeader";
-  subtitle?: string;
-}
+declare function getForegroundColor(foreground: Color, color: Color): Color;
 /**
-* Separator field schema for visual separation
+* Derive a dark-mode ThemeColorInput from its light-mode counterpart.
 */
-interface SeparatorFieldSchema extends PropertyFieldSchema {
-  type: "separator";
-}
+declare function deriveDarkVariant(name: SemanticColorName, light: ThemeColorInput): ThemeColorInput;
 /**
-* Button group field schema.
-* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
+* Merge auto-derived dark colors with any user-specified overrides.
+* For each semantic color, if the user has fully overridden both base and
+* foreground those are used; otherwise the missing channels are derived.
 */
-interface ButtonGroupFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
-  type: "buttonGroup";
-  options: Array<{
-    label?: string;
-    ariaLabel?: string;
-    icon?: LucideIcon;
-    value: T;
-  }>;
-  defaultValue?: T;
-}
+declare function mergeDarkOverrides(def: ThemeDefinition): Record<SemanticColorName, ThemeColorInput>;
 /**
-* Color select field schema
+* Resolve a ThemeDefinition into a complete ResolvedTheme.
+* Dark mode colors are derived from light where not overridden.
 */
-interface ColorSelectFieldSchema extends PropertyFieldSchema {
-  type: "colorSelect";
-  defaultValue?: ColorOptions;
-  excludeColors?: ColorOptions[];
+declare function resolveTheme(def: ThemeDefinition): ResolvedTheme;
+//#endregion
+//#region ../../platform/theme-engine/src/css-generator.d.ts
+interface GenerateThemeCSSOptions {
+  /** Whether or not to allow prefers-color-scheme to choose the theme mode */
+  disableAutoTheme?: boolean;
+  /** Whether to emit Tailwind built-in color overrides (default true) */
+  mapTailwindColors?: boolean;
 }
 /**
-* Section layout select field schema for visual masonry layout selector
+* Generate a complete CSS string for a resolved theme.
+* Outputs 2–3 blocks: light default, dark explicit via `[data-theme-mode="dark"]`,
+* and (unless `disableAutoTheme`) a `prefers-color-scheme: dark` media query block.
 */
-interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {
-  type: "sectionLayoutSelect";
-  defaultValue?: SectionLayoutType;
-}
+declare function generateThemeCSS(theme: ResolvedTheme, options?: GenerateThemeCSSOptions): string;
+//#endregion
+//#region ../../platform/theme-engine/src/serialisation.d.ts
 /**
-* Background field combines resource selection and color properties.
-* Uses StrictOmit to exclude conflicting "type" discriminant from parents.
+* Serialise a ThemeDefinition (with Color objects) to a plain JSON payload
+* suitable for backend storage.
 */
-interface BackgroundFieldSchema extends StrictOmit<ResourceFieldSchema, "type">, StrictOmit<ColorFieldSchema, "type"> {
-  type: "background";
-}
+declare function serialiseTheme(def: ThemeDefinition): ThemePayload;
 /**
-* Content position field schema for 3x3 grid position picker
+* Deserialise a backend payload into a ThemeDefinition with Color objects.
+* Accepts `Record<string, unknown>` because API data is untyped at the boundary.
+* Falls back to default colors for any missing light-mode entries.
 */
-interface ContentPositionFieldSchema extends PropertyFieldSchema {
-  type: "contentPosition";
-  defaultValue?: string;
+declare function deserialiseTheme(payload: Record<string, unknown>): ThemeDefinition;
+//#endregion
+//#region ../../platform/theme-engine/src/transforms.d.ts
+/** Shape of a raw theme from the FluidOS API */
+interface RawApiTheme {
+  id: number;
+  config?: Record<string, unknown> | null;
+  active?: boolean | null;
+  name?: string | null;
 }
 /**
-* Text size select field schema for visual font size selector
+* Build a ThemeDefinition from a single API theme object.
+* Handles both new structured format and legacy flat format.
 */
-interface TextSizeSelectFieldSchema extends PropertyFieldSchema {
-  type: "textSizeSelect";
-  defaultValue?: FontSizeOptions;
-}
+declare function buildThemeDefinition(theme: RawApiTheme): ThemeDefinition;
 /**
-* CSS unit type for height/width fields
+* Transform raw API themes to ThemeDefinition[].
+* Catches and logs errors per theme (graceful degradation).
 */
-type CssUnit = "px" | "rem" | "vh" | "%";
+declare function transformThemes(themes: RawApiTheme[]): ThemeDefinition[];
 /**
-* CSS unit field schema for numeric values with selectable units (px, rem, vh, %)
+* Get the active theme ID from a list of raw API themes.
+* Falls back to the first theme if none is marked active.
 */
-interface CssUnitFieldSchema extends PropertyFieldSchema {
-  type: "cssUnit";
-  minByUnit?: Partial<Record<CssUnit, number>>;
-  maxByUnit?: Partial<Record<CssUnit, number>>;
-  stepByUnit?: Partial<Record<CssUnit, number>>;
-  allowedUnits?: CssUnit[];
-  defaultUnit?: CssUnit;
-}
+declare function getActiveThemeId(themes: RawApiTheme[]): string | undefined;
+//#endregion
+//#region ../../platform/theme-engine/src/theme-applicator.d.ts
 /**
-* Font picker field schema for Google Fonts selection
+* Inject or update a `<style>` element in `<head>` for the given theme.
+* The element ID is deterministic (`theme-style-{themeId}`) so repeated calls
+* for the same theme are idempotent — the existing element is updated in place.
+* Also loads Google Fonts referenced by the theme's font families.
+* No-op when `document` is unavailable (SSR).
 */
-interface FontPickerFieldSchema extends PropertyFieldSchema {
-  type: "fontPicker";
-  placeholder?: string;
-}
+declare function applyTheme(theme: ResolvedTheme, options?: GenerateThemeCSSOptions): void;
+/** Remove an injected theme stylesheet and clean up font link ownership. No-op during SSR. */
+declare function removeTheme(themeId: string): void;
+/** Remove all injected theme stylesheets and font links. No-op during SSR. */
+declare function removeAllThemes(): void;
+//#endregion
+//#region ../../platform/theme-engine/src/defaults.d.ts
+declare const DEFAULT_FONT_SIZES: Record<FontSizeKey, string>;
+declare const DEFAULT_FONT_FAMILIES: Record<FontFamilyKey, string>;
+declare const DEFAULT_SPACING = "0.25rem";
+declare const DEFAULT_RADII: Record<RadiusKey, string>;
+declare const DEFAULT_COLORS: {
+  readonly background: "#ffffff";
+  readonly foreground: "#1a1a1a";
+  readonly primary: "#3b82f6";
+  readonly secondary: "#6b7280";
+  readonly accent: "#10b981";
+  readonly muted: "#f3f4f6";
+  readonly destructive: "#ef4444";
+  readonly mutedForeground: "#6b7280";
+};
+declare const DEFAULT_THEME_ID = "default";
+declare const DEFAULT_THEME_NAME = "Default Theme";
 /**
-* String array field schema for managing lists of text items
+* Build a fresh ThemeDefinition populated with all defaults.
+* Returns a new object each call because Color instances are mutable — do not cache the result.
 */
-interface StringArrayFieldSchema extends PropertyFieldSchema {
-  type: "stringArray";
-  placeholder?: string;
-  defaultValue?: string[];
-}
+declare function getDefaultThemeDefinition(): ThemeDefinition;
+//#endregion
+//#region ../core/src/types/navigation.d.ts
 /**
-* Border radius composite field schema for controlling 4 corners with a single field.
-* Maps to 4 individual widget prop keys (topLeft, topRight, bottomLeft, bottomRight).
+* Navigation item in the sidebar/menu structure.
+*
+* Field types match the FluidOS API schema (`FluidOSNavigationItem`).
+* Differences from the raw API type:
+* - `id` is optional (system/default items may not have one)
+* - `label` is required (transforms default null to "Untitled")
+* - `section` is a frontend-only extension (not in API)
+* - Nullable fields use `undefined` instead of `null` (except `parent_id`)
 */
-interface BorderRadiusFieldSchema extends PropertyFieldSchema {
-  type: "borderRadius";
-  keys: {
-    topLeft: string;
-    topRight: string;
-    bottomLeft: string;
-    bottomRight: string;
-  };
-  defaultValue?: BorderRadiusOptions;
+interface NavigationItem {
+  /** Database-generated identifier — optional because system/default items may not have one */
+  readonly id?: number;
+  /** URL slug for routing (`| undefined` for exactOptionalPropertyTypes compat) */
+  slug?: string | undefined;
+  /** Display label — required; transforms default null API values to "Untitled" */
+  label: string;
+  /** Icon identifier (e.g., FontAwesome name) */
+  icon?: string | undefined;
+  /** Section grouping for quick links (frontend-only, not in API) */
+  section?: string;
+  /** Associated screen ID */
+  screen_id?: number | undefined;
+  /** Sort order */
+  position?: number | undefined;
+  /** Parent navigation item ID (null for root items) */
+  parent_id?: number | null;
+  /** Origin of this navigation item */
+  source?: "user" | "system" | "code";
+  /** Nested navigation items */
+  children: NavigationItem[];
 }
 /**
-* Screen picker field schema for selecting a portal screen (navigation, system, or available)
+* Screen definition with its component tree
 */
-interface ScreenPickerFieldSchema extends PropertyFieldSchema {
-  type: "screenPicker";
-  /** Whether to include system navigation items in the picker */
-  includeSystemItems?: boolean;
+interface ScreenDefinition {
+  readonly id: number;
+  slug: string;
+  name: string;
+  component_tree: WidgetSchema[];
 }
 /**
-* Union of all field schema types
+* Navigation configuration for the portal
 */
-type PropertyField = TextFieldSchema | TextareaFieldSchema | NumberFieldSchema | BooleanFieldSchema | SelectFieldSchema<string | number> | ColorFieldSchema | RangeFieldSchema | DataSourceFieldSchema | ResourceFieldSchema | ImageFieldSchema | AlignmentFieldSchema | SliderFieldSchema | ColorPickerFieldSchema | SectionHeaderFieldSchema | SeparatorFieldSchema | ButtonGroupFieldSchema<string | number> | ColorSelectFieldSchema | SectionLayoutSelectFieldSchema | BackgroundFieldSchema | ContentPositionFieldSchema | TextSizeSelectFieldSchema | CssUnitFieldSchema | FontPickerFieldSchema | StringArrayFieldSchema | BorderRadiusFieldSchema | ScreenPickerFieldSchema;
+interface Navigation {
+  readonly definition_id: number;
+  readonly id: number;
+  name: string;
+  navigation_items: NavigationItem[];
+  screens: ScreenDefinition[];
+}
+/** A portal app profile — themes, navigation, and definition reference. */
+interface RepAppProfile {
+  name: string;
+  themes: ThemeDefinition[];
+  activeThemeId?: string;
+  navigation: Navigation;
+  mobile_navigation?: Navigation;
+  definition_id: number;
+}
+/** Full portal app data returned by the fluidos API or builder preview. */
+interface RepAppData {
+  definition_id: number;
+  published_version: number;
+  screens: ScreenDefinition[];
+  profile: RepAppProfile;
+}
+/** Wrapper for the `/fluid_os/definitions/active` API response. */
+interface RepAppManifest {
+  manifest: RepAppData;
+}
+//#endregion
+//#region ../core/src/types/shareable-item.d.ts
 /**
-* Schema for per-item configuration in custom data sources.
-* Widgets can define this to allow users to configure widget-specific
-* settings for each selected item (e.g., title, description, button).
+* 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 ItemConfigSchema {
-  /** Fields available for per-item configuration */
-  fields: PropertyField[];
-  /** Optional description shown at top of item config panel */
-  description?: string;
+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;
 }
+//#endregion
+//#region ../core/src/types/field-types.d.ts
 /**
-* Schema for a widget's editable properties
+* Color options constant - single source of truth for color values.
+* Use COLOR_OPTIONS.primary instead of "primary" for type-safe comparisons.
 */
-interface WidgetPropertySchema {
-  /** Widget type this schema applies to */
-  widgetType: WidgetType;
-  /** Display name for the widget */
-  displayName: string;
-  /** Optional tab configuration - if present, tabs are enabled */
-  tabsConfig?: TabConfig[];
-  /** Editable property fields */
-  fields: PropertyField[];
-  /** Optional custom validator function */
-  validate?: (props: Record<string, unknown>) => string | null;
-  /** Props that can be populated from data sources */
-  dataSourceTargetProps?: string[];
-  /** Optional schema for per-item configurations in custom data sources */
-  itemConfigSchema?: ItemConfigSchema;
-}
+declare const COLOR_OPTIONS: {
+  readonly background: "background";
+  readonly foreground: "foreground";
+  readonly primary: "primary";
+  readonly secondary: "secondary";
+  readonly accent: "accent";
+  readonly muted: "muted";
+  readonly border: "border";
+  readonly destructive: "destructive";
+  readonly transparent: "transparent";
+};
 /**
-* Group property fields by their group property.
-*
-* Fields flagged with `advanced: true` are collected into the
-* `CUSTOM_STYLING_GROUP` bucket regardless of their declared `group`,
-* and that bucket is always placed last so it renders at the bottom of
-* the tab. Non-advanced fields keep their author-declared group and
-* their relative insertion order, including fields that explicitly use
-* `CUSTOM_STYLING_GROUP`.
+* Union type of all color options, derived from COLOR_OPTIONS constant.
+* @see deriving-typeof-for-object-keys pattern
 */
-declare function groupPropertyFields(fields: readonly PropertyField[]): Record<string, PropertyField[]>;
+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 FONT_WEIGHT_OPTIONS: {
+  readonly normal: "normal";
+  readonly medium: "medium";
+  readonly semibold: "semibold";
+  readonly bold: "bold";
+};
+type FontWeightOptions = (typeof FONT_WEIGHT_OPTIONS)[keyof typeof FONT_WEIGHT_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];
+declare const BORDER_WIDTH_OPTIONS: {
+  readonly none: "none";
+  readonly thin: "thin";
+  readonly medium: "medium";
+  readonly thick: "thick";
+};
+type BorderWidthOptions = (typeof BORDER_WIDTH_OPTIONS)[keyof typeof BORDER_WIDTH_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;
+}
 /**
-* Extract current values from widget props based on property fields
+* Section layout configuration - single source of truth for layout types.
+* SectionLayoutType is derived from these keys to prevent drift.
 */
-declare function extractPropertyValues(widget: Readonly<WidgetSchema>, fields: readonly PropertyField[]): Record<string, unknown>;
+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-[minmax(0,1fr)_minmax(0,1fr)]";
+  };
+  readonly "2c-left-wider": {
+    readonly columns: 2;
+    readonly widths: readonly ["2fr", "1fr"];
+    readonly gridClasses: "@md:grid-cols-[minmax(0,2fr)_minmax(0,1fr)]";
+  };
+  readonly "2c-right-wider": {
+    readonly columns: 2;
+    readonly widths: readonly ["1fr", "2fr"];
+    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,2fr)]";
+  };
+  readonly "2c-left-narrow": {
+    readonly columns: 2;
+    readonly widths: readonly ["1fr", "3fr"];
+    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,3fr)]";
+  };
+  readonly "2c-right-narrow": {
+    readonly columns: 2;
+    readonly widths: readonly ["3fr", "1fr"];
+    readonly gridClasses: "@md:grid-cols-[minmax(0,3fr)_minmax(0,1fr)]";
+  };
+  readonly "3c-equal": {
+    readonly columns: 3;
+    readonly widths: readonly ["1fr", "1fr", "1fr"];
+    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,1fr)_minmax(0,1fr)]";
+  };
+  readonly "3c-middle-wider": {
+    readonly columns: 3;
+    readonly widths: readonly ["1fr", "2fr", "1fr"];
+    readonly gridClasses: "@md:grid-cols-[minmax(0,1fr)_minmax(0,2fr)_minmax(0,1fr)]";
+  };
+};
 /**
-* Apply property values to widget props
+* Union type of all section layout types, derived from SECTION_LAYOUT_CONFIG keys.
+* @see deriving-typeof-for-object-keys pattern
 */
-declare function applyPropertyValues(widget: Readonly<WidgetSchema>, values: Readonly<Record<string, unknown>>): WidgetSchema;
+type SectionLayoutType = keyof typeof SECTION_LAYOUT_CONFIG;
+/** @deprecated Use SECTION_LAYOUT_CONFIG instead */
+declare const sectionLayoutConfig: typeof SECTION_LAYOUT_CONFIG;
 //#endregion
-//#region ../core/src/registries/field-helpers.d.ts
-/**
-* Gap value mapping - use `as const satisfies` for compile-time validation
-* with literal type preservation.
-*/
-declare const gapValues: {
-  readonly none: 0;
-  readonly xs: 1;
-  readonly sm: 2;
-  readonly md: 4;
-  readonly lg: 6;
-  readonly xl: 8;
-};
+//#region ../core/src/types/index.d.ts
+type StrictOmit<T, K extends keyof T> = Omit<T, K>;
 //#endregion
-//#region ../core/src/registries/container-types.d.ts
-/**
-* Interface for container widget behavior.
-* Container widgets can hold and manage child widgets.
-* Note: Children can be null for sparse arrays (e.g., grid layouts with empty cells)
-*/
-interface ContainerWidgetBehavior {
-  /** Identifies this widget type as a container */
-  isContainer: true;
-  /** Gets children from the widget's props */
-  getChildren: (props: Record<string, unknown>) => (WidgetSchema | null)[];
-  /** Creates new props with updated children */
-  setChildren: (props: Record<string, unknown>, children: (WidgetSchema | null)[]) => Record<string, unknown>;
-  /** Optional: Check if this container accepts a specific widget type */
-  canAcceptChild?: (childType: string) => boolean;
+//#region src/widgets/remote/contract/portal-function.d.ts
+type PortalFunctionJsonValue = RemoteDomSerializableValue;
+type PortalFunctionJsonPrimitive = null | boolean | number | string;
+type IsAny<Value> = 0 extends 1 & Value ? true : false;
+type IsPortalFunctionJsonBranch<Value, Seen> = Value extends PortalFunctionJsonPrimitive ? true : Value extends readonly (infer Item)[] ? IsPortalFunctionJsonValue<Item, Seen> : Value extends ((...args: never[]) => unknown) ? false : Value extends object ? Extract<keyof Value, symbol> extends never ? false extends { [Key in keyof Value]-?: IsPortalFunctionJsonValue<Required<Value>[Key], Seen | Value> }[keyof Value] ? false : true : false : false;
+type IsPortalFunctionJsonValue<Value, Seen = never> = IsAny<Value> extends true ? false : [Value] extends [never] ? false : [Value] extends [Seen] ? true : false extends (Value extends unknown ? IsPortalFunctionJsonBranch<Value, Seen> : never) ? false : true;
+type IsExactlyVoid<Value> = [Value] extends [void] ? [void] extends [Value] ? true : false : false;
+type PortalFunctionContractErrors<Output, Input> = IsPortalFunctionJsonValue<Output> extends true ? IsExactlyVoid<Input> extends true ? [] : IsPortalFunctionJsonValue<Input> extends true ? [] : [error: "Portal function input must contain only JSON values"] : [error: "Portal function output must contain only JSON values"];
+type PortalFunctionErrorCode = "NOT_MOUNTED" | "NOT_DECLARED" | "INVALID_ARGUMENT" | "UNAVAILABLE" | "UNSUPPORTED" | "HOST_FAILURE" | "INVALID_RESPONSE";
+/** A stable, serializable failure reported by a Portal function call. */
+declare class PortalFunctionError extends Error {
+  readonly code: PortalFunctionErrorCode;
+  constructor(code: PortalFunctionErrorCode, message: string);
 }
-//#endregion
-//#region ../core/src/registries/widget-manifest.d.ts
-/**
-* The manifest a plugin author provides to register a custom widget.
-* Required fields ensure the widget works in both builder and SDK contexts.
-* Optional fields enable advanced behavior (containers, min SDK version).
-*/
-interface WidgetManifest {
-  /** Schema version for forward compatibility. Currently must be 1. */
-  manifestVersion: number;
-  /** Unique widget type identifier (e.g., "StockTickerWidget"). */
-  type: string;
-  /** The React component that renders this widget. */
-  component: AnyComponent;
-  /** Human-readable name shown in the builder palette. */
-  displayName: string;
-  /** Brief description shown in the builder palette. */
-  description: string;
-  /** Icon identifier for the builder palette (e.g., "chart-line"). */
-  icon: string;
-  /** Category ID for palette grouping (e.g., "components", "blocks", "utility"). */
-  category: string;
-  /** Property schema defining editable fields in the builder's property panel. */
-  propertySchema: WidgetPropertySchema;
-  /** Default prop values when the widget is first created. */
-  defaultProps: Record<string, unknown>;
-  /** Container behavior — only if this widget can hold child widgets. */
-  container?: ContainerWidgetBehavior;
-  /** Minimum SDK version required (e.g., "1.0.0"). */
-  minSdkVersion?: string;
-  /** Resizable configuration. */
-  resizable?: {
-    horizontal?: boolean;
-    vertical?: boolean;
-    minWidth?: number;
-    minHeight?: number;
-  };
-  /** Exact grant the host must approve before this remote widget is added. */
-  networkAccessGrant?: RemoteWidgetNetworkAccessGrant;
+interface PortalFunctionDefinition {
+  readonly capability: string;
+  readonly version: string;
+  readonly method: string;
 }
-//#endregion
-//#region src/utils/build-remote-widget-plugin-manifests.d.ts
-interface RemoteWidgetPluginHostOptions extends RemoteDomWidgetRegistryOptions {
-  readonly warningSink?: WidgetRegistryWarningSink;
+type PortalFunction<Output, Input = void> = [Input] extends [void] ? () => Promise<Output> : (input: Input) => Promise<Output>;
+type AnyPortalFunction = (...args: never[]) => Promise<unknown>;
+type PortalFunctionHandler<Output, Input = void> = [Input] extends [void] ? () => Output | Promise<Output> : (input: Input) => Output | Promise<Output>;
+interface PortalFunctionImplementation {
+  readonly definition: PortalFunctionDefinition;
+  readonly portalFunction: AnyPortalFunction;
+  readonly handler: (...args: never[]) => unknown | Promise<unknown>;
 }
-/**
-* Projects accepted canonical packages into builder manifests using the same
-* package-atomic acceptance pass as the runtime registry.
-*/
-declare function buildRemoteWidgetPluginManifests(packages: readonly RemoteDomWidgetPackageDescriptor[], hostOptions?: RemoteWidgetPluginHostOptions): WidgetManifest[];
-declare function getRemoteWidgetPackageCategoryId(remotePackage: Pick<RemoteDomWidgetPackageDescriptor, "packageId" | "source">): string;
+declare function definePortalFunction<Output, Input = void>(definition: PortalFunctionDefinition, ..._contractErrors: PortalFunctionContractErrors<Output, Input>): PortalFunction<Output, Input>;
+declare function implementPortalFunction<Output, Input = void>(portalFunction: PortalFunction<Output, Input>, handler: PortalFunctionHandler<NoInfer<Output>, NoInfer<Input>>): PortalFunctionImplementation;
 //#endregion
-export { deriveDarkVariant as $, RepAppData as A, isWidgetType as At, DEFAULT_THEME_NAME as B, FontWeightOptions as C, WidgetPath as Ct, sectionLayoutConfig as D, WidgetTypeName as Dt, SectionLayoutType as E, WidgetType as Et, DEFAULT_FONT_FAMILIES as F, RawApiTheme as G, applyTheme as H, DEFAULT_FONT_SIZES as I, transformThemes as J, buildThemeDefinition as K, DEFAULT_RADII as L, RepAppProfile as M, ScreenDefinition as N, ShareableItem as O, assertDefined as Ot, DEFAULT_COLORS as P, generateThemeCSS as Q, DEFAULT_SPACING as R, FontSizeOptions as S, WIDGET_TYPE_NAMES as St, PaddingOptions as T, WidgetSchema as Tt, removeAllThemes as U, getDefaultThemeDefinition as V, removeTheme as W, serialiseTheme as X, deserialiseTheme as Y, GenerateThemeCSSOptions as Z, BackgroundValue as _, ThemeColorPlain as _t, gapValues as a, FONT_SIZE_KEYS as at, ButtonSizeOptions as b, AnyComponent as bt, PropertyFieldType as c, OklchPlain as ct, applyPropertyValues as d, ResolvedColorSet as dt, getForegroundColor as et, extractPropertyValues as f, ResolvedSemanticColor as ft, BackgroundType as g, ThemeColorInput as gt, AlignOptions as h, SemanticColorName as ht, WidgetManifest as i, FONT_FAMILY_KEYS as it, RepAppManifest as j, isWidgetTypeName as jt, NavigationItem as k, assertNever as kt, TabConfig as l, RADIUS_KEYS as lt, isPropertyFieldType as m, SEMANTIC_COLOR_NAMES as mt, buildRemoteWidgetPluginManifests as n, parseColor as nt, PROPERTY_FIELD_TYPES as o, FontFamilyKey as ot, groupPropertyFields as p, ResolvedTheme as pt, getActiveThemeId as q, getRemoteWidgetPackageCategoryId as r, resolveTheme as rt, PropertyFieldSchema as s, FontSizeKey as st, RemoteWidgetPluginHostOptions as t, mergeDarkOverrides as tt, WidgetPropertySchema as u, RadiusKey as ut, BorderRadiusOptions as v, ThemeDefinition as vt, GapOptions as w, WidgetRegistry as wt, ColorOptions as x, TypedWidgetSchema as xt, BorderWidthOptions as y, ThemePayload as yt, DEFAULT_THEME_ID as z };
-//# sourceMappingURL=build-remote-widget-plugin-manifests-BsgLYqar.d.mts.map
+export { resolveTheme as $, DEFAULT_COLORS as A, RemoteDomWidgetDefinition as At, removeTheme as B, extractPropertyValues as Bt, sectionLayoutConfig as C, WidgetTypeName as Ct, RepAppManifest as D, isWidgetTypeName as Dt, RepAppData as E, isWidgetType as Et, DEFAULT_THEME_ID as F, PropertyFieldSchema as Ft, deserialiseTheme as G, buildThemeDefinition as H, isPropertyFieldType as Ht, DEFAULT_THEME_NAME as I, PropertyFieldType as It, generateThemeCSS as J, serialiseTheme as K, getDefaultThemeDefinition as L, TabConfig as Lt, DEFAULT_FONT_SIZES as M, WidgetSourcePropertyField as Mt, DEFAULT_RADII as N, WidgetSourcePropertySchema as Nt, RepAppProfile as O, RemoteWidgetNetworkAccessGrant as Ot, DEFAULT_SPACING as P, PROPERTY_FIELD_TYPES as Pt, parseColor as Q, applyTheme as R, WidgetPropertySchema as Rt, SectionLayoutType as S, WidgetType as St, NavigationItem as T, assertNever as Tt, getActiveThemeId as U, RawApiTheme as V, groupPropertyFields as Vt, transformThemes as W, getForegroundColor as X, deriveDarkVariant as Y, mergeDarkOverrides as Z, ColorOptions as _, TypedWidgetSchema as _t, PortalFunctionErrorCode as a, RADIUS_KEYS as at, GapOptions as b, WidgetRegistry as bt, PortalFunctionJsonValue as c, ResolvedSemanticColor as ct, AlignOptions as d, SemanticColorName as dt, FONT_FAMILY_KEYS as et, BackgroundType as f, ThemeColorInput as ft, ButtonSizeOptions as g, AnyComponent as gt, BorderWidthOptions as h, ThemePayload as ht, PortalFunctionError as i, OklchPlain as it, DEFAULT_FONT_FAMILIES as j, RemoteDomWidgetPackageDescriptor as jt, ScreenDefinition as k, JsonValue as kt, definePortalFunction as l, ResolvedTheme as lt, BorderRadiusOptions as m, ThemeDefinition as mt, PortalFunction as n, FontFamilyKey as nt, PortalFunctionHandler as o, RadiusKey as ot, BackgroundValue as p, ThemeColorPlain as pt, GenerateThemeCSSOptions as q, PortalFunctionDefinition as r, FontSizeKey as rt, PortalFunctionImplementation as s, ResolvedColorSet as st, AnyPortalFunction as t, FONT_SIZE_KEYS as tt, implementPortalFunction as u, SEMANTIC_COLOR_NAMES as ut, FontSizeOptions as v, WIDGET_TYPE_NAMES as vt, ShareableItem as w, assertDefined as wt, PaddingOptions as x, WidgetSchema as xt, FontWeightOptions as y, WidgetPath as yt, removeAllThemes as z, applyPropertyValues as zt };
+//# sourceMappingURL=portal-function-DgqXwF13.d.mts.map