@elliots/typical 0.2.3 → 0.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elliot Shepherd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS 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.

package/README.md

@@ -294,7 +294,6 @@ Create a `typical.json` file in your project root (optional):
 | `validateCasts`          | `false`                                                   | Validate type assertions (`as Type`)                              |
 | `transformJSONParse`     | `true`                                                    | Transform `JSON.parse` to validate and filter to typed properties |
 | `transformJSONStringify` | `true`                                                    | Transform `JSON.stringify` to only include typed properties       |
-| `reusableValidators`     | `true`                                                    | Hoist validators to module scope for reduced code size            |
 
 ---
 
@@ -357,6 +356,50 @@ The generated validation code is optimised for runtime performance:
 - **Union early bail-out** - Union type checks use if-else chains so the first matching type succeeds immediately
 - **Skip comments** - Add `// @typical-ignore` before a function to skip all validation for it
 
+## VSCode Extension
+
+A VSCode extension is available that shows runtime validation indicators directly in your editor. It's not yet published to the marketplace, but you can build and install it locally.
+
+### Features
+
+- **Subtle underlines** on validated parameters, return values, type casts, and JSON operations
+  - Green dotted underline = validated at runtime
+  - Grey dotted underline = skipped (e.g., generic types)
+- **Hover tooltips** explaining what's being validated and why
+- **Optional inlay hints** showing validation status inline
+- **Preview command** to see the compiled output with validation code
+
+### Building and Installing
+
+```bash
+# Navigate to the extension directory
+cd packages/vscode-extension
+
+# Install dependencies
+pnpm install
+
+# Build and package the extension
+pnpm run build
+pnpm run package
+
+# Install the .vsix file
+code --install-extension typical-vscode-0.0.1.vsix
+```
+
+Or use the convenience script:
+
+```bash
+cd packages/vscode-extension
+pnpm run dev-install
+```
+
+### Requirements
+
+- Your project must have `@elliots/typical` or `@elliots/typical-compiler` as a dependency
+- The extension uses the compiler binary from your project's `node_modules`
+
+---
+
 ## Debugging
 
 Set `DEBUG=1` for verbose logging:
@@ -367,10 +410,42 @@ DEBUG=1 npm run build
 
 ## Limitations
 
-- Generic type parameters (`T`) cannot be validated - no runtime type information
-- Type-only imports of classes aren't checked (can't do instanceof on type-only imports)
-- Validation of functions is just not done. Need to think about that one.
-- Some complex types may not be fully supported yet. If you find any that fail, please open an issue!
+### Types that cannot be validated at runtime
+
+These TypeScript features have no runtime representation and are skipped:
+
+| Feature                 | Why                              | Example                                |
+| ----------------------- | -------------------------------- | -------------------------------------- |
+| Generic type parameters | No runtime type info for `T`     | `function process<T>(x: T): T`         |
+| Conditional types       | Compile-time only                | `T extends string ? A : B`             |
+| `infer` keyword         | Compile-time type inference      | `T extends Array<infer U> ? U : never` |
+| `keyof` operator        | Compile-time key extraction      | `keyof User`                           |
+| Indexed access types    | Compile-time type lookup         | `User['name']`                         |
+| Unique symbols          | Symbol identity not checkable    | `declare const id: unique symbol`      |
+| Index signature values  | Would require iterating all keys | `{ [key: string]: number }`            |
+
+### Other limitations
+
+- **Type-only imports** - `import type { MyClass }` can't use instanceof (class doesn't exist at runtime)
+- **Function signatures** - Only validates `typeof === 'function'`, not parameter/return types
+- **Function overloads** - Validates the implementation signature, not individual overload signatures
+- **Complex library types** - DOM types, React types, etc. may exceed complexity limits (configurable via `maxGeneratedFunctions`)
+
+### What IS validated
+
+Despite these limitations, Typical validates most practical TypeScript patterns:
+
+- All primitive types (string, number, boolean, bigint, symbol, null, undefined)
+- Object properties and nested objects
+- Arrays and tuples (including variadic tuples)
+- Union and intersection types
+- Literal types and template literal types
+- Enums (string and numeric)
+- Utility types (Partial, Required, Pick, Omit, Record, Extract, Exclude)
+- Mapped and conditional types (when resolved to concrete types)
+- Branded/opaque types (validates the underlying primitive)
+- Class instances (via instanceof)
+- Built-in types (Date, Map, Set, URL, Error, etc.)
 
 ---
 
@@ -378,34 +453,28 @@ DEBUG=1 npm run build
 
 Runtime validation performance comparing Typical vs Zod vs no validation:
 
-| Scenario                           |   Nothing |   Typical |       Zod |                     vs Nothing |                          vs Zod |
-| ---------------------------------- | --------: | --------: | --------: | -----------------------------: | ------------------------------: |
-| string                             |  23.91M/s |  24.86M/s |  24.80M/s | ${\textsf{\color{olive}1.0x}}$ |  ${\textsf{\color{olive}1.0x}}$ |
-| number                             |  24.33M/s |  25.44M/s |  24.44M/s | ${\textsf{\color{olive}1.0x}}$ |  ${\textsf{\color{olive}1.0x}}$ |
-| boolean                            |  24.49M/s |  24.49M/s |  24.19M/s | ${\textsf{\color{olive}1.0x}}$ |  ${\textsf{\color{olive}1.0x}}$ |
-| object w/ template literals        |  24.53M/s |  21.39M/s |   7.71M/s | ${\textsf{\color{olive}0.9x}}$ |  ${\textsf{\color{green}2.8x}}$ |
-| nested w/ template literals        |  24.69M/s |   8.05M/s |   2.31M/s |   ${\textsf{\color{red}0.3x}}$ |  ${\textsf{\color{green}3.5x}}$ |
-| array w/ templates (10)            |  29.89M/s |   7.10M/s |   1.54M/s |   ${\textsf{\color{red}0.2x}}$ |  ${\textsf{\color{green}4.6x}}$ |
-| array w/ templates (100)           |  30.18M/s | 795.31K/s | 150.09K/s |   ${\textsf{\color{red}0.0x}}$ |  ${\textsf{\color{green}5.3x}}$ |
-| union types                        |  29.77M/s |  30.69M/s |  10.76M/s | ${\textsf{\color{olive}1.0x}}$ |  ${\textsf{\color{green}2.9x}}$ |
-| template literals                  |  30.09M/s |  17.23M/s |   1.71M/s |   ${\textsf{\color{red}0.6x}}$ | ${\textsf{\color{green}10.1x}}$ |
-| complex config                     |  30.56M/s |  29.14M/s |   3.51M/s | ${\textsf{\color{olive}1.0x}}$ |  ${\textsf{\color{green}8.3x}}$ |
-| JSON.parse (small)                 |   4.61M/s |   4.37M/s |   3.85M/s | ${\textsf{\color{olive}0.9x}}$ |  ${\textsf{\color{green}1.1x}}$ |
-| JSON.parse (small+filtered extras) |   4.65M/s |   4.32M/s |   3.79M/s | ${\textsf{\color{olive}0.9x}}$ |  ${\textsf{\color{green}1.1x}}$ |
-| JSON.parse (medium)                |   2.85M/s |   2.26M/s | 928.42K/s |   ${\textsf{\color{red}0.8x}}$ |  ${\textsf{\color{green}2.4x}}$ |
-| JSON.parse (large)                 | 209.41K/s | 186.91K/s |  99.28K/s | ${\textsf{\color{olive}0.9x}}$ |  ${\textsf{\color{green}1.9x}}$ |
-| JSON.parse (1000 large)            |     211/s |     212/s |     104/s | ${\textsf{\color{olive}1.0x}}$ |  ${\textsf{\color{green}2.0x}}$ |
-| JSON.stringify (small)             |   9.99M/s |   9.30M/s |   6.70M/s | ${\textsf{\color{olive}0.9x}}$ |  ${\textsf{\color{green}1.4x}}$ |
-| JSON.stringify (small+extras)      |   2.85M/s |   9.20M/s |   6.98M/s | ${\textsf{\color{green}3.2x}}$ |  ${\textsf{\color{green}1.3x}}$ |
-| JSON.stringify (medium)            |   5.09M/s |   3.82M/s |   1.16M/s |   ${\textsf{\color{red}0.8x}}$ |  ${\textsf{\color{green}3.3x}}$ |
-| JSON.stringify (large)             | 392.53K/s | 330.45K/s | 132.50K/s |   ${\textsf{\color{red}0.8x}}$ |  ${\textsf{\color{green}2.5x}}$ |
-| JSON.stringify (1000 large)        |     362/s |     339/s |     128/s | ${\textsf{\color{olive}0.9x}}$ |  ${\textsf{\color{green}2.7x}}$ |
+| Scenario                           |   Nothing |   Typical |       Zod | vs Nothing |   vs Zod |
+| ---------------------------------- | --------: | --------: | --------: | ---------: | -------: |
+| string                             |  23.91M/s |  24.86M/s |  24.80M/s |    🟡 1.0x |  🟡 1.0x |
+| number                             |  24.33M/s |  25.44M/s |  24.44M/s |    🟡 1.0x |  🟡 1.0x |
+| boolean                            |  24.49M/s |  24.49M/s |  24.19M/s |    🟡 1.0x |  🟡 1.0x |
+| object w/ template literals        |  24.53M/s |  21.39M/s |   7.71M/s |    🟡 0.9x |  🟢 2.8x |
+| nested w/ template literals        |  24.69M/s |   8.05M/s |   2.31M/s |    🔴 0.3x |  🟢 3.5x |
+| array w/ templates (10)            |  29.89M/s |   7.10M/s |   1.54M/s |    🔴 0.2x |  🟢 4.6x |
+| array w/ templates (100)           |  30.18M/s | 795.31K/s | 150.09K/s |    🔴 0.0x |  🟢 5.3x |
+| union types                        |  29.77M/s |  30.69M/s |  10.76M/s |    🟡 1.0x |  🟢 2.9x |
+| template literals                  |  30.09M/s |  17.23M/s |   1.71M/s |    🔴 0.6x | 🟢 10.1x |
+| complex config                     |  30.56M/s |  29.14M/s |   3.51M/s |    🟡 1.0x |  🟢 8.3x |
+| JSON.parse (small)                 |   4.61M/s |   4.37M/s |   3.85M/s |    🟡 0.9x |  🟢 1.1x |
+| JSON.parse (small+filtered extras) |   4.65M/s |   4.32M/s |   3.79M/s |    🟡 0.9x |  🟢 1.1x |
+| JSON.parse (medium)                |   2.85M/s |   2.26M/s | 928.42K/s |    🔴 0.8x |  🟢 2.4x |
+| JSON.parse (large)                 | 209.41K/s | 186.91K/s |  99.28K/s |    🟡 0.9x |  🟢 1.9x |
+| JSON.parse (1000 large)            |     211/s |     212/s |     104/s |    🟡 1.0x |  🟢 2.0x |
+| JSON.stringify (small)             |   9.99M/s |   9.30M/s |   6.70M/s |    🟡 0.9x |  🟢 1.4x |
+| JSON.stringify (small+extras)      |   2.85M/s |   9.20M/s |   6.98M/s |    🟢 3.2x |  🟢 1.3x |
+| JSON.stringify (medium)            |   5.09M/s |   3.82M/s |   1.16M/s |    🔴 0.8x |  🟢 3.3x |
+| JSON.stringify (large)             | 392.53K/s | 330.45K/s | 132.50K/s |    🔴 0.8x |  🟢 2.5x |
+| JSON.stringify (1000 large)        |     362/s |     339/s |     128/s |    🟡 0.9x |  🟢 2.7x |
 
 - **vs Nothing**: Speed relative to no validation or filtering (1.0x = same speed)
 - **vs Zod**: Speed relative to Zod (1.0x = same speed)
-
-Key findings:
-
-- Primitives and simple types have near-zero overhead
-- Typical is **2-10x faster than Zod** for complex types
-- JSON operations have minimal overhead while providing full type safety

package/dist/src/cli.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
-import * as fs from 'fs';
-import * as path from 'path';
-import { TypicalTransformer } from './transformer.js';
-import { loadConfig, validateConfig } from './config.js';
+import { Command } from "commander";
+import * as fs from "fs";
+import * as path from "path";
+import { TypicalTransformer } from "./transformer.js";
+import { loadConfig, validateConfig } from "./config.js";
 const program = new Command();
-program.name('typical').description('Runtime safe TypeScript transformer').version('0.1.0');
+program.name("typical").description("Runtime safe TypeScript transformer").version("0.1.0");
 program
-    .command('transform')
-    .description('Transform a TypeScript file with runtime validation')
-    .argument('<file>', 'TypeScript file to transform')
-    .option('-o, --output <file>', 'Output file')
-    .option('-c, --config <file>', 'Config file path', 'typical.json')
-    .option('-p, --project <file>', 'TypeScript config file path', 'tsconfig.json')
+    .command("transform")
+    .description("Transform a TypeScript file with runtime validation")
+    .argument("<file>", "TypeScript file to transform")
+    .option("-o, --output <file>", "Output file")
+    .option("-c, --config <file>", "Config file path", "typical.json")
+    .option("-p, --project <file>", "TypeScript config file path", "tsconfig.json")
     .action(async (file, options) => {
     let transformer = null;
     try {
@@ -23,14 +23,14 @@ program
             process.exit(1);
         }
         console.log(`Transforming ${file}...`);
-        const result = await transformer.transform(path.resolve(file), 'ts');
+        const result = await transformer.transform(path.resolve(file), "ts");
         // Determine output file path
-        const outputFile = options.output ? path.resolve(options.output) : file + '.transformed.ts';
+        const outputFile = options.output ? path.resolve(options.output) : file + ".transformed.ts";
         fs.writeFileSync(outputFile, result.code);
         console.log(`Transformed code written to ${outputFile}`);
     }
     catch (error) {
-        console.error('Transformation failed:', error);
+        console.error("Transformation failed:", error);
         process.exit(1);
     }
     finally {

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAA;AACxB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAExD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAE3F,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,qDAAqD,CAAC;KAClE,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;KAClD,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5C,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,CAAC;KACjE,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,eAAe,CAAC;KAC9E,MAAM,CACL,KAAK,EACH,IAAY,EACZ,OAIC,EACD,EAAE;IACF,IAAI,WAAW,GAA8B,IAAI,CAAA;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;QACzD,WAAW,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAE7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;YACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAA;QACtC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;QAEpE,6BAA6B;QAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAE3F,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,OAAO,CAAC,GAAG,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAA;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAA;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;YAAS,CAAC;QACT,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,WAAW,CAAC,KAAK,EAAE,CAAA;QAC3B,CAAC;IACH,CAAC;AACH,CAAC,CACF,CAAA;AAEH,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5F,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,qDAAqD,CAAC;KAClE,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;KAClD,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5C,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,CAAC;KACjE,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,eAAe,CAAC;KAC9E,MAAM,CACL,KAAK,EACH,IAAY,EACZ,OAIC,EACD,EAAE;IACF,IAAI,WAAW,GAA8B,IAAI,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,WAAW,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAE9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAErE,6BAA6B;QAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAE5F,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;AACH,CAAC,CACF,CAAC;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/config.d.ts

@@ -21,13 +21,6 @@ export interface TypicalSourceMapConfig {
 export interface TypicalConfig {
     include?: string[];
     exclude?: string[];
-    /**
-     * Controls whether validators are hoisted to module scope for reuse.
-     * - 'auto' (default): Hoist only validators used more than once
-     * - 'never': Never hoist, always generate inline validators
-     * - 'always': Always hoist validators, even if only used once
-     */
-    reusableValidators?: 'auto' | 'never' | 'always';
     validateCasts?: boolean;
     hoistRegex?: boolean;
     debug?: TypicalDebugConfig;

package/dist/src/config.js

@@ -1,7 +1,6 @@
 export const defaultConfig = {
-    include: ['**/*.ts', '**/*.tsx'],
-    exclude: ['node_modules/**', '**/*.d.ts', 'dist/**', 'build/**'],
-    reusableValidators: 'auto', // Hoists validators to module scope for reduced code size
+    include: ["**/*.ts", "**/*.tsx"],
+    exclude: ["node_modules/**", "**/*.d.ts", "dist/**", "build/**"],
     validateCasts: false,
     validateFunctions: true,
     transformJSONParse: true,
@@ -16,13 +15,13 @@ export const defaultConfig = {
         inline: false,
     },
 };
-import fs from 'fs';
-import path from 'path';
+import fs from "fs";
+import path from "path";
 export function loadConfig(configPath) {
-    const configFile = configPath || path.join(process.cwd(), 'typical.json');
+    const configFile = configPath || path.join(process.cwd(), "typical.json");
     if (fs.existsSync(configFile)) {
         try {
-            const configContent = fs.readFileSync(configFile, 'utf8');
+            const configContent = fs.readFileSync(configFile, "utf8");
             const userConfig = JSON.parse(configContent);
             return {
                 ...defaultConfig,

package/dist/src/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AA0EA,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAChC,OAAO,EAAE,CAAC,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC;IAChE,kBAAkB,EAAE,MAAM,EAAE,0DAA0D;IACtF,aAAa,EAAE,KAAK;IACpB,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,IAAI;IAC5B,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE;QACL,sBAAsB,EAAE,KAAK;KAC9B;IACD,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,KAAK;KACd;CACF,CAAA;AAED,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,MAAM,UAAU,UAAU,CAAC,UAAmB;IAC5C,MAAM,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAA;IAEzE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;YACzD,MAAM,UAAU,GAA2B,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;YAEpE,OAAO;gBACL,GAAG,aAAa;gBAChB,GAAG,UAAU;aACd,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,+BAA+B,UAAU,GAAG,EAAE,KAAK,CAAC,CAAA;YACjE,OAAO,aAAa,CAAA;QACtB,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,yEAAyE;IACzE,kDAAkD;IAClD,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAmEA,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAChC,OAAO,EAAE,CAAC,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC;IAChE,aAAa,EAAE,KAAK;IACpB,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,IAAI;IAC5B,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE;QACL,sBAAsB,EAAE,KAAK;KAC9B;IACD,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,KAAK;KACd;CACF,CAAC;AAEF,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,UAAU,CAAC,UAAmB;IAC5C,MAAM,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAE1E,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,UAAU,GAA2B,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAErE,OAAO;gBACL,GAAG,aAAa;gBAChB,GAAG,UAAU;aACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,+BAA+B,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;YAClE,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,yEAAyE;IACzE,kDAAkD;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/esm-loader-register.js

@@ -1,3 +1,3 @@
-import { register } from 'node:module';
-register('./esm-loader.js', { parentURL: import.meta.url });
+import { register } from "node:module";
+register("./esm-loader.js", { parentURL: import.meta.url });
 //# sourceMappingURL=esm-loader-register.js.map

package/dist/src/esm-loader-register.js.map

@@ -1 +1 @@
-{"version":3,"file":"esm-loader-register.js","sourceRoot":"","sources":["../../src/esm-loader-register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA"}
+{"version":3,"file":"esm-loader-register.js","sourceRoot":"","sources":["../../src/esm-loader-register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/src/esm-loader.js

@@ -1,7 +1,7 @@
-import { fileURLToPath, pathToFileURL } from 'url';
-import { existsSync } from 'fs';
-import { TypicalTransformer } from './transformer.js';
-import { loadConfig, validateConfig } from './config.js';
+import { fileURLToPath, pathToFileURL } from "url";
+import { existsSync } from "fs";
+import { TypicalTransformer } from "./transformer.js";
+import { loadConfig, validateConfig } from "./config.js";
 const config = validateConfig(loadConfig());
 // Shared transformer - stays alive for the lifetime of the process
 let transformer = null;
@@ -16,12 +16,12 @@ async function getTransformer() {
  */
 export async function resolve(specifier, context, nextResolve) {
     // Only handle relative imports ending in .js
-    if (specifier.startsWith('.') && specifier.endsWith('.js')) {
+    if (specifier.startsWith(".") && specifier.endsWith(".js")) {
         const { parentURL } = context;
         if (parentURL) {
             const parentPath = fileURLToPath(parentURL);
-            const dir = parentPath.substring(0, parentPath.lastIndexOf('/'));
-            const tsPath = dir + '/' + specifier.slice(0, -3) + '.ts';
+            const dir = parentPath.substring(0, parentPath.lastIndexOf("/"));
+            const tsPath = dir + "/" + specifier.slice(0, -3) + ".ts";
             if (existsSync(tsPath)) {
                 return {
                     url: pathToFileURL(tsPath).href,
@@ -37,17 +37,17 @@ export async function resolve(specifier, context, nextResolve) {
  * Note: Source maps not yet supported in v2
  */
 export async function load(url, context, nextLoad) {
-    if (!url.endsWith('.ts')) {
+    if (!url.endsWith(".ts")) {
         return nextLoad(url, context);
     }
     const filePath = fileURLToPath(url);
     try {
         const t = await getTransformer();
-        const result = await t.transform(filePath, 'ts');
+        const result = await t.transform(filePath, "ts");
         // For now, output is TypeScript - need to transpile to JS
         // TODO: Add JS transpilation in Go or here
         // For now, use TypeScript's transpileModule as fallback
-        const ts = await import('typescript');
+        const ts = await import("typescript");
         const transpiled = ts.default.transpileModule(result.code, {
             compilerOptions: {
                 module: ts.default.ModuleKind.ESNext,
@@ -57,7 +57,7 @@ export async function load(url, context, nextLoad) {
             fileName: filePath,
         });
         return {
-            format: 'module',
+            format: "module",
             source: transpiled.outputText,
             shortCircuit: true,
         };

package/dist/src/esm-loader.js.map

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

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
-export { TypicalTransformer } from './transformer.js';
-export type { TransformResult } from './transformer.js';
-export { loadConfig, validateConfig, defaultConfig } from './config.js';
-export type { TypicalConfig, TypicalSourceMapConfig } from './config.js';
-export { BuildTimer, buildTimer } from './timing.js';
+export { TypicalTransformer } from "./transformer.js";
+export type { TransformResult } from "./transformer.js";
+export { loadConfig, validateConfig, defaultConfig } from "./config.js";
+export type { TypicalConfig, TypicalSourceMapConfig } from "./config.js";
+export { BuildTimer, buildTimer } from "./timing.js";

package/dist/src/index.js

@@ -1,4 +1,4 @@
-export { TypicalTransformer } from './transformer.js';
-export { loadConfig, validateConfig, defaultConfig } from './config.js';
-export { BuildTimer, buildTimer } from './timing.js';
+export { TypicalTransformer } from "./transformer.js";
+export { loadConfig, validateConfig, defaultConfig } from "./config.js";
+export { BuildTimer, buildTimer } from "./timing.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEvE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/timing.d.ts

@@ -1,19 +1,26 @@
 /**
- * Performance instrumentation for tracking build times
+ * Simple build timing utility for debugging performance.
  */
 export declare class BuildTimer {
     private timings;
-    private starts;
-    start(stage: string): void;
-    end(stage: string): void;
+    /**
+     * Reset all timing data.
+     */
     reset(): void;
+    /**
+     * Start timing a named section.
+     */
+    start(name: string): void;
+    /**
+     * End timing a named section.
+     */
+    end(name: string): void;
+    /**
+     * Print a timing report to console.
+     */
     report(prefix?: string): void;
-    getTimings(): Map<string, {
-        count: number;
-        total: number;
-        avg: number;
-        min: number;
-        max: number;
-    }>;
 }
+/**
+ * Shared build timer instance.
+ */
 export declare const buildTimer: BuildTimer;

package/dist/src/timing.js

@@ -1,65 +1,53 @@
 /**
- * Performance instrumentation for tracking build times
+ * Simple build timing utility for debugging performance.
  */
 export class BuildTimer {
     timings = new Map();
-    starts = new Map();
-    start(stage) {
-        this.starts.set(stage, performance.now());
-    }
-    end(stage) {
-        const start = this.starts.get(stage);
-        if (start !== undefined) {
-            const duration = performance.now() - start;
-            const existing = this.timings.get(stage) ?? [];
-            existing.push(duration);
-            this.timings.set(stage, existing);
-            this.starts.delete(stage);
-        }
-    }
+    /**
+     * Reset all timing data.
+     */
     reset() {
         this.timings.clear();
-        this.starts.clear();
     }
-    report(prefix = '[typical]') {
-        console.log(`\n${prefix} Build Performance Report:`);
-        console.log('─'.repeat(60));
-        // Sort stages by total time (descending) for better readability
-        const sortedStages = Array.from(this.timings.entries()).sort(([, a], [, b]) => b.reduce((x, y) => x + y, 0) - a.reduce((x, y) => x + y, 0));
-        let totalTime = 0;
-        for (const [stage, times] of sortedStages) {
-            const total = times.reduce((a, b) => a + b, 0);
-            const avg = total / times.length;
-            const min = Math.min(...times);
-            const max = Math.max(...times);
-            const count = times.length;
-            totalTime += total;
-            console.log(`${stage}:`);
-            console.log(`  Count: ${count}`);
-            console.log(`  Total: ${total.toFixed(2)}ms`);
-            console.log(`  Avg:   ${avg.toFixed(2)}ms`);
-            console.log(`  Min:   ${min.toFixed(2)}ms`);
-            console.log(`  Max:   ${max.toFixed(2)}ms`);
+    /**
+     * Start timing a named section.
+     */
+    start(name) {
+        const existing = this.timings.get(name);
+        if (existing) {
+            existing.start = performance.now();
+        }
+        else {
+            this.timings.set(name, { start: performance.now(), total: 0, count: 0 });
         }
-        console.log('─'.repeat(60));
-        console.log(`Total transform time: ${totalTime.toFixed(2)}ms`);
-        console.log('');
     }
-    getTimings() {
-        const result = new Map();
-        for (const [stage, times] of this.timings) {
-            const total = times.reduce((a, b) => a + b, 0);
-            result.set(stage, {
-                count: times.length,
-                total,
-                avg: total / times.length,
-                min: Math.min(...times),
-                max: Math.max(...times),
-            });
+    /**
+     * End timing a named section.
+     */
+    end(name) {
+        const timing = this.timings.get(name);
+        if (timing && timing.start > 0) {
+            timing.total += performance.now() - timing.start;
+            timing.count++;
+            timing.start = 0;
+        }
+    }
+    /**
+     * Print a timing report to console.
+     */
+    report(prefix = "[typical]") {
+        if (this.timings.size === 0) {
+            return;
+        }
+        console.log(`${prefix} Timing report:`);
+        for (const [name, timing] of this.timings) {
+            const avg = timing.count > 0 ? timing.total / timing.count : 0;
+            console.log(`  ${name}: ${timing.total.toFixed(2)}ms total, ${timing.count} calls, ${avg.toFixed(2)}ms avg`);
         }
-        return result;
     }
 }
-// Singleton instance for use across plugins
+/**
+ * Shared build timer instance.
+ */
 export const buildTimer = new BuildTimer();
 //# sourceMappingURL=timing.js.map

package/dist/src/timing.js.map

@@ -1 +1 @@
-{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/timing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/timing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,UAAU;IACb,OAAO,GAAiE,IAAI,GAAG,EAAE,CAAC;IAE1F;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;YACjD,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,WAAW;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,iBAAiB,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,KAAK,WAAW,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAChG,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/src/transformer.d.ts

@@ -5,8 +5,8 @@
  * and validation code generation. This class just manages the lifecycle
  * and communication with the Go process.
  */
-import { type RawSourceMap } from '@elliots/typical-compiler';
-import type { TypicalConfig } from './config.js';
+import { type RawSourceMap } from "@elliots/typical-compiler";
+import type { TypicalConfig } from "./config.js";
 export interface TransformResult {
     code: string;
     map: RawSourceMap | null;
@@ -30,7 +30,7 @@ export declare class TypicalTransformer {
      * @param mode - Output mode: 'ts' returns TypeScript, 'js' would transpile (not yet supported)
      * @returns Transformed code with validation
      */
-    transform(fileName: string, mode?: 'ts' | 'js'): Promise<TransformResult>;
+    transform(fileName: string, mode?: "ts" | "js"): Promise<TransformResult>;
     /**
      * Close the Go compiler process and release resources.
      * This immediately kills the process without waiting for pending operations.