@venizia/dev-configs 0.4.6 → 0.4.7-1

package/LICENSE.md

@@ -37,7 +37,7 @@ This monorepo contains the following packages, all licensed under MIT:
 | `@venizia/ignis-helpers` | Utility helpers - logging, cron, Redis, queues, storage |
 | `@venizia/ignis-inversion` | Dependency Injection & IoC container |
 | `@venizia/dev-configs` | Shared oxlint, ESLint, TypeScript configurations |
-| `@venizia/ignis-docs` | Documentation and MCP Server |
+| `@venizia/ignis-docs` | Documentation site content |
 
 ---
 
@@ -79,8 +79,6 @@ Ignis uses the following open-source libraries. We are grateful to the authors a
 | Library | License | Description |
 |---------|---------|-------------|
 | [VitePress](https://github.com/vuejs/vitepress) | MIT | Static site generator |
-| [Fuse.js](https://github.com/krisk/fuse) | Apache-2.0 | Fuzzy search library |
-| [gray-matter](https://github.com/jonschlinkert/gray-matter) | MIT | Front-matter parser |
 
 ---
 

package/README.md

@@ -104,7 +104,7 @@ Every IGNIS package and example does.
 | :--- | :--- |
 | `@venizia/dev-configs` | Everything below, re-exported |
 | `@venizia/dev-configs/compilers` | `BunCompiler` |
-| `@venizia/dev-configs/testing` | `rejectionOf`, `expectRejection` - test helpers for a promise that must reject (imports `bun:test`; tests only) |
+| `@venizia/dev-configs/testing` | `RejectionHelper` (`rejectionOf`, `expectRejection`), `SpawnHelper` (`spawnSyncBounded`), `RepoTmp` (`findRoot`, `apply`) - test helpers (imports `bun:test`; tests only) |
 | `@venizia/dev-configs/linters` | `oxlintConfigs`, `OxlintConfigs`, `BrowserOxlintConfigs`, `ReactOxlintConfigs`, `LintIgnore`, `namingConventionConfigs`, `reactNamingConventionConfigs`, `houseConfigs`, `reactHouseConfigs`, `eslintConfigs`, `ReactEslintConfigs`, the rule classes and their types |
 | `@venizia/dev-configs/linters/oxlint` | `oxlintConfigs`, `OxlintConfigs`, `IOxlintPresetOptions`, `BrowserOxlintConfigs`, `ReactOxlintConfigs`, `LintIgnore`, the rule classes and their types: everything an oxlint config needs, and nothing that loads ESLint. Loads in milliseconds: `/linters` also loads ESLint and its plugins, which an oxlint config never uses |
 | `@venizia/dev-configs/tsconfig.base.json` | Target and lib ES2025, `module` Node16, strict mode (`noImplicitAny` and `useUnknownInCatchVariables` on) with `strictPropertyInitialization` off (DI-injected properties have no initializer), `noEmitOnError`, tests excluded |

package/dist/checks/catalog.d.ts

@@ -34,6 +34,8 @@ export interface ICatalogReport {
     /** Set when there is no `workspaces.catalog` to check against. */
     noCatalog: boolean;
 }
-/** Reads the root catalog and every manifest the options name, and reports everything wrong with their ranges. */
-export declare const findCatalogProblems: (opts?: ICatalogOptions) => Promise<ICatalogReport>;
+export declare class CatalogCheck {
+    /** Reads the root catalog and every manifest the options name, and reports everything wrong with their ranges. */
+    static find(opts?: ICatalogOptions): Promise<ICatalogReport>;
+}
 //# sourceMappingURL=catalog.d.ts.map

package/dist/checks/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/checks/catalog.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,6GAA6G;IAC7G,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IAEnB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;CACpB;AAcD,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,GAAU,OAAM,eAAoB,KAAG,OAAO,CAAC,cAAc,CAkG5F,CAAC"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/checks/catalog.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,6GAA6G;IAC7G,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IAEnB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;CACpB;AAcD,qBAAa,YAAY;IACvB,kHAAkH;WACrG,IAAI,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;CAqGvE"}

package/dist/checks/catalog.js

@@ -1,94 +1,98 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findCatalogProblems = void 0;
+exports.CatalogCheck = void 0;
 const bun_1 = require("bun");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 /** `peerDependencies` are compatibility statements for consumers and stay deliberately looser than the install range. */
 const CATALOGUED_BLOCKS = ['dependencies', 'devDependencies'];
 const DEFAULT_GLOB = 'packages/*/package.json';
-/** Reads the root catalog and every manifest the options name, and reports everything wrong with their ranges. */
-const findCatalogProblems = async (opts = {}) => {
-    const { root = process.cwd(), globs = [], presetPrefix, pinned = [] } = opts;
-    const rootJson = JSON.parse(await Bun.file((0, node_path_1.join)(root, 'package.json')).text());
-    const catalog = rootJson.workspaces?.catalog ?? {};
-    if (Object.keys(catalog).length === 0) {
-        return { problems: [], entries: 0, referenced: 0, noCatalog: true };
-    }
-    const problems = [];
-    const referenced = new Set();
-    const presentPinned = pinned.filter((file) => (0, node_fs_1.existsSync)((0, node_path_1.join)(root, file)));
-    const files = new Set();
-    for (const pattern of [DEFAULT_GLOB, ...globs]) {
-        for await (const file of new bun_1.Glob(pattern).scan(root)) {
-            files.add(file);
-        }
-    }
-    for (const file of [...files, ...presentPinned]) {
-        let json;
-        try {
-            json = JSON.parse(await Bun.file((0, node_path_1.join)(root, file)).text());
+class CatalogCheck {
+    /** Reads the root catalog and every manifest the options name, and reports everything wrong with their ranges. */
+    static async find(opts = {}) {
+        const { root = process.cwd(), globs = [], presetPrefix, pinned = [] } = opts;
+        const result = await Bun.file((0, node_path_1.join)(root, 'package.json')).text();
+        const rootJson = JSON.parse(result);
+        const catalog = rootJson.workspaces?.catalog ?? {};
+        if (Object.keys(catalog).length === 0) {
+            return { problems: [], entries: 0, referenced: 0, noCatalog: true };
         }
-        catch (error) {
-            problems.push({
-                file,
-                message: `invalid JSON - ${error instanceof Error ? error.message : error}`,
-            });
-            continue;
+        const problems = [];
+        const referenced = new Set();
+        const presentPinned = pinned.filter((file) => (0, node_fs_1.existsSync)((0, node_path_1.join)(root, file)));
+        const files = new Set();
+        for (const pattern of [DEFAULT_GLOB, ...globs]) {
+            for await (const file of new bun_1.Glob(pattern).scan(root)) {
+                files.add(file);
+            }
         }
-        const isPinned = presentPinned.includes(file);
-        for (const block of CATALOGUED_BLOCKS) {
-            const entriesList = Object.entries(json[block] ?? {});
-            for (const [dep, range] of entriesList) {
-                if (!(dep in catalog)) {
-                    continue;
-                }
-                referenced.add(dep);
-                if (isPinned) {
-                    if (range !== catalog[dep]) {
-                        problems.push({
-                            file,
-                            message: `${block}.${dep} is "${range}" but the catalog pins "${catalog[dep]}" - this project is outside the workspace, so pin exactly that`,
-                        });
+        for (const file of [...files, ...presentPinned]) {
+            let json;
+            try {
+                const result2 = await Bun.file((0, node_path_1.join)(root, file)).text();
+                json = JSON.parse(result2);
+            }
+            catch (error) {
+                problems.push({
+                    file,
+                    message: `invalid JSON - ${error instanceof Error ? error.message : error}`,
+                });
+                continue;
+            }
+            const isPinned = presentPinned.includes(file);
+            for (const block of CATALOGUED_BLOCKS) {
+                const entriesList = Object.entries(json[block] ?? {});
+                for (const [dep, range] of entriesList) {
+                    if (!(dep in catalog)) {
+                        continue;
                     }
-                    continue;
+                    referenced.add(dep);
+                    if (isPinned) {
+                        if (range !== catalog[dep]) {
+                            problems.push({
+                                file,
+                                message: `${block}.${dep} is "${range}" but the catalog pins "${catalog[dep]}" - this project is outside the workspace, so pin exactly that`,
+                            });
+                        }
+                        continue;
+                    }
+                    if (range === 'catalog:') {
+                        continue;
+                    }
+                    problems.push({
+                        file,
+                        message: `${block}.${dep} is "${range}" but the catalog owns it - use "catalog:" (catalog pins ${catalog[dep]})`,
+                    });
                 }
-                if (range === 'catalog:') {
+            }
+            // A preset is not a published manifest: its markers are resolved by the release, and the library kind gives a
+            // name one catalog range, so a lib's peer takes the same marker as its dev dependency.
+            const isPreset = presetPrefix !== undefined && file.startsWith(presetPrefix);
+            // A peer resolved from the catalog would collapse to the exact install range, losing the looseness that makes it a peer.
+            const peerEntries = Object.entries(json.peerDependencies ?? {});
+            for (const [dep, range] of peerEntries) {
+                if (range !== 'catalog:' || isPreset) {
                     continue;
                 }
                 problems.push({
                     file,
-                    message: `${block}.${dep} is "${range}" but the catalog owns it - use "catalog:" (catalog pins ${catalog[dep]})`,
+                    message: `peerDependencies.${dep} uses "catalog:" - a peer range must stay hand-authored and looser than the install range`,
                 });
             }
         }
-        // A preset is not a published manifest: its markers are resolved by the release, and the library kind gives a
-        // name one catalog range, so a lib's peer takes the same marker as its dev dependency.
-        const isPreset = presetPrefix !== undefined && file.startsWith(presetPrefix);
-        // A peer resolved from the catalog would collapse to the exact install range, losing the looseness that makes it a peer.
-        const peerEntries = Object.entries(json.peerDependencies ?? {});
-        for (const [dep, range] of peerEntries) {
-            if (range !== 'catalog:' || isPreset) {
+        // A catalog entry nobody references is dead weight that will drift out of date unnoticed.
+        const catalogKeys = Object.keys(catalog);
+        for (const dep of catalogKeys) {
+            if (referenced.has(dep)) {
                 continue;
             }
             problems.push({
-                file,
-                message: `peerDependencies.${dep} uses "catalog:" - a peer range must stay hand-authored and looser than the install range`,
+                file: 'package.json',
+                message: `catalog entry "${dep}" is referenced by no workspace - drop it`,
             });
         }
+        return { problems, entries: catalogKeys.length, referenced: referenced.size, noCatalog: false };
     }
-    // A catalog entry nobody references is dead weight that will drift out of date unnoticed.
-    const catalogKeys = Object.keys(catalog);
-    for (const dep of catalogKeys) {
-        if (referenced.has(dep)) {
-            continue;
-        }
-        problems.push({
-            file: 'package.json',
-            message: `catalog entry "${dep}" is referenced by no workspace - drop it`,
-        });
-    }
-    return { problems, entries: catalogKeys.length, referenced: referenced.size, noCatalog: false };
-};
-exports.findCatalogProblems = findCatalogProblems;
+}
+exports.CatalogCheck = CatalogCheck;
 //# sourceMappingURL=catalog.js.map

package/dist/checks/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/checks/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import { Glob } from 'bun';\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/**\n * Guards dependency versions against the root `workspaces.catalog`.\n *\n * A catalogued dep is referenced as `catalog:` and resolved at publish time by `bun publish`, which\n * substitutes the real range while packing. `npm publish` does NOT - it ships `catalog:` verbatim\n * and the manifest is unresolvable for every consumer, which is how 0.1.1-9 / -6 / -4 broke.\n */\nexport interface ICatalogProblem {\n  file: string;\n  message: string;\n}\n\nexport interface ICatalogOptions {\n  /** The repository root: where the root `package.json` and the globs resolve. Default: the current folder. */\n  root?: string;\n\n  /** Manifests to check, beside `packages/*\\/package.json`. A glob relative to the root. */\n  globs?: string[];\n\n  /**\n   * Files that are not published manifests but carry `dependencies` and `devDependencies` the\n   * release resolves (a VULCAN preset): `catalog:` is allowed in their `peerDependencies`, because a\n   * library preset gives one name one catalog range. A file belongs here when its path starts with\n   * this prefix, for example `presets/`.\n   */\n  presetPrefix?: string;\n\n  /**\n   * Manifests outside the workspace (a wiki with its own lockfile): `catalog:` does not resolve\n   * there, so a catalogued dependency must be pinned to exactly the catalog's version instead.\n   */\n  pinned?: string[];\n}\n\nexport interface ICatalogReport {\n  problems: ICatalogProblem[];\n  entries: number;\n  referenced: number;\n\n  /** Set when there is no `workspaces.catalog` to check against. */\n  noCatalog: boolean;\n}\n\n/** `peerDependencies` are compatibility statements for consumers and stay deliberately looser than the install range. */\nconst CATALOGUED_BLOCKS = ['dependencies', 'devDependencies'] as const;\n\nconst DEFAULT_GLOB = 'packages/*/package.json';\n\ninterface IManifest {\n  workspaces?: { catalog?: Record<string, string> };\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n}\n\n/** Reads the root catalog and every manifest the options name, and reports everything wrong with their ranges. */\nexport const findCatalogProblems = async (opts: ICatalogOptions = {}): Promise<ICatalogReport> => {\n  const { root = process.cwd(), globs = [], presetPrefix, pinned = [] } = opts;\n  const rootJson: IManifest = JSON.parse(await Bun.file(join(root, 'package.json')).text());\n  const catalog: Record<string, string> = rootJson.workspaces?.catalog ?? {};\n\n  if (Object.keys(catalog).length === 0) {\n    return { problems: [], entries: 0, referenced: 0, noCatalog: true };\n  }\n\n  const problems: ICatalogProblem[] = [];\n  const referenced = new Set<string>();\n  const presentPinned = pinned.filter((file) => existsSync(join(root, file)));\n\n  const files = new Set<string>();\n  for (const pattern of [DEFAULT_GLOB, ...globs]) {\n    for await (const file of new Glob(pattern).scan(root)) {\n      files.add(file);\n    }\n  }\n\n  for (const file of [...files, ...presentPinned]) {\n    let json: IManifest;\n\n    try {\n      json = JSON.parse(await Bun.file(join(root, file)).text());\n    } catch (error) {\n      problems.push({\n        file,\n        message: `invalid JSON - ${error instanceof Error ? error.message : error}`,\n      });\n      continue;\n    }\n\n    const isPinned = presentPinned.includes(file);\n\n    for (const block of CATALOGUED_BLOCKS) {\n      const entriesList = Object.entries(json[block] ?? {});\n      for (const [dep, range] of entriesList) {\n        if (!(dep in catalog)) {\n          continue;\n        }\n\n        referenced.add(dep);\n\n        if (isPinned) {\n          if (range !== catalog[dep]) {\n            problems.push({\n              file,\n              message: `${block}.${dep} is \"${range}\" but the catalog pins \"${catalog[dep]}\" - this project is outside the workspace, so pin exactly that`,\n            });\n          }\n\n          continue;\n        }\n\n        if (range === 'catalog:') {\n          continue;\n        }\n\n        problems.push({\n          file,\n          message: `${block}.${dep} is \"${range}\" but the catalog owns it - use \"catalog:\" (catalog pins ${catalog[dep]})`,\n        });\n      }\n    }\n\n    // A preset is not a published manifest: its markers are resolved by the release, and the library kind gives a\n    // name one catalog range, so a lib's peer takes the same marker as its dev dependency.\n    const isPreset = presetPrefix !== undefined && file.startsWith(presetPrefix);\n\n    // A peer resolved from the catalog would collapse to the exact install range, losing the looseness that makes it a peer.\n    const peerEntries = Object.entries(json.peerDependencies ?? {});\n    for (const [dep, range] of peerEntries) {\n      if (range !== 'catalog:' || isPreset) {\n        continue;\n      }\n\n      problems.push({\n        file,\n        message: `peerDependencies.${dep} uses \"catalog:\" - a peer range must stay hand-authored and looser than the install range`,\n      });\n    }\n  }\n\n  // A catalog entry nobody references is dead weight that will drift out of date unnoticed.\n  const catalogKeys = Object.keys(catalog);\n  for (const dep of catalogKeys) {\n    if (referenced.has(dep)) {\n      continue;\n    }\n\n    problems.push({\n      file: 'package.json',\n      message: `catalog entry \"${dep}\" is referenced by no workspace - drop it`,\n    });\n  }\n\n  return { problems, entries: catalogKeys.length, referenced: referenced.size, noCatalog: false };\n};\n"]}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/checks/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import { Glob } from 'bun';\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/**\n * Guards dependency versions against the root `workspaces.catalog`.\n *\n * A catalogued dep is referenced as `catalog:` and resolved at publish time by `bun publish`, which\n * substitutes the real range while packing. `npm publish` does NOT - it ships `catalog:` verbatim\n * and the manifest is unresolvable for every consumer, which is how 0.1.1-9 / -6 / -4 broke.\n */\nexport interface ICatalogProblem {\n  file: string;\n  message: string;\n}\n\nexport interface ICatalogOptions {\n  /** The repository root: where the root `package.json` and the globs resolve. Default: the current folder. */\n  root?: string;\n\n  /** Manifests to check, beside `packages/*\\/package.json`. A glob relative to the root. */\n  globs?: string[];\n\n  /**\n   * Files that are not published manifests but carry `dependencies` and `devDependencies` the\n   * release resolves (a VULCAN preset): `catalog:` is allowed in their `peerDependencies`, because a\n   * library preset gives one name one catalog range. A file belongs here when its path starts with\n   * this prefix, for example `presets/`.\n   */\n  presetPrefix?: string;\n\n  /**\n   * Manifests outside the workspace (a wiki with its own lockfile): `catalog:` does not resolve\n   * there, so a catalogued dependency must be pinned to exactly the catalog's version instead.\n   */\n  pinned?: string[];\n}\n\nexport interface ICatalogReport {\n  problems: ICatalogProblem[];\n  entries: number;\n  referenced: number;\n\n  /** Set when there is no `workspaces.catalog` to check against. */\n  noCatalog: boolean;\n}\n\n/** `peerDependencies` are compatibility statements for consumers and stay deliberately looser than the install range. */\nconst CATALOGUED_BLOCKS = ['dependencies', 'devDependencies'] as const;\n\nconst DEFAULT_GLOB = 'packages/*/package.json';\n\ninterface IManifest {\n  workspaces?: { catalog?: Record<string, string> };\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n}\n\nexport class CatalogCheck {\n  /** Reads the root catalog and every manifest the options name, and reports everything wrong with their ranges. */\n  static async find(opts: ICatalogOptions = {}): Promise<ICatalogReport> {\n    const { root = process.cwd(), globs = [], presetPrefix, pinned = [] } = opts;\n    const result = await Bun.file(join(root, 'package.json')).text();\n    const rootJson: IManifest = JSON.parse(result);\n    const catalog: Record<string, string> = rootJson.workspaces?.catalog ?? {};\n\n    if (Object.keys(catalog).length === 0) {\n      return { problems: [], entries: 0, referenced: 0, noCatalog: true };\n    }\n\n    const problems: ICatalogProblem[] = [];\n    const referenced = new Set<string>();\n    const presentPinned = pinned.filter((file) => existsSync(join(root, file)));\n\n    const files = new Set<string>();\n    for (const pattern of [DEFAULT_GLOB, ...globs]) {\n      for await (const file of new Glob(pattern).scan(root)) {\n        files.add(file);\n      }\n    }\n\n    for (const file of [...files, ...presentPinned]) {\n      let json: IManifest;\n\n      try {\n        const result2 = await Bun.file(join(root, file)).text();\n        json = JSON.parse(result2);\n      } catch (error) {\n        problems.push({\n          file,\n          message: `invalid JSON - ${error instanceof Error ? error.message : error}`,\n        });\n        continue;\n      }\n\n      const isPinned = presentPinned.includes(file);\n\n      for (const block of CATALOGUED_BLOCKS) {\n        const entriesList = Object.entries(json[block] ?? {});\n        for (const [dep, range] of entriesList) {\n          if (!(dep in catalog)) {\n            continue;\n          }\n\n          referenced.add(dep);\n\n          if (isPinned) {\n            if (range !== catalog[dep]) {\n              problems.push({\n                file,\n                message: `${block}.${dep} is \"${range}\" but the catalog pins \"${catalog[dep]}\" - this project is outside the workspace, so pin exactly that`,\n              });\n            }\n\n            continue;\n          }\n\n          if (range === 'catalog:') {\n            continue;\n          }\n\n          problems.push({\n            file,\n            message: `${block}.${dep} is \"${range}\" but the catalog owns it - use \"catalog:\" (catalog pins ${catalog[dep]})`,\n          });\n        }\n      }\n\n      // A preset is not a published manifest: its markers are resolved by the release, and the library kind gives a\n      // name one catalog range, so a lib's peer takes the same marker as its dev dependency.\n      const isPreset = presetPrefix !== undefined && file.startsWith(presetPrefix);\n\n      // A peer resolved from the catalog would collapse to the exact install range, losing the looseness that makes it a peer.\n      const peerEntries = Object.entries(json.peerDependencies ?? {});\n      for (const [dep, range] of peerEntries) {\n        if (range !== 'catalog:' || isPreset) {\n          continue;\n        }\n\n        problems.push({\n          file,\n          message: `peerDependencies.${dep} uses \"catalog:\" - a peer range must stay hand-authored and looser than the install range`,\n        });\n      }\n    }\n\n    // A catalog entry nobody references is dead weight that will drift out of date unnoticed.\n    const catalogKeys = Object.keys(catalog);\n    for (const dep of catalogKeys) {\n      if (referenced.has(dep)) {\n        continue;\n      }\n\n      problems.push({\n        file: 'package.json',\n        message: `catalog entry \"${dep}\" is referenced by no workspace - drop it`,\n      });\n    }\n\n    return { problems, entries: catalogKeys.length, referenced: referenced.size, noCatalog: false };\n  }\n}\n"]}

package/dist/checks/module-cycles.d.ts

@@ -10,13 +10,15 @@ export declare class ModuleGraph {
     private static walk;
     private static resolveRelative;
 }
-/**
- * `devz check module-cycles <dir> [--max <n>]`: prints the cycles of a built ESM directory and
- * returns 1 when there are more than `max` (no bound by default), 2 on a usage error.
- */
-export declare const runModuleCycles: (opts: {
-    args: string[];
-    print: (line: string) => void;
-    printError: (line: string) => void;
-}) => number;
+export declare class ModuleCyclesCheck {
+    /**
+     * `devz check module-cycles <dir> [--max <n>]`: prints the cycles of a built ESM directory and
+     * returns 1 when there are more than `max` (no bound by default), 2 on a usage error.
+     */
+    static run(opts: {
+        args: string[];
+        print: (line: string) => void;
+        printError: (line: string) => void;
+    }): number;
+}
 //# sourceMappingURL=module-cycles.d.ts.map

package/dist/checks/module-cycles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-cycles.d.ts","sourceRoot":"","sources":["../../src/checks/module-cycles.ts"],"names":[],"mappings":"AAaA,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFxB,OAAO;IAKP,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAwBxD,uFAAuF;IACvF,MAAM,IAAI,MAAM,EAAE,EAAE;IAkDpB,OAAO,CAAC,MAAM,CAAC,IAAI;IAcnB,OAAO,CAAC,MAAM,CAAC,eAAe;CAa/B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM;IACpC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,KAAG,MA8BH,CAAC"}
+{"version":3,"file":"module-cycles.d.ts","sourceRoot":"","sources":["../../src/checks/module-cycles.ts"],"names":[],"mappings":"AAaA,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFxB,OAAO;IAKP,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAwBxD,uFAAuF;IACvF,MAAM,IAAI,MAAM,EAAE,EAAE;IAkDpB,OAAO,CAAC,MAAM,CAAC,IAAI;IAcnB,OAAO,CAAC,MAAM,CAAC,eAAe;CAa/B;AAED,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;KACpC,GAAG,MAAM;CA+BX"}

package/dist/checks/module-cycles.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runModuleCycles = exports.ModuleGraph = void 0;
+exports.ModuleCyclesCheck = exports.ModuleGraph = void 0;
 /**
  * Lists import cycles in a built ESM directory. bun turns every member of a
  * cycle into a lazy initializer, and a barrel `export *` over such a member
@@ -113,37 +113,39 @@ class ModuleGraph {
     }
 }
 exports.ModuleGraph = ModuleGraph;
-/**
- * `devz check module-cycles <dir> [--max <n>]`: prints the cycles of a built ESM directory and
- * returns 1 when there are more than `max` (no bound by default), 2 on a usage error.
- */
-const runModuleCycles = (opts) => {
-    const { args, print, printError } = opts;
-    const { positionals, values } = (0, node_util_1.parseArgs)({
-        args,
-        allowPositionals: true,
-        options: { max: { type: 'string' }, dist: { type: 'string' } },
-    });
-    const dir = values.dist ?? positionals[0];
-    const usage = 'usage: devz check module-cycles <built ESM dir> [--max <n>]';
-    if (!dir) {
-        printError(usage);
-        return 2;
-    }
-    let max = Number.POSITIVE_INFINITY;
-    if (values.max !== undefined) {
-        if (!/^\d+$/.test(values.max)) {
+class ModuleCyclesCheck {
+    /**
+     * `devz check module-cycles <dir> [--max <n>]`: prints the cycles of a built ESM directory and
+     * returns 1 when there are more than `max` (no bound by default), 2 on a usage error.
+     */
+    static run(opts) {
+        const { args, print, printError } = opts;
+        const { positionals, values } = (0, node_util_1.parseArgs)({
+            args,
+            allowPositionals: true,
+            options: { max: { type: 'string' }, dist: { type: 'string' } },
+        });
+        const dir = values.dist ?? positionals[0];
+        const usage = 'usage: devz check module-cycles <built ESM dir> [--max <n>]';
+        if (!dir) {
             printError(usage);
             return 2;
         }
-        max = Number(values.max);
-    }
-    const cycles = ModuleGraph.fromDirectory({ dir }).cycles();
-    print(`${dir}: ${cycles.length} cycle(s)`);
-    for (const cycle of cycles) {
-        print(`  - ${cycle.join(' <-> ')}`);
+        let max = Number.POSITIVE_INFINITY;
+        if (values.max !== undefined) {
+            if (!/^\d+$/.test(values.max)) {
+                printError(usage);
+                return 2;
+            }
+            max = Number(values.max);
+        }
+        const cycles = ModuleGraph.fromDirectory({ dir }).cycles();
+        print(`${dir}: ${cycles.length} cycle(s)`);
+        for (const cycle of cycles) {
+            print(`  - ${cycle.join(' <-> ')}`);
+        }
+        return cycles.length > max ? 1 : 0;
     }
-    return cycles.length > max ? 1 : 0;
-};
-exports.runModuleCycles = runModuleCycles;
+}
+exports.ModuleCyclesCheck = ModuleCyclesCheck;
 //# sourceMappingURL=module-cycles.js.map

package/dist/checks/module-cycles.js.map

@@ -1 +1 @@
-{"version":3,"file":"module-cycles.js","sourceRoot":"","sources":["../../src/checks/module-cycles.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Lists import cycles in a built ESM directory. bun turns every member of a\n * cycle into a lazy initializer, and a barrel `export *` over such a member\n * can leave its exports undefined. Usage: devz check module-cycles packages/helpers/dist/esm [--max 0]\n */\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { parseArgs } from 'node:util';\n\n// Only match import/export statements at the start of a line (after optional\n// whitespace), ignoring matches inside comments or string literals.\nconst IMPORT_PATTERN = /^\\s*(?:import|export)\\s[^;]*?from\\s+'([^']+)'|^\\s*import\\s+'([^']+)'/gm;\n\nexport class ModuleGraph {\n  private constructor(\n    private readonly root: string,\n    private readonly edges: Map<string, string[]>,\n  ) {}\n\n  static fromDirectory(opts: { dir: string }): ModuleGraph {\n    const root = resolve(opts.dir);\n    const files = ModuleGraph.walk({ dir: root });\n    const edges = new Map<string, string[]>();\n\n    for (const file of files) {\n      const text = readFileSync(file, 'utf8');\n      const targets = new Set<string>();\n      const matches = text.matchAll(IMPORT_PATTERN);\n      for (const match of matches) {\n        const target = ModuleGraph.resolveRelative({\n          from: file,\n          specifier: match[1] ?? match[2],\n        });\n        if (target) {\n          targets.add(target);\n        }\n      }\n      edges.set(file, [...targets]);\n    }\n\n    return new ModuleGraph(root, edges);\n  }\n\n  /** Strongly connected components with more than one member, as repo-relative paths. */\n  cycles(): string[][] {\n    let index = 0;\n    const stack: string[] = [];\n    const onStack = new Set<string>();\n    const indices = new Map<string, number>();\n    const lowLinks = new Map<string, number>();\n    const found: string[][] = [];\n\n    const visit = (node: string): void => {\n      indices.set(node, index);\n      lowLinks.set(node, index);\n      index++;\n      stack.push(node);\n      onStack.add(node);\n\n      const nexts = this.edges.get(node) ?? [];\n      for (const next of nexts) {\n        if (!indices.has(next)) {\n          visit(next);\n          lowLinks.set(node, Math.min(lowLinks.get(node)!, lowLinks.get(next)!));\n        } else if (onStack.has(next)) {\n          lowLinks.set(node, Math.min(lowLinks.get(node)!, indices.get(next)!));\n        }\n      }\n\n      if (lowLinks.get(node) !== indices.get(node)) {\n        return;\n      }\n      const component: string[] = [];\n      let member: string;\n      do {\n        member = stack.pop()!;\n        onStack.delete(member);\n        component.push(relative(this.root, member));\n      } while (member !== node);\n      if (component.length > 1) {\n        found.push(component.sort());\n      }\n    };\n\n    const edgesKeys = this.edges.keys();\n    for (const node of edgesKeys) {\n      if (!indices.has(node)) {\n        visit(node);\n      }\n    }\n\n    return found;\n  }\n\n  private static walk(opts: { dir: string }): string[] {\n    const out: string[] = [];\n    const dirEntries = readdirSync(opts.dir);\n    for (const name of dirEntries) {\n      const full = join(opts.dir, name);\n      if (statSync(full).isDirectory()) {\n        out.push(...ModuleGraph.walk({ dir: full }));\n      } else if (full.endsWith('.js')) {\n        out.push(full);\n      }\n    }\n    return out;\n  }\n\n  private static resolveRelative(opts: { from: string; specifier: string }): string | undefined {\n    if (!opts.specifier.startsWith('.')) {\n      return undefined;\n    }\n    const base = resolve(dirname(opts.from), opts.specifier);\n    const candidates = [base, `${base}.js`, join(base, 'index.js')];\n    for (const candidate of candidates) {\n      if (existsSync(candidate) && statSync(candidate).isFile()) {\n        return candidate;\n      }\n    }\n    return undefined;\n  }\n}\n\n/**\n * `devz check module-cycles <dir> [--max <n>]`: prints the cycles of a built ESM directory and\n * returns 1 when there are more than `max` (no bound by default), 2 on a usage error.\n */\nexport const runModuleCycles = (opts: {\n  args: string[];\n  print: (line: string) => void;\n  printError: (line: string) => void;\n}): number => {\n  const { args, print, printError } = opts;\n  const { positionals, values } = parseArgs({\n    args,\n    allowPositionals: true,\n    options: { max: { type: 'string' }, dist: { type: 'string' } },\n  });\n  const dir = values.dist ?? positionals[0];\n  const usage = 'usage: devz check module-cycles <built ESM dir> [--max <n>]';\n  if (!dir) {\n    printError(usage);\n    return 2;\n  }\n\n  let max = Number.POSITIVE_INFINITY;\n  if (values.max !== undefined) {\n    if (!/^\\d+$/.test(values.max)) {\n      printError(usage);\n      return 2;\n    }\n    max = Number(values.max);\n  }\n\n  const cycles = ModuleGraph.fromDirectory({ dir }).cycles();\n  print(`${dir}: ${cycles.length} cycle(s)`);\n  for (const cycle of cycles) {\n    print(`  - ${cycle.join(' <-> ')}`);\n  }\n\n  return cycles.length > max ? 1 : 0;\n};\n"]}
+{"version":3,"file":"module-cycles.js","sourceRoot":"","sources":["../../src/checks/module-cycles.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Lists import cycles in a built ESM directory. bun turns every member of a\n * cycle into a lazy initializer, and a barrel `export *` over such a member\n * can leave its exports undefined. Usage: devz check module-cycles packages/helpers/dist/esm [--max 0]\n */\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { parseArgs } from 'node:util';\n\n// Only match import/export statements at the start of a line (after optional\n// whitespace), ignoring matches inside comments or string literals.\nconst IMPORT_PATTERN = /^\\s*(?:import|export)\\s[^;]*?from\\s+'([^']+)'|^\\s*import\\s+'([^']+)'/gm;\n\nexport class ModuleGraph {\n  private constructor(\n    private readonly root: string,\n    private readonly edges: Map<string, string[]>,\n  ) {}\n\n  static fromDirectory(opts: { dir: string }): ModuleGraph {\n    const root = resolve(opts.dir);\n    const files = ModuleGraph.walk({ dir: root });\n    const edges = new Map<string, string[]>();\n\n    for (const file of files) {\n      const text = readFileSync(file, 'utf8');\n      const targets = new Set<string>();\n      const matches = text.matchAll(IMPORT_PATTERN);\n      for (const match of matches) {\n        const target = ModuleGraph.resolveRelative({\n          from: file,\n          specifier: match[1] ?? match[2],\n        });\n        if (target) {\n          targets.add(target);\n        }\n      }\n      edges.set(file, [...targets]);\n    }\n\n    return new ModuleGraph(root, edges);\n  }\n\n  /** Strongly connected components with more than one member, as repo-relative paths. */\n  cycles(): string[][] {\n    let index = 0;\n    const stack: string[] = [];\n    const onStack = new Set<string>();\n    const indices = new Map<string, number>();\n    const lowLinks = new Map<string, number>();\n    const found: string[][] = [];\n\n    const visit = (node: string): void => {\n      indices.set(node, index);\n      lowLinks.set(node, index);\n      index++;\n      stack.push(node);\n      onStack.add(node);\n\n      const nexts = this.edges.get(node) ?? [];\n      for (const next of nexts) {\n        if (!indices.has(next)) {\n          visit(next);\n          lowLinks.set(node, Math.min(lowLinks.get(node)!, lowLinks.get(next)!));\n        } else if (onStack.has(next)) {\n          lowLinks.set(node, Math.min(lowLinks.get(node)!, indices.get(next)!));\n        }\n      }\n\n      if (lowLinks.get(node) !== indices.get(node)) {\n        return;\n      }\n      const component: string[] = [];\n      let member: string;\n      do {\n        member = stack.pop()!;\n        onStack.delete(member);\n        component.push(relative(this.root, member));\n      } while (member !== node);\n      if (component.length > 1) {\n        found.push(component.sort());\n      }\n    };\n\n    const edgesKeys = this.edges.keys();\n    for (const node of edgesKeys) {\n      if (!indices.has(node)) {\n        visit(node);\n      }\n    }\n\n    return found;\n  }\n\n  private static walk(opts: { dir: string }): string[] {\n    const out: string[] = [];\n    const dirEntries = readdirSync(opts.dir);\n    for (const name of dirEntries) {\n      const full = join(opts.dir, name);\n      if (statSync(full).isDirectory()) {\n        out.push(...ModuleGraph.walk({ dir: full }));\n      } else if (full.endsWith('.js')) {\n        out.push(full);\n      }\n    }\n    return out;\n  }\n\n  private static resolveRelative(opts: { from: string; specifier: string }): string | undefined {\n    if (!opts.specifier.startsWith('.')) {\n      return undefined;\n    }\n    const base = resolve(dirname(opts.from), opts.specifier);\n    const candidates = [base, `${base}.js`, join(base, 'index.js')];\n    for (const candidate of candidates) {\n      if (existsSync(candidate) && statSync(candidate).isFile()) {\n        return candidate;\n      }\n    }\n    return undefined;\n  }\n}\n\nexport class ModuleCyclesCheck {\n  /**\n   * `devz check module-cycles <dir> [--max <n>]`: prints the cycles of a built ESM directory and\n   * returns 1 when there are more than `max` (no bound by default), 2 on a usage error.\n   */\n  static run(opts: {\n    args: string[];\n    print: (line: string) => void;\n    printError: (line: string) => void;\n  }): number {\n    const { args, print, printError } = opts;\n    const { positionals, values } = parseArgs({\n      args,\n      allowPositionals: true,\n      options: { max: { type: 'string' }, dist: { type: 'string' } },\n    });\n    const dir = values.dist ?? positionals[0];\n    const usage = 'usage: devz check module-cycles <built ESM dir> [--max <n>]';\n    if (!dir) {\n      printError(usage);\n      return 2;\n    }\n\n    let max = Number.POSITIVE_INFINITY;\n    if (values.max !== undefined) {\n      if (!/^\\d+$/.test(values.max)) {\n        printError(usage);\n        return 2;\n      }\n      max = Number(values.max);\n    }\n\n    const cycles = ModuleGraph.fromDirectory({ dir }).cycles();\n    print(`${dir}: ${cycles.length} cycle(s)`);\n    for (const cycle of cycles) {\n      print(`  - ${cycle.join(' <-> ')}`);\n    }\n\n    return cycles.length > max ? 1 : 0;\n  }\n}\n"]}

package/dist/checks/purity/manifest.d.ts

@@ -9,7 +9,7 @@ export interface IPurityEntry {
      * field remap, which the downstream app's bundler (Vite, ...) honours and `bun build` does not.
      * Never for the repository's own source: an external hides that file from the module graph
      * entirely, so using it on our own code would let a real leak through unseen rather than prove
-     * anything pure. Enforced by {@link assertNoWorkspaceExternal}, not left to this comment alone.
+     * anything pure. Enforced by {@link PurityManifest.assertNoWorkspaceExternal}, not left to this comment alone.
      */
     external?: string[];
     /**
@@ -54,41 +54,47 @@ export interface IPurityOptions {
     /** Package-name prefix of this repository's own packages; an `external` may never start with it. Default `@venizia/`. */
     workspaceScope?: string;
 }
-/**
- * A code-level guard, not just the JSDoc on `external`: it is an escape hatch from this gate, and a
- * hatch with no lock is one bad edit away from hiding a real leak - `external: ['@venizia/ignis-helpers']`
- * on a red entry would silently turn it green by removing the exact root-barrel import this gate
- * exists to catch from the module graph, rather than proving it absent.
- *
- * A plain `Error`, not `getError`: the engine runs from the repository root through `devz`, outside
- * every workspace package, and has no logger to resolve.
- */
-export declare const assertNoWorkspaceExternal: (manifest: IPurityEntry[], workspaceScope?: string) => IPurityEntry[];
-/**
- * Exported for the tests, which have to drive a claim that no longer matches its package's
- * `exports` map - the staleness guard is the whole point of deriving, and it cannot be asserted
- * through a built manifest, which by construction is never stale.
- */
-export declare const deriveEntries: (opts: {
-    claim: IPurityClaim;
-    root: string;
-}) => IPurityEntry[];
-/**
- * A browser claim is only honest if a browser bundler can actually consume the entry. A CommonJS
- * entry forces every consumer into a workaround, so the claim carries the obligation: every claimed
- * sub-path must publish its runtime entries below `esmEntryPrefix`. Checked here rather than trusted
- * to a comment, for the same reason as {@link assertNoWorkspaceExternal} - the failure is otherwise
- * invisible until someone tries to bundle the package downstream.
- */
-export declare const assertBrowserEsmEntry: (opts: {
-    claims: IPurityClaim[];
-    root: string;
-    esmEntryPrefix: string;
-}) => IPurityClaim[];
-/** The rows of a whole repository: every claim derived from its package's `exports`, then the guards. */
-export declare const buildManifest: (opts: {
-    claims: IPurityClaim[];
-    root: string;
-    options?: IPurityOptions;
-}) => IPurityEntry[];
+/** Derives the rows of the purity gate from the `exports` map of each claimed package, then runs the guards on them. */
+export declare class PurityManifest {
+    /**
+     * A code-level guard, not just the JSDoc on `external`: it is an escape hatch from this gate, and a
+     * hatch with no lock is one bad edit away from hiding a real leak - `external: ['@venizia/ignis-helpers']`
+     * on a red entry would silently turn it green by removing the exact root-barrel import this gate
+     * exists to catch from the module graph, rather than proving it absent.
+     *
+     * A plain `Error`, not `getError`: the engine runs from the repository root through `devz`, outside
+     * every workspace package, and has no logger to resolve.
+     */
+    static assertNoWorkspaceExternal(opts: {
+        manifest: IPurityEntry[];
+        workspaceScope?: string;
+    }): IPurityEntry[];
+    /**
+     * Public for the tests, which have to drive a claim that no longer matches its package's
+     * `exports` map - the staleness guard is the whole point of deriving, and it cannot be asserted
+     * through a built manifest, which by construction is never stale.
+     */
+    static deriveEntries(opts: {
+        claim: IPurityClaim;
+        root: string;
+    }): IPurityEntry[];
+    /**
+     * A browser claim is only honest if a browser bundler can actually consume the entry. A CommonJS
+     * entry forces every consumer into a workaround, so the claim carries the obligation: every claimed
+     * sub-path must publish its runtime entries below `esmEntryPrefix`. Checked here rather than trusted
+     * to a comment, for the same reason as {@link PurityManifest.assertNoWorkspaceExternal} - the failure is otherwise
+     * invisible until someone tries to bundle the package downstream.
+     */
+    static assertBrowserEsmEntry(opts: {
+        claims: IPurityClaim[];
+        root: string;
+        esmEntryPrefix: string;
+    }): IPurityClaim[];
+    /** The rows of a whole repository: every claim derived from its package's `exports`, then the guards. */
+    static build(opts: {
+        claims: IPurityClaim[];
+        root: string;
+        options?: IPurityOptions;
+    }): IPurityEntry[];
+}
 //# sourceMappingURL=manifest.d.ts.map

package/dist/checks/purity/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/checks/purity/manifest.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yHAAyH;IACzH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,YAAY,EAAE,EACxB,iBAAgB,MAAgC,KAC/C,YAAY,EAiBd,CAAC;AAiEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,YAAY,EA8EvF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB,KAAG,YAAY,EAiCf,CAAC;AAEF,yGAAyG;AACzG,eAAO,MAAM,aAAa,GAAI,MAAM;IAClC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,KAAG,YAAY,EAWf,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/checks/purity/manifest.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yHAAyH;IACzH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA2ED,wHAAwH;AACxH,qBAAa,cAAc;IACzB;;;;;;;;OAQG;IACH,MAAM,CAAC,yBAAyB,CAAC,IAAI,EAAE;QACrC,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,YAAY,EAAE;IAqBlB;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,EAAE;IAgFjF;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE;QACjC,MAAM,EAAE,YAAY,EAAE,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,YAAY,EAAE;IAoClB,yGAAyG;IACzG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,YAAY,EAAE,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,cAAc,CAAC;KAC1B,GAAG,YAAY,EAAE;CAcnB"}