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

package/dist/index.d.ts

@@ -20,6 +20,12 @@ export interface Toolchain {
      * When set, the supervisor prefers the active one (pinned →
      * `default: true` → first) over the flat `run`/`compile`. */
     runConfigs?: RunConfig[];
+    /** Official install instructions for this toolchain, surfaced in the IDE
+     * config panel when the `detect` probe fails (e.g. the Rust toolchain page). */
+    installUrl?: string;
+    /** One-line, actionable hint shown when the toolchain is missing (e.g.
+     * "`cargo` was not found. Install the Rust toolchain…"). */
+    installHint?: string;
 }
 /**
  * One named run/compile combo a pack exposes — e.g. an example that swaps
@@ -63,10 +69,86 @@ export interface ThemeSpec {
     /** Design-token name -> CSS colour. Unknown keys are ignored by the host. */
     tokens: Partial<Record<ThemeTokenKey, string>>;
 }
+/**
+ * IntelliSense data a lang pack ships for the console's Monaco editor. The
+ * console has a real language service only for TypeScript/JavaScript (Monaco's
+ * built-in TS worker); every other language gets tokenisation only. A pack can
+ * light up completion, hover, and signature help for its `monacoLang` by
+ * shipping this curated data — no in-browser language server required. The host
+ * registers one provider per `monacoLang` and feeds it every pack's entries.
+ */
+export interface LangIntellisense {
+    /** Monaco language id these entries apply to (e.g. "csharp", "rust"). */
+    monacoLang: string;
+    /** Extra characters that reopen the completion popup (e.g. ["."]). The word
+     * character set always triggers completion; add member-access dots etc. */
+    triggerCharacters?: string[];
+    /** Completion items offered in files of this language. */
+    completions?: CompletionSpec[];
+    /** Hover cards keyed by the exact symbol under the cursor. */
+    hovers?: HoverSpec[];
+    /** Signature-help entries shown while typing a call's arguments. */
+    signatures?: SignatureSpec[];
+}
+/**
+ * Monaco `CompletionItemKind` names a pack may use. The listed names are the
+ * commonly-emitted ones and exist only as authoring hints — the real authority
+ * is the host's kind→Monaco mapping, which renders any unknown value as
+ * `Value`. The union is intentionally open (`string & {}`) because the mapping
+ * lives in a separate repo (the console), so a closed set here can't be
+ * compile-time reconciled with it and would only drift; keeping it open means a
+ * new generator-emitted kind never breaks consumers of this package.
+ */
+export type CompletionKind = "keyword" | "snippet" | "function" | "method" | "constructor" | "class" | "struct" | "interface" | "enum" | "module" | "property" | "field" | "variable" | "constant" | "value" | (string & {});
+/** One completion item. `insertText` defaults to `label`. */
+export interface CompletionSpec {
+    /** Text shown in the completion list. */
+    label: string;
+    /** Icon/category. Defaults to "value" when omitted. */
+    kind?: CompletionKind;
+    /** Text inserted on accept. Defaults to `label`. */
+    insertText?: string;
+    /** When true, `insertText` is a Monaco snippet (`${1:name}` placeholders). */
+    snippet?: boolean;
+    /** Short right-aligned signature/type (e.g. the return type). */
+    detail?: string;
+    /** Markdown documentation shown in the details flyout. */
+    documentation?: string;
+}
+/** A hover card: shown when the pointer rests on `symbol`. */
+export interface HoverSpec {
+    /** Exact identifier that triggers this hover (whole-word match). */
+    symbol: string;
+    /** Markdown rendered in the hover card. */
+    contents: string;
+}
+/** One function/method signature surfaced by signature help. */
+export interface SignatureSpec {
+    /** Identifier that, when followed by `(`, triggers this help (e.g.
+     * "CreateProcessInstanceAsync"). */
+    trigger: string;
+    /** Full signature line shown in the popup. */
+    label: string;
+    /** Markdown documentation for the call. */
+    documentation?: string;
+    /** Ordered parameters; the active one is highlighted by comma position. */
+    parameters?: SignatureParam[];
+}
+/** One parameter within a {@link SignatureSpec}. */
+export interface SignatureParam {
+    /** Parameter label as it appears in the signature (e.g. "id: string"). */
+    label: string;
+    /** Markdown documentation for this parameter. */
+    documentation?: string;
+}
 export interface ExtManifest {
     id: string;
     kind: ExtKind;
     displayName: string;
+    /** Optional pack icon: an inline SVG XML string (preferred; use single-quoted
+     * attributes so it nests in JSON) or a data:/http: URL. Lang packs supply this
+     * so the console can badge project cards with a language icon. */
+    icon?: string;
     fileTypes?: FileType[];
     templates?: TemplateSpec[];
     toolchain?: Toolchain;
@@ -83,6 +165,10 @@ export interface ExtManifest {
     summary?: string;
     /** theme packs: the console colour themes this pack contributes. */
     themes?: ThemeSpec[];
+    /** lang packs: curated IntelliSense (completion/hover/signature) for the
+     * pack's languages, since the console has no in-browser language server for
+     * anything but TypeScript. One entry per `monacoLang`. */
+    intellisense?: LangIntellisense[];
     /** Built-in packs set this; published packs omit it. */
     builtin?: boolean;
 }

package/package.json

@@ -1,14 +1,22 @@
 {
   "name": "@nanobpm/nano-ide-ext-types",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "TypeScript types for the nano-ide.ext.json extension manifest (ADR 0007).",
   "license": "Apache-2.0",
   "type": "module",
-  "publishConfig": { "access": "public" },
-  "repository": { "type": "git", "url": "https://github.com/jwulf/nano-ide.git", "directory": "packages/ext-types" },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jwulf/nano-ide.git",
+    "directory": "packages/ext-types"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc --noEmit"