@mnmal-ai/substrate-config 0.0.0 → 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,39 @@
 # @mnmal-ai/substrate-config
 
-Reserved by MNMAL. Nothing here yet.
+Workspace tooling, published so other repositories can extend it. It is not bundled into `@mnmal-ai/substrate` and is not part of its public surface.
+
+Shared TypeScript, Biome and tsdown configs for the Substrate workspace, and a toolchain manifest with a checker.
+
+Exports `tsconfig.base.json` (strict + `exactOptionalPropertyTypes`), the presets `tsconfig.lib.json` / `tsconfig.app.json` / `tsconfig.dts.json` that extend it, `biome.json` (formatter + lint rules), and the `defineLibTsdown` / `defineBinTsdown` helpers for `tsdown.config.ts`. Other repositories can extend these too.
+
+## Usage
+
+```jsonc
+// In a package's tsconfig.json:
+{
+  "extends": "@mnmal-ai/substrate-config/tsconfig.lib.json",
+  "include": ["src/**/*", "test/**/*"]
+}
+```
+
+```ts
+// In a package's tsdown.config.ts:
+import { defineLibTsdown } from '@mnmal-ai/substrate-config/tsdown';
+export default defineLibTsdown({ external: ['some-runtime-dep'] });
+```
+
+## Toolchain manifest
+
+`toolchain.json` records the toolchain this workspace is built with: the Node engines floor, pnpm, the Biome schema, tracked catalog entries (TypeScript, tsdown, vitest, Biome, `@types/node`, zod, the MCP SDK) and GitHub Actions pins. A workspace package that depends on it can check the repository against it:
+
+```bash
+pnpm exec substrate-toolchain-check            # report drift, exit 0
+pnpm exec substrate-toolchain-check --strict   # exit 1 on drift (for CI)
+pnpm exec substrate-toolchain-check --fix      # align in place, then run pnpm install
+```
+
+It checks only what the repository uses: a catalog entry it lacks, or an action it never calls, is not drift. `--fix` edits in place and keeps formatting (catalog entries, `packageManager`, mise's pnpm, `engines.node`, the Biome schema, Actions pins), and never adds a field a repository does not have. The checker has no dependencies, so it runs on whatever toolchain the repository is on.
+
+## More
+
+- Source: `packages/substrate-config/src/tsdown.ts` (build helpers), `tsconfig.*.json` (presets), `bin/toolchain-check.mjs`

package/bin/toolchain-check.mjs

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+/**
+ * substrate-toolchain-check — compare a repo's toolchain with the fleet's.
+ *
+ *   substrate-toolchain-check [--strict] [--fix] [--root <dir>] [--json]
+ *
+ * The fleet's versions are `toolchain.json` beside this file, generated from
+ * mnmal-ai/substrate's own config at release. So a repo is held to the
+ * substrate-config version it depends on, and moving the fleet is a substrate-config
+ * bump in each repo rather than N hand edits.
+ *
+ * Checks only what the repo actually uses: a catalog entry it does not have,
+ * or an action it does not call, is not drift. Zero dependencies on purpose,
+ * so it runs whatever toolchain the repo is on — including a drifted one.
+ *
+ * `--fix` rewrites what it finds in place, before checking: catalog entries,
+ * pnpm (packageManager + mise), engines.node, the Biome schema and Actions
+ * pins. Edits are textual, so formatting survives. It never adds a field a
+ * repo does not have. Run `pnpm install` afterwards when the catalog moved.
+ *
+ * Exit 0 when aligned, or when drift is found without --strict (warn mode);
+ * 1 when drift is found with --strict.
+ */
+
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const args = process.argv.slice(2);
+const at = args.indexOf('--root');
+const root = resolve(at >= 0 ? (args[at + 1] ?? '.') : '.');
+const strict = args.includes('--strict');
+const asJson = args.includes('--json');
+const fix = args.includes('--fix');
+
+const fleet = JSON.parse(
+  readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'toolchain.json'), 'utf8')
+);
+const read = (p) => (existsSync(join(root, p)) ? readFileSync(join(root, p), 'utf8') : null);
+
+/** Files `--fix` rewrote, for the report. */
+const fixed = [];
+/** Rewrite `path` through `edit` when it exists and the edit changes it. */
+const rewrite = (path, edit) => {
+  const before = read(path);
+  if (before === null) return;
+  const after = edit(before);
+  if (after !== before) {
+    writeFileSync(join(root, path), after);
+    fixed.push(path);
+  }
+};
+
+if (fix) {
+  rewrite('package.json', (t) =>
+    t
+      .replace(/("packageManager"\s*:\s*")pnpm@[^"]*(")/, `$1pnpm@${fleet.pnpm}$2`)
+      .replace(/("engines"\s*:\s*\{[^}]*?"node"\s*:\s*")[^"]*(")/, `$1${fleet.node.engines}$2`)
+  );
+  rewrite('mise.toml', (t) => t.replace(/^(\s*pnpm\s*=\s*")[^"]+(")/m, `$1${fleet.pnpm}$2`));
+  rewrite('biome.json', (t) => t.replace(/(schemas\/)[\d.]+(\/)/, `$1${fleet.biomeSchema}$2`));
+  rewrite('pnpm-workspace.yaml', (t) => {
+    let on = false;
+    return t
+      .split('\n')
+      .map((line) => {
+        if (/^catalog:\s*$/.test(line)) on = true;
+        else if (on && line.trim() !== '' && !line.startsWith(' ')) on = false;
+        if (!on) return line;
+        const m = /^(\s+["']?)([^"':#]+?)(["']?\s*:\s*["']?)([^"'\s#]+)(.*)$/.exec(line);
+        const want = m && fleet.catalog?.[m[2]];
+        return want === undefined || want === null ? line : `${m[1]}${m[2]}${m[3]}${want}${m[5]}`;
+      })
+      .join('\n');
+  });
+  const wfDir = join(root, '.github/workflows');
+  if (existsSync(wfDir)) {
+    for (const f of readdirSync(wfDir).filter((x) => /\.ya?ml$/.test(x))) {
+      rewrite(join('.github/workflows', f), (t) =>
+        t.replace(
+          /(uses:\s*)([\w./-]+)@([0-9a-f]{40})(\s*#\s*)v[\d.]+/g,
+          (whole, pre, action, _sha, gap) => {
+            const want = fleet.actions?.[action];
+            return want === undefined ? whole : `${pre}${action}@${want.sha}${gap}${want.version}`;
+          }
+        )
+      );
+    }
+  }
+}
+
+/** @type {Array<{ item: string; want: string; have: string | null; ok: boolean }>} */
+const rows = [];
+const check = (item, want, have) => {
+  if (want === undefined || have === null || have === undefined) return;
+  rows.push({ item, want: String(want), have: String(have), ok: String(want) === String(have) });
+};
+
+// A repo without package.json (holomap is Rust) still has workflow pins to check.
+const pkgText = read('package.json');
+if (pkgText !== null) {
+  const pkg = JSON.parse(pkgText);
+  check('engines.node', fleet.node?.engines, pkg.engines?.node ?? '(none)');
+  if (typeof pkg.packageManager === 'string' && pkg.packageManager.startsWith('pnpm@'))
+    check('packageManager pnpm', fleet.pnpm, pkg.packageManager.slice(5).split('+')[0]);
+}
+
+const mise = read('mise.toml');
+const misePnpm = mise && /^\s*pnpm\s*=\s*"([^"]+)"/m.exec(mise)?.[1];
+if (misePnpm) check('mise pnpm', fleet.pnpm, misePnpm);
+
+const biome = read('biome.json');
+const schema = biome && /schemas\/([\d.]+)\//.exec(biome)?.[1];
+if (schema) check('biome.json $schema', fleet.biomeSchema, schema);
+
+const ws = read('pnpm-workspace.yaml');
+if (ws !== null) {
+  let on = false;
+  for (const line of ws.split('\n')) {
+    if (/^catalog:\s*$/.test(line)) {
+      on = true;
+      continue;
+    }
+    if (!on) continue;
+    if (line.trim() !== '' && !line.startsWith(' ')) break;
+    const m = /^\s+["']?([^"':#]+?)["']?\s*:\s*["']?([^"'\s#]+)/.exec(line);
+    if (m && fleet.catalog?.[m[1]] !== undefined)
+      check(`catalog ${m[1]}`, fleet.catalog[m[1]], m[2]);
+  }
+}
+
+const wf = join(root, '.github/workflows');
+if (existsSync(wf)) {
+  const seen = new Set();
+  for (const f of readdirSync(wf).filter((x) => /\.ya?ml$/.test(x))) {
+    const text = readFileSync(join(wf, f), 'utf8');
+    for (const m of text.matchAll(/uses:\s*([\w./-]+)@([0-9a-f]{40})(?:\s*#\s*(v[\d.]+))?/g)) {
+      const [, action, sha, version] = m;
+      const want = fleet.actions?.[action];
+      if (want === undefined || seen.has(`${action}@${sha}`)) continue;
+      seen.add(`${action}@${sha}`);
+      check(
+        `action ${action} (${f})`,
+        `${want.version} ${want.sha.slice(0, 7)}`,
+        `${version ?? '?'} ${sha.slice(0, 7)}`
+      );
+    }
+  }
+}
+
+const drift = rows.filter((r) => !r.ok);
+if (fix && !asJson) {
+  console.log(
+    fixed.length === 0
+      ? 'fix: nothing to rewrite'
+      : `fix: rewrote ${fixed.join(', ')}${fixed.includes('pnpm-workspace.yaml') ? ' (run pnpm install to update the lockfile)' : ''}`
+  );
+}
+if (asJson) {
+  console.log(
+    JSON.stringify({ aligned: drift.length === 0, rows, ...(fix ? { fixed } : {}) }, null, 2)
+  );
+} else {
+  for (const r of rows)
+    console.log(
+      `${r.ok ? '  ok   ' : '  DRIFT'} ${r.item.padEnd(44)} ${r.ok ? r.have : `${r.have}  (fleet: ${r.want})`}`
+    );
+  console.log(
+    drift.length === 0
+      ? `aligned with the fleet toolchain (${rows.length} checks)`
+      : `${drift.length} of ${rows.length} drift from the fleet toolchain${strict ? '' : ' (warn only; pass --strict to fail)'}`
+  );
+}
+process.exit(drift.length > 0 && strict ? 1 : 0);

package/biome.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
+  "root": false,
+  "assist": { "actions": { "source": { "organizeImports": "on" } } },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended",
+      "style": {
+        "noNonNullAssertion": "off"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "trailingCommas": "none",
+      "semicolons": "always"
+    }
+  },
+  "files": {
+    "includes": [
+      "**/*.{ts,tsx,js,mjs,json,jsonc}",
+      "!**/dist",
+      "!**/dist-tarball",
+      "!**/node_modules",
+      "!**/.turbo"
+    ]
+  }
+}

package/dist/tsdown.d.ts

@@ -0,0 +1,48 @@
+/** A banner: fixed text per output kind. */
+export interface TsdownBanner {
+    js?: string;
+    css?: string;
+    dts?: string;
+}
+/**
+ * The tsdown config the helpers build. Declared here rather than as tsdown's
+ * `UserConfig` so the published types name no tsdown version; it is
+ * assignable to the consumer's own `UserConfig`.
+ */
+export interface TsdownConfig {
+    entry: string[] | Record<string, string>;
+    format: 'esm'[];
+    platform: 'node' | 'neutral';
+    target: string;
+    fixedExtension: boolean;
+    sourcemap: boolean;
+    clean: boolean;
+    minify: boolean;
+    outDir: string;
+    dts: boolean;
+    deps?: {
+        neverBundle?: (string | RegExp)[];
+        alwaysBundle?: (string | RegExp)[];
+    };
+    shims?: boolean;
+    banner?: TsdownBanner;
+}
+export interface BinTsdownOptions {
+    entry: Record<string, string>;
+    banner?: TsdownBanner;
+    clean?: boolean;
+    /** Extra never-bundle patterns, merged after NODE_BARE_BUILTINS. */
+    neverBundle?: (string | RegExp)[];
+    /** Force-bundle patterns (deps.alwaysBundle). */
+    alwaysBundle?: (string | RegExp)[];
+}
+export declare function defineBinTsdown({ entry, banner, clean, neverBundle, alwaysBundle }: BinTsdownOptions): TsdownConfig;
+export interface LibTsdownOptions {
+    entry?: string[] | Record<string, string>;
+    /** Never-bundle patterns — mapped to tsdown's `deps.neverBundle`. */
+    external?: (string | RegExp)[];
+    platform?: 'node' | 'neutral';
+    banner?: TsdownBanner;
+}
+export declare function defineLibTsdown({ entry, external, platform, banner }?: LibTsdownOptions): TsdownConfig;
+//# sourceMappingURL=tsdown.d.ts.map

package/dist/tsdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdown.d.ts","sourceRoot":"","sources":["../src/tsdown.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAClC,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;KACpC,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAuDD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,WAAW,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAClC,iDAAiD;IACjD,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,MAAM,EACN,KAAY,EACZ,WAAgB,EAChB,YAAY,EACb,EAAE,gBAAgB,GAAG,YAAY,CAqBjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAwB,EACxB,QAAQ,EACR,QAAiB,EACjB,MAAM,EACP,GAAE,gBAAqB,GAAG,YAAY,CAgBtC"}

package/dist/tsdown.js

@@ -0,0 +1,93 @@
+//#region src/tsdown.ts
+/**
+* Bare-name Node builtins. CJS deps (ws, postgres, pino) `require('events')`
+* unprefixed; bin-mode bundling collapses them inline, then the bundler's
+* inner require shim throws at runtime. Listing them as external keeps these
+* imports as Node-resolved at runtime instead of bundled.
+*/
+const NODE_BARE_BUILTINS = [
+	"assert",
+	"async_hooks",
+	"buffer",
+	"child_process",
+	"cluster",
+	"console",
+	"constants",
+	"crypto",
+	"dgram",
+	"diagnostics_channel",
+	"dns",
+	"domain",
+	"events",
+	"fs",
+	"fs/promises",
+	"http",
+	"http2",
+	"https",
+	"inspector",
+	"module",
+	"net",
+	"os",
+	"path",
+	"perf_hooks",
+	"process",
+	"punycode",
+	"querystring",
+	"readline",
+	"repl",
+	"stream",
+	"stream/web",
+	"string_decoder",
+	"sys",
+	"timers",
+	"tls",
+	"trace_events",
+	"tty",
+	"url",
+	"util",
+	"v8",
+	"vm",
+	"wasi",
+	"worker_threads",
+	"zlib"
+];
+function defineBinTsdown({ entry, banner, clean = true, neverBundle = [], alwaysBundle }) {
+	return {
+		entry,
+		format: ["esm"],
+		platform: "node",
+		target: "node26",
+		fixedExtension: false,
+		sourcemap: false,
+		clean,
+		minify: false,
+		outDir: "dist",
+		dts: false,
+		deps: {
+			neverBundle: [...NODE_BARE_BUILTINS, ...neverBundle],
+			...alwaysBundle !== void 0 ? { alwaysBundle } : {}
+		},
+		shims: true,
+		...banner !== void 0 ? { banner } : {}
+	};
+}
+function defineLibTsdown({ entry = ["src/index.ts"], external, platform = "node", banner } = {}) {
+	return {
+		entry,
+		format: ["esm"],
+		platform,
+		target: "node26",
+		fixedExtension: false,
+		sourcemap: false,
+		clean: true,
+		minify: false,
+		outDir: "dist",
+		dts: false,
+		...external !== void 0 ? { deps: { neverBundle: external } } : {},
+		...banner !== void 0 ? { banner } : {}
+	};
+}
+//#endregion
+export { defineBinTsdown, defineLibTsdown };
+
+//# sourceMappingURL=tsdown.js.map

package/dist/tsdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdown.js","names":[],"sources":["../src/tsdown.ts"],"sourcesContent":["/** A banner: fixed text per output kind. */\nexport interface TsdownBanner {\n  js?: string;\n  css?: string;\n  dts?: string;\n}\n\n/**\n * The tsdown config the helpers build. Declared here rather than as tsdown's\n * `UserConfig` so the published types name no tsdown version; it is\n * assignable to the consumer's own `UserConfig`.\n */\nexport interface TsdownConfig {\n  entry: string[] | Record<string, string>;\n  format: 'esm'[];\n  platform: 'node' | 'neutral';\n  target: string;\n  fixedExtension: boolean;\n  sourcemap: boolean;\n  clean: boolean;\n  minify: boolean;\n  outDir: string;\n  dts: boolean;\n  deps?: {\n    neverBundle?: (string | RegExp)[];\n    alwaysBundle?: (string | RegExp)[];\n  };\n  shims?: boolean;\n  banner?: TsdownBanner;\n}\n\n/**\n * Bare-name Node builtins. CJS deps (ws, postgres, pino) `require('events')`\n * unprefixed; bin-mode bundling collapses them inline, then the bundler's\n * inner require shim throws at runtime. Listing them as external keeps these\n * imports as Node-resolved at runtime instead of bundled.\n */\nconst NODE_BARE_BUILTINS = [\n  'assert',\n  'async_hooks',\n  'buffer',\n  'child_process',\n  'cluster',\n  'console',\n  'constants',\n  'crypto',\n  'dgram',\n  'diagnostics_channel',\n  'dns',\n  'domain',\n  'events',\n  'fs',\n  'fs/promises',\n  'http',\n  'http2',\n  'https',\n  'inspector',\n  'module',\n  'net',\n  'os',\n  'path',\n  'perf_hooks',\n  'process',\n  'punycode',\n  'querystring',\n  'readline',\n  'repl',\n  'stream',\n  'stream/web',\n  'string_decoder',\n  'sys',\n  'timers',\n  'tls',\n  'trace_events',\n  'tty',\n  'url',\n  'util',\n  'v8',\n  'vm',\n  'wasi',\n  'worker_threads',\n  'zlib'\n];\n\nexport interface BinTsdownOptions {\n  entry: Record<string, string>;\n  banner?: TsdownBanner;\n  clean?: boolean;\n  /** Extra never-bundle patterns, merged after NODE_BARE_BUILTINS. */\n  neverBundle?: (string | RegExp)[];\n  /** Force-bundle patterns (deps.alwaysBundle). */\n  alwaysBundle?: (string | RegExp)[];\n}\n\nexport function defineBinTsdown({\n  entry,\n  banner,\n  clean = true,\n  neverBundle = [],\n  alwaysBundle\n}: BinTsdownOptions): TsdownConfig {\n  return {\n    entry,\n    format: ['esm'],\n    platform: 'node',\n    target: 'node26',\n    // tsdown defaults to .mjs/.d.mts even under type:module — pin .js so\n    // package.json main/types/exports/bin paths resolve.\n    fixedExtension: false,\n    sourcemap: false,\n    clean,\n    minify: false,\n    outDir: 'dist',\n    dts: false,\n    deps: {\n      neverBundle: [...NODE_BARE_BUILTINS, ...neverBundle],\n      ...(alwaysBundle !== undefined ? { alwaysBundle } : {})\n    },\n    shims: true,\n    ...(banner !== undefined ? { banner } : {})\n  };\n}\n\nexport interface LibTsdownOptions {\n  entry?: string[] | Record<string, string>;\n  /** Never-bundle patterns — mapped to tsdown's `deps.neverBundle`. */\n  external?: (string | RegExp)[];\n  platform?: 'node' | 'neutral';\n  banner?: TsdownBanner;\n}\n\nexport function defineLibTsdown({\n  entry = ['src/index.ts'],\n  external,\n  platform = 'node',\n  banner\n}: LibTsdownOptions = {}): TsdownConfig {\n  return {\n    entry,\n    format: ['esm'],\n    platform,\n    target: 'node26',\n    // See defineBinTsdown — keep emitted extensions at .js/.d.ts.\n    fixedExtension: false,\n    sourcemap: false,\n    clean: true,\n    minify: false,\n    outDir: 'dist',\n    dts: false,\n    ...(external !== undefined ? { deps: { neverBundle: external } } : {}),\n    ...(banner !== undefined ? { banner } : {})\n  };\n}\n"],"mappings":";;;;;;;AAqCA,MAAM,qBAAqB;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAYA,SAAgB,gBAAgB,EAC9B,OACA,QACA,QAAQ,MACR,cAAc,CAAC,GACf,gBACiC;CACjC,OAAO;EACL;EACA,QAAQ,CAAC,KAAK;EACd,UAAU;EACV,QAAQ;EAGR,gBAAgB;EAChB,WAAW;EACX;EACA,QAAQ;EACR,QAAQ;EACR,KAAK;EACL,MAAM;GACJ,aAAa,CAAC,GAAG,oBAAoB,GAAG,WAAW;GACnD,GAAI,iBAAiB,KAAA,IAAY,EAAE,aAAa,IAAI,CAAC;EACvD;EACA,OAAO;EACP,GAAI,WAAW,KAAA,IAAY,EAAE,OAAO,IAAI,CAAC;CAC3C;AACF;AAUA,SAAgB,gBAAgB,EAC9B,QAAQ,CAAC,cAAc,GACvB,UACA,WAAW,QACX,WACoB,CAAC,GAAiB;CACtC,OAAO;EACL;EACA,QAAQ,CAAC,KAAK;EACd;EACA,QAAQ;EAER,gBAAgB;EAChB,WAAW;EACX,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,KAAK;EACL,GAAI,aAAa,KAAA,IAAY,EAAE,MAAM,EAAE,aAAa,SAAS,EAAE,IAAI,CAAC;EACpE,GAAI,WAAW,KAAA,IAAY,EAAE,OAAO,IAAI,CAAC;CAC3C;AACF"}

package/package.json

@@ -1,7 +1,56 @@
 {
   "name": "@mnmal-ai/substrate-config",
-  "version": "0.0.0",
-  "description": "Reserved by MNMAL. Not yet released.",
+  "version": "1.0.0-alpha.1",
+  "description": "Shared TypeScript, Biome, and tsdown configs for the Substrate workspace.",
   "license": "Apache-2.0",
-  "files": ["README.md"]
-}
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mnmal-ai/substrate.git",
+    "directory": "packages/substrate-config"
+  },
+  "type": "module",
+  "exports": {
+    "./biome.json": "./biome.json",
+    "./tsconfig.base.json": "./tsconfig.base.json",
+    "./tsconfig.lib.json": "./tsconfig.lib.json",
+    "./tsconfig.app.json": "./tsconfig.app.json",
+    "./tsconfig.dts.json": "./tsconfig.dts.json",
+    "./tsdown": {
+      "import": "./dist/tsdown.js",
+      "types": "./dist/tsdown.d.ts"
+    },
+    "./toolchain.json": "./toolchain.json"
+  },
+  "files": [
+    "dist",
+    "biome.json",
+    "tsconfig.base.json",
+    "tsconfig.lib.json",
+    "tsconfig.app.json",
+    "tsconfig.dts.json",
+    "toolchain.json",
+    "bin"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.4",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "engines": {
+    "node": ">=26.2.0"
+  },
+  "bin": {
+    "substrate-toolchain-check": "bin/toolchain-check.mjs"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.self-dts.json",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "lint": "biome check .",
+    "test": "vitest run"
+  }
+}

package/toolchain.json

@@ -0,0 +1,43 @@
+{
+  "$comment": "Generated by scripts/emit-toolchain.mjs in mnmal-ai/substrate from its own config. Do not edit; compare with `substrate-toolchain-check`.",
+  "node": {
+    "engines": ">=26.2.0"
+  },
+  "pnpm": "12.14.0",
+  "biomeSchema": "2.5.15",
+  "catalog": {
+    "@biomejs/biome": "^2.5.15",
+    "@modelcontextprotocol/sdk": "^1.32.0",
+    "@types/node": "^26.6.4",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3",
+    "zod": "^4.6.5"
+  },
+  "actions": {
+    "actions/cache": {
+      "sha": "55cc8345863c7cc4c66a329aec7e433d2d1c52a9",
+      "version": "v6.1.0"
+    },
+    "actions/checkout": {
+      "sha": "3d3c42e5aac5ba805825da76410c181273ba90b1",
+      "version": "v7.0.1"
+    },
+    "actions/download-artifact": {
+      "sha": "9000827ccba6bdab643e8b6fd33ac0654aef8333",
+      "version": "v8.0.2"
+    },
+    "actions/setup-node": {
+      "sha": "2028fbc5c25fe9cf00d9f06a71cc4710d4507903",
+      "version": "v5.0.0"
+    },
+    "actions/upload-artifact": {
+      "sha": "cf430e030ddbb5b0abf93d22962f4752f3646cd9",
+      "version": "v7.0.2"
+    },
+    "jdx/mise-action": {
+      "sha": "c2a87611a18de5b3828c5652fe268e992400cb5c",
+      "version": "v4.3.0"
+    }
+  }
+}

package/tsconfig.app.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "lib": ["ES2025"],
+    "types": ["node"],
+    // Same source-resolution map as tsconfig.lib.json — apps now resolve
+    // workspace imports to package SOURCE, killing the transient TS7016
+    // "could not find declaration file for .../dist/index.js" noise that fires
+    // while the bundler rebuilds a dependency's dist. Paths are relative to THIS file
+    // (TS >=5.0 resolves `paths` in `extends` relative to the declaring
+    // config). The one exception is substrate-client, the lone DOM-lib package
+    // (transport/ws.ts names `BinaryType`); it is back in the workspace, so a
+    // consumer app that resolves it to source fails this ES2025-only lib.
+    // Such an app (apps/substrate, for `substrate ask`) overrides `paths` in its own
+    // tsconfig to point `@mnmal-ai/substrate-client` at its built dist/index.d.ts.
+    "paths": {
+      "@mnmal-ai/substrate/*": ["../../apps/substrate/src/exports/*.ts"],
+      "@mnmal-ai/*": ["../*/src/index.ts", "../../plugins/*/src/index.ts"]
+    }
+  }
+}

package/tsconfig.base.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "target": "ES2025",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "isolatedModules": true
+  }
+}

package/tsconfig.dts.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "emitDeclarationOnly": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": false
+  }
+}

package/tsconfig.lib.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true,
+    // Resolve workspace imports to package SOURCE for type-checking + the
+    // editor LSP, not built dist/*.d.ts — kills the transient TS7016
+    // "could not find declaration file" noise that fires while the bundler rebuilds a
+    // dependency's dist. Paths are relative to THIS file (TS >=5.0 resolves
+    // `paths` in `extends` relative to the declaring config). Subpath imports
+    // (e.g. @mnmal-ai/substrate-embedder/fake) don't match and fall through to
+    // exports resolution. tsconfig.app.json carries the same map; only
+    // tsconfig.dts.json is deliberately excluded (declaration emit must
+    // reference packages by name, not source).
+    "paths": {
+      "@mnmal-ai/substrate/*": ["../../apps/substrate/src/exports/*.ts"],
+      "@mnmal-ai/*": ["../*/src/index.ts", "../../plugins/*/src/index.ts"]
+    }
+  }
+}