@fluid-app/rep-core 0.1.3 → 0.1.5

package/dist/registries/index.d.cts

@@ -3,6 +3,7 @@ import { StrictOmit, AlignOptions, ColorOptions, SectionLayoutType, FontSizeOpti
 import { b as WidgetType, W as WidgetSchema } from '../widget-schema-36uGUTWL.cjs';
 import '../types-R1kV_DKF.cjs';
 import 'colorjs.io';
+import '@fluid-app/fluidos-api-client';
 import '../shareable-item-DkgWpwoU.cjs';
 import 'react';
 import '../data-sources/types.cjs';

package/dist/registries/index.d.ts

@@ -3,6 +3,7 @@ import { StrictOmit, AlignOptions, ColorOptions, SectionLayoutType, FontSizeOpti
 import { b as WidgetType, W as WidgetSchema } from '../widget-schema-DxdlJD8E.js';
 import '../types-R1kV_DKF.js';
 import 'colorjs.io';
+import '@fluid-app/fluidos-api-client';
 import '../shareable-item-DkgWpwoU.js';
 import 'react';
 import '../data-sources/types.js';

package/dist/types/index.d.cts

@@ -2,31 +2,48 @@ import { W as WidgetSchema } from '../widget-schema-36uGUTWL.cjs';
 export { T as TypedWidgetSchema, e as WIDGET_TYPE_NAMES, a as WidgetPath, d as WidgetRegistry, b as WidgetType, c as WidgetTypeName, h as assertDefined, g as assertNever, f as isWidgetType, i as isWidgetTypeName } from '../widget-schema-36uGUTWL.cjs';
 import { T as ThemeDefinition } from '../types-R1kV_DKF.cjs';
 export { R as ResolvedTheme, a as ThemeColorInput, b as ThemePayload } from '../types-R1kV_DKF.cjs';
+import { components } from '@fluid-app/fluidos-api-client';
 import { S as ShareableItem } from '../shareable-item-DkgWpwoU.cjs';
 import 'react';
 import '../data-sources/types.cjs';
 import 'colorjs.io';
 
+/** The API schema type — single source of truth for navigation item fields. */
+type ApiNavigationItem = components["schemas"]["FluidOSNavigationItem"];
 /**
- * Navigation item in the sidebar/menu structure
+ * Strip `null` from a union type, converting `T | null` → `T`.
+ * Used to convert API's null convention to rep-core's undefined convention.
+ */
+type StripNull<T> = Exclude<T, null>;
+/**
+ * Navigation item in the sidebar/menu structure.
+ *
+ * Derived from `FluidOSNavigationItem` (the API schema) so field types
+ * track upstream changes. Differences from the 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 NavigationItem {
-    /** Database-generated identifier */
-    readonly id?: number;
+    /** Database-generated identifier — optional because system/default items may not have one */
+    readonly id?: ApiNavigationItem["id"];
     /** URL slug for routing */
-    slug?: string;
-    /** Display label */
+    slug?: StripNull<ApiNavigationItem["slug"]>;
+    /** Display label — required; transforms default null API values to "Untitled" */
     label: string;
     /** Icon identifier (e.g., FontAwesome name) */
-    icon?: string;
-    /** Section grouping for quick links (e.g., "User", "Shareables") */
+    icon?: StripNull<ApiNavigationItem["icon"]>;
+    /** Section grouping for quick links (frontend-only, not in API) */
     section?: string;
     /** Associated screen ID */
-    screen_id?: number;
+    screen_id?: StripNull<ApiNavigationItem["screen_id"]>;
     /** Sort order */
-    position?: number;
+    position?: StripNull<ApiNavigationItem["position"]>;
     /** Parent navigation item ID (null for root items) */
-    parent_id?: number | null;
+    parent_id?: ApiNavigationItem["parent_id"];
+    /** Origin of this navigation item */
+    source?: ApiNavigationItem["source"];
     /** Nested navigation items */
     children: NavigationItem[];
 }

package/dist/types/index.d.ts

@@ -2,31 +2,48 @@ import { W as WidgetSchema } from '../widget-schema-DxdlJD8E.js';
 export { T as TypedWidgetSchema, e as WIDGET_TYPE_NAMES, a as WidgetPath, d as WidgetRegistry, b as WidgetType, c as WidgetTypeName, h as assertDefined, g as assertNever, f as isWidgetType, i as isWidgetTypeName } from '../widget-schema-DxdlJD8E.js';
 import { T as ThemeDefinition } from '../types-R1kV_DKF.js';
 export { R as ResolvedTheme, a as ThemeColorInput, b as ThemePayload } from '../types-R1kV_DKF.js';
+import { components } from '@fluid-app/fluidos-api-client';
 import { S as ShareableItem } from '../shareable-item-DkgWpwoU.js';
 import 'react';
 import '../data-sources/types.js';
 import 'colorjs.io';
 
+/** The API schema type — single source of truth for navigation item fields. */
+type ApiNavigationItem = components["schemas"]["FluidOSNavigationItem"];
 /**
- * Navigation item in the sidebar/menu structure
+ * Strip `null` from a union type, converting `T | null` → `T`.
+ * Used to convert API's null convention to rep-core's undefined convention.
+ */
+type StripNull<T> = Exclude<T, null>;
+/**
+ * Navigation item in the sidebar/menu structure.
+ *
+ * Derived from `FluidOSNavigationItem` (the API schema) so field types
+ * track upstream changes. Differences from the 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 NavigationItem {
-    /** Database-generated identifier */
-    readonly id?: number;
+    /** Database-generated identifier — optional because system/default items may not have one */
+    readonly id?: ApiNavigationItem["id"];
     /** URL slug for routing */
-    slug?: string;
-    /** Display label */
+    slug?: StripNull<ApiNavigationItem["slug"]>;
+    /** Display label — required; transforms default null API values to "Untitled" */
     label: string;
     /** Icon identifier (e.g., FontAwesome name) */
-    icon?: string;
-    /** Section grouping for quick links (e.g., "User", "Shareables") */
+    icon?: StripNull<ApiNavigationItem["icon"]>;
+    /** Section grouping for quick links (frontend-only, not in API) */
     section?: string;
     /** Associated screen ID */
-    screen_id?: number;
+    screen_id?: StripNull<ApiNavigationItem["screen_id"]>;
     /** Sort order */
-    position?: number;
+    position?: StripNull<ApiNavigationItem["position"]>;
     /** Parent navigation item ID (null for root items) */
-    parent_id?: number | null;
+    parent_id?: ApiNavigationItem["parent_id"];
+    /** Origin of this navigation item */
+    source?: ApiNavigationItem["source"];
     /** Nested navigation items */
     children: NavigationItem[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluid-app/rep-core",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Core types, theme engine, and widget utilities for the Fluid rep platform",
   "type": "module",
   "exports": {
@@ -155,7 +155,8 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "colorjs.io": "^0.5.2",
-    "tailwind-merge": "^3.0.2"
+    "tailwind-merge": "^3.0.2",
+    "@fluid-app/fluidos-api-client": "0.1.0"
   },
   "scripts": {
     "build": "tsup",