@syntrologie/adapt-nav 0.0.0-semantically-released

package/dist/schema.js

@@ -0,0 +1,101 @@
+/**
+ * Adaptive Nav - Config Schema
+ *
+ * Zod schema for validating navigation link list configuration.
+ * Demonstrates compositional action pattern with per-item showWhen.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Decision Strategy Schema (simplified for this package)
+// ============================================================================
+const ConditionZ = z
+    .object({
+    type: z.string(),
+})
+    .passthrough();
+const RuleZ = z.object({
+    conditions: z.array(ConditionZ),
+    value: z.unknown(),
+});
+const RuleStrategyZ = z.object({
+    type: z.literal('rules'),
+    rules: z.array(RuleZ),
+    default: z.unknown(),
+});
+const ScoreStrategyZ = z.object({
+    type: z.literal('score'),
+    field: z.string(),
+    threshold: z.number(),
+    above: z.unknown(),
+    below: z.unknown(),
+});
+const ModelStrategyZ = z.object({
+    type: z.literal('model'),
+    modelId: z.string(),
+    inputs: z.array(z.string()),
+    outputMapping: z.record(z.unknown()),
+    default: z.unknown(),
+});
+const ExternalStrategyZ = z.object({
+    type: z.literal('external'),
+    endpoint: z.string(),
+    method: z.enum(['GET', 'POST']).optional(),
+    default: z.unknown(),
+    timeoutMs: z.number().optional(),
+});
+const DecisionStrategyZ = z.discriminatedUnion('type', [
+    RuleStrategyZ,
+    ScoreStrategyZ,
+    ModelStrategyZ,
+    ExternalStrategyZ,
+]);
+// ============================================================================
+// Nav Link Schema
+// ============================================================================
+/**
+ * Schema for a single navigation link (compositional action).
+ */
+export const NavLinkSchema = z.object({
+    kind: z.literal('nav:link'),
+    config: z.object({
+        /** Display label for the link */
+        label: z.string().min(1, 'Label is required'),
+        /** Target URL */
+        href: z.string().min(1, 'URL is required'),
+        /** Optional icon (emoji or icon key) */
+        icon: z.string().optional(),
+        /** Whether to open in new tab */
+        external: z.boolean().default(false),
+    }),
+    /** Per-item activation strategy (null = always show) */
+    showWhen: DecisionStrategyZ.nullable().optional(),
+});
+// ============================================================================
+// Nav Config Schema
+// ============================================================================
+/**
+ * Full configuration schema for adaptive-nav.
+ */
+export const configSchema = z.object({
+    /** Layout orientation */
+    layout: z.enum(['horizontal', 'vertical']).default('horizontal'),
+    /** Color theme */
+    theme: z.enum(['light', 'dark', 'auto']).default('auto'),
+    /** Navigation links (compositional actions) */
+    actions: z.array(NavLinkSchema).default([]),
+});
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Validate a nav link action.
+ */
+export function validateNavLink(data) {
+    return NavLinkSchema.safeParse(data);
+}
+/**
+ * Validate the full nav config.
+ */
+export function validateNavConfig(data) {
+    return configSchema.safeParse(data);
+}

package/dist/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Adaptive Nav - Types
+ *
+ * Type definitions for the navigation link list adaptive.
+ * Demonstrates compositional action pattern with per-item showWhen.
+ */
+/**
+ * Simplified DecisionStrategy type for this package.
+ * Full definition is in @syntrologie/runtime-sdk.
+ */
+export type DecisionStrategy<T = unknown> = RuleStrategy<T> | ScoreStrategy<T> | ModelStrategy<T> | ExternalStrategy<T>;
+export interface RuleStrategy<T = unknown> {
+    type: 'rules';
+    rules: Array<{
+        conditions: Array<Record<string, unknown>>;
+        value: T;
+    }>;
+    default: T;
+}
+export interface ScoreStrategy<T = unknown> {
+    type: 'score';
+    field: string;
+    threshold: number;
+    above: T;
+    below: T;
+}
+export interface ModelStrategy<T = unknown> {
+    type: 'model';
+    modelId: string;
+    inputs: string[];
+    outputMapping: Record<string, T>;
+    default: T;
+}
+export interface ExternalStrategy<T = unknown> {
+    type: 'external';
+    endpoint: string;
+    method?: 'GET' | 'POST';
+    default: T;
+    timeoutMs?: number;
+}
+/**
+ * Single navigation link configuration.
+ * This is a "compositional action" - it's not executed, but rendered by the parent.
+ */
+export interface NavLinkAction {
+    /** Action kind identifier */
+    kind: 'nav:link';
+    /** Link configuration */
+    config: {
+        /** Display label for the link */
+        label: string;
+        /** Target URL */
+        href: string;
+        /** Optional icon (emoji or icon key) */
+        icon?: string;
+        /** Whether to open in new tab */
+        external?: boolean;
+    };
+    /** Optional per-item activation strategy */
+    showWhen?: DecisionStrategy<boolean> | null;
+}
+/**
+ * Layout orientation for the navigation links.
+ */
+export type NavLayout = 'horizontal' | 'vertical';
+/**
+ * Theme for the navigation widget.
+ */
+export type NavTheme = 'light' | 'dark' | 'auto';
+/**
+ * Full configuration for the adaptive-nav widget.
+ */
+export interface NavConfig {
+    /** Layout orientation */
+    layout: NavLayout;
+    /** Color theme */
+    theme: NavTheme;
+    /** Navigation links (compositional actions) */
+    actions: NavLinkAction[];
+}
+/**
+ * Runtime services passed to the widget.
+ */
+export interface NavWidgetRuntime {
+    /** Synchronously evaluate a decision strategy */
+    evaluateSync: <T>(strategy: DecisionStrategy<T>) => {
+        value: T;
+        isFallback: boolean;
+    };
+    /** Context manager for subscribing to changes */
+    context: {
+        subscribe: (callback: () => void) => () => void;
+    };
+    /** Event bus for publishing interactions */
+    events: {
+        publish: (name: string, props?: Record<string, unknown>) => void;
+    };
+}
+/**
+ * Props passed to the NavWidget component.
+ */
+export interface NavWidgetProps {
+    /** Widget configuration */
+    config: NavConfig;
+    /** Runtime services */
+    runtime: NavWidgetRuntime;
+    /** Instance ID for telemetry */
+    instanceId: string;
+}
+export interface EditorPanelProps {
+    config: Record<string, unknown>;
+    onChange: (config: Record<string, unknown>) => void;
+    editor: {
+        setDirty: (dirty: boolean) => void;
+        navigateHome: () => Promise<boolean>;
+        save: () => Promise<void>;
+        publish: (captureScreenshot?: boolean) => Promise<void>;
+    };
+    platformClient?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Adaptive Nav - Types
+ *
+ * Type definitions for the navigation link list adaptive.
+ * Demonstrates compositional action pattern with per-item showWhen.
+ */
+export {};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@syntrologie/adapt-nav",
+  "version": "0.0.0-semantically-released",
+  "description": "Adaptive Navigation Links - Widget-based nav list with per-item conditional visibility",
+  "license": "Proprietary",
+  "private": false,
+  "author": "Syntrologie <eng@syntrologie.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SyntropyForge/amazing-demos.git",
+    "directory": "tech-core/sdks/adaptives/adaptive-nav"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    },
+    "./editor": {
+      "types": "./dist/editor.d.ts",
+      "import": "./dist/editor.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@syntrologie/runtime-sdk": "^2.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "typescript": "^5.0.0",
+    "zod": "^3.25.0"
+  }
+}