@celox-sim/vite-plugin 0.0.1 → 0.1.3

package/dist/cache.d.ts

@@ -0,0 +1,18 @@
+import type { GenTsJsonOutput } from "./types.js";
+export declare class GenTsCache {
+    private readonly _projectRoot;
+    private _data;
+    private _mtimeKey;
+    constructor(_projectRoot: string);
+    /** Get cached data, refreshing if any .veryl file has changed. */
+    get(): GenTsJsonOutput;
+    /** Force invalidation — next `get()` will re-run the generator. */
+    invalidate(): void;
+    /**
+     * Build a key from the max mtime of all .veryl files in the project.
+     * This is intentionally cheap — only stats, no file reads.
+     */
+    private computeMtimeKey;
+    private walkVerylFiles;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,YAAY;IAHzC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,SAAS,CAAM;gBAEM,YAAY,EAAE,MAAM;IAEjD,kEAAkE;IAClE,GAAG,IAAI,eAAe;IAUtB,mEAAmE;IACnE,UAAU,IAAI,IAAI;IAKlB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,cAAc;CAgCvB"}

package/dist/cache.js

@@ -0,0 +1,71 @@
+import { readdirSync, statSync } from "node:fs";
+import { join, extname } from "node:path";
+import { runGenTs } from "./generator.js";
+export class GenTsCache {
+    _projectRoot;
+    _data;
+    _mtimeKey = "";
+    constructor(_projectRoot) {
+        this._projectRoot = _projectRoot;
+    }
+    /** Get cached data, refreshing if any .veryl file has changed. */
+    get() {
+        const key = this.computeMtimeKey();
+        if (this._data && this._mtimeKey === key) {
+            return this._data;
+        }
+        this._data = runGenTs(this._projectRoot);
+        this._mtimeKey = key;
+        return this._data;
+    }
+    /** Force invalidation — next `get()` will re-run the generator. */
+    invalidate() {
+        this._mtimeKey = "";
+        this._data = undefined;
+    }
+    /**
+     * Build a key from the max mtime of all .veryl files in the project.
+     * This is intentionally cheap — only stats, no file reads.
+     */
+    computeMtimeKey() {
+        let maxMtime = 0;
+        let count = 0;
+        this.walkVerylFiles(this._projectRoot, (mtimeMs) => {
+            if (mtimeMs > maxMtime)
+                maxMtime = mtimeMs;
+            count++;
+        });
+        return `${count}:${maxMtime}`;
+    }
+    walkVerylFiles(dir, cb) {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip common non-source directories
+                if (entry.name === "node_modules" ||
+                    entry.name === "target" ||
+                    entry.name === ".git" ||
+                    entry.name === "dist") {
+                    continue;
+                }
+                this.walkVerylFiles(full, cb);
+            }
+            else if (extname(entry.name) === ".veryl") {
+                try {
+                    cb(statSync(full).mtimeMs);
+                }
+                catch {
+                    // file may have been deleted
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,OAAO,UAAU;IAIQ;IAHrB,KAAK,CAA8B;IACnC,SAAS,GAAG,EAAE,CAAC;IAEvB,YAA6B,YAAoB;QAApB,iBAAY,GAAZ,YAAY,CAAQ;IAAG,CAAC;IAErD,kEAAkE;IAClE,GAAG;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,KAAK,GAAG,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,mEAAmE;IACnE,UAAU;QACR,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;IAED;;;OAGG;IACK,eAAe;QACrB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;YACjD,IAAI,OAAO,GAAG,QAAQ;gBAAE,QAAQ,GAAG,OAAO,CAAC;YAC3C,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC;IAChC,CAAC;IAEO,cAAc,CACpB,GAAW,EACX,EAA6B;QAE7B,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,qCAAqC;gBACrC,IACE,KAAK,CAAC,IAAI,KAAK,cAAc;oBAC7B,KAAK,CAAC,IAAI,KAAK,QAAQ;oBACvB,KAAK,CAAC,IAAI,KAAK,MAAM;oBACrB,KAAK,CAAC,IAAI,KAAK,MAAM,EACrB,CAAC;oBACD,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC5C,IAAI,CAAC;oBACH,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC7B,CAAC;gBAAC,MAAM,CAAC;oBACP,6BAA6B;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/generator.d.ts

@@ -0,0 +1,6 @@
+import type { GenTsJsonOutput } from "./types.js";
+/**
+ * Run the TypeScript type generator via the NAPI addon and parse the output.
+ */
+export declare function runGenTs(projectRoot: string): GenTsJsonOutput;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAI7D"}

package/dist/generator.js

@@ -0,0 +1,10 @@
+import { loadNativeAddon } from "@celox-sim/celox";
+/**
+ * Run the TypeScript type generator via the NAPI addon and parse the output.
+ */
+export function runGenTs(projectRoot) {
+    const addon = loadNativeAddon();
+    const json = addon.genTs(projectRoot);
+    return JSON.parse(json);
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB;IAC1C,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;AAC7C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { Plugin } from "vite";
+import type { CeloxPluginOptions } from "./types.js";
+export type { CeloxPluginOptions } from "./types.js";
+/**
+ * Vite plugin for importing `.veryl` files as typed `ModuleDefinition` objects.
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import celox from "@celox-sim/vite-plugin";
+ * export default defineConfig({ plugins: [celox()] });
+ *
+ * // test file
+ * import { Adder } from './src/Adder.veryl';
+ * const sim = Simulator.create(Adder); // fully typed
+ * ```
+ */
+export default function celoxPlugin(options?: CeloxPluginOptions): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,YAAY,CAAC;AAIlE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAsFxE"}

package/dist/index.js

@@ -0,0 +1,152 @@
+import { resolve, isAbsolute, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { GenTsCache } from "./cache.js";
+import { generateSidecars, cleanSidecars } from "./sidecar.js";
+const VERYL_PREFIX = "\0veryl:";
+/**
+ * Vite plugin for importing `.veryl` files as typed `ModuleDefinition` objects.
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import celox from "@celox-sim/vite-plugin";
+ * export default defineConfig({ plugins: [celox()] });
+ *
+ * // test file
+ * import { Adder } from './src/Adder.veryl';
+ * const sim = Simulator.create(Adder); // fully typed
+ * ```
+ */
+export default function celoxPlugin(options) {
+    let projectRoot;
+    let cache;
+    let sidecarPaths = [];
+    return {
+        name: "vite-plugin-celox",
+        enforce: "pre",
+        configResolved(config) {
+            // Determine project root
+            if (options?.projectRoot) {
+                projectRoot = resolve(options.projectRoot);
+            }
+            else {
+                projectRoot = findVerylProjectRoot(config.root);
+            }
+            cache = new GenTsCache(projectRoot);
+        },
+        buildStart() {
+            // Run generator and create type sidecars
+            const data = cache.get();
+            cleanSidecars(sidecarPaths);
+            sidecarPaths = generateSidecars(data, projectRoot);
+        },
+        resolveId(source, importer) {
+            if (!source.endsWith(".veryl"))
+                return;
+            // Resolve to absolute path
+            let absPath;
+            if (isAbsolute(source)) {
+                absPath = source;
+            }
+            else if (importer) {
+                absPath = resolve(dirname(importer), source);
+            }
+            else {
+                absPath = resolve(source);
+            }
+            // Only handle .veryl files that exist
+            if (!existsSync(absPath))
+                return;
+            return VERYL_PREFIX + absPath;
+        },
+        load(id) {
+            if (!id.startsWith(VERYL_PREFIX))
+                return;
+            const absPath = id.slice(VERYL_PREFIX.length);
+            const data = cache.get();
+            // Find the relative source file path
+            const relPath = makeRelative(absPath, projectRoot);
+            const moduleNames = data.fileModules[relPath];
+            if (!moduleNames || moduleNames.length === 0) {
+                this.warn(`No modules found in ${relPath}`);
+                return "export {};";
+            }
+            // Build ESM exports for each module in this file
+            const exports = moduleNames
+                .map((name) => {
+                const mod = data.modules.find((m) => m.moduleName === name);
+                if (!mod)
+                    return "";
+                return generateEsmExport(mod, data.projectPath);
+            })
+                .filter((s) => s.length > 0)
+                .join("\n\n");
+            return exports;
+        },
+        handleHotUpdate({ file }) {
+            if (!file.endsWith(".veryl"))
+                return;
+            // Invalidate cache so next load re-runs the generator
+            cache.invalidate();
+            // Re-generate sidecars
+            const data = cache.get();
+            cleanSidecars(sidecarPaths);
+            sidecarPaths = generateSidecars(data, projectRoot);
+        },
+    };
+}
+/**
+ * Search upward from `startDir` for a directory containing `Veryl.toml`.
+ */
+function findVerylProjectRoot(startDir) {
+    let dir = resolve(startDir);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        if (existsSync(resolve(dir, "Veryl.toml"))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new Error("Could not find Veryl.toml in any parent directory. " +
+                "Set the projectRoot plugin option explicitly.");
+        }
+        dir = parent;
+    }
+}
+/**
+ * Make `absPath` relative to `base`, using forward slashes.
+ */
+function makeRelative(absPath, base) {
+    // Normalise to forward slashes so the comparison works on Windows
+    const normAbs = absPath.replace(/\\/g, "/");
+    const normBase = base.replace(/\\/g, "/").replace(/\/$/, "");
+    let rel = normAbs;
+    if (normAbs.startsWith(normBase + "/")) {
+        rel = normAbs.slice(normBase.length + 1);
+    }
+    else if (normAbs.startsWith(normBase)) {
+        rel = normAbs.slice(normBase.length);
+    }
+    if (rel.startsWith("/")) {
+        rel = rel.slice(1);
+    }
+    return rel;
+}
+/**
+ * Generate an ESM export for a single module.
+ */
+function generateEsmExport(mod, projectPath) {
+    const portsJson = JSON.stringify(mod.ports, null, 2)
+        .split("\n")
+        .map((line, i) => (i === 0 ? line : "  " + line))
+        .join("\n");
+    const eventsJson = JSON.stringify(mod.events);
+    return `export const ${mod.moduleName} = {
+  __celox_module: true,
+  name: ${JSON.stringify(mod.moduleName)},
+  source: "",
+  projectPath: ${JSON.stringify(projectPath)},
+  ports: ${portsJson},
+  events: ${eventsJson},
+};`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI/D,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,OAA4B;IAC9D,IAAI,WAAmB,CAAC;IACxB,IAAI,KAAiB,CAAC;IACtB,IAAI,YAAY,GAAa,EAAE,CAAC;IAEhC,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,KAAK;QAEd,cAAc,CAAC,MAAM;YACnB,yBAAyB;YACzB,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;gBACzB,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,KAAK,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;QAED,UAAU;YACR,yCAAyC;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YACzB,aAAa,CAAC,YAAY,CAAC,CAAC;YAC5B,YAAY,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;QAED,SAAS,CAAC,MAAM,EAAE,QAAQ;YACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAEvC,2BAA2B;YAC3B,IAAI,OAAe,CAAC;YACpB,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,OAAO,GAAG,MAAM,CAAC;YACnB,CAAC;iBAAM,IAAI,QAAQ,EAAE,CAAC;gBACpB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YAED,sCAAsC;YACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO;YAEjC,OAAO,YAAY,GAAG,OAAO,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,EAAE;YACL,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;gBAAE,OAAO;YAEzC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAEzB,qCAAqC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAE9C,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;gBAC5C,OAAO,YAAY,CAAC;YACtB,CAAC;YAED,iDAAiD;YACjD,MAAM,OAAO,GAAG,WAAW;iBACxB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACZ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;gBAC5D,IAAI,CAAC,GAAG;oBAAE,OAAO,EAAE,CAAC;gBACpB,OAAO,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YAClD,CAAC,CAAC;iBACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;iBAC3B,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,eAAe,CAAC,EAAE,IAAI,EAAE;YACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAErC,sDAAsD;YACtD,KAAK,CAAC,UAAU,EAAE,CAAC;YAEnB,uBAAuB;YACvB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YACzB,aAAa,CAAC,YAAY,CAAC,CAAC;YAC5B,YAAY,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,QAAgB;IAC5C,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,iDAAiD;IACjD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;YAC3C,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,qDAAqD;gBACnD,+CAA+C,CAClD,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe,EAAE,IAAY;IACjD,kEAAkE;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7D,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC;QACvC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,GAAgB,EAAE,WAAmB;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SACjD,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;SAChD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE9C,OAAO,gBAAgB,GAAG,CAAC,UAAU;;UAE7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;;iBAEvB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;WACjC,SAAS;YACR,UAAU;GACnB,CAAC;AACJ,CAAC"}

package/dist/sidecar.d.ts

@@ -0,0 +1,17 @@
+import type { GenTsJsonOutput } from "./types.js";
+/** Default directory (relative to project root) for generated sidecar files. */
+export declare const SIDECAR_DIR = ".celox";
+/**
+ * Generate `.d.veryl.ts` sidecar files in the sidecar directory,
+ * mirroring the source tree structure.
+ *
+ * TypeScript picks these up via `allowArbitraryExtensions` + `rootDirs`
+ * in tsconfig.  For example, `src/Adder.veryl` produces
+ * `.celox/src/Adder.d.veryl.ts`.
+ */
+export declare function generateSidecars(data: GenTsJsonOutput, projectRoot: string): string[];
+/**
+ * Remove all sidecar files that were previously generated.
+ */
+export declare function cleanSidecars(paths: string[]): void;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../src/sidecar.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,gFAAgF;AAChF,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAkCV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAUnD"}

package/dist/sidecar.js

@@ -0,0 +1,68 @@
+import { writeFileSync, mkdirSync, unlinkSync, existsSync } from "node:fs";
+import { join, resolve, dirname, relative, isAbsolute } from "node:path";
+/** Default directory (relative to project root) for generated sidecar files. */
+export const SIDECAR_DIR = ".celox";
+/**
+ * Generate `.d.veryl.ts` sidecar files in the sidecar directory,
+ * mirroring the source tree structure.
+ *
+ * TypeScript picks these up via `allowArbitraryExtensions` + `rootDirs`
+ * in tsconfig.  For example, `src/Adder.veryl` produces
+ * `.celox/src/Adder.d.veryl.ts`.
+ */
+export function generateSidecars(data, projectRoot) {
+    const written = [];
+    const root = resolve(projectRoot);
+    const outDir = join(root, SIDECAR_DIR);
+    for (const [sourceFile, moduleNames] of Object.entries(data.fileModules)) {
+        const verylPath = resolve(projectRoot, sourceFile);
+        // Skip files that don't exist on disk (e.g. standard library paths
+        // reported with a stripped leading "/" by celox-gen-ts)
+        if (!existsSync(verylPath))
+            continue;
+        const rel = relative(root, verylPath);
+        // Skip files outside the project root (e.g. standard library from global
+        // cache).  On Windows, relative() across different drives returns an
+        // absolute path; on all platforms, paths outside root start with "..".
+        if (isAbsolute(rel) || rel.startsWith(".."))
+            continue;
+        const sidecarPath = sidecarPathFor(join(outDir, rel));
+        const modules = moduleNames
+            .map((name) => data.modules.find((m) => m.moduleName === name))
+            .filter((m) => m !== undefined);
+        if (modules.length === 0)
+            continue;
+        // Combine dtsContent from all modules in this file
+        // Each module's dtsContent already contains the import and interface
+        const content = modules.map((m) => m.dtsContent).join("\n");
+        mkdirSync(dirname(sidecarPath), { recursive: true });
+        writeFileSync(sidecarPath, content, "utf-8");
+        written.push(sidecarPath);
+    }
+    return written;
+}
+/**
+ * Remove all sidecar files that were previously generated.
+ */
+export function cleanSidecars(paths) {
+    for (const p of paths) {
+        try {
+            if (existsSync(p)) {
+                unlinkSync(p);
+            }
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    }
+}
+/**
+ * Given `/path/to/.celox/src/Adder.veryl`, returns `/path/to/.celox/src/Adder.d.veryl.ts`.
+ */
+function sidecarPathFor(verylPath) {
+    const dir = dirname(verylPath);
+    const base = verylPath.slice(dir.length + 1); // "Adder.veryl"
+    const stem = base.replace(/\.veryl$/, "");
+    return join(dir, `${stem}.d.veryl.ts`);
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.js","sourceRoot":"","sources":["../src/sidecar.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+/** JSON output from `celox-gen-ts --json`. */
+export interface GenTsJsonOutput {
+    readonly projectPath: string;
+    readonly modules: readonly GenTsModule[];
+    readonly fileModules: Record<string, readonly string[]>;
+}
+/** Per-module entry from `celox-gen-ts --json`. */
+export interface GenTsModule {
+    readonly moduleName: string;
+    readonly sourceFile: string;
+    readonly dtsContent: string;
+    readonly mdContent: string;
+    readonly ports: Record<string, GenTsPortInfo>;
+    readonly events: readonly string[];
+}
+/** Port metadata from the generator. */
+export interface GenTsPortInfo {
+    readonly direction: "input" | "output" | "inout";
+    readonly type: "clock" | "reset" | "logic" | "bit";
+    readonly width: number;
+    readonly is4state: boolean;
+}
+/** Plugin options. */
+export interface CeloxPluginOptions {
+    /** Explicit path to the Veryl project root (directory containing Veryl.toml). */
+    projectRoot?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CACzD;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,sBAAsB;AACtB,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,10 +1,46 @@
 {
   "name": "@celox-sim/vite-plugin",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @celox-sim/vite-plugin",
+  "version": "0.1.3",
+  "description": "Vite plugin for importing .veryl files as typed ModuleDefinition objects",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "celox",
+    "veryl",
+    "hdl",
+    "vite",
+    "vitest",
+    "plugin"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/celox-sim/celox",
+    "directory": "packages/vite-plugin"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "dependencies": {
+    "@celox-sim/celox": "0.1.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}

package/src/cache.ts

@@ -0,0 +1,75 @@
+import { readdirSync, statSync } from "node:fs";
+import { join, extname } from "node:path";
+import type { GenTsJsonOutput } from "./types.js";
+import { runGenTs } from "./generator.js";
+
+export class GenTsCache {
+  private _data: GenTsJsonOutput | undefined;
+  private _mtimeKey = "";
+
+  constructor(private readonly _projectRoot: string) {}
+
+  /** Get cached data, refreshing if any .veryl file has changed. */
+  get(): GenTsJsonOutput {
+    const key = this.computeMtimeKey();
+    if (this._data && this._mtimeKey === key) {
+      return this._data;
+    }
+    this._data = runGenTs(this._projectRoot);
+    this._mtimeKey = key;
+    return this._data;
+  }
+
+  /** Force invalidation — next `get()` will re-run the generator. */
+  invalidate(): void {
+    this._mtimeKey = "";
+    this._data = undefined;
+  }
+
+  /**
+   * Build a key from the max mtime of all .veryl files in the project.
+   * This is intentionally cheap — only stats, no file reads.
+   */
+  private computeMtimeKey(): string {
+    let maxMtime = 0;
+    let count = 0;
+    this.walkVerylFiles(this._projectRoot, (mtimeMs) => {
+      if (mtimeMs > maxMtime) maxMtime = mtimeMs;
+      count++;
+    });
+    return `${count}:${maxMtime}`;
+  }
+
+  private walkVerylFiles(
+    dir: string,
+    cb: (mtimeMs: number) => void,
+  ): void {
+    let entries;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        // Skip common non-source directories
+        if (
+          entry.name === "node_modules" ||
+          entry.name === "target" ||
+          entry.name === ".git" ||
+          entry.name === "dist"
+        ) {
+          continue;
+        }
+        this.walkVerylFiles(full, cb);
+      } else if (extname(entry.name) === ".veryl") {
+        try {
+          cb(statSync(full).mtimeMs);
+        } catch {
+          // file may have been deleted
+        }
+      }
+    }
+  }
+}

package/src/generator.ts

@@ -0,0 +1,11 @@
+import { loadNativeAddon } from "@celox-sim/celox";
+import type { GenTsJsonOutput } from "./types.js";
+
+/**
+ * Run the TypeScript type generator via the NAPI addon and parse the output.
+ */
+export function runGenTs(projectRoot: string): GenTsJsonOutput {
+  const addon = loadNativeAddon();
+  const json = addon.genTs(projectRoot);
+  return JSON.parse(json) as GenTsJsonOutput;
+}

package/src/index.ts

@@ -0,0 +1,172 @@
+import { resolve, isAbsolute, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import type { Plugin } from "vite";
+import type { CeloxPluginOptions, GenTsModule } from "./types.js";
+import { GenTsCache } from "./cache.js";
+import { generateSidecars, cleanSidecars } from "./sidecar.js";
+
+export type { CeloxPluginOptions } from "./types.js";
+
+const VERYL_PREFIX = "\0veryl:";
+
+/**
+ * Vite plugin for importing `.veryl` files as typed `ModuleDefinition` objects.
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import celox from "@celox-sim/vite-plugin";
+ * export default defineConfig({ plugins: [celox()] });
+ *
+ * // test file
+ * import { Adder } from './src/Adder.veryl';
+ * const sim = Simulator.create(Adder); // fully typed
+ * ```
+ */
+export default function celoxPlugin(options?: CeloxPluginOptions): Plugin {
+  let projectRoot: string;
+  let cache: GenTsCache;
+  let sidecarPaths: string[] = [];
+
+  return {
+    name: "vite-plugin-celox",
+    enforce: "pre",
+
+    configResolved(config) {
+      // Determine project root
+      if (options?.projectRoot) {
+        projectRoot = resolve(options.projectRoot);
+      } else {
+        projectRoot = findVerylProjectRoot(config.root);
+      }
+
+      cache = new GenTsCache(projectRoot);
+    },
+
+    buildStart() {
+      // Run generator and create type sidecars
+      const data = cache.get();
+      cleanSidecars(sidecarPaths);
+      sidecarPaths = generateSidecars(data, projectRoot);
+    },
+
+    resolveId(source, importer) {
+      if (!source.endsWith(".veryl")) return;
+
+      // Resolve to absolute path
+      let absPath: string;
+      if (isAbsolute(source)) {
+        absPath = source;
+      } else if (importer) {
+        absPath = resolve(dirname(importer), source);
+      } else {
+        absPath = resolve(source);
+      }
+
+      // Only handle .veryl files that exist
+      if (!existsSync(absPath)) return;
+
+      return VERYL_PREFIX + absPath;
+    },
+
+    load(id) {
+      if (!id.startsWith(VERYL_PREFIX)) return;
+
+      const absPath = id.slice(VERYL_PREFIX.length);
+      const data = cache.get();
+
+      // Find the relative source file path
+      const relPath = makeRelative(absPath, projectRoot);
+      const moduleNames = data.fileModules[relPath];
+
+      if (!moduleNames || moduleNames.length === 0) {
+        this.warn(`No modules found in ${relPath}`);
+        return "export {};";
+      }
+
+      // Build ESM exports for each module in this file
+      const exports = moduleNames
+        .map((name) => {
+          const mod = data.modules.find((m) => m.moduleName === name);
+          if (!mod) return "";
+          return generateEsmExport(mod, data.projectPath);
+        })
+        .filter((s) => s.length > 0)
+        .join("\n\n");
+
+      return exports;
+    },
+
+    handleHotUpdate({ file }) {
+      if (!file.endsWith(".veryl")) return;
+
+      // Invalidate cache so next load re-runs the generator
+      cache.invalidate();
+
+      // Re-generate sidecars
+      const data = cache.get();
+      cleanSidecars(sidecarPaths);
+      sidecarPaths = generateSidecars(data, projectRoot);
+    },
+  };
+}
+
+/**
+ * Search upward from `startDir` for a directory containing `Veryl.toml`.
+ */
+function findVerylProjectRoot(startDir: string): string {
+  let dir = resolve(startDir);
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    if (existsSync(resolve(dir, "Veryl.toml"))) {
+      return dir;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) {
+      throw new Error(
+        "Could not find Veryl.toml in any parent directory. " +
+          "Set the projectRoot plugin option explicitly.",
+      );
+    }
+    dir = parent;
+  }
+}
+
+/**
+ * Make `absPath` relative to `base`, using forward slashes.
+ */
+function makeRelative(absPath: string, base: string): string {
+  // Normalise to forward slashes so the comparison works on Windows
+  const normAbs = absPath.replace(/\\/g, "/");
+  const normBase = base.replace(/\\/g, "/").replace(/\/$/, "");
+  let rel = normAbs;
+  if (normAbs.startsWith(normBase + "/")) {
+    rel = normAbs.slice(normBase.length + 1);
+  } else if (normAbs.startsWith(normBase)) {
+    rel = normAbs.slice(normBase.length);
+  }
+  if (rel.startsWith("/")) {
+    rel = rel.slice(1);
+  }
+  return rel;
+}
+
+/**
+ * Generate an ESM export for a single module.
+ */
+function generateEsmExport(mod: GenTsModule, projectPath: string): string {
+  const portsJson = JSON.stringify(mod.ports, null, 2)
+    .split("\n")
+    .map((line, i) => (i === 0 ? line : "  " + line))
+    .join("\n");
+
+  const eventsJson = JSON.stringify(mod.events);
+
+  return `export const ${mod.moduleName} = {
+  __celox_module: true,
+  name: ${JSON.stringify(mod.moduleName)},
+  source: "",
+  projectPath: ${JSON.stringify(projectPath)},
+  ports: ${portsJson},
+  events: ${eventsJson},
+};`;
+}

package/src/sidecar.ts

@@ -0,0 +1,78 @@
+import { writeFileSync, mkdirSync, unlinkSync, existsSync } from "node:fs";
+import { join, resolve, dirname, relative, isAbsolute } from "node:path";
+import type { GenTsJsonOutput } from "./types.js";
+
+/** Default directory (relative to project root) for generated sidecar files. */
+export const SIDECAR_DIR = ".celox";
+
+/**
+ * Generate `.d.veryl.ts` sidecar files in the sidecar directory,
+ * mirroring the source tree structure.
+ *
+ * TypeScript picks these up via `allowArbitraryExtensions` + `rootDirs`
+ * in tsconfig.  For example, `src/Adder.veryl` produces
+ * `.celox/src/Adder.d.veryl.ts`.
+ */
+export function generateSidecars(
+  data: GenTsJsonOutput,
+  projectRoot: string,
+): string[] {
+  const written: string[] = [];
+  const root = resolve(projectRoot);
+  const outDir = join(root, SIDECAR_DIR);
+
+  for (const [sourceFile, moduleNames] of Object.entries(data.fileModules)) {
+    const verylPath = resolve(projectRoot, sourceFile);
+    // Skip files that don't exist on disk (e.g. standard library paths
+    // reported with a stripped leading "/" by celox-gen-ts)
+    if (!existsSync(verylPath)) continue;
+
+    const rel = relative(root, verylPath);
+    // Skip files outside the project root (e.g. standard library from global
+    // cache).  On Windows, relative() across different drives returns an
+    // absolute path; on all platforms, paths outside root start with "..".
+    if (isAbsolute(rel) || rel.startsWith("..")) continue;
+    const sidecarPath = sidecarPathFor(join(outDir, rel));
+
+    const modules = moduleNames
+      .map((name) => data.modules.find((m) => m.moduleName === name))
+      .filter((m) => m !== undefined);
+
+    if (modules.length === 0) continue;
+
+    // Combine dtsContent from all modules in this file
+    // Each module's dtsContent already contains the import and interface
+    const content = modules.map((m) => m.dtsContent).join("\n");
+
+    mkdirSync(dirname(sidecarPath), { recursive: true });
+    writeFileSync(sidecarPath, content, "utf-8");
+    written.push(sidecarPath);
+  }
+
+  return written;
+}
+
+/**
+ * Remove all sidecar files that were previously generated.
+ */
+export function cleanSidecars(paths: string[]): void {
+  for (const p of paths) {
+    try {
+      if (existsSync(p)) {
+        unlinkSync(p);
+      }
+    } catch {
+      // ignore cleanup errors
+    }
+  }
+}
+
+/**
+ * Given `/path/to/.celox/src/Adder.veryl`, returns `/path/to/.celox/src/Adder.d.veryl.ts`.
+ */
+function sidecarPathFor(verylPath: string): string {
+  const dir = dirname(verylPath);
+  const base = verylPath.slice(dir.length + 1); // "Adder.veryl"
+  const stem = base.replace(/\.veryl$/, "");
+  return join(dir, `${stem}.d.veryl.ts`);
+}

package/src/types.ts

@@ -0,0 +1,30 @@
+/** JSON output from `celox-gen-ts --json`. */
+export interface GenTsJsonOutput {
+  readonly projectPath: string;
+  readonly modules: readonly GenTsModule[];
+  readonly fileModules: Record<string, readonly string[]>;
+}
+
+/** Per-module entry from `celox-gen-ts --json`. */
+export interface GenTsModule {
+  readonly moduleName: string;
+  readonly sourceFile: string;
+  readonly dtsContent: string;
+  readonly mdContent: string;
+  readonly ports: Record<string, GenTsPortInfo>;
+  readonly events: readonly string[];
+}
+
+/** Port metadata from the generator. */
+export interface GenTsPortInfo {
+  readonly direction: "input" | "output" | "inout";
+  readonly type: "clock" | "reset" | "logic" | "bit";
+  readonly width: number;
+  readonly is4state: boolean;
+}
+
+/** Plugin options. */
+export interface CeloxPluginOptions {
+  /** Explicit path to the Veryl project root (directory containing Veryl.toml). */
+  projectRoot?: string;
+}

package/README.md

@@ -1,45 +0,0 @@
-# @celox-sim/vite-plugin
-
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@celox-sim/vite-plugin`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**