@nanobpm/nano-ide-ext-types 1.7.0 → 1.8.0

package/README.md

@@ -0,0 +1,37 @@
+# @nanobpm/nano-ide-ext-types
+
+**TypeScript types for the `nano-ide.ext.json` extension manifest** (ADR 0007).
+
+This is the shared type contract for authoring [Nano RAD IDE](https://github.com/Magikcraft/nano-bpm)
+extension packs. Import it in a pack's tooling to get a typed, checked
+`nano-ide.ext.json` — the same manifest shape the host parser
+(`server/src/console/extensions.rs`) validates at load time.
+
+It is a **library, not a marketplace pack**: it ships no `nano-ide.ext.json`
+manifest of its own and contributes nothing to the console UI. It exists so pack
+authors and the manifest validator share one source of truth for the extension
+contract (lang, app, example, theme, and trigger pack kinds, plus the theme
+design-token vocabulary).
+
+## Usage
+
+```ts
+import type { ExtManifest } from "@nanobpm/nano-ide-ext-types";
+
+const manifest: ExtManifest = {
+  id: "my-pack",
+  kind: "lang",
+  displayName: "My language",
+  // …type-checked against the ADR 0007 contract
+};
+```
+
+## Install
+
+```sh
+npm install --save-dev @nanobpm/nano-ide-ext-types
+```
+
+## Licence
+
+Apache-2.0.

package/dist/index.d.ts

@@ -303,6 +303,17 @@ export interface ExtManifest {
      * out of it being a pack journey.
      */
     tours?: TourSpec[];
+    /**
+     * app packs that front an out-of-process CLI (e.g. this Urban pack →
+     * `@nanobpm/urban`'s `urban`/`create-urban-app` bins): opt in to a guarded
+     * `npm install` inside the pack after it is fetched, so its runtime
+     * dependencies' `node_modules/.bin/*` are materialised (an `npm pack` tarball
+     * ships `package.json` but not `node_modules`). Mirrors the host's
+     * `ExtManifest.install_deps: bool`. The host installs `--omit=dev`
+     * `--ignore-scripts` (until the pack is trusted); default/absent is a pure
+     * pack+extract with no network install.
+     */
+    installDeps?: boolean;
 }
 /**
  * A named gate from the console's shared precondition library

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-ide-ext-types",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "TypeScript types for the nano-ide.ext.json extension manifest (ADR 0007).",
   "license": "Apache-2.0",
   "type": "module",
@@ -9,13 +9,14 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/jwulf/nano-ide.git",
+    "url": "git+https://github.com/jwulf/nano-ide.git",
     "directory": "packages/ext-types"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",