@ts-runtypes/devtools 0.9.0

package/LICENSE

@@ -0,0 +1,104 @@
+RunTypes Small Organization License 1.0.0
+
+Copyright (c) 2026 Ma Jerez. All rights reserved except as expressly granted below.
+
+## Purpose
+
+This license lets individuals and smaller organizations use the software for
+free, subject to the rules below. Larger organizations must obtain a paid
+commercial license. This is a proprietary, source-available style license; it is
+NOT an open source license.
+
+## Acceptance
+
+To exercise any rights under this license you must agree to its rules. Those
+rules are both obligations under your agreement with the licensor and conditions
+of your license. Do not do anything with the software that this license does not
+expressly permit.
+
+## Free License
+
+The licensor grants you a non-exclusive, non-transferable, royalty-free,
+worldwide license to install, run, and use the software, and to include it as a
+dependency in your own applications and deploy those applications, provided that:
+
+- you qualify as a Small Organization (see below), and
+- you comply with the Limitations below.
+
+## Small Organization
+
+You qualify for the Free License only if you are:
+
+- an individual using the software; or
+- an organization whose total gross revenue, aggregated across the organization
+  and all of its affiliates, was less than 10,000,000 US dollars (USD) during its
+  most recently completed fiscal year.
+
+"Affiliates" means all entities that control, are controlled by, or are under
+common control with an organization.
+
+If you do not qualify, you must obtain a Commercial License before using the
+software.
+
+## Limitations
+
+The Free License does NOT permit you to:
+
+- copy or reproduce the software, except as strictly necessary to install and run
+  it for your permitted use;
+- modify the software or create derivative works from it;
+- distribute, publish, sublicense, sell, rent, lease, or otherwise make the
+  software available to any third party, except as embedded in your own
+  applications for their normal operation;
+- reverse engineer, decompile, or disassemble any part of the software provided
+  in compiled or binary form, except to the extent this restriction is prohibited
+  by applicable law;
+- remove or alter any copyright, license, or other proprietary notices.
+
+All rights not expressly granted here are reserved by the licensor.
+
+## Commercial License
+
+If you do not qualify as a Small Organization, or if you need rights beyond those
+granted by the Free License, you must obtain a separate commercial license from
+the licensor. To request one, contact: jerez.m82@gmail.com.
+
+## Notices
+
+You must keep this license file, and all copyright and other notices, with every
+copy of the software.
+
+## No Other Rights
+
+This license does not grant you any rights in the licensor's trademarks, patents,
+or other intellectual property, except the copyright rights expressly stated
+above.
+
+## Termination
+
+If you violate this license, it terminates automatically. On termination you must
+stop using the software and delete all copies in your possession or control. If
+your violation is capable of cure, your license is reinstated if you cure the
+violation within 30 days of first becoming aware of it, unless the licensor has
+already notified you that your license has terminated.
+
+## No Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. YOU BEAR THE ENTIRE RISK OF USING
+THE SOFTWARE.
+
+## Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT WILL THE LICENSOR BE LIABLE
+FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR
+THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+## Definitions
+
+- "Licensor" means Ma Jerez, the copyright holder.
+- "Software" means the RunTypes packages published under the @ts-runtypes npm
+  scope, together with any files distributed with them under this license.
+- "You" means the individual or entity exercising rights under this license.

package/README.md

@@ -0,0 +1,76 @@
+# ts-runtypes-devtools
+
+Cross-bundler build tooling for **RunTypes**. One package, one plugin built on
+[unplugin](https://github.com/unjs/unplugin), exposed as ready-made entry
+points for each bundler. The plugin rewrites RunTypes marker calls
+(`getRunTypeId`, `createValidate`, `createJsonEncoder`, …) into specialized,
+type-derived code generated by the [RunTypes](../../README.md) Go resolver.
+
+## Entry points
+
+| Import                          | What it is                                                           |
+| ------------------------------- | -------------------------------------------------------------------- |
+| `ts-runtypes-devtools/vite`     | Vite plugin (default export is the plugin factory)                   |
+| `ts-runtypes-devtools/rollup`   | Rollup plugin                                                        |
+| `ts-runtypes-devtools/webpack`  | webpack plugin                                                       |
+| `ts-runtypes-devtools/rspack`   | Rspack plugin                                                        |
+| `ts-runtypes-devtools/esbuild`  | esbuild plugin                                                       |
+| `ts-runtypes-devtools/unplugin` | the framework-agnostic unplugin instance (`.vite`, `.rollup`, …)     |
+| `ts-runtypes-devtools`          | the unplugin instance (default export) plus shared types + helpers   |
+| `ts-runtypes-devtools/eslint`   | reserved for the future lint integration (placeholder, no rules yet) |
+
+> The transform is identical across bundlers; the Vite entry additionally wires
+> HMR. Vite and Rollup are covered by tests today; webpack, Rspack and esbuild
+> ride the same unplugin core. esbuild has no native transform phase, so
+> unplugin emulates it via `onLoad`.
+
+## Install
+
+```bash
+pnpm add -D ts-runtypes-devtools
+```
+
+The plugin runs a small prebuilt Go binary. It resolves the right binary for
+your platform automatically through `ts-runtypes-bin`; pass `binary` only to
+point at a custom or in-repo build.
+
+## Usage
+
+```ts
+// vite.config.ts
+import {defineConfig} from 'vite';
+import runtypes from 'ts-runtypes-devtools/vite';
+
+export default defineConfig({
+  plugins: [runtypes()],
+});
+```
+
+Every other bundler is the same shape, e.g. Rollup:
+
+```ts
+// rollup.config.js
+import runtypes from 'ts-runtypes-devtools/rollup';
+
+export default {
+  plugins: [runtypes()],
+};
+```
+
+## Options
+
+| Option                            | Default                      | Description                                                       |
+| --------------------------------- | ---------------------------- | ----------------------------------------------------------------- |
+| `binary`                          | auto (via `ts-runtypes-bin`) | Path to a custom `ts-runtypes` binary.                            |
+| `cwd`                             | bundler root                 | Project root (where `tsconfig.json` lives).                       |
+| `tsconfig`                        | `"tsconfig.json"`            | tsconfig path, relative to `cwd`.                                 |
+| `emitMode`                        | `"code"`                     | What each cache entry ships: `code`, `functions`, or `both`.      |
+| `moduleMode`                      | `"default"`                  | Virtual-module grouping: `default`, `allSingle`, `allModules`.    |
+| `inlineMode`                      | `"default"`                  | Child-inlining policy: `default` or `allInternal`.                |
+| `parallelScan` / `parallelRender` | `true`                       | Opt out of the resolver's parallel phases (benchmarking / debug). |
+
+The on-disk artifact cache (`node_modules/.cache/ts-runtypes`) has no option here: it follows TypeScript's `incremental` / `composite` tsconfig setting (on when your project is incremental, off otherwise).
+
+## Status
+
+Experimental.

package/dist/apply-edits.d.ts

@@ -0,0 +1,8 @@
+import { type SourceMap } from './edit-buffer.ts';
+import type { Edit } from './protocol.ts';
+export declare function applyEdits(file: string, code: string, importBlock: string, edits: Edit[]): {
+    code: string;
+    map: SourceMap;
+};
+export declare function sourceHash(code: string): string;
+//# sourceMappingURL=apply-edits.d.ts.map

package/dist/apply-edits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-edits.d.ts","sourceRoot":"","sources":["../src/apply-edits.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAa,KAAK,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AAMxC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,SAAS,CAAA;CAAC,CASzH;AAQD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C"}

package/dist/apply-edits.js

@@ -0,0 +1,24 @@
+import { EditBuffer } from "./edit-buffer.js";
+export function applyEdits(file, code, importBlock, edits) {
+    const buffer = new EditBuffer(code);
+    for (const edit of edits) {
+        if (edit.start === edit.end)
+            buffer.appendLeft(edit.start, edit.text);
+        else
+            buffer.update(edit.start, edit.end, edit.text);
+    }
+    if (importBlock)
+        buffer.prepend(importBlock);
+    const map = buffer.generateMap({ source: file, includeContent: true });
+    return { code: buffer.toString(), map };
+}
+export function sourceHash(code) {
+    const bytes = Buffer.from(code, 'utf8');
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < bytes.length; i++) {
+        hash ^= bytes[i];
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=apply-edits.js.map

package/dist/apply-edits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-edits.js","sourceRoot":"","sources":["../src/apply-edits.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAC,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAO5D,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,WAAmB,EAAE,KAAa;IACvF,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG;YAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;;YACjE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,WAAW;QAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,EAAC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAC,CAAC,CAAC;IACrE,OAAO,EAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAC,CAAC;AACxC,CAAC;AAQD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC"}

package/dist/diagnosticCatalog.d.ts

@@ -0,0 +1,7 @@
+export { DIAGNOSTIC_CATALOG } from './diagnosticCatalog.generated.ts';
+export type { DiagnosticEntry } from './diagnosticCatalog.generated.ts';
+export declare function renderHeadline(code: string, args?: readonly string[]): string;
+export declare function renderDetail(code: string, args?: readonly string[]): string | undefined;
+export declare function alwaysThrowFactory(code: string, siteHint?: string, ...args: string[]): () => never;
+export declare function messageForCode(code: string, args?: readonly string[]): string;
+//# sourceMappingURL=diagnosticCatalog.d.ts.map

package/dist/diagnosticCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticCatalog.d.ts","sourceRoot":"","sources":["../src/diagnosticCatalog.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAC,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AACpE,YAAY,EAAC,eAAe,EAAC,MAAM,kCAAkC,CAAC;AAkBtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI7E;AAQD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAIvF;AAeD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAOlG;AAQD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE7E"}

package/dist/diagnosticCatalog.generated.d.ts

@@ -0,0 +1,6 @@
+export interface DiagnosticEntry {
+    readonly headline: string;
+    readonly detail?: string;
+}
+export declare const DIAGNOSTIC_CATALOG: Record<string, DiagnosticEntry>;
+//# sourceMappingURL=diagnosticCatalog.generated.d.ts.map

package/dist/diagnosticCatalog.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticCatalog.generated.d.ts","sourceRoot":"","sources":["../src/diagnosticCatalog.generated.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAwtB9D,CAAC"}