@nanobpm/nano-ide-ext-types 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type ExtKind = "lang" | "app" | "example";
+export type ExtKind = "lang" | "app" | "example" | "theme";
 export interface FileType {
     /** File extension including the dot, e.g. ".rs". */
     ext: string;
@@ -8,17 +8,61 @@ export interface FileType {
 export interface Toolchain {
     /** Probe argv proving the toolchain is installed (e.g. ["cargo","--version"]). */
     detect?: string[];
-    /** argv to run the project (cwd = project dir). Empty => built-in Deno runner. */
+    /** argv to run the project (cwd = project dir). Empty => built-in Deno runner.
+     * Serves as a fallback when the active run config's `run` argv is empty. */
     run?: string[];
-    /** argv to compile the project. Empty => Deno compile. */
+    /** argv to compile the project. Empty => Deno compile. Serves as a fallback
+     * when the active run config's `compile` argv is empty. */
     compile?: string[];
     /** Cross-compile target triples this toolchain offers. */
     targets?: string[];
+    /** Named run configurations the console surfaces in a Run/Target dropdown.
+     * When set, the supervisor prefers the active one (pinned →
+     * `default: true` → first) over the flat `run`/`compile`. */
+    runConfigs?: RunConfig[];
+}
+/**
+ * One named run/compile combo a pack exposes — e.g. an example that swaps
+ * transports or build profiles. The console persists the picked id in the
+ * project's `nanobpm.project.json` as `toolchain.activeRunConfig`.
+ */
+export interface RunConfig {
+    /** Stable id, unique within the pack (e.g. "stock-grpc"). */
+    id: string;
+    /** Human-facing label shown in the Run dropdown. */
+    label: string;
+    /** When no id is pinned by the user, this entry is picked; else the first. */
+    default?: boolean;
+    /** argv override for this config. Empty => fall back to `Toolchain.run`. */
+    run?: string[];
+    /** argv override for this config. Empty => fall back to `Toolchain.compile`. */
+    compile?: string[];
+    /** Env vars layered on top of the base spawn env (last wins on key clash). */
+    env?: Record<string, string>;
 }
 export interface TemplateSpec {
     id: string;
     label: string;
 }
+/**
+ * The console's design-token vocabulary (nanobpmn
+ * console/src/theme/tokens.css). A theme restyles the whole console by giving
+ * CSS colours for these keys; missing keys fall back to the base appearance.
+ */
+export declare const THEME_TOKEN_KEYS: readonly ["app", "panel", "raised", "inset", "hover", "edge", "edgeStrong", "text", "textMuted", "textFaint", "accent", "accentStrong", "accent2", "onAccent", "ok", "warn", "danger", "info"];
+export type ThemeTokenKey = (typeof THEME_TOKEN_KEYS)[number];
+/** One console colour theme a `kind: "theme"` pack contributes. Pure data. */
+export interface ThemeSpec {
+    /** Stable id, unique across packs (e.g. "nord-dark"). */
+    id: string;
+    /** Human-facing name shown in the console's theme picker. */
+    label: string;
+    /** Base palette the tokens override — controls color-scheme and any token
+     * the theme doesn't specify. */
+    appearance: "light" | "dark";
+    /** Design-token name -> CSS colour. Unknown keys are ignored by the host. */
+    tokens: Partial<Record<ThemeTokenKey, string>>;
+}
 export interface ExtManifest {
     id: string;
     kind: ExtKind;
@@ -26,12 +70,19 @@ export interface ExtManifest {
     fileTypes?: FileType[];
     templates?: TemplateSpec[];
     toolchain?: Toolchain;
-    /** example packs: lang pack ids required to build/run this example. */
+    /** example/app packs: lang pack ids required to build/run this pack's
+     * projects. The FIRST entry sets the scaffolded project's language — which
+     * drives the host's run/compile toolchain — so any app or example pack that
+     * isn't Deno-based must declare it (else new projects fall back to the Deno
+     * runtime). Required for example packs; required for app packs whose
+     * toolchain declares a detect probe. */
     requires?: string[];
     /** example packs: subdir holding the ready-to-copy project. */
     appDir?: string;
     /** example packs: one-line description for the picker. */
     summary?: string;
+    /** theme packs: the console colour themes this pack contributes. */
+    themes?: ThemeSpec[];
     /** Built-in packs set this; published packs omit it. */
     builtin?: boolean;
 }

package/dist/index.js

@@ -1,3 +1,28 @@
 // nano-ide.ext.json manifest contract (ADR 0007). Mirrors the host parser in
 // nanobpmn server/src/console/extensions.rs — keep in sync.
+/**
+ * The console's design-token vocabulary (nanobpmn
+ * console/src/theme/tokens.css). A theme restyles the whole console by giving
+ * CSS colours for these keys; missing keys fall back to the base appearance.
+ */
+export const THEME_TOKEN_KEYS = [
+    "app",
+    "panel",
+    "raised",
+    "inset",
+    "hover",
+    "edge",
+    "edgeStrong",
+    "text",
+    "textMuted",
+    "textFaint",
+    "accent",
+    "accentStrong",
+    "accent2",
+    "onAccent",
+    "ok",
+    "warn",
+    "danger",
+    "info",
+];
 export const MANIFEST_FILE = "nano-ide.ext.json";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-ide-ext-types",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TypeScript types for the nano-ide.ext.json extension manifest (ADR 0007).",
   "license": "Apache-2.0",
   "type": "module",