@venizia/dev-configs 0.3.2 → 0.3.3

package/README.md

@@ -385,7 +385,8 @@ instead: `LintIgnore.oxlint({ config, patterns: LINT_IGNORE })`.
 ### BunCompiler
 
 `BunCompiler.compile()` builds one Bun executable: minified, with a linked source map. The
-compile target comes from `BUN_TARGET` and defaults to `bun-linux-x64`.
+compile target comes from `BUN_TARGET` and defaults to `bun-linux-x64`. `define` passes compile-time
+constants to `Bun.build`; a compile script uses it to bake the build stamp.
 
 ```typescript
 import { BunCompiler } from '@venizia/dev-configs';
@@ -393,6 +394,16 @@ import { BunCompiler } from '@venizia/dev-configs';
 await BunCompiler.compile({ entrypoint: './src/index.ts', outfile: './dist/app' });
 ```
 
+Bake a value into the binary with `define`. Each value is a JSON-encoded expression:
+
+```typescript
+await BunCompiler.compile({
+  entrypoint: './src/index.ts',
+  outfile: './dist/app',
+  define: { APP_FLAVOUR: JSON.stringify('blue') },
+});
+```
+
 ## Where it sits
 
 The root of the chain, with no IGNIS dependency: **dev-configs** -> inversion -> {filter, helpers}

package/dist/compilers/bun.d.ts

@@ -10,6 +10,8 @@ export declare class BunCompiler {
         outfile?: string;
         target?: string;
         plugins?: Bun.BunPlugin[];
+        /** Compile-time constants: each key is replaced by its value, a JSON-encoded expression, wherever the bundle reads it. */
+        define?: Record<string, string>;
     }): Promise<void>;
 }
 //# sourceMappingURL=bun.d.ts.map

package/dist/compilers/bun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/compilers/bun.ts"],"names":[],"mappings":"AAIA,gHAAgH;AAChH,qBAAa,WAAW;IACtB;;;;OAIG;WACU,OAAO,CAClB,IAAI,GAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;KACtB,GACL,OAAO,CAAC,IAAI,CAAC;CAiCjB"}
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/compilers/bun.ts"],"names":[],"mappings":"AAIA,gHAAgH;AAChH,qBAAa,WAAW;IACtB;;;;OAIG;WACU,OAAO,CAClB,IAAI,GAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;QAC1B,0HAA0H;QAC1H,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC5B,GACL,OAAO,CAAC,IAAI,CAAC;CAmCjB"}

package/dist/compilers/bun.js

@@ -12,7 +12,7 @@ class BunCompiler {
      * `platformaticKafkaPlugins()` from `helpers`, which would invert that chain.
      */
     static async compile(opts = {}) {
-        const { entrypoint = DEFAULT_ENTRYPOINT, outfile = DEFAULT_OUTFILE, target = Bun.env.BUN_TARGET ?? DEFAULT_COMPILE_TARGET, plugins = [], } = opts;
+        const { entrypoint = DEFAULT_ENTRYPOINT, outfile = DEFAULT_OUTFILE, target = Bun.env.BUN_TARGET ?? DEFAULT_COMPILE_TARGET, plugins = [], define = {}, } = opts;
         const built = await Bun.build({
             entrypoints: [entrypoint],
             target: 'bun',
@@ -23,6 +23,7 @@ class BunCompiler {
                 target: target,
                 outfile,
             },
+            define,
             plugins,
         });
         if (!built.success) {

package/dist/compilers/bun.js.map

@@ -1 +1 @@
-{"version":3,"file":"bun.js","sourceRoot":"","sources":["../../src/compilers/bun.ts"],"names":[],"mappings":";;;AAAA,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAC7C,MAAM,eAAe,GAAG,YAAY,CAAC;AACrC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAE/C,gHAAgH;AAChH,MAAa,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,OAKI,EAAE;QAEN,MAAM,EACJ,UAAU,GAAG,kBAAkB,EAC/B,OAAO,GAAG,eAAe,EACzB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,sBAAsB,EACrD,OAAO,GAAG,EAAE,GACb,GAAG,IAAI,CAAC;QAET,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC;YAC5B,WAAW,EAAE,CAAC,UAAU,CAAC;YACzB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;YAC1C,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE;gBACP,MAAM,EAAE,MAAiC;gBACzC,OAAO;aACR;YACD,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,4FAA4F;YAC5F,8FAA8F;YAC9F,sGAAsG;YACtG,MAAM,IAAI,KAAK,CACb;gBACE,gDAAgD,UAAU,IAAI;gBAC9D,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;aAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA9CD,kCA8CC","sourcesContent":["const DEFAULT_ENTRYPOINT = './dist/index.js';\nconst DEFAULT_OUTFILE = './dist/bin';\nconst DEFAULT_COMPILE_TARGET = 'bun-linux-x64';\n\n/** Bundles and compiles a single Bun executable: minified, linked sourcemaps, target read from `BUN_TARGET`. */\nexport class BunCompiler {\n  /**\n   * `plugins` is a parameter, never resolved here - `dev-configs` sits below every other IGNIS\n   * package (see the Makefile chain) and must not import a plugin factory such as\n   * `platformaticKafkaPlugins()` from `helpers`, which would invert that chain.\n   */\n  static async compile(\n    opts: {\n      entrypoint?: string;\n      outfile?: string;\n      target?: string;\n      plugins?: Bun.BunPlugin[];\n    } = {},\n  ): Promise<void> {\n    const {\n      entrypoint = DEFAULT_ENTRYPOINT,\n      outfile = DEFAULT_OUTFILE,\n      target = Bun.env.BUN_TARGET ?? DEFAULT_COMPILE_TARGET,\n      plugins = [],\n    } = opts;\n\n    const built = await Bun.build({\n      entrypoints: [entrypoint],\n      target: 'bun',\n      minify: { whitespace: true, syntax: true },\n      sourcemap: 'linked',\n      throw: false,\n      compile: {\n        target: target as Bun.Build.CompileTarget,\n        outfile,\n      },\n      plugins,\n    });\n\n    if (!built.success) {\n      // `getError` lives in `inversion`, which depends on `dev-configs` - importing it here would\n      // create a circular workspace dependency, so a failed compile throws a plain `Error` instead.\n      // eslint-disable-next-line venizia/no-new-error -- getError would be a dev-configs -> inversion cycle\n      throw new Error(\n        [\n          `[BunCompiler] compile failed for entrypoint \"${entrypoint}\":`,\n          ...built.logs.map(log => `[${log.level}] ${log.message}`),\n        ].join('\\n'),\n      );\n    }\n  }\n}\n"]}
+{"version":3,"file":"bun.js","sourceRoot":"","sources":["../../src/compilers/bun.ts"],"names":[],"mappings":";;;AAAA,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAC7C,MAAM,eAAe,GAAG,YAAY,CAAC;AACrC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAE/C,gHAAgH;AAChH,MAAa,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,OAOI,EAAE;QAEN,MAAM,EACJ,UAAU,GAAG,kBAAkB,EAC/B,OAAO,GAAG,eAAe,EACzB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,sBAAsB,EACrD,OAAO,GAAG,EAAE,EACZ,MAAM,GAAG,EAAE,GACZ,GAAG,IAAI,CAAC;QAET,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC;YAC5B,WAAW,EAAE,CAAC,UAAU,CAAC;YACzB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;YAC1C,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE;gBACP,MAAM,EAAE,MAAiC;gBACzC,OAAO;aACR;YACD,MAAM;YACN,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,4FAA4F;YAC5F,8FAA8F;YAC9F,sGAAsG;YACtG,MAAM,IAAI,KAAK,CACb;gBACE,gDAAgD,UAAU,IAAI;gBAC9D,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;aAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAlDD,kCAkDC","sourcesContent":["const DEFAULT_ENTRYPOINT = './dist/index.js';\nconst DEFAULT_OUTFILE = './dist/bin';\nconst DEFAULT_COMPILE_TARGET = 'bun-linux-x64';\n\n/** Bundles and compiles a single Bun executable: minified, linked sourcemaps, target read from `BUN_TARGET`. */\nexport class BunCompiler {\n  /**\n   * `plugins` is a parameter, never resolved here - `dev-configs` sits below every other IGNIS\n   * package (see the Makefile chain) and must not import a plugin factory such as\n   * `platformaticKafkaPlugins()` from `helpers`, which would invert that chain.\n   */\n  static async compile(\n    opts: {\n      entrypoint?: string;\n      outfile?: string;\n      target?: string;\n      plugins?: Bun.BunPlugin[];\n      /** Compile-time constants: each key is replaced by its value, a JSON-encoded expression, wherever the bundle reads it. */\n      define?: Record<string, string>;\n    } = {},\n  ): Promise<void> {\n    const {\n      entrypoint = DEFAULT_ENTRYPOINT,\n      outfile = DEFAULT_OUTFILE,\n      target = Bun.env.BUN_TARGET ?? DEFAULT_COMPILE_TARGET,\n      plugins = [],\n      define = {},\n    } = opts;\n\n    const built = await Bun.build({\n      entrypoints: [entrypoint],\n      target: 'bun',\n      minify: { whitespace: true, syntax: true },\n      sourcemap: 'linked',\n      throw: false,\n      compile: {\n        target: target as Bun.Build.CompileTarget,\n        outfile,\n      },\n      define,\n      plugins,\n    });\n\n    if (!built.success) {\n      // `getError` lives in `inversion`, which depends on `dev-configs` - importing it here would\n      // create a circular workspace dependency, so a failed compile throws a plain `Error` instead.\n      // eslint-disable-next-line venizia/no-new-error -- getError would be a dev-configs -> inversion cycle\n      throw new Error(\n        [\n          `[BunCompiler] compile failed for entrypoint \"${entrypoint}\":`,\n          ...built.logs.map(log => `[${log.level}] ${log.message}`),\n        ].join('\\n'),\n      );\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/dev-configs",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Shareable development configurations for TypeScript projects: oxlint and oxfmt presets with per-rule builders, the ESLint naming-convention rule, the legacy ESLint flat config and Prettier presets, and TypeScript compiler options with critical decorator support (experimentalDecorators, emitDecoratorMetadata, useDefineForClassFields). Single source of truth for consistent code style, type checking, and build settings across monorepo packages.",
   "keywords": [
     "build-tools",