skedyul 0.2.18 → 0.2.20

package/dist/.build-stamp

@@ -1 +1 @@
-1769309135803
+1769314034571

package/dist/config.d.ts

@@ -456,14 +456,24 @@ export interface ListBlockDefinition {
 export type PageBlockDefinition = CardBlockDefinition | LegacyFormBlockDefinition | ListBlockDefinition;
 /** Mode for context data fetching */
 export type PageContextMode = 'first' | 'many' | 'count';
+/**
+ * Page context filters using structured format.
+ * Format: { fieldHandle: { operator: value } }
+ * Values can be Liquid template strings, e.g., { id: { eq: '{{ path_params.id }}' } }
+ */
+export type PageContextFilters = Record<string, Record<string, string | number | boolean | (string | number | boolean)[]>>;
 /** Single context item definition */
 export interface PageContextItemDefinition {
     /** Model handle to fetch data from */
     model: string;
     /** Fetch mode: 'first' returns single object, 'many' returns array, 'count' returns number */
     mode: PageContextMode;
-    /** Optional filters using StructuredFilter format */
-    filters?: StructuredFilter;
+    /**
+     * Optional filters. Supports:
+     * - Simple key-value with Liquid templates: { id: '{{ path_params.id }}' }
+     * - StructuredFilter format: { status: { eq: 'APPROVED' } }
+     */
+    filters?: PageContextFilters;
     /** Optional limit for 'many' mode */
     limit?: number;
 }
@@ -474,13 +484,58 @@ export interface PageInstanceFilter {
     model: string;
     where?: Record<string, unknown>;
 }
+/** Navigation item for sidebar */
+export interface NavigationItem {
+    /** Display label (supports Liquid templates) */
+    label: string;
+    /** URL href (supports Liquid templates with path_params and context) */
+    href: string;
+    /** Optional icon name */
+    icon?: string;
+}
+/** Navigation section with title and items */
+export interface NavigationSection {
+    /** Section title (supports Liquid templates) */
+    title?: string;
+    /** Navigation items in this section */
+    items: NavigationItem[];
+}
+/** Sidebar navigation configuration */
+export interface NavigationSidebar {
+    /** Sections to display in the sidebar */
+    sections: NavigationSection[];
+}
+/** Breadcrumb item */
+export interface BreadcrumbItem {
+    /** Display label (supports Liquid templates) */
+    label: string;
+    /** Optional href - if not provided, item is not clickable */
+    href?: string;
+}
+/** Breadcrumb navigation configuration */
+export interface NavigationBreadcrumb {
+    /** Breadcrumb items from left to right */
+    items: BreadcrumbItem[];
+}
+/** Full navigation configuration */
+export interface NavigationConfig {
+    /** Sidebar navigation */
+    sidebar?: NavigationSidebar;
+    /** Breadcrumb navigation */
+    breadcrumb?: NavigationBreadcrumb;
+}
 export interface PageDefinition {
-    handle: string;
     type: PageType;
     title: string;
-    path?: string;
-    /** Whether to show in navigation - boolean or Liquid template string */
-    navigation?: boolean | string;
+    /** URL path for this page (e.g., '/phone-numbers' or '/phone-numbers/[id]' for dynamic segments) */
+    path: string;
+    /**
+     * Navigation configuration:
+     * - true/false: show/hide in auto-generated navigation
+     * - string: Liquid template that evaluates to true/false
+     * - NavigationConfig: full navigation override for this page (replaces base navigation)
+     */
+    navigation?: boolean | string | NavigationConfig;
     blocks: PageBlockDefinition[];
     actions?: PageActionDefinition[];
     /** Context data to load for Liquid templates. appInstallationId filtering is automatic. */
@@ -544,6 +599,8 @@ export interface ProvisionConfig {
     channels?: ChannelDefinition[];
     /** Workflow definitions */
     workflows?: WorkflowDefinition[];
+    /** Base navigation configuration for all pages (can be overridden per page) */
+    navigation?: NavigationConfig;
     /** Page definitions for app UI */
     pages?: PageDefinition[];
     /** Webhook handler names to auto-register at provision level */

package/dist/index.d.ts

@@ -10,4 +10,4 @@ declare const _default: {
 };
 export default _default;
 export { defineConfig, loadConfig, validateConfig, CONFIG_FILE_NAMES, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
-export type { SkedyulConfig, SerializableSkedyulConfig, EnvVariableDefinition, EnvSchema, EnvVisibility, ComputeLayerType, InstallHandlerContext, InstallHandlerResult, InstallHandler, ModelDefinition, ModelFieldDefinition, ResourceScope, FieldOwner, InternalFieldDataType, FieldOption, InlineFieldDefinition, AppFieldVisibility, RelationshipDefinition, RelationshipLink, RelationshipCardinality, OnDeleteBehavior, ChannelDefinition, ChannelToolBindings, WorkflowDefinition, WorkflowAction, WorkflowActionInput, PageDefinition, PageBlockDefinition, PageFieldDefinition, PageActionDefinition, PageType, PageBlockType, PageFieldType, PageFieldSource, PageFormHeader, PageContextMode, PageContextItemDefinition, PageContextDefinition, PageInstanceFilter, WebhookHttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ProvisionConfig, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, StructuredFilter, } from './config';
+export type { SkedyulConfig, SerializableSkedyulConfig, EnvVariableDefinition, EnvSchema, EnvVisibility, ComputeLayerType, InstallHandlerContext, InstallHandlerResult, InstallHandler, ModelDefinition, ModelFieldDefinition, ResourceScope, FieldOwner, InternalFieldDataType, FieldOption, InlineFieldDefinition, AppFieldVisibility, RelationshipDefinition, RelationshipLink, RelationshipCardinality, OnDeleteBehavior, ChannelDefinition, ChannelToolBindings, WorkflowDefinition, WorkflowAction, WorkflowActionInput, PageDefinition, PageBlockDefinition, PageFieldDefinition, PageActionDefinition, PageType, PageBlockType, PageFieldType, PageFieldSource, PageFormHeader, PageContextMode, PageContextItemDefinition, PageContextDefinition, PageInstanceFilter, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, WebhookHttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ProvisionConfig, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, StructuredFilter, } from './config';

package/dist/schemas.d.ts

@@ -2063,6 +2063,12 @@ export declare const PageContextModeSchema: z.ZodEnum<{
     many: "many";
     count: "count";
 }>;
+/**
+ * Page context filters schema.
+ * Uses structured filter format: { fieldHandle: { operator: value } }
+ * Values can be Liquid template strings, e.g., { id: { eq: '{{ path_params.id }}' } }
+ */
+export declare const PageContextFiltersSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodString]>>>;
 /** Single context item definition */
 export declare const PageContextItemDefinitionSchema: z.ZodObject<{
     model: z.ZodString;
@@ -2071,7 +2077,7 @@ export declare const PageContextItemDefinitionSchema: z.ZodObject<{
         many: "many";
         count: "count";
     }>;
-    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodString]>>>>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** Context definition: variable name -> context item */
@@ -2082,7 +2088,7 @@ export declare const PageContextDefinitionSchema: z.ZodRecord<z.ZodString, z.Zod
         many: "many";
         count: "count";
     }>;
-    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodString]>>>>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
 /** @deprecated Use PageContextDefinitionSchema instead */
@@ -2090,15 +2096,88 @@ export declare const PageInstanceFilterSchema: z.ZodObject<{
     model: z.ZodString;
     where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
+/** Navigation item for sidebar */
+export declare const NavigationItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Navigation section with title and items */
+export declare const NavigationSectionSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Sidebar navigation configuration */
+export declare const NavigationSidebarSchema: z.ZodObject<{
+    sections: z.ZodArray<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Breadcrumb item */
+export declare const BreadcrumbItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Breadcrumb navigation configuration */
+export declare const NavigationBreadcrumbSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Full navigation configuration */
+export declare const NavigationConfigSchema: z.ZodObject<{
+    sidebar: z.ZodOptional<z.ZodObject<{
+        sections: z.ZodArray<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+                icon: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    breadcrumb: z.ZodOptional<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const PageDefinitionSchema: z.ZodObject<{
-    handle: z.ZodString;
     type: z.ZodEnum<{
         INSTANCE: "INSTANCE";
         LIST: "LIST";
     }>;
     title: z.ZodString;
-    path: z.ZodOptional<z.ZodString>;
-    navigation: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    path: z.ZodString;
+    navigation: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString, z.ZodObject<{
+        sidebar: z.ZodOptional<z.ZodObject<{
+            sections: z.ZodArray<z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodString;
+                    icon: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        breadcrumb: z.ZodOptional<z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>>;
     blocks: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"card">;
         restructurable: z.ZodOptional<z.ZodBoolean>;
@@ -2467,7 +2546,7 @@ export declare const PageDefinitionSchema: z.ZodObject<{
             many: "many";
             count: "count";
         }>;
-        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodString]>>>>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
     filter: z.ZodOptional<z.ZodObject<{
@@ -2666,15 +2745,49 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
             }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    navigation: z.ZodOptional<z.ZodObject<{
+        sidebar: z.ZodOptional<z.ZodObject<{
+            sections: z.ZodArray<z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodString;
+                    icon: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        breadcrumb: z.ZodOptional<z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        handle: z.ZodString;
         type: z.ZodEnum<{
             INSTANCE: "INSTANCE";
             LIST: "LIST";
         }>;
         title: z.ZodString;
-        path: z.ZodOptional<z.ZodString>;
-        navigation: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+        path: z.ZodString;
+        navigation: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString, z.ZodObject<{
+            sidebar: z.ZodOptional<z.ZodObject<{
+                sections: z.ZodArray<z.ZodObject<{
+                    title: z.ZodOptional<z.ZodString>;
+                    items: z.ZodArray<z.ZodObject<{
+                        label: z.ZodString;
+                        href: z.ZodString;
+                        icon: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            breadcrumb: z.ZodOptional<z.ZodObject<{
+                items: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>>;
         blocks: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             type: z.ZodLiteral<"card">;
             restructurable: z.ZodOptional<z.ZodBoolean>;
@@ -3043,7 +3156,7 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                 many: "many";
                 count: "count";
             }>;
-            filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
+            filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodString]>>>>;
             limit: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         filter: z.ZodOptional<z.ZodObject<{
@@ -3225,15 +3338,49 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        navigation: z.ZodOptional<z.ZodObject<{
+            sidebar: z.ZodOptional<z.ZodObject<{
+                sections: z.ZodArray<z.ZodObject<{
+                    title: z.ZodOptional<z.ZodString>;
+                    items: z.ZodArray<z.ZodObject<{
+                        label: z.ZodString;
+                        href: z.ZodString;
+                        icon: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            breadcrumb: z.ZodOptional<z.ZodObject<{
+                items: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            handle: z.ZodString;
             type: z.ZodEnum<{
                 INSTANCE: "INSTANCE";
                 LIST: "LIST";
             }>;
             title: z.ZodString;
-            path: z.ZodOptional<z.ZodString>;
-            navigation: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+            path: z.ZodString;
+            navigation: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString, z.ZodObject<{
+                sidebar: z.ZodOptional<z.ZodObject<{
+                    sections: z.ZodArray<z.ZodObject<{
+                        title: z.ZodOptional<z.ZodString>;
+                        items: z.ZodArray<z.ZodObject<{
+                            label: z.ZodString;
+                            href: z.ZodString;
+                            icon: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                breadcrumb: z.ZodOptional<z.ZodObject<{
+                    items: z.ZodArray<z.ZodObject<{
+                        label: z.ZodString;
+                        href: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>>;
             blocks: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
                 type: z.ZodLiteral<"card">;
                 restructurable: z.ZodOptional<z.ZodBoolean>;
@@ -3602,7 +3749,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                     many: "many";
                     count: "count";
                 }>;
-                filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
+                filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodString]>>>>;
                 limit: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             filter: z.ZodOptional<z.ZodObject<{
@@ -3631,10 +3778,17 @@ export type PageFieldSource = z.infer<typeof PageFieldSourceSchema>;
 export type PageActionDefinition = z.infer<typeof PageActionDefinitionSchema>;
 export type PageBlockDefinition = z.infer<typeof PageBlockDefinitionSchema>;
 export type PageContextMode = z.infer<typeof PageContextModeSchema>;
+export type PageContextFilters = z.infer<typeof PageContextFiltersSchema>;
 export type PageContextItemDefinition = z.infer<typeof PageContextItemDefinitionSchema>;
 export type PageContextDefinition = z.infer<typeof PageContextDefinitionSchema>;
 /** @deprecated Use PageContextDefinition instead */
 export type PageInstanceFilter = z.infer<typeof PageInstanceFilterSchema>;
+export type NavigationItem = z.infer<typeof NavigationItemSchema>;
+export type NavigationSection = z.infer<typeof NavigationSectionSchema>;
+export type NavigationSidebar = z.infer<typeof NavigationSidebarSchema>;
+export type BreadcrumbItem = z.infer<typeof BreadcrumbItemSchema>;
+export type NavigationBreadcrumb = z.infer<typeof NavigationBreadcrumbSchema>;
+export type NavigationConfig = z.infer<typeof NavigationConfigSchema>;
 export type PageDefinition = z.infer<typeof PageDefinitionSchema>;
 export type ModelDependency = z.infer<typeof ModelDependencySchema>;
 export type ChannelDependency = z.infer<typeof ChannelDependencySchema>;

package/dist/schemas.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmptyFormComponentDefinitionSchema = exports.ListComponentDefinitionSchema = exports.ListItemTemplateSchema = exports.FileSettingComponentDefinitionSchema = exports.ImageSettingComponentDefinitionSchema = exports.TimePickerComponentDefinitionSchema = exports.DatePickerComponentDefinitionSchema = exports.CheckboxComponentDefinitionSchema = exports.ComboboxComponentDefinitionSchema = exports.SelectComponentDefinitionSchema = exports.TextareaComponentDefinitionSchema = exports.InputComponentDefinitionSchema = exports.FormLayoutConfigDefinitionSchema = exports.FormLayoutRowDefinitionSchema = exports.FormLayoutColumnDefinitionSchema = exports.RelationshipExtensionSchema = exports.FieldSettingButtonPropsSchema = exports.FormV2StylePropsSchema = exports.PageActionDefinitionSchema = exports.PageFormHeaderSchema = exports.PageFieldSourceSchema = exports.PageFieldTypeSchema = exports.PageBlockTypeSchema = exports.PageTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.ChannelDefinitionSchema = exports.ChannelToolBindingsSchema = exports.RelationshipDefinitionSchema = exports.RelationshipLinkSchema = exports.OnDeleteBehaviorSchema = exports.RelationshipCardinalitySchema = exports.ModelDefinitionSchema = exports.ModelFieldDefinitionSchema = exports.AppFieldVisibilitySchema = exports.InlineFieldDefinitionSchema = exports.FieldOptionSchema = exports.FieldDataTypeSchema = exports.ResourceDependencySchema = exports.WorkflowDependencySchema = exports.ChannelDependencySchema = exports.ModelDependencySchema = exports.StructuredFilterSchema = exports.FieldOwnerSchema = exports.ResourceScopeSchema = exports.ComputeLayerTypeSchema = exports.EnvSchemaSchema = exports.EnvVariableDefinitionSchema = exports.EnvVisibilitySchema = void 0;
-exports.SkedyulConfigSchema = exports.ProvisionConfigSchema = exports.WebhooksSchema = exports.WebhookHandlerDefinitionSchema = exports.WebhookHttpMethodSchema = exports.PageDefinitionSchema = exports.PageInstanceFilterSchema = exports.PageContextDefinitionSchema = exports.PageContextItemDefinitionSchema = exports.PageContextModeSchema = exports.PageBlockDefinitionSchema = exports.ListBlockDefinitionSchema = exports.LegacyFormBlockDefinitionSchema = exports.PageFieldDefinitionSchema = exports.CardBlockDefinitionSchema = exports.CardBlockHeaderSchema = exports.FormV2PropsDefinitionSchema = exports.FormV2ComponentDefinitionSchema = exports.FieldSettingComponentDefinitionSchema = exports.ModalFormDefinitionSchema = exports.AlertComponentDefinitionSchema = void 0;
+exports.SkedyulConfigSchema = exports.ProvisionConfigSchema = exports.WebhooksSchema = exports.WebhookHandlerDefinitionSchema = exports.WebhookHttpMethodSchema = exports.PageDefinitionSchema = exports.NavigationConfigSchema = exports.NavigationBreadcrumbSchema = exports.BreadcrumbItemSchema = exports.NavigationSidebarSchema = exports.NavigationSectionSchema = exports.NavigationItemSchema = exports.PageInstanceFilterSchema = exports.PageContextDefinitionSchema = exports.PageContextItemDefinitionSchema = exports.PageContextFiltersSchema = exports.PageContextModeSchema = exports.PageBlockDefinitionSchema = exports.ListBlockDefinitionSchema = exports.LegacyFormBlockDefinitionSchema = exports.PageFieldDefinitionSchema = exports.CardBlockDefinitionSchema = exports.CardBlockHeaderSchema = exports.FormV2PropsDefinitionSchema = exports.FormV2ComponentDefinitionSchema = exports.FieldSettingComponentDefinitionSchema = exports.ModalFormDefinitionSchema = exports.AlertComponentDefinitionSchema = void 0;
 exports.safeParseConfig = safeParseConfig;
 exports.isModelDependency = isModelDependency;
 exports.isChannelDependency = isChannelDependency;
@@ -492,14 +492,24 @@ exports.PageBlockDefinitionSchema = zod_1.z.union([
 ]);
 /** Mode for context data fetching */
 exports.PageContextModeSchema = zod_1.z.enum(['first', 'many', 'count']);
+/**
+ * Page context filters schema.
+ * Uses structured filter format: { fieldHandle: { operator: value } }
+ * Values can be Liquid template strings, e.g., { id: { eq: '{{ path_params.id }}' } }
+ */
+exports.PageContextFiltersSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.union([PrimitiveSchema, zod_1.z.array(PrimitiveSchema), zod_1.z.string()])));
 /** Single context item definition */
 exports.PageContextItemDefinitionSchema = zod_1.z.object({
     /** Model handle to fetch data from */
     model: zod_1.z.string(),
     /** Fetch mode: 'first' returns single object, 'many' returns array, 'count' returns number */
     mode: exports.PageContextModeSchema,
-    /** Optional filters using StructuredFilter format */
-    filters: exports.StructuredFilterSchema.optional(),
+    /**
+     * Optional filters. Supports:
+     * - Simple key-value with Liquid templates: { id: '{{ path_params.id }}' }
+     * - StructuredFilter format: { status: { eq: 'APPROVED' } }
+     */
+    filters: exports.PageContextFiltersSchema.optional(),
     /** Optional limit for 'many' mode */
     limit: zod_1.z.number().optional(),
 });
@@ -510,12 +520,61 @@ exports.PageInstanceFilterSchema = zod_1.z.object({
     model: zod_1.z.string(),
     where: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Navigation Schemas
+// ─────────────────────────────────────────────────────────────────────────────
+/** Navigation item for sidebar */
+exports.NavigationItemSchema = zod_1.z.object({
+    /** Display label (supports Liquid templates) */
+    label: zod_1.z.string(),
+    /** URL href (supports Liquid templates with path_params and context) */
+    href: zod_1.z.string(),
+    /** Optional icon name */
+    icon: zod_1.z.string().optional(),
+});
+/** Navigation section with title and items */
+exports.NavigationSectionSchema = zod_1.z.object({
+    /** Section title (supports Liquid templates) */
+    title: zod_1.z.string().optional(),
+    /** Navigation items in this section */
+    items: zod_1.z.array(exports.NavigationItemSchema),
+});
+/** Sidebar navigation configuration */
+exports.NavigationSidebarSchema = zod_1.z.object({
+    /** Sections to display in the sidebar */
+    sections: zod_1.z.array(exports.NavigationSectionSchema),
+});
+/** Breadcrumb item */
+exports.BreadcrumbItemSchema = zod_1.z.object({
+    /** Display label (supports Liquid templates) */
+    label: zod_1.z.string(),
+    /** Optional href - if not provided, item is not clickable */
+    href: zod_1.z.string().optional(),
+});
+/** Breadcrumb navigation configuration */
+exports.NavigationBreadcrumbSchema = zod_1.z.object({
+    /** Breadcrumb items from left to right */
+    items: zod_1.z.array(exports.BreadcrumbItemSchema),
+});
+/** Full navigation configuration */
+exports.NavigationConfigSchema = zod_1.z.object({
+    /** Sidebar navigation */
+    sidebar: exports.NavigationSidebarSchema.optional(),
+    /** Breadcrumb navigation */
+    breadcrumb: exports.NavigationBreadcrumbSchema.optional(),
+});
 exports.PageDefinitionSchema = zod_1.z.object({
-    handle: zod_1.z.string(),
     type: exports.PageTypeSchema,
     title: zod_1.z.string(),
-    path: zod_1.z.string().optional(),
-    navigation: zod_1.z.union([zod_1.z.boolean(), zod_1.z.string()]).optional().default(true),
+    /** URL path for this page (e.g., '/phone-numbers' or '/phone-numbers/[id]' for dynamic segments) */
+    path: zod_1.z.string(),
+    /**
+     * Navigation configuration:
+     * - true/false: show/hide in auto-generated navigation
+     * - string: Liquid template that evaluates to true/false
+     * - NavigationConfigSchema: full navigation override for this page (replaces base navigation)
+     */
+    navigation: zod_1.z.union([zod_1.z.boolean(), zod_1.z.string(), exports.NavigationConfigSchema]).optional().default(true),
     blocks: zod_1.z.array(exports.PageBlockDefinitionSchema),
     actions: zod_1.z.array(exports.PageActionDefinitionSchema).optional(),
     /** Context data to load for Liquid templates. appInstallationId filtering is automatic. */
@@ -542,6 +601,8 @@ exports.ProvisionConfigSchema = zod_1.z.object({
     relationships: zod_1.z.array(exports.RelationshipDefinitionSchema).optional(),
     channels: zod_1.z.array(exports.ChannelDefinitionSchema).optional(),
     workflows: zod_1.z.array(exports.WorkflowDefinitionSchema).optional(),
+    /** Base navigation configuration for all pages (can be overridden per page) */
+    navigation: exports.NavigationConfigSchema.optional(),
     pages: zod_1.z.array(exports.PageDefinitionSchema).optional(),
     webhooks: zod_1.z.array(zod_1.z.string()).optional(),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "0.2.18",
+  "version": "0.2.20",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",