@fluid-app/fluid-cli-portal 0.1.56 → 0.1.58

package/dist/index.d.mts

@@ -811,8 +811,8 @@ type FluidOsHeyApiClient = Client;
 /**
 * Any valid JSON value for provider, integration, theme, metadata, or other dynamic payloads whose keys are not fixed by the API contract.
 */
-type JsonValue = string | number | boolean | null | Array<JsonValue> | {
-  [key: string]: JsonValue;
+type JsonValue$1 = string | number | boolean | null | Array<JsonValue$1> | {
+  [key: string]: JsonValue$1;
 };
 /**
 * FluidOS::NavigationItem
@@ -884,7 +884,7 @@ type FluidOsProfile = {
 * Dynamic Fluid OS JSON payload whose keys are defined by the app builder configuration.
 */
 type FluidOsDynamicPayload = {
-  [key: string]: JsonValue;
+  [key: string]: JsonValue$1;
 } | null;
 //#endregion
 //#region src/utils/mappings.d.ts
@@ -1039,6 +1039,8 @@ interface ValidationError {
 * Extract the slug from a file path (e.g., "screens/home.json" -> "home").
 */
 declare function slugFromPath(filePath: string): string;
+/** Validate every managed local portal file against the canonical schemas. */
+declare function validatePortalSchemas(portalDir: string): Promise<ValidationError[]>;
 /**
 * Categorize a snapshot diff into resource-type-specific change lists.
 */
@@ -1047,9 +1049,7 @@ declare function categorizeChanges(diff: SnapshotDiff): CategorizedChanges;
 * Validate that all cross-references between local portal files are valid.
 *
 * Checks:
-* - New and changed resources contain the required local-file fields
-* - Every widget node in a changed screen has a string "id" and "type"
-* - New and changed themes include the required config object
+* - Widget IDs remain unique within each changed screen
 * - Navigation items' "screen" slugs reference existing screen files or mappings
 * - Profile "navigation" and "mobile_navigation" slugs reference existing nav files or mappings
 * - Profile "themes" slugs reference existing theme files or mappings
@@ -1273,23 +1273,731 @@ declare const versionCommand: Command;
 //#region src/commands/doctor.d.ts
 declare const doctorCommand: Command;
 //#endregion
-//#region src/utils/transform.d.ts
-type ApiScreen = FluidOsScreen;
-type ApiTheme = FluidOsTheme;
-type ApiNavigationBasic = FluidOsNavigationBasic;
-type ApiNavigationItem = FluidOsNavigationItem;
-type ApiProfile = FluidOsProfile;
-interface LocalScreen {
+//#region ../../portal/definition-schema/src/generated/types.d.ts
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | JsonObject | PortalWidgetNode;
+interface JsonObject {
+  readonly [key: string]: JsonValue;
+}
+type ColorOption = "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+interface PortalDataSourceConfig {
+  readonly sources: JsonObject[];
+  readonly loading?: {
+    readonly showSkeleton?: boolean;
+  };
+  readonly error?: {
+    readonly fallback?: JsonObject;
+    readonly retryCount?: number;
+    readonly retryDelay?: number;
+  };
+}
+interface PortalWidgetNodeBase {
+  readonly id: string;
+  readonly type: string;
+  readonly props: JsonObject;
+  readonly dataSource?: PortalDataSourceConfig;
+  readonly columnIndex?: number;
+}
+interface AlertWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "AlertWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleFontWeight?: "normal" | "medium" | "semibold" | "bold";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    titleAlignment?: "left" | "center" | "right";
+    description?: string;
+    descriptionFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    descriptionFontWeight?: "normal" | "medium" | "semibold" | "bold";
+    descriptionColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    descriptionAlignment?: "left" | "center" | "right";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface BulletListWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "BulletListWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    listType?: "unordered" | "ordered";
+    items?: string[];
+    itemFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    itemColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    gapSize?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
+  };
+}
+interface CalendarWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "CalendarWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    titleText?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    accentColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    showYearEyebrow?: boolean;
+    showTodayButton?: boolean;
+    showEventDensity?: boolean;
+    weekendDim?: boolean;
+  };
+}
+interface CardWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "CardWidget";
+  readonly props: {
+    headerEnabled?: boolean;
+    title?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    headerBackground?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    footerEnabled?: boolean;
+    footerContent?: string;
+    footerColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    footerBackground?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    gapSize?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
+    children?: Array<PortalWidgetNode | null>;
+  };
+}
+interface CarouselWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "CarouselWidget";
+  readonly props: {
+    editorialFrame?: boolean;
+    frameColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    headerSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    headerColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    textSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    align?: {
+      vertical?: "top" | "center" | "bottom";
+      horizontal?: "left" | "center" | "right";
+    };
+    textWidth?: string;
+    carouselHeight?: string;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    overlayEnabled?: boolean;
+    overlayType?: "solid" | "gradient";
+    overlayIntensity?: number;
+    showButton?: boolean;
+    buttonColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    buttonSize?: "sm" | "default" | "lg" | "xl";
+    enableAutoScroll?: boolean;
+    autoScrollInterval?: number;
+    slides?: JsonValue;
+  };
+}
+interface CatchUpWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "CatchUpWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    titleText?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    accentColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    maxItems?: number;
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface ChartWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "ChartWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    description?: string;
+    descriptionFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    descriptionColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    chartType?: "bar" | "line" | "area" | "pie";
+    showLegend?: boolean;
+    showTooltip?: boolean;
+    showGrid?: boolean;
+    width?: string;
+    height?: string;
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    dataKey?: "value";
+    xAxisKey?: "name";
+    data?: JsonValue;
+    chartConfig?: JsonValue;
+  };
+}
+interface ContainerWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "ContainerWidget";
+  readonly props: {
+    gapSize?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    children?: Array<PortalWidgetNode | null>;
+  };
+}
+interface EmbedWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "EmbedWidget";
+  readonly props: {
+    url?: string;
+    title?: string;
+    displayMode?: "inline" | "cover";
+    coverResource?: string | null | JsonObject;
+    coverUseCustomUrl?: boolean;
+    coverImageUrl?: string;
+    coverHeight?: string;
+    coverShowHeader?: boolean;
+    coverHeaderIcon?: "GraduationCap" | "Video" | "BookOpen" | "Globe" | "User" | "Star" | "Heart" | "Trophy" | "Sparkles" | "Zap" | "Gift" | "ShoppingBag" | "Bell" | "Calendar" | "Bookmark";
+    coverHeaderIconColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    coverTitle?: string;
+    coverMeta?: string;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    fullScreen?: boolean;
+    height?: string;
+    allowFullscreen?: boolean;
+    loading?: "lazy" | "eager";
+  };
+}
+interface ImageWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "ImageWidget";
+  readonly props: {
+    resource?: string | null | JsonObject;
+    useCustomUrl?: boolean;
+    src?: string;
+    alt?: string;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    verticalSizing?: "auto" | "fixed";
+    fixedHeight?: string;
+    displayFit?: "cover" | "contain";
+    focusPoint?: string;
+    linkType?: "url" | "screen" | "share";
+    href?: string;
+    openInNewTab?: boolean;
+    screenSlug?: string;
+    shareSource?: "resource" | "url";
+    shareResource?: string | null | JsonObject;
+    shareUrl?: string;
+  };
+}
+interface LayoutWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "LayoutWidget";
+  readonly props: {
+    sectionLayout?: "single-column" | "2c-equal" | "2c-left-wider" | "2c-right-wider" | "2c-left-narrow" | "2c-right-narrow" | "3c-equal" | "3c-middle-wider";
+    gapSize?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    children?: Array<PortalWidgetNode | null>;
+  };
+}
+interface LinkWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "LinkWidget";
+  readonly props: {
+    linkType?: "url" | "screen" | "share";
+    text?: string;
+    href?: string;
+    openInNewTab?: boolean;
+    screenSlug?: string;
+    shareSource?: "resource" | "url";
+    shareResource?: string | null | JsonObject;
+    shareUrl?: string;
+    variant?: "default" | "outline" | "secondary" | "ghost" | "destructive";
+    size?: "sm" | "default" | "lg" | "xl";
+    fontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    underline?: boolean;
+    alignment?: "left" | "center" | "right";
+    fullWidth?: boolean;
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadiusTL?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderRadiusTR?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderRadiusBL?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderRadiusBR?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface ListWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "ListWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    gap?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    listType?: "unordered" | "ordered";
+    maxItems?: number;
+    imageAspectRatio?: "square" | "landscape" | "portrait";
+    showBadge?: boolean;
+    showMetaText?: boolean;
+    columns?: number;
+    scrollAxis?: "horizontal" | "vertical";
+    numberColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    numberSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    itemTitleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    itemTitleSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    descriptionColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    descriptionSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    priceColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    priceSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    originalPriceColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    metaTextColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    metaTextSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    showFeaturedSection?: boolean;
+    featuredAsset?: string | null | JsonObject;
+    featuredTitle?: string;
+    featuredSubtitle?: string;
+    featuredButtonText?: string;
+    featuredButtonUrl?: string;
+    featuredSubtitleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    featuredSubtitleSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    items?: JsonValue;
+  };
+}
+interface MySiteWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "MySiteWidget";
+  readonly props: {
+    showPreview?: boolean;
+    showAnalytics?: boolean;
+    showLiveBadge?: boolean;
+    showQR?: boolean;
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    accentColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+  };
+}
+interface NestedWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "NestedWidget";
+  readonly props: {
+    resource?: string | null | JsonObject;
+    titleEnabled?: boolean;
+    titleText?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    primaryMediaHeight?: string;
+    titleAlignment?: {
+      vertical?: "top" | "center" | "bottom";
+      horizontal?: "left" | "center" | "right";
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    overlayEnabled?: boolean;
+    overlayType?: "solid" | "gradient";
+    overlayIntensity?: number;
+    gap?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
+    nestedTextColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    shareables?: JsonValue;
+  };
+}
+interface PointsWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "PointsWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    balanceColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    historyEnabled?: boolean;
+    historyTitle?: string;
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    accentColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface QuickLinksWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "QuickLinksWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link1Label?: string;
+    link1Url?: string;
+    link1Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link1Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link2Enabled?: boolean;
+    link2Label?: string;
+    link2Url?: string;
+    link2Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link2Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link3Enabled?: boolean;
+    link3Label?: string;
+    link3Url?: string;
+    link3Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link3Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link4Enabled?: boolean;
+    link4Label?: string;
+    link4Url?: string;
+    link4Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link4Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link5Enabled?: boolean;
+    link5Label?: string;
+    link5Url?: string;
+    link5Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link5Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link6Enabled?: boolean;
+    link6Label?: string;
+    link6Url?: string;
+    link6Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link6Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link7Enabled?: boolean;
+    link7Label?: string;
+    link7Url?: string;
+    link7Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link7Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    link8Enabled?: boolean;
+    link8Label?: string;
+    link8Url?: string;
+    link8Icon?: "Link" | "User" | "Share2" | "ShoppingBag" | "Video" | "Mail" | "MessageCircle" | "Globe" | "Calendar" | "Bell" | "Heart" | "Star" | "Zap" | "Gift" | "Phone" | "MapPin" | "Play" | "Package" | "ExternalLink" | "Bookmark" | "Trophy" | "Sparkles";
+    link8Color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    layout?: "cards" | "list";
+    iconRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    showChevron?: boolean;
+    openInNewTab?: boolean;
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface QuickShareWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "QuickShareWidget";
+  readonly props: {
+    shareableResource?: string | null | JsonObject;
+    titleEnabled?: boolean;
+    titleText?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    showResourceType?: boolean;
+    showShareActions?: boolean;
+    showDomainPrefix?: boolean;
+    showBuyButton?: boolean;
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    accentColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    overlayEnabled?: boolean;
+    overlayType?: "gradient" | "solid";
+    overlayIntensity?: number;
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface RecentActivityWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "RecentActivityWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    titleText?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    showEyebrow?: boolean;
+    showCountChip?: boolean;
+    maxItemsToShow?: number;
+    showRelativeTime?: boolean;
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    accentColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface SeparatorWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "SeparatorWidget";
+  readonly props: {
+    orientation?: "horizontal" | "vertical";
+    color?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    thickness?: string;
+    width?: string;
+    marginTop?: 0 | 2 | 4 | 6 | 8 | 10;
+    marginBottom?: 0 | 2 | 4 | 6 | 8 | 10;
+  };
+}
+interface ShopWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "ShopWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    showSearch?: boolean;
+    showSort?: boolean;
+    columns?: 2 | 3 | 4 | 5 | 6;
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    cardBackground?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    cardTextColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    useDataSource?: boolean;
+    pageSize?: number;
+    products?: JsonValue;
+  };
+}
+interface SpacerWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "SpacerWidget";
+  readonly props: {
+    customHeight?: string;
+  };
+}
+interface TableWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "TableWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    titleText?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    alternatingColorEnabled?: boolean;
+    headerBackgroundColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    headerTextColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    filterEnabled?: boolean;
+    sortingEnabled?: boolean;
+    paginationEnabled?: boolean;
+    maxRowsPerPage?: number;
+    data?: JsonValue;
+    columns?: JsonValue;
+  };
+}
+interface TextWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "TextWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    title?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleFontWeight?: "normal" | "medium" | "semibold" | "bold";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    titleAlignment?: "left" | "center" | "right";
+    description?: string;
+    descriptionFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    descriptionFontWeight?: "normal" | "medium" | "semibold" | "bold";
+    descriptionColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    descriptionAlignment?: "left" | "center" | "right";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface ToDoWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "ToDoWidget";
+  readonly props: {
+    titleEnabled?: boolean;
+    titleText?: string;
+    titleFontSize?: "2xl" | "xl" | "lg" | "md" | "sm" | "xs";
+    titleColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    background?: string | {
+      type: "solid" | "image";
+      color?: ColorOption;
+      resource?: string | null | JsonObject;
+    };
+    textColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    accentColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    maxItems?: number;
+    padding?: 0 | 2 | 4 | 6 | 8 | 10;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+  };
+}
+interface VideoWidgetNode extends PortalWidgetNodeBase {
+  readonly type: "VideoWidget";
+  readonly props: {
+    resource?: string | null | JsonObject;
+    useCustomUrl?: boolean;
+    src?: string;
+    poster?: string;
+    displayMode?: "inline" | "card";
+    title?: string;
+    tagline?: string;
+    eyebrow?: string;
+    tag?: string;
+    duration?: string;
+    author?: string;
+    date?: string;
+    editorialFrame?: boolean;
+    frameColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    showFullscreenPill?: boolean;
+    primaryCtaText?: string;
+    primaryCtaLink?: string;
+    secondaryCtaText?: string;
+    secondaryCtaLink?: string;
+    borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    borderWidth?: "none" | "thin" | "medium" | "thick";
+    borderColor?: "background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "border" | "destructive" | "transparent";
+    verticalSizing?: "auto" | "fixed";
+    fixedHeight?: string;
+    displayFit?: "cover" | "contain";
+    focusPoint?: string;
+    controls?: boolean;
+    autoplay?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+  };
+}
+type PortalBuiltinWidgetNode = AlertWidgetNode | BulletListWidgetNode | CalendarWidgetNode | CardWidgetNode | CarouselWidgetNode | CatchUpWidgetNode | ChartWidgetNode | ContainerWidgetNode | EmbedWidgetNode | ImageWidgetNode | LayoutWidgetNode | LinkWidgetNode | ListWidgetNode | MySiteWidgetNode | NestedWidgetNode | PointsWidgetNode | QuickLinksWidgetNode | QuickShareWidgetNode | RecentActivityWidgetNode | SeparatorWidgetNode | ShopWidgetNode | SpacerWidgetNode | TableWidgetNode | TextWidgetNode | ToDoWidgetNode | VideoWidgetNode;
+interface PortalThirdPartyWidgetNode extends PortalWidgetNodeBase {
+  readonly type: `company.${string}.${string}` | `droplet.${string}.${string}`;
+  readonly props: JsonObject;
+}
+type PortalWidgetNode = PortalBuiltinWidgetNode | PortalThirdPartyWidgetNode;
+interface PortalScreen {
+  readonly $schema?: string;
   readonly name: string;
-  readonly component_tree: Record<string, unknown>[];
+  readonly component_tree: PortalWidgetNode[];
 }
-interface LocalTheme {
+interface PortalThemeColor {
+  readonly base: {
+    readonly l: number;
+    readonly c: number;
+    readonly h: number;
+  };
+  readonly foreground: {
+    readonly l: number;
+    readonly c: number;
+    readonly h: number;
+  };
+}
+interface PortalThemeConfig {
+  readonly id: string;
   readonly name: string;
-  readonly config: Record<string, unknown>;
+  readonly light: Readonly<Record<"background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "destructive", PortalThemeColor>>;
+  readonly dark: Readonly<Partial<Record<"background" | "foreground" | "primary" | "secondary" | "accent" | "muted" | "destructive", {
+    readonly base?: PortalThemeColor["base"];
+    readonly foreground?: PortalThemeColor["foreground"];
+  }>>>;
+  readonly fontSizes: Readonly<Record<"extraSmall" | "small" | "regular" | "large" | "extraLarge" | "giant", string>>;
+  readonly fontFamilies: Readonly<Record<"header" | "body", string>>;
+  readonly spacing: string;
+  readonly radii: Readonly<Record<"small" | "medium" | "large" | "extraLarge", string>>;
+  readonly syncWithBrandColors?: boolean;
+}
+interface PortalTheme {
+  readonly $schema?: string;
+  readonly name: string;
+  readonly config: PortalThemeConfig;
   readonly active: boolean;
 }
-interface LocalNavigationItem {
-  /** Server-owned sync identity. New draft items omit it until push. */
+interface PortalNavigationItem {
   readonly id?: number;
   readonly icon: string | null;
   readonly label: string | null;
@@ -1298,14 +2006,16 @@ interface LocalNavigationItem {
   readonly source: string;
   readonly position: number | null;
   readonly parent_id: number | null;
-  readonly children: LocalNavigationItem[];
+  readonly children: PortalNavigationItem[];
 }
-interface LocalNavigation {
+interface PortalNavigation {
+  readonly $schema?: string;
   readonly name: string;
-  readonly platform: string;
-  readonly navigation_items: LocalNavigationItem[];
+  readonly platform: "web" | "mobile";
+  readonly navigation_items: PortalNavigationItem[];
 }
-interface LocalProfile {
+interface PortalProfile {
+  readonly $schema?: string;
   readonly name: string;
   readonly default: boolean;
   readonly navigation: string | null;
@@ -1318,6 +2028,18 @@ interface LocalProfile {
     readonly countries: number[];
   };
 }
+//#endregion
+//#region src/utils/transform.d.ts
+type ApiScreen = FluidOsScreen;
+type ApiTheme = FluidOsTheme;
+type ApiNavigationBasic = FluidOsNavigationBasic;
+type ApiNavigationItem = FluidOsNavigationItem;
+type ApiProfile = FluidOsProfile;
+type LocalScreen = PortalScreen;
+type LocalTheme = PortalTheme;
+type LocalNavigationItem = PortalNavigationItem;
+type LocalNavigation = PortalNavigation;
+type LocalProfile = PortalProfile;
 /**
 * Transform an API screen response into the local file format.
 * Strips server-only fields and normalizes `component_tree` to always be an array.
@@ -1330,7 +2052,8 @@ declare function transformScreen(screen: ApiScreen): LocalScreen;
 declare function deriveScreenSlug(screen: ApiScreen, existingSlugs: Set<string>): string;
 /**
 * Transform an API theme response into the local file format.
-* Passes theme config through as-is (hex conversion is a separate ticket).
+* Normalizes both legacy flat and structured API configs to the current
+* structured theme payload.
 */
 declare function transformTheme(theme: ApiTheme): LocalTheme;
 /**
@@ -1363,5 +2086,5 @@ declare function transformProfile(profile: ApiProfile, navIdToSlug: Map<number,
 //#region src/index.d.ts
 declare const plugin: FluidPlugin;
 //#endregion
-export { type BuildOptions, CANONICAL_PROJECT_NAME, type CategorizedChanges, type CompanyPackagePreflight, type CompanyWidgetPackage, type ConfiguredWidgetPackage, type CreateOptions, type CreatePortalGitCredentialOptions, type CreatePortalProjectDependencies, type DefinitionMapping, type DevOptions, FILE_SYSTEM_ERRORS, type FileHash, type FileHashMap, type FileSystemError, type FileSystemErrorCode, type GitCredentialOutcome, GitError, type LocalNavigation, type LocalNavigationItem, type LocalProfile, type LocalScreen, type LocalTheme, type MappedResourceType, type PortalDeployOptions, type PortalGitCredential, type PortalGitSyncOptions, type PortalGitSyncResult, type PortalMappings, type ProjectConfig, type PublishWidgetRuntimeArtifactsOptions, type ScaffoldFromGitHubOptions, type SelectedPageTemplate, type Snapshot, type SnapshotDiff, TEMPLATES, TEMPLATE_REPO_URL, type TemplateName, type TemplatePaths, type TemplateVariables, type ValidationError, type WidgetCreateOptions, type WidgetPublishOptions, buildIdToSlugMap, buildNavigationIdToSlugMap, buildSnapshot, buildThemeIdToSlugMap, categorizeChanges, cloneCommand, computeFileHash, copyTemplate, copyTemplateSafe, createCommand, createDirectory, createDirectorySafe, createPortalGitCredential, createPortalProject, plugin as default, deployCommand, deriveScreenSlug, deriveSlug, diffAgainstSnapshot, directoryExists, doctorCommand, ensureGitAvailable, fileExists, formatPackageKeyMismatch, getInstallCommand, getOriginUrl, getRunCommand, getSdkVersion, getSdkVersionSafe, getTemplatePaths, gitAheadBehindVsFetchHead, gitAutoCommit, gitClone, gitFetch, gitInit, gitMergeFastForward, gitMissingError, gitPush, hasUncommittedChanges, installDependencies, isGitAvailable, isGitRepo, pathExists, portalGitCredentialPath, preflightCompanyPackage, promptProjectConfig, publishWidgetRuntimeArtifacts, pullCommand, pushCommand, readCompanyWidgetPackage, readFileSafe, readMappings, readSnapshot, removeMapping, resolveIdToSlug, resolvePublishVersion, resolveSlugToId, rewriteProjectName, runPackageManager, runPortalGitSync, scaffoldFromGitHub, slugFromPath, topLevelWidgetCommand, transformNavigation, transformNavigationItems, transformProfile, transformScreen, transformTheme, updateMapping, validateCrossReferences, versionCommand, widgetCommand, writeFileSafe, writeFluidrcProfile, writeMappings, writeSnapshot };
+export { type BuildOptions, CANONICAL_PROJECT_NAME, type CategorizedChanges, type CompanyPackagePreflight, type CompanyWidgetPackage, type ConfiguredWidgetPackage, type CreateOptions, type CreatePortalGitCredentialOptions, type CreatePortalProjectDependencies, type DefinitionMapping, type DevOptions, FILE_SYSTEM_ERRORS, type FileHash, type FileHashMap, type FileSystemError, type FileSystemErrorCode, type GitCredentialOutcome, GitError, type LocalNavigation, type LocalNavigationItem, type LocalProfile, type LocalScreen, type LocalTheme, type MappedResourceType, type PortalDeployOptions, type PortalGitCredential, type PortalGitSyncOptions, type PortalGitSyncResult, type PortalMappings, type ProjectConfig, type PublishWidgetRuntimeArtifactsOptions, type ScaffoldFromGitHubOptions, type SelectedPageTemplate, type Snapshot, type SnapshotDiff, TEMPLATES, TEMPLATE_REPO_URL, type TemplateName, type TemplatePaths, type TemplateVariables, type ValidationError, type WidgetCreateOptions, type WidgetPublishOptions, buildIdToSlugMap, buildNavigationIdToSlugMap, buildSnapshot, buildThemeIdToSlugMap, categorizeChanges, cloneCommand, computeFileHash, copyTemplate, copyTemplateSafe, createCommand, createDirectory, createDirectorySafe, createPortalGitCredential, createPortalProject, plugin as default, deployCommand, deriveScreenSlug, deriveSlug, diffAgainstSnapshot, directoryExists, doctorCommand, ensureGitAvailable, fileExists, formatPackageKeyMismatch, getInstallCommand, getOriginUrl, getRunCommand, getSdkVersion, getSdkVersionSafe, getTemplatePaths, gitAheadBehindVsFetchHead, gitAutoCommit, gitClone, gitFetch, gitInit, gitMergeFastForward, gitMissingError, gitPush, hasUncommittedChanges, installDependencies, isGitAvailable, isGitRepo, pathExists, portalGitCredentialPath, preflightCompanyPackage, promptProjectConfig, publishWidgetRuntimeArtifacts, pullCommand, pushCommand, readCompanyWidgetPackage, readFileSafe, readMappings, readSnapshot, removeMapping, resolveIdToSlug, resolvePublishVersion, resolveSlugToId, rewriteProjectName, runPackageManager, runPortalGitSync, scaffoldFromGitHub, slugFromPath, topLevelWidgetCommand, transformNavigation, transformNavigationItems, transformProfile, transformScreen, transformTheme, updateMapping, validateCrossReferences, validatePortalSchemas, versionCommand, widgetCommand, writeFileSafe, writeFluidrcProfile, writeMappings, writeSnapshot };
 //# sourceMappingURL=index.d.mts.map