@dforge-core/dforge-cli 0.1.0-rc.5 → 0.1.0-rc.7

package/README.md

@@ -91,6 +91,42 @@ dforge-cli module install --path . --code <tenant>   # full validation + install
 
 The first install runs the full server-side validator (manifest, FK targets, package-filter SQL, migration safety) — fix anything it flags, then re-run.
 
+### Programmatic use (subpath export)
+
+The pure-TS builders behind `init module` are also exposed as a library entry, so downstream packages can compose module file maps without shelling to the CLI. Used by [`@dforge-core/dforge-mcp`](https://www.npmjs.com/package/@dforge-core/dforge-mcp) to drive AI-authored modules.
+
+```ts
+import {
+	buildManifest,
+	buildEntity,
+	buildDataViews,
+	buildFolders,
+	buildMenus,
+	buildRoles,
+} from "@dforge-core/dforge-cli/templates";
+import type { ScaffoldOpts, EntitySpec } from "@dforge-core/dforge-cli/templates";
+import { randomUUID } from "node:crypto";
+
+const opts: ScaffoldOpts = {
+	path: "",
+	code: "smoke",
+	displayName: "Smoke",
+	description: "",
+	author: "",
+	license: "MIT",
+	version: "0.1.0",
+	dbSchemaVersion: "0.0.1",
+	dependencies: ["admin", "metadata"],
+	preset: "minimal",
+	entities: [{ name: "thing", label: "Thing", traits: "identity+audit" }],
+};
+
+const manifest = buildManifest(opts, randomUUID());
+// → plain JS object, ready for JSON.stringify
+```
+
+All builders are pure functions returning plain JS objects (no I/O). The subpath ships dual CJS + ESM + `.d.ts` types.
+
 ## Auth
 
 The remote `module install --url` and `marketplace publish` flows need a JWT

package/dist/cli.js

@@ -1009,9 +1009,41 @@ function buildGitignore() {
     ""
   ].join("\n");
 }
+function buildVscodeSettings() {
+  return {
+    "json.schemas": SCHEMA_BINDINGS.map((b3) => ({
+      fileMatch: b3.fileMatch,
+      url: `${SCHEMA_BASE}/${b3.schema}.schema.json`
+    }))
+  };
+}
+function buildZedSettings() {
+  return {
+    languages: {
+      JSON: {
+        "json.schemas": SCHEMA_BINDINGS.map((b3) => ({
+          fileMatch: b3.fileMatch,
+          url: `${SCHEMA_BASE}/${b3.schema}.schema.json`
+        }))
+      }
+    }
+  };
+}
+var SCHEMA_BASE, SCHEMA_BINDINGS;
 var init_templates = __esm({
   "src/init/templates.ts"() {
     "use strict";
+    SCHEMA_BASE = "https://cdn.jsdelivr.net/npm/@dforge-core/dforge-mcp@latest/resources/schemas";
+    SCHEMA_BINDINGS = [
+      { fileMatch: ["manifest.json"], schema: "manifest" },
+      { fileMatch: ["entities/*.json"], schema: "entity" },
+      { fileMatch: ["ui/data_views.json"], schema: "data-views" },
+      { fileMatch: ["ui/folders.json"], schema: "folders" },
+      { fileMatch: ["ui/menus.json"], schema: "menus" },
+      { fileMatch: ["security/roles.json"], schema: "roles" },
+      { fileMatch: ["logic/jobs.json"], schema: "jobs" },
+      { fileMatch: ["seed-data/*.json"], schema: "seed-data" }
+    ];
   }
 });
 
@@ -1208,6 +1240,8 @@ function writeAll(opts) {
   writeJson(path2.join(root, "ui", "actions.json"), buildActions());
   writeJson(path2.join(root, "security", "roles.json"), buildRoles(opts));
   writeText(path2.join(root, ".gitignore"), buildGitignore());
+  writeJson(path2.join(root, ".vscode", "settings.json"), buildVscodeSettings());
+  writeJson(path2.join(root, ".zed", "settings.json"), buildZedSettings());
   if (opts.preset === "full") {
     writeJson(path2.join(root, "settings.json"), buildSettings());
     writeJson(path2.join(root, "translations", "en-US.json"), buildTranslations(opts));

package/dist/lib.d.mts

@@ -62,5 +62,7 @@ declare function buildSettings(): Record<string, unknown>;
 declare function buildTranslations(opts: ScaffoldOpts): Record<string, string>;
 declare function buildSeedData(): unknown[];
 declare function buildGitignore(): string;
+declare function buildVscodeSettings(): Record<string, unknown>;
+declare function buildZedSettings(): Record<string, unknown>;
 
-export { type DataView, type Entity, type EntitySpec, type Manifest, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations };
+export { type DataView, type Entity, type EntitySpec, type Manifest, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations, buildVscodeSettings, buildZedSettings };

package/dist/lib.d.ts

@@ -62,5 +62,7 @@ declare function buildSettings(): Record<string, unknown>;
 declare function buildTranslations(opts: ScaffoldOpts): Record<string, string>;
 declare function buildSeedData(): unknown[];
 declare function buildGitignore(): string;
+declare function buildVscodeSettings(): Record<string, unknown>;
+declare function buildZedSettings(): Record<string, unknown>;
 
-export { type DataView, type Entity, type EntitySpec, type Manifest, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations };
+export { type DataView, type Entity, type EntitySpec, type Manifest, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations, buildVscodeSettings, buildZedSettings };

package/dist/lib.js

@@ -30,7 +30,9 @@ __export(lib_exports, {
   buildRoles: () => buildRoles,
   buildSeedData: () => buildSeedData,
   buildSettings: () => buildSettings,
-  buildTranslations: () => buildTranslations
+  buildTranslations: () => buildTranslations,
+  buildVscodeSettings: () => buildVscodeSettings,
+  buildZedSettings: () => buildZedSettings
 });
 module.exports = __toCommonJS(lib_exports);
 
@@ -162,6 +164,37 @@ function buildGitignore() {
     ""
   ].join("\n");
 }
+var SCHEMA_BASE = "https://cdn.jsdelivr.net/npm/@dforge-core/dforge-mcp@latest/resources/schemas";
+var SCHEMA_BINDINGS = [
+  { fileMatch: ["manifest.json"], schema: "manifest" },
+  { fileMatch: ["entities/*.json"], schema: "entity" },
+  { fileMatch: ["ui/data_views.json"], schema: "data-views" },
+  { fileMatch: ["ui/folders.json"], schema: "folders" },
+  { fileMatch: ["ui/menus.json"], schema: "menus" },
+  { fileMatch: ["security/roles.json"], schema: "roles" },
+  { fileMatch: ["logic/jobs.json"], schema: "jobs" },
+  { fileMatch: ["seed-data/*.json"], schema: "seed-data" }
+];
+function buildVscodeSettings() {
+  return {
+    "json.schemas": SCHEMA_BINDINGS.map((b) => ({
+      fileMatch: b.fileMatch,
+      url: `${SCHEMA_BASE}/${b.schema}.schema.json`
+    }))
+  };
+}
+function buildZedSettings() {
+  return {
+    languages: {
+      JSON: {
+        "json.schemas": SCHEMA_BINDINGS.map((b) => ({
+          fileMatch: b.fileMatch,
+          url: `${SCHEMA_BASE}/${b.schema}.schema.json`
+        }))
+      }
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   buildActions,
@@ -174,5 +207,7 @@ function buildGitignore() {
   buildRoles,
   buildSeedData,
   buildSettings,
-  buildTranslations
+  buildTranslations,
+  buildVscodeSettings,
+  buildZedSettings
 });

package/dist/lib.mjs

@@ -126,6 +126,37 @@ function buildGitignore() {
     ""
   ].join("\n");
 }
+var SCHEMA_BASE = "https://cdn.jsdelivr.net/npm/@dforge-core/dforge-mcp@latest/resources/schemas";
+var SCHEMA_BINDINGS = [
+  { fileMatch: ["manifest.json"], schema: "manifest" },
+  { fileMatch: ["entities/*.json"], schema: "entity" },
+  { fileMatch: ["ui/data_views.json"], schema: "data-views" },
+  { fileMatch: ["ui/folders.json"], schema: "folders" },
+  { fileMatch: ["ui/menus.json"], schema: "menus" },
+  { fileMatch: ["security/roles.json"], schema: "roles" },
+  { fileMatch: ["logic/jobs.json"], schema: "jobs" },
+  { fileMatch: ["seed-data/*.json"], schema: "seed-data" }
+];
+function buildVscodeSettings() {
+  return {
+    "json.schemas": SCHEMA_BINDINGS.map((b) => ({
+      fileMatch: b.fileMatch,
+      url: `${SCHEMA_BASE}/${b.schema}.schema.json`
+    }))
+  };
+}
+function buildZedSettings() {
+  return {
+    languages: {
+      JSON: {
+        "json.schemas": SCHEMA_BINDINGS.map((b) => ({
+          fileMatch: b.fileMatch,
+          url: `${SCHEMA_BASE}/${b.schema}.schema.json`
+        }))
+      }
+    }
+  };
+}
 export {
   buildActions,
   buildDataViews,
@@ -137,5 +168,7 @@ export {
   buildRoles,
   buildSeedData,
   buildSettings,
-  buildTranslations
+  buildTranslations,
+  buildVscodeSettings,
+  buildZedSettings
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dforge-core/dforge-cli",
-	"version": "0.1.0-rc.5",
+	"version": "0.1.0-rc.7",
 	"description": "dForge CLI - validate, pack, publish, and install dForge modules. Distributes a single-file native binary per platform via optionalDependencies (esbuild-style).",
 	"license": "MIT",
 	"homepage": "https://github.com/iash44/dForge-core",