@playableintelligence/template-vite 0.1.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2026 PlayableIntelligence. All rights reserved.
+
+This software is proprietary and confidential. The published npm package
+contains only compiled, minified output; the original source code is not
+distributed. No license is granted to use, copy, modify, distribute, or
+create derivative works from this software except as expressly permitted in
+writing by PlayableIntelligence.

package/README.md

@@ -0,0 +1,24 @@
+# @playableintelligence/template-vite
+
+unplugin-based bundler plugin (Vite-first) for asset-swappable game templates. On every build it extracts `hotswappable()` slots and emits the JSON Schema, fails the build on bad authoring, and serves the schema as a virtual module.
+
+```bash
+npm i -D @playableintelligence/template-vite
+```
+
+```ts
+// vite.config.ts
+import templateSchema from "@playableintelligence/template-vite";
+
+export default {
+  plugins: [templateSchema({ src: "src/**/*.ts", out: "schema.json", template: "my-template" })],
+};
+```
+
+```ts
+import schema from "virtual:workflow/schema";
+```
+
+One core, many bundlers — also exports `rollup`, `webpack`, `esbuild`, and `rspack` factories.
+
+Pairs with `@playableintelligence/template-sdk` + `-cli`. Proprietary — see [LICENSE](./LICENSE).

package/dist/index.cjs

@@ -0,0 +1,4 @@
+"use strict";var g=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var k=Object.prototype.hasOwnProperty;var y=(t,e)=>{for(var n in e)g(t,n,{get:e[n],enumerable:!0})},I=(t,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of x(e))!k.call(t,s)&&s!==n&&g(t,s,{get:()=>e[s],enumerable:!(r=S(e,s))||r.enumerable});return t};var R=t=>I(g({},"__esModule",{value:!0}),t);var b={};y(b,{RESOLVED_VIRTUAL_MODULE_ID:()=>c,VIRTUAL_MODULE_ID:()=>i,buildSchema:()=>l,default:()=>E,esbuild:()=>A,formatDiagnostics:()=>p,rollup:()=>v,rspack:()=>_,unplugin:()=>o,validateInputs:()=>u,vite:()=>h,webpack:()=>U});module.exports=R(b);var f=require("fs"),m=require("path"),D=require("unplugin");var a=require("@playableintelligence/template-cli"),w=require("@playableintelligence/template-sdk"),i="virtual:workflow/schema",c=`\0${i}`,O=["src/**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"];function L(t){return t===void 0?O:Array.isArray(t)?t:[t]}function l(t={}){let e=(0,a.extract)({entries:L(t.src),cwd:t.cwd,packageSpecifiers:t.packageSpecifiers}),n=e.diagnostics.filter(d=>d.severity==="error"),r=e.diagnostics.filter(d=>d.severity==="warning");return{schema:(0,a.toJsonSchema)(e.descriptors,{template:t.template}),descriptors:e.descriptors,errors:n,warnings:r}}function u(t,e){let n=(0,w.createRuntime)(e);for(let r of t)n.resolve({name:r.name,input:r.input,variable:r.variable,default:r.default,...r.description!==void 0?{description:r.description}:{},...r.constraints?{constraints:r.constraints}:{}});return n.diagnostics()}function p(t){return t.map(e=>`  ${e.severity} [${e.code}] ${e.loc.file}:${e.loc.line}:${e.loc.column} \u2014 ${e.message}`).join(`
+`)}var $=(t={})=>{let e,n=()=>{let r=l(t);if(e=r,r.errors.length>0)throw new Error(`[workflow] extraction failed with ${r.errors.length} error(s):
+${p(r.errors)}`);for(let s of r.warnings)console.warn(`[workflow] warning [${s.code}] ${s.loc.file}:${s.loc.line} \u2014 ${s.message}`);if(t.out){let s=(0,m.resolve)(t.cwd??process.cwd(),t.out);(0,f.mkdirSync)((0,m.dirname)(s),{recursive:!0}),(0,f.writeFileSync)(s,`${JSON.stringify(r.schema,null,2)}
+`,"utf8")}if(t.inputs)for(let s of u(r.descriptors,t.inputs))console.warn(`[workflow] ${s.code}: ${s.message}`);return r};return{name:"unplugin-workflow",buildStart(){n()},resolveId(r){return r===i?c:null},load(r){if(r!==c)return null;let s=(e??n()).schema;return`export default ${JSON.stringify(s)};`}}},o=(0,D.createUnplugin)($),h=o.vite,v=o.rollup,U=o.webpack,_=o.rspack,A=o.esbuild,E=h;0&&(module.exports={RESOLVED_VIRTUAL_MODULE_ID,VIRTUAL_MODULE_ID,buildSchema,esbuild,formatDiagnostics,rollup,rspack,unplugin,validateInputs,vite,webpack});

package/dist/index.d.cts

@@ -0,0 +1,58 @@
+import * as _rollup from 'rollup';
+import * as _vite from 'vite';
+import * as _unplugin from 'unplugin';
+import { AssetDescriptor, Diagnostic } from '@playableintelligence/template-cli';
+import { AssetInputs, RuntimeDiagnostic } from '@playableintelligence/template-sdk';
+
+/**
+ * Core logic for the workflow bundler plugin (M06).
+ *
+ * Thin wrapper over the CLI's `extract` + `toJsonSchema` (no second extraction
+ * or schema code path — ADR 0006). Input validation reuses the SDK runtime so it
+ * can never drift from real resolution semantics.
+ */
+
+/** Virtual module specifier the app imports to read its own schema. */
+declare const VIRTUAL_MODULE_ID = "virtual:workflow/schema";
+/** Resolved (null-prefixed) id, per bundler virtual-module convention. */
+declare const RESOLVED_VIRTUAL_MODULE_ID = "\0virtual:workflow/schema";
+interface WorkflowPluginOptions {
+    /** Source globs to scan. Default: `src/**` over TS/JS flavors. */
+    src?: string | string[];
+    /** Output path for `schema.json` (relative to `cwd`). When omitted, nothing is written. */
+    out?: string;
+    /** Template name recorded as `x-gc-template`. */
+    template?: string;
+    /** Working directory for glob resolution. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Sample provided inputs to validate against the schema in dev. */
+    inputs?: AssetInputs;
+    /** Package specifiers whose `hotswappable` export is the extraction target. */
+    packageSpecifiers?: string[];
+}
+interface BuildSchemaResult {
+    schema: Record<string, unknown>;
+    descriptors: AssetDescriptor[];
+    errors: Diagnostic[];
+    warnings: Diagnostic[];
+}
+/** Extract slots and emit the JSON Schema. Reports diagnostics; never throws on bad input. */
+declare function buildSchema(options?: WorkflowPluginOptions): BuildSchemaResult;
+/**
+ * Validate provided inputs against extracted slots by replaying them through the
+ * SDK runtime — yielding the same `unknown-variable` / `unsatisfied-required-constraint`
+ * diagnostics the game would see at runtime.
+ */
+declare function validateInputs(descriptors: AssetDescriptor[], inputs: AssetInputs): RuntimeDiagnostic[];
+/** Format extraction diagnostics for terminal / overlay output. */
+declare function formatDiagnostics(diagnostics: Diagnostic[]): string;
+
+/** The shared unplugin instance (exposes `.vite`, `.rollup`, `.raw`, …). */
+declare const unplugin: _unplugin.UnpluginInstance<WorkflowPluginOptions | undefined, boolean>;
+declare const vite: (options?: WorkflowPluginOptions | undefined) => _vite.Plugin<any> | _vite.Plugin<any>[];
+declare const rollup: (options?: WorkflowPluginOptions | undefined) => _rollup.Plugin<any> | _rollup.Plugin<any>[];
+declare const webpack: (options?: WorkflowPluginOptions | undefined) => WebpackPluginInstance;
+declare const rspack: (options?: WorkflowPluginOptions | undefined) => RspackPluginInstance;
+declare const esbuild: (options?: WorkflowPluginOptions | undefined) => _unplugin.EsbuildPlugin;
+
+export { type BuildSchemaResult, RESOLVED_VIRTUAL_MODULE_ID, VIRTUAL_MODULE_ID, type WorkflowPluginOptions, buildSchema, vite as default, esbuild, formatDiagnostics, rollup, rspack, unplugin, validateInputs, vite, webpack };

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import * as _rollup from 'rollup';
+import * as _vite from 'vite';
+import * as _unplugin from 'unplugin';
+import { AssetDescriptor, Diagnostic } from '@playableintelligence/template-cli';
+import { AssetInputs, RuntimeDiagnostic } from '@playableintelligence/template-sdk';
+
+/**
+ * Core logic for the workflow bundler plugin (M06).
+ *
+ * Thin wrapper over the CLI's `extract` + `toJsonSchema` (no second extraction
+ * or schema code path — ADR 0006). Input validation reuses the SDK runtime so it
+ * can never drift from real resolution semantics.
+ */
+
+/** Virtual module specifier the app imports to read its own schema. */
+declare const VIRTUAL_MODULE_ID = "virtual:workflow/schema";
+/** Resolved (null-prefixed) id, per bundler virtual-module convention. */
+declare const RESOLVED_VIRTUAL_MODULE_ID = "\0virtual:workflow/schema";
+interface WorkflowPluginOptions {
+    /** Source globs to scan. Default: `src/**` over TS/JS flavors. */
+    src?: string | string[];
+    /** Output path for `schema.json` (relative to `cwd`). When omitted, nothing is written. */
+    out?: string;
+    /** Template name recorded as `x-gc-template`. */
+    template?: string;
+    /** Working directory for glob resolution. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Sample provided inputs to validate against the schema in dev. */
+    inputs?: AssetInputs;
+    /** Package specifiers whose `hotswappable` export is the extraction target. */
+    packageSpecifiers?: string[];
+}
+interface BuildSchemaResult {
+    schema: Record<string, unknown>;
+    descriptors: AssetDescriptor[];
+    errors: Diagnostic[];
+    warnings: Diagnostic[];
+}
+/** Extract slots and emit the JSON Schema. Reports diagnostics; never throws on bad input. */
+declare function buildSchema(options?: WorkflowPluginOptions): BuildSchemaResult;
+/**
+ * Validate provided inputs against extracted slots by replaying them through the
+ * SDK runtime — yielding the same `unknown-variable` / `unsatisfied-required-constraint`
+ * diagnostics the game would see at runtime.
+ */
+declare function validateInputs(descriptors: AssetDescriptor[], inputs: AssetInputs): RuntimeDiagnostic[];
+/** Format extraction diagnostics for terminal / overlay output. */
+declare function formatDiagnostics(diagnostics: Diagnostic[]): string;
+
+/** The shared unplugin instance (exposes `.vite`, `.rollup`, `.raw`, …). */
+declare const unplugin: _unplugin.UnpluginInstance<WorkflowPluginOptions | undefined, boolean>;
+declare const vite: (options?: WorkflowPluginOptions | undefined) => _vite.Plugin<any> | _vite.Plugin<any>[];
+declare const rollup: (options?: WorkflowPluginOptions | undefined) => _rollup.Plugin<any> | _rollup.Plugin<any>[];
+declare const webpack: (options?: WorkflowPluginOptions | undefined) => WebpackPluginInstance;
+declare const rspack: (options?: WorkflowPluginOptions | undefined) => RspackPluginInstance;
+declare const esbuild: (options?: WorkflowPluginOptions | undefined) => _unplugin.EsbuildPlugin;
+
+export { type BuildSchemaResult, RESOLVED_VIRTUAL_MODULE_ID, VIRTUAL_MODULE_ID, type WorkflowPluginOptions, buildSchema, vite as default, esbuild, formatDiagnostics, rollup, rspack, unplugin, validateInputs, vite, webpack };

package/dist/index.js

@@ -0,0 +1,4 @@
+import{mkdirSync as D,writeFileSync as h}from"fs";import{dirname as S,resolve as x}from"path";import{createUnplugin as k}from"unplugin";import{extract as f,toJsonSchema as m}from"@playableintelligence/template-cli";import{createRuntime as d}from"@playableintelligence/template-sdk";var i="virtual:workflow/schema",c=`\0${i}`,g=["src/**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"];function w(e){return e===void 0?g:Array.isArray(e)?e:[e]}function l(e={}){let r=f({entries:w(e.src),cwd:e.cwd,packageSpecifiers:e.packageSpecifiers}),n=r.diagnostics.filter(a=>a.severity==="error"),t=r.diagnostics.filter(a=>a.severity==="warning");return{schema:m(r.descriptors,{template:e.template}),descriptors:r.descriptors,errors:n,warnings:t}}function u(e,r){let n=d(r);for(let t of e)n.resolve({name:t.name,input:t.input,variable:t.variable,default:t.default,...t.description!==void 0?{description:t.description}:{},...t.constraints?{constraints:t.constraints}:{}});return n.diagnostics()}function p(e){return e.map(r=>`  ${r.severity} [${r.code}] ${r.loc.file}:${r.loc.line}:${r.loc.column} \u2014 ${r.message}`).join(`
+`)}var y=(e={})=>{let r,n=()=>{let t=l(e);if(r=t,t.errors.length>0)throw new Error(`[workflow] extraction failed with ${t.errors.length} error(s):
+${p(t.errors)}`);for(let s of t.warnings)console.warn(`[workflow] warning [${s.code}] ${s.loc.file}:${s.loc.line} \u2014 ${s.message}`);if(e.out){let s=x(e.cwd??process.cwd(),e.out);D(S(s),{recursive:!0}),h(s,`${JSON.stringify(t.schema,null,2)}
+`,"utf8")}if(e.inputs)for(let s of u(t.descriptors,e.inputs))console.warn(`[workflow] ${s.code}: ${s.message}`);return t};return{name:"unplugin-workflow",buildStart(){n()},resolveId(t){return t===i?c:null},load(t){if(t!==c)return null;let s=(r??n()).schema;return`export default ${JSON.stringify(s)};`}}},o=k(y),I=o.vite,A=o.rollup,E=o.webpack,b=o.rspack,V=o.esbuild,P=I;export{c as RESOLVED_VIRTUAL_MODULE_ID,i as VIRTUAL_MODULE_ID,l as buildSchema,P as default,V as esbuild,p as formatDiagnostics,A as rollup,b as rspack,o as unplugin,u as validateInputs,I as vite,E as webpack};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@playableintelligence/template-vite",
+  "version": "0.1.0",
+  "description": "unplugin-based bundler plugin (Vite-first) that emits the template JSON Schema at build time, fails fast on diagnostics, exposes a virtual schema module, and validates inputs in dev.",
+  "license": "UNLICENSED",
+  "author": "PlayableIntelligence",
+  "keywords": [
+    "playableintelligence",
+    "game-template",
+    "vite-plugin",
+    "unplugin",
+    "json-schema"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "tsup",
+    "publish:dry": "bun publish --dry-run",
+    "publish:pkg": "bun publish"
+  },
+  "dependencies": {
+    "@playableintelligence/template-cli": "0.0.0",
+    "@playableintelligence/template-sdk": "0.0.0",
+    "unplugin": "^2.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "vite": "^6.0.0"
+  },
+  "peerDependencies": {
+    "vite": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}