wicked-crew-api-types 0.116.0 → 0.118.0

package/index.d.ts

@@ -5472,6 +5472,37 @@ export interface SystemSettings {
   [key: `studio.${string}`]: unknown;
 }
 
+/**
+ * The demo video's palette from the operator's studio skin (`studio.appearance`): each colour `#rrggbb`. Renderers
+ * use it by default; a storyline's own brand colour or a custom video style overrides it.
+ */
+export interface VideoPalette {
+  /** The page ground (title and end cards, the stage behind the app). */
+  canvas: string;
+  /** A raised surface (chips, caption band). */
+  surface: string;
+  /** Primary text. */
+  ink: string;
+  /** Secondary text. */
+  ink2: string;
+  /** Quiet text (kickers, counters). */
+  muted: string;
+  /** Hairlines and inactive progress. */
+  line: string;
+  /** The skin's accent, adjusted per theme and until it reads on `canvas` (≥ 3:1): chapter numbers, highlights, the cursor ring. */
+  accent: string;
+  /** The skin's typeface family name. */
+  font: string;
+  scheme: 'light' | 'dark';
+}
+
+/** `GET /appearance/video-palette` → 200. `studio-default` = no skin stored: studio's new-install look. */
+export interface VideoPaletteResponse {
+  source: 'studio-skin' | 'studio-default';
+  theme: 'dark' | 'light' | 'wicked-light' | 'wicked-dark';
+  palette: VideoPalette;
+}
+
 /**
  * `GET /settings` → 200 (api-types 0.38.0 — the body's first named type; the shape `{ settings }`
  * is unchanged since 0.1). `path` (additive; DES-L10 PR-L10-6, crew ≥ 0.7.35) is the ABSOLUTE
@@ -10416,7 +10447,51 @@ export type EditorPermission =
   | 'network.media'
   /** Talk, through studio's host, to an MCP server the operator connected (DES-MCP-INSPECTOR-001).
    *  No posture rule allows it: the editor's install consent writes its per-build grant. */
-  | 'mcp.session';
+  | 'mcp.session'
+  /** Protocol 2 `theme.set` (DES-EDITOR-PLUGIN-CONTRACT-001 §7.2): change this artifact's theme, as a new version. */
+  | 'artifact.theme';
+
+/**
+ * A protocol-2 editor's surfaces (DES-EDITOR-PLUGIN-CONTRACT-001 §5.2), as the registry parsed them from its
+ * manifest: defaults filled (`interactive:false`, `aspect:'16:9'`, `actions:[]`, `primary:false`, `maxChars:200`,
+ * `full.default:'simple'`), `options`/`full` null when not declared. The host renders the card, the options tabs
+ * and full screen from this copy (and requires the bundle's `plugin.ready` copy to be the same).
+ */
+export interface EditorSurfaces {
+  card: {
+    /** The frame takes pointer and keys inside the card (a protocol-1 inline card never did). */
+    interactive: boolean;
+    /** `auto`: the plugin reports its height (`ui.height`, clamped to 120-560 px). */
+    aspect: '16:9' | '4:3' | 'auto';
+    /** At most 4, drawn by the HOST in the card footer. `plugin` → `host.action {id}`; the others are host verbs. */
+    actions: Array<{ id: string; label: string; primary: boolean; verb: 'plugin' | 'host:export' | 'host:ask' }>;
+  };
+  /** At most 5 tabs, added to the host panel on Options; null = no Options button. */
+  options: { tabs: EditorOptionsTab[] } | null;
+  /** Null = no Full screen button. `modes` null = one mode (no Simple/Advanced toggle). */
+  full: { modes: Array<'simple' | 'advanced'> | null; default: 'simple' | 'advanced' } | null;
+}
+
+/** One options tab: a frame of the plugin's (`plugin`) or host-drawn controls (`controls`, at most 12). */
+export interface EditorOptionsTab {
+  id: string;
+  label: string;
+  render: 'plugin' | 'controls';
+  controls?: EditorControl[];
+}
+
+/** A host-drawn control (§5.3, a closed vocabulary). `options` for select/segmented (2-8); `min`/`max`/`step`
+ *  for range; `maxChars` for text. */
+export interface EditorControl {
+  id: string;
+  label: string;
+  type: 'toggle' | 'segmented' | 'select' | 'color' | 'text' | 'range';
+  options?: Array<{ id: string; label: string }>;
+  min?: number;
+  max?: number;
+  step?: number;
+  maxChars?: number;
+}
 
 /**
  * One registered editor, as Settings → Editors renders it. No path is on the wire: the bundle is
@@ -10436,6 +10511,10 @@ export interface EditorView {
   kinds: string[];
   sizes: Array<'inline' | 'pane' | 'full'>;
   panels?: Array<'checks'>;
+  /** Protocol 2 (an editor whose `protocol` lists 2): its declared surfaces, parsed. Absent for a protocol-1
+   *  editor, and from a daemon that predates the field (added with api-types 0.117.0; the host then reads
+   *  the bundle's `plugin.ready` copy). */
+  surfaces?: EditorSurfaces;
   /** Each with the reason shown at install. The GRANTED set is `GET /editors/:id/grants`. */
   permissions: Array<{ id: EditorPermission; why: string }>;
   /** The full sha256 of the entry file, pinned when the registry read it. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.116.0",
+  "version": "0.118.0",
   "description": "The wire contract of the wicked-crew daemon's /api/v1 REST surface and /ws CoreEvent frames \u2014 types only, zero runtime",
   "type": "module",
   "types": "./index.d.ts",