@ikenga/contract 0.18.0 → 0.19.0

package/src/__fixtures__/manifest-v5/invalid/companion-panel-missing-route.json

@@ -0,0 +1,11 @@
+{
+  "id": "com.ikenga.no-panel-route",
+  "name": "No Panel Route",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "companion_panels": [
+      { "id": "state", "title": "State", "session_scoped": true }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/context-action-bad-run.json

@@ -0,0 +1,16 @@
+{
+  "id": "com.ikenga.bad-run",
+  "name": "Bad Run",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "context_actions": [
+      {
+        "id": "shell-out",
+        "label": "Shell Out",
+        "when": { "kind": "file" },
+        "run": { "kind": "shell", "command": "rm -rf /" }
+      }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/context-selector-bad-kind.json

@@ -0,0 +1,16 @@
+{
+  "id": "com.ikenga.bad-selector",
+  "name": "Bad Selector",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "context_actions": [
+      {
+        "id": "project-wide",
+        "label": "Project Wide",
+        "when": { "kind": "project" },
+        "run": { "kind": "dispatch", "prompt": "hi" }
+      }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/explorer-section-missing-data-route.json

@@ -0,0 +1,11 @@
+{
+  "id": "com.ikenga.no-data-route",
+  "name": "No Data Route",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "explorer_sections": [
+      { "id": "queue", "title": "Queue", "order": 1 }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/side-pane-viewers-empty.json

@@ -0,0 +1,9 @@
+{
+  "id": "com.ikenga.sidepane-empty",
+  "name": "Side Pane Empty",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "side_pane_viewers": []
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/side-pane-viewers.json

@@ -0,0 +1,14 @@
+{
+  "id": "com.ikenga.sidepane",
+  "name": "Side Pane",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/viewer", "kind": "iframe", "source": "viewer.html" }
+    ],
+    "side_pane_viewers": [
+      { "id": "viewer", "label": "Viewer", "route": "/viewer" }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/view-route-no-routes.json

@@ -0,0 +1,11 @@
+{
+  "id": "com.ikenga.no-routes",
+  "name": "No Routes",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "views": [
+      { "id": "orphan", "title": "Orphan", "route": "/orphan" }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/view-route-undeclared.json

@@ -0,0 +1,15 @@
+{
+  "id": "com.ikenga.bad-route",
+  "name": "Bad Route",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/grid", "kind": "iframe", "source": "grid.html" }
+    ],
+    "views": [
+      { "id": "grid", "title": "Grid", "route": "/grid" },
+      { "id": "missing", "title": "Missing", "route": "/not-declared" }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/view-unknown-field.json

@@ -0,0 +1,14 @@
+{
+  "id": "com.ikenga.strict-view",
+  "name": "Strict View",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/grid", "kind": "iframe", "source": "grid.html" }
+    ],
+    "views": [
+      { "id": "grid", "title": "Grid", "route": "/grid", "label": "not-a-field" }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/invalid/widget-bad-span.json

@@ -0,0 +1,14 @@
+{
+  "id": "com.ikenga.bad-span",
+  "name": "Bad Span",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/w/main", "kind": "iframe", "source": "w-main.html" }
+    ],
+    "widgets": [
+      { "id": "main", "title": "Main", "route": "/w/main", "span": "large" }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/valid/companion-panels.json

@@ -0,0 +1,26 @@
+{
+  "id": "com.ikenga.companion-demo",
+  "name": "Companion Demo",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/session-state", "kind": "iframe", "source": "session-state.html" },
+      { "path": "/project-state", "kind": "iframe", "source": "project-state.html" }
+    ],
+    "companion_panels": [
+      {
+        "id": "session-state",
+        "title": "Session State",
+        "icon": "activity",
+        "route": "/session-state",
+        "session_scoped": true
+      },
+      {
+        "id": "project-state",
+        "title": "Project State",
+        "route": "/project-state"
+      }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/valid/context-actions.json

@@ -0,0 +1,41 @@
+{
+  "id": "com.ikenga.actions-demo",
+  "name": "Actions Demo",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/review", "kind": "iframe", "source": "review.html" }
+    ],
+    "context_actions": [
+      {
+        "id": "hand-to-chi",
+        "label": "Hand to Chi",
+        "when": { "kind": "file", "glob": "*.md" },
+        "run": {
+          "kind": "dispatch",
+          "prompt": "Review {{file.path}} in {{project.root}}",
+          "target": "chi"
+        }
+      },
+      {
+        "id": "open-artifact",
+        "label": "Open Artifact",
+        "when": { "kind": "artifact" },
+        "run": { "kind": "view", "route": "/review" }
+      },
+      {
+        "id": "summarize-session",
+        "label": "Summarize Session",
+        "when": { "kind": "session" },
+        "run": { "kind": "dispatch", "prompt": "Summarize {{pane.url}}" }
+      },
+      {
+        "id": "triage-ngwa",
+        "label": "Triage Item",
+        "when": { "kind": "ngwa-item", "kinds": ["task", "alert"] },
+        "run": { "kind": "view", "route": "/review" }
+      }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/valid/explorer-sections.json

@@ -0,0 +1,31 @@
+{
+  "id": "com.ikenga.explorer-demo",
+  "name": "Explorer Demo",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "explorer_sections": [
+      {
+        "id": "open-tasks",
+        "title": "Open Tasks",
+        "icon": "check-circle",
+        "order": 10,
+        "data_route": "/pkg/com.ikenga.explorer-demo/sections/open-tasks"
+      },
+      {
+        "id": "recent-files",
+        "title": "Recent Files",
+        "data_route": "/pkg/com.ikenga.explorer-demo/sections/recent-files"
+      }
+    ]
+  },
+  "iyke": {
+    "routes": [
+      {
+        "method": "GET",
+        "path": "/pkg/com.ikenga.explorer-demo/sections/open-tasks",
+        "handler": "sidecar:pa-ikenga-explorer-demo sections"
+      }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/valid/full.json

@@ -0,0 +1,42 @@
+{
+  "id": "com.ikenga.full-v5",
+  "name": "Full v5",
+  "version": "2.0.0",
+  "ikenga_api": "5",
+  "author": { "name": "Ikenga", "key": "ed25519:abc" },
+  "ui": {
+    "routes": [
+      { "path": "/grid", "kind": "iframe", "source": "grid.html" },
+      { "path": "/panel", "kind": "iframe", "source": "panel.html" },
+      { "path": "/w/main", "kind": "iframe", "source": "w-main.html" }
+    ],
+    "views": [
+      { "id": "grid", "title": "Grid", "icon": "layout-grid", "route": "/grid", "pin_on_install": true }
+    ],
+    "explorer_sections": [
+      { "id": "queue", "title": "Queue", "order": 5, "data_route": "/pkg/com.ikenga.full-v5/queue" }
+    ],
+    "companion_panels": [
+      { "id": "state", "title": "State", "route": "/panel", "session_scoped": true }
+    ],
+    "context_actions": [
+      {
+        "id": "dispatch-file",
+        "label": "Dispatch File",
+        "when": { "kind": "file" },
+        "run": { "kind": "dispatch", "prompt": "Handle {{file.path}}" }
+      }
+    ],
+    "widgets": [
+      { "id": "main", "title": "Main", "route": "/w/main", "span": "medium" }
+    ],
+    "command_palette": [
+      { "id": "refresh", "label": "Refresh", "action": { "type": "whatever-untyped" } }
+    ],
+    "session": { "persistence": "keep" }
+  },
+  "permissions": {
+    "net": ["https://api.example.com/"],
+    "events": ["pkg://lifecycle"]
+  }
+}

package/src/__fixtures__/manifest-v5/valid/minimal.json

@@ -0,0 +1,6 @@
+{
+  "id": "com.ikenga.minimal",
+  "name": "Minimal",
+  "version": "1.0.0",
+  "ikenga_api": "5"
+}

package/src/__fixtures__/manifest-v5/valid/nav-and-views.json

@@ -0,0 +1,17 @@
+{
+  "id": "com.ikenga.nav-and-views",
+  "name": "Nav And Views",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/grid", "kind": "iframe", "source": "grid.html" }
+    ],
+    "nav": [
+      { "id": "legacy-grid", "label": "Legacy Grid", "icon": "grid", "route": "/grid" }
+    ],
+    "views": [
+      { "id": "grid", "title": "Grid", "icon": "layout-grid", "route": "/grid" }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/valid/v4-manifest.json

@@ -0,0 +1,20 @@
+{
+  "id": "com.ikenga.legacy-v4",
+  "name": "Legacy v4",
+  "version": "1.4.0",
+  "ikenga_api": "4",
+  "ui": {
+    "routes": [
+      { "path": "/home", "kind": "iframe", "source": "home.html" }
+    ],
+    "nav": [
+      { "id": "home", "label": "Home", "icon": "home", "route": "/home" }
+    ],
+    "command_palette": [
+      { "id": "sync", "label": "Sync", "shortcut": "ctrl+shift+s", "action": "sync.now" }
+    ]
+  },
+  "capabilities": {
+    "webview": { "child_webviews": true, "partitions": ["default"] }
+  }
+}

package/src/__fixtures__/manifest-v5/valid/views.json

@@ -0,0 +1,26 @@
+{
+  "id": "com.ikenga.views-demo",
+  "name": "Views Demo",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/grid", "kind": "iframe", "source": "grid.html" },
+      { "path": "/detail", "kind": "iframe", "source": "detail.html" }
+    ],
+    "views": [
+      {
+        "id": "grid",
+        "title": "Grid",
+        "icon": "layout-grid",
+        "route": "/grid",
+        "pin_on_install": true
+      },
+      {
+        "id": "detail",
+        "title": "Detail",
+        "route": "/detail"
+      }
+    ]
+  }
+}

package/src/__fixtures__/manifest-v5/valid/widgets.json

@@ -0,0 +1,18 @@
+{
+  "id": "com.ikenga.widgets-demo",
+  "name": "Widgets Demo",
+  "version": "1.0.0",
+  "ikenga_api": "5",
+  "ui": {
+    "routes": [
+      { "path": "/w/stats", "kind": "iframe", "source": "w-stats.html" },
+      { "path": "/w/feed", "kind": "iframe", "source": "w-feed.html" },
+      { "path": "/w/pipeline", "kind": "iframe", "source": "w-pipeline.html" }
+    ],
+    "widgets": [
+      { "id": "stats", "title": "Stats", "route": "/w/stats", "span": "small" },
+      { "id": "feed", "title": "Feed", "route": "/w/feed" },
+      { "id": "pipeline", "title": "Pipeline", "route": "/w/pipeline", "span": "wide" }
+    ]
+  }
+}

package/src/index.ts

@@ -15,4 +15,4 @@ export * from './app-bridge.js';
 export * from './ngwa.js';
 
 /** This package's own version. */
-export const CONTRACT_PACKAGE_VERSION = '0.5.0' as const;
+export const CONTRACT_PACKAGE_VERSION = '0.19.0' as const;