@fluid-app/portal-sdk 0.1.469 → 0.1.470

package/dist/{build-remote-widget-plugin-manifests-CFmLot7p.d.cts → portal-function-DYWFgeRx.d.cts}

@@ -1,7 +1,6 @@
-import { m as RemoteDomWidgetPackageDescriptor } from "./portal-function-CW3U6P5p.cjs";
-import { r as WidgetRegistryWarningSink, t as RemoteDomWidgetRegistryOptions } from "./build-widget-registry-DSE7CmVe.cjs";
-import Color from "colorjs.io";
 import { LucideIcon } from "lucide-react";
+import Color from "colorjs.io";
+import { RemoteDomSerializableValue } from "@fluid-app/widget-runtime/worker";
 
 //#region ../core/src/data-sources/types.d.ts
 type StaticSourceType = "collections" | "categories" | "tags";
@@ -116,939 +115,970 @@ 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;
+/**
+* Range slider field schema
+*/
+interface RangeFieldSchema extends PropertyFieldSchema {
+  type: "range";
+  min: number;
+  max: number;
+  step?: number;
 }
-/** Resolved semantic color */
-interface ResolvedSemanticColor {
-  base: Color;
-  foreground: Color;
+/**
+* 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;
+  }>;
 }
-/** 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"];
+/**
+* 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[];
 }
-/** Plain OKLCH triplet for JSON serialisation (no Color dependency) */
-interface OklchPlain {
-  l: number;
-  c: number;
-  h: number;
+/**
+* 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.
+*/
+interface ImageFieldSchema extends PropertyFieldSchema {
+  type: "image";
+  /**
+  * Restricts which MIME categories the picker offers. Defaults to "image".
+  */
+  accept?: "image" | "video" | "any";
 }
-/** Serialised color pair as stored in the backend payload */
-interface ThemeColorPlain {
-  base: OklchPlain;
-  foreground: OklchPlain;
+/**
+* Alignment field schema
+*/
+interface AlignmentFieldSchema extends PropertyFieldSchema {
+  type: "alignment";
+  options: {
+    verticalEnabled: boolean;
+    horizontalEnabled: boolean;
+  };
+  defaultValue?: AlignOptions;
 }
-/** 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;
+/**
+* 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;
 }
-//#endregion
-//#region ../core/src/types/navigation.d.ts
 /**
-* 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`)
+* Color picker field schema with optional swatches
 */
-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 ColorPickerFieldSchema extends PropertyFieldSchema {
+  type: "colorPicker";
+  swatches?: string[];
 }
 /**
-* Screen definition with its component tree
+* Section header field schema for visual grouping
 */
-interface ScreenDefinition {
-  readonly id: number;
-  slug: string;
-  name: string;
-  component_tree: WidgetSchema[];
+interface SectionHeaderFieldSchema extends PropertyFieldSchema {
+  type: "sectionHeader";
+  subtitle?: string;
 }
 /**
-* Navigation configuration for the portal
+* Separator field schema for visual separation
 */
-interface Navigation {
-  readonly definition_id: number;
-  readonly id: number;
-  name: string;
-  navigation_items: NavigationItem[];
-  screens: ScreenDefinition[];
+interface SeparatorFieldSchema extends PropertyFieldSchema {
+  type: "separator";
 }
-/** 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;
+/**
+* Button group field schema.
+* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
+*/
+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;
 }
-/** Full portal app data returned by the fluidos API or builder preview. */
-interface RepAppData {
-  definition_id: number;
-  published_version: number;
-  screens: ScreenDefinition[];
-  profile: RepAppProfile;
+/**
+* Semantic theme-color token selector. Prefer this field over free-form color
+* controls so widgets continue to work across portal themes and color modes.
+*/
+interface ColorSelectFieldSchema extends PropertyFieldSchema {
+  type: "colorSelect";
+  defaultValue?: ColorOptions;
+  excludeColors?: ColorOptions[];
 }
-/** Wrapper for the `/fluid_os/definitions/active` API response. */
-interface RepAppManifest {
-  manifest: RepAppData;
+/**
+* Section layout select field schema for visual masonry layout selector
+*/
+interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {
+  type: "sectionLayoutSelect";
+  defaultValue?: SectionLayoutType;
 }
-//#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.
+* Background field combines resource selection and color properties.
+* Uses StrictOmit to exclude conflicting "type" discriminant from parents.
 */
-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 BackgroundFieldSchema extends StrictOmit<ResourceFieldSchema, "type">, StrictOmit<ColorFieldSchema, "type"> {
+  type: "background";
 }
-//#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.
+* Content position field schema for 3x3 grid position picker
 */
-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";
-};
+interface ContentPositionFieldSchema extends PropertyFieldSchema {
+  type: "contentPosition";
+  defaultValue?: string;
+}
 /**
-* Union type of all color options, derived from COLOR_OPTIONS constant.
-* @see deriving-typeof-for-object-keys pattern
+* Text size select field schema for visual font size selector
 */
-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 TextSizeSelectFieldSchema extends PropertyFieldSchema {
+  type: "textSizeSelect";
+  defaultValue?: FontSizeOptions;
 }
 /**
-* 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
+* CSS unit type for height/width fields
 */
-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 CssUnit = "px" | "rem" | "vh" | "%";
 /**
-* Tab configuration for organizing properties
+* CSS unit field schema for numeric values with selectable units (px, rem, vh, %)
 */
-interface TabConfig {
-  /** Unique identifier for the tab */
-  id: string;
-  /** Display label for the tab */
-  label: string;
+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;
 }
 /**
-* 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
+* Font picker field schema for Google Fonts selection
 */
-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 FontPickerFieldSchema extends PropertyFieldSchema {
+  type: "fontPicker";
+  placeholder?: string;
 }
 /**
-* Text field schema
+* String array field schema for managing lists of text items
 */
-interface TextFieldSchema extends PropertyFieldSchema {
-  type: "text";
+interface StringArrayFieldSchema extends PropertyFieldSchema {
+  type: "stringArray";
   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;
-  }>;
+  defaultValue?: string[];
 }
 /**
-* Textarea field schema
+* 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 TextareaFieldSchema extends PropertyFieldSchema {
-  type: "textarea";
-  placeholder?: string;
-  rows?: number;
-  maxLength?: number;
+interface BorderRadiusFieldSchema extends PropertyFieldSchema {
+  type: "borderRadius";
+  keys: {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+  };
+  defaultValue?: BorderRadiusOptions;
 }
 /**
-* Number field schema
+* Screen picker field schema for selecting a portal screen (navigation, system, or available)
 */
-interface NumberFieldSchema extends PropertyFieldSchema {
-  type: "number";
-  min?: number;
-  max?: number;
-  step?: number;
+interface ScreenPickerFieldSchema extends PropertyFieldSchema {
+  type: "screenPicker";
+  /** Whether to include system navigation items in the picker */
+  includeSystemItems?: boolean;
 }
 /**
-* Boolean field schema
+* Union of all field schema types
 */
-interface BooleanFieldSchema extends PropertyFieldSchema {
-  type: "boolean";
-}
+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;
 /**
-* Select field schema with type-safe option values.
-* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
+* 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 SelectFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
-  type: "select";
-  options: Array<{
-    label: string;
-    value: T;
-  }>;
-  defaultValue?: T;
+interface ItemConfigSchema {
+  /** Fields available for per-item configuration */
+  fields: PropertyField[];
+  /** Optional description shown at top of item config panel */
+  description?: string;
 }
 /**
-* Color field schema
+* Schema for a widget's editable properties
 */
-interface ColorFieldSchema extends PropertyFieldSchema {
-  type: "color";
+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;
 }
 /**
-* Range slider 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 RangeFieldSchema extends PropertyFieldSchema {
-  type: "range";
-  min: number;
-  max: number;
-  step?: number;
-}
+declare function groupPropertyFields(fields: readonly PropertyField[]): Record<string, PropertyField[]>;
 /**
-* Data source field schema for configuring widget data sources
+* Extract current values from widget props based on property fields
 */
-interface DataSourceFieldSchema extends PropertyFieldSchema {
-  type: "dataSource";
-}
+declare function extractPropertyValues(widget: Readonly<WidgetSchema>, fields: readonly PropertyField[]): Record<string, unknown>;
 /**
-* Resource field schema for selecting a single resource from the selection modal
+* Apply property values to widget props
 */
-interface ResourceFieldSchema extends PropertyFieldSchema {
-  type: "resource";
-  /** Optional filter to specific shareable types */
-  allowedTypes?: string[];
+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;
 /**
-* 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.
+* 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.
 */
-interface ImageFieldSchema extends PropertyFieldSchema {
-  type: "image";
-  /**
-  * Restricts which MIME categories the picker offers. Defaults to "image".
-  */
-  accept?: "image" | "video" | "any";
-}
+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;
 /**
-* Alignment field schema
+* JSON-serializable property editor schema accepted by widget source metadata.
+* The build adds `widgetType`; authors must not supply it.
 */
-interface AlignmentFieldSchema extends PropertyFieldSchema {
-  type: "alignment";
-  options: {
-    verticalEnabled: boolean;
-    horizontalEnabled: boolean;
+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;
   };
-  defaultValue?: AlignOptions;
+}
+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[];
 }
 /**
-* Slider field schema with optional unit suffix (e.g., "rem", "px")
+* 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 SliderFieldSchema extends PropertyFieldSchema {
-  type: "slider";
-  min: number;
-  max: number;
-  step?: number;
-  unit?: string;
+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 picker field schema with optional swatches
+* Generic component type — avoids React dependency in core.
+* Accepts both function components and class component constructors.
 */
-interface ColorPickerFieldSchema extends PropertyFieldSchema {
-  type: "colorPicker";
-  swatches?: string[];
-}
+type AnyComponent = ((props: any) => any) | (new (props: any) => any);
 /**
-* Section header field schema for visual grouping
+* 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 SectionHeaderFieldSchema extends PropertyFieldSchema {
-  type: "sectionHeader";
-  subtitle?: string;
-}
+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";
+};
 /**
-* Separator field schema for visual separation
+* Union of all known widget type names.
+* Derived from WIDGET_TYPE_NAMES to avoid duplication (deriving-typeof-for-object-keys rule).
 */
-interface SeparatorFieldSchema extends PropertyFieldSchema {
-  type: "separator";
-}
+type WidgetTypeName = (typeof WIDGET_TYPE_NAMES)[keyof typeof WIDGET_TYPE_NAMES];
 /**
-* Button group field schema.
-* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
+* Legacy alias for backwards compatibility.
+* Prefer using WidgetTypeName for new code when you need the union type.
 */
-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;
-}
+type WidgetType = string;
+type WidgetRegistry = Record<WidgetType, AnyComponent>;
 /**
-* Color select field schema
+* Base widget schema with loose typing for runtime data.
+* Use TypedWidgetSchema<T> when you have a known registry for better type safety.
 */
-interface ColorSelectFieldSchema extends PropertyFieldSchema {
-  type: "colorSelect";
-  defaultValue?: ColorOptions;
-  excludeColors?: ColorOptions[];
-}
+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;
+};
 /**
-* Section layout select field schema for visual masonry layout selector
+* 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.
 */
-interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {
-  type: "sectionLayoutSelect";
-  defaultValue?: SectionLayoutType;
-}
+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];
 /**
-* Background field combines resource selection and color properties.
-* Uses StrictOmit to exclude conflicting "type" discriminant from parents.
+* Widget path in the tree - array of indices.
+* Readonly tuple to prevent accidental mutation.
 */
-interface BackgroundFieldSchema extends StrictOmit<ResourceFieldSchema, "type">, StrictOmit<ColorFieldSchema, "type"> {
-  type: "background";
-}
+type WidgetPath = readonly number[];
 /**
-* Content position field schema for 3x3 grid position picker
+* 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
+* }
 */
-interface ContentPositionFieldSchema extends PropertyFieldSchema {
-  type: "contentPosition";
-  defaultValue?: string;
-}
+declare function isWidgetTypeName(type: string): type is WidgetTypeName;
 /**
-* Text size select field schema for visual font size selector
+* 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
+* }
 */
-interface TextSizeSelectFieldSchema extends PropertyFieldSchema {
-  type: "textSizeSelect";
-  defaultValue?: FontSizeOptions;
-}
+declare function isWidgetType<T extends WidgetTypeName>(widget: WidgetSchema | null | undefined, typeName: T): widget is WidgetSchema & {
+  readonly type: T;
+};
 /**
-* CSS unit type for height/width fields
+* 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");
+* }
 */
-type CssUnit = "px" | "rem" | "vh" | "%";
+declare function assertNever(value: never, context?: string): never;
 /**
-* CSS unit field schema for numeric values with selectable units (px, rem, vh, %)
+* 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
 */
-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 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;
 }
-/**
-* Font picker field schema for Google Fonts selection
-*/
-interface FontPickerFieldSchema extends PropertyFieldSchema {
-  type: "fontPicker";
-  placeholder?: string;
+/** 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;
 }
-/**
-* String array field schema for managing lists of text items
-*/
-interface StringArrayFieldSchema extends PropertyFieldSchema {
-  type: "stringArray";
-  placeholder?: string;
-  defaultValue?: string[];
+/** 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;
+}
+/** 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 ../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
-*/
-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;
-/**
-* 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).
+* Navigation configuration for the portal
 */
-interface ItemConfigSchema {
-  /** Fields available for per-item configuration */
-  fields: PropertyField[];
-  /** Optional description shown at top of item config panel */
-  description?: string;
+interface Navigation {
+  readonly definition_id: number;
+  readonly id: number;
+  name: string;
+  navigation_items: NavigationItem[];
+  screens: ScreenDefinition[];
 }
-/**
-* Schema for a widget's editable properties
-*/
-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;
+/** 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
 /**
-* 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`.
-*/
-declare function groupPropertyFields(fields: readonly PropertyField[]): Record<string, PropertyField[]>;
-/**
-* Extract current values from widget props based on property fields
-*/
-declare function extractPropertyValues(widget: Readonly<WidgetSchema>, fields: readonly PropertyField[]): Record<string, unknown>;
-/**
-* Apply property values to widget props
+* 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.
 */
-declare function applyPropertyValues(widget: Readonly<WidgetSchema>, values: Readonly<Record<string, unknown>>): WidgetSchema;
+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/registries/field-helpers.d.ts
+//#region ../core/src/types/field-types.d.ts
 /**
-* Gap value mapping - use `as const satisfies` for compile-time validation
-* with literal type preservation.
+* Color options constant - single source of truth for color values.
+* Use COLOR_OPTIONS.primary instead of "primary" for type-safe comparisons.
 */
-declare const gapValues: {
-  readonly none: 0;
-  readonly xs: 1;
-  readonly sm: 2;
-  readonly md: 4;
-  readonly lg: 6;
-  readonly xl: 8;
+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";
 };
-//#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)
+* Union type of all color options, derived from COLOR_OPTIONS constant.
+* @see deriving-typeof-for-object-keys pattern
 */
-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;
+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;
 }
-//#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).
+* Section layout configuration - single source of truth for layout types.
+* SectionLayoutType is derived from these keys to prevent drift.
 */
-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;
+declare const SECTION_LAYOUT_CONFIG: {
+  readonly "single-column": {
+    readonly columns: 1;
+    readonly widths: readonly ["1fr"];
+    readonly gridClasses: "";
   };
-  /** Exact grant the host must approve before this remote widget is added. */
-  networkAccessGrant?: RemoteWidgetNetworkAccessGrant;
-}
-//#endregion
-//#region src/utils/build-remote-widget-plugin-manifests.d.ts
-interface RemoteWidgetPluginHostOptions extends RemoteDomWidgetRegistryOptions {
-  readonly warningSink?: WidgetRegistryWarningSink;
-}
+  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)]";
+  };
+};
 /**
-* Projects accepted canonical packages into builder manifests using the same
-* package-atomic acceptance pass as the runtime registry.
+* Union type of all section layout types, derived from SECTION_LAYOUT_CONFIG keys.
+* @see deriving-typeof-for-object-keys pattern
 */
-declare function buildRemoteWidgetPluginManifests(packages: readonly RemoteDomWidgetPackageDescriptor[], hostOptions?: RemoteWidgetPluginHostOptions): WidgetManifest[];
-declare function getRemoteWidgetPackageCategoryId(remotePackage: Pick<RemoteDomWidgetPackageDescriptor, "packageId" | "source">): string;
+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 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);
+}
+interface PortalFunctionDefinition {
+  readonly capability: string;
+  readonly version: string;
+  readonly method: string;
+}
+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>;
+}
+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 { WidgetPath as $, RepAppData as A, RadiusKey as B, FontWeightOptions as C, sectionLayoutConfig as D, SectionLayoutType as E, FONT_SIZE_KEYS as F, SemanticColorName as G, ResolvedSemanticColor as H, FontFamilyKey as I, ThemeDefinition as J, ThemeColorInput as K, FontSizeKey as L, RepAppProfile as M, ScreenDefinition as N, ShareableItem as O, FONT_FAMILY_KEYS as P, WIDGET_TYPE_NAMES as Q, OklchPlain as R, FontSizeOptions as S, PaddingOptions as T, ResolvedTheme as U, ResolvedColorSet as V, SEMANTIC_COLOR_NAMES as W, AnyComponent as X, ThemePayload as Y, TypedWidgetSchema as Z, BackgroundValue as _, gapValues as a, assertNever as at, ButtonSizeOptions as b, PropertyFieldType as c, applyPropertyValues as d, WidgetRegistry as et, extractPropertyValues as f, BackgroundType as g, AlignOptions as h, WidgetManifest as i, assertDefined as it, RepAppManifest as j, NavigationItem as k, TabConfig as l, isPropertyFieldType as m, buildRemoteWidgetPluginManifests as n, WidgetType as nt, PROPERTY_FIELD_TYPES as o, isWidgetType as ot, groupPropertyFields as p, ThemeColorPlain as q, getRemoteWidgetPackageCategoryId as r, WidgetTypeName as rt, PropertyFieldSchema as s, isWidgetTypeName as st, RemoteWidgetPluginHostOptions as t, WidgetSchema as tt, WidgetPropertySchema as u, BorderRadiusOptions as v, GapOptions as w, ColorOptions as x, BorderWidthOptions as y, RADIUS_KEYS as z };
-//# sourceMappingURL=build-remote-widget-plugin-manifests-CFmLot7p.d.cts.map
+export { WidgetTypeName as $, FONT_FAMILY_KEYS as A, SEMANTIC_COLOR_NAMES as B, sectionLayoutConfig as C, RepAppManifest as D, RepAppData as E, RADIUS_KEYS as F, ThemePayload as G, ThemeColorInput as H, RadiusKey as I, WIDGET_TYPE_NAMES as J, AnyComponent as K, ResolvedColorSet as L, FontFamilyKey as M, FontSizeKey as N, RepAppProfile as O, OklchPlain as P, WidgetType as Q, ResolvedSemanticColor as R, SectionLayoutType as S, NavigationItem as T, ThemeColorPlain as U, SemanticColorName as V, ThemeDefinition as W, WidgetRegistry as X, WidgetPath as Y, WidgetSchema as Z, ColorOptions as _, groupPropertyFields as _t, PortalFunctionErrorCode as a, JsonValue as at, GapOptions as b, PortalFunctionJsonValue as c, WidgetSourcePropertyField as ct, AlignOptions as d, PropertyFieldSchema as dt, assertDefined as et, BackgroundType as f, PropertyFieldType as ft, ButtonSizeOptions as g, extractPropertyValues as gt, BorderWidthOptions as h, applyPropertyValues as ht, PortalFunctionError as i, RemoteWidgetNetworkAccessGrant as it, FONT_SIZE_KEYS as j, ScreenDefinition as k, definePortalFunction as l, WidgetSourcePropertySchema as lt, BorderRadiusOptions as m, WidgetPropertySchema as mt, PortalFunction as n, isWidgetType as nt, PortalFunctionHandler as o, RemoteDomWidgetDefinition as ot, BackgroundValue as p, TabConfig as pt, TypedWidgetSchema as q, PortalFunctionDefinition as r, isWidgetTypeName as rt, PortalFunctionImplementation as s, RemoteDomWidgetPackageDescriptor as st, AnyPortalFunction as t, assertNever as tt, implementPortalFunction as u, PROPERTY_FIELD_TYPES as ut, FontSizeOptions as v, isPropertyFieldType as vt, ShareableItem as w, PaddingOptions as x, FontWeightOptions as y, ResolvedTheme as z };
+//# sourceMappingURL=portal-function-DYWFgeRx.d.cts.map