@zukhruf/git-hooks 0.0.0-stage → 0.3.41

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ezzabuzaid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+# @zukhruf/git-hooks
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Git hooks written in TypeScript. A pre-commit hook runs steps in order against the staged commit. The steps check the staged copy of each file with Prettier and change nothing, run `nx sync` and stage only the files that sync wrote, and build generated files when nx says that their projects are affected. A repo adds a step of its own as a class.
+
+The words in these documents have one meaning each. See the glossary in [CONTEXT.md](./CONTEXT.md).
+
+## Install the hook
+
+Add the package and the repo's own Prettier:
+
+```sh
+npm install --save-dev @zukhruf/git-hooks prettier
+```
+
+Write the hook in `.husky/pre-commit.ts`, and make it executable:
+
+```ts
+#!/usr/bin/env node
+import { Format, preCommit } from '@zukhruf/git-hooks';
+
+await preCommit([new Format()]);
+```
+
+Git runs a hook by its name, and Node runs a TypeScript file only when its name ends in `.ts`. So `.husky/pre-commit` is a link to the TypeScript file. Commit the link:
+
+```sh
+chmod +x .husky/pre-commit.ts
+ln -s pre-commit.ts .husky/pre-commit
+```
+
+Tell git where the hooks are, in the `prepare` script of `package.json`:
+
+```json
+{ "scripts": { "prepare": "git config core.hooksPath .husky || exit 0" } }
+```
+
+## Check the format of the staged files
+
+`Format` checks the staged copy of each staged file with the Prettier config of the repo. It skips the files that `.prettierignore` names, the files that Prettier has no parser for, and links, because the staged copy of a link is the path that it points to. When a file is not formatted, or Prettier cannot parse it, the commit stops and the hook names each file:
+
+```text
+format    2 staged files are not formatted:
+            src/app.ts
+            docs/notes.md (SyntaxError: Unexpected token (3:1))
+          Run `npx prettier --write src/app.ts docs/notes.md`, stage them, and commit again.
+✖ commit stopped by the pre-commit hook
+```
+
+The step changes no file and stages nothing. A file that is partly staged is judged as the commit holds it.
+
+## Stage the files that nx sync writes
+
+`Sync` runs `nx sync` and stages the files that it changed. The option `stage` names the files that the sync generators of the repo write. The default is `**/tsconfig*.json`. A repo with the Tailwind sync generator adds its style sheets:
+
+```ts
+import { Format, Sync, preCommit } from '@zukhruf/git-hooks';
+
+await preCommit([
+  new Sync({ stage: ['**/tsconfig*.json', '**/styles.css'] }),
+  new Format(),
+]);
+```
+
+The step does not stage a file that was changed before the hook ran, or a changed file that `stage` does not name: another session can edit the same working tree. When `nx sync` fails, the commit stops, and the hook shows the reason that nx gave.
+
+## Build generated files
+
+`Codegen` runs nx targets that write generated files, and stages those files. With `when`, it builds only when nx says that the staged files affect one of those projects:
+
+```ts
+import { Codegen, Format, Sync, preCommit } from '@zukhruf/git-hooks';
+
+await preCommit([
+  new Sync(),
+  new Codegen({
+    when: ['backend', 'frontend'],
+    run: ['backend:build', 'frontend:build'],
+    stage: ['openapi.json', 'packages/client/src'],
+  }),
+  new Format(),
+]);
+```
+
+The targets run in the order that `run` gives. When a target fails, the commit stops, and the hook shows the reason that the target gave. Put `Format` after `Codegen`, so that the generated files are checked too.
+
+## Add a step of your own
+
+A step is a subclass of `Step`. It names itself and gives an outcome: `this.pass()`, `this.skip(why)` or `this.fail(why)`. A fail stops the commit. `Commit` reads the staged commit: `staged()`, `files()` (the staged paths that hold file content, without links and submodules), `blob(path)`, `touches(globs)`, and `inSnapshot(work)`, which runs `work` on a copy of the staged tree in a temporary folder:
+
+```ts
+import { type Commit, Step } from '@zukhruf/git-hooks';
+
+export class DesignCheck extends Step {
+  readonly name = 'design';
+
+  async run(commit: Commit) {
+    if (!(await commit.touches(['DESIGN.md', 'apps/**/*.css'])))
+      return this.skip('no design files staged');
+    const valid = await commit.inSnapshot((folder) => checkDesign(folder));
+    return valid
+      ? this.pass()
+      : this.fail('DESIGN.md disagrees with the styles');
+  }
+}
+```

package/dist/codegen.d.ts

@@ -0,0 +1,15 @@
+import type { Commit } from './commit.ts';
+import { type Outcome, Step } from './step.ts';
+interface CodegenOptions {
+    readonly when?: readonly string[];
+    readonly run: readonly string[];
+    readonly stage: readonly string[];
+}
+export declare class Codegen extends Step {
+    #private;
+    readonly name = "codegen";
+    constructor({ when, run, stage }: CodegenOptions);
+    run(commit: Commit): Promise<Outcome>;
+}
+export {};
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE/C,UAAU,cAAc;IAGtB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAMD,qBAAa,OAAQ,SAAQ,IAAI;;IAC/B,QAAQ,CAAC,IAAI,aAAa;gBAKd,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,cAAc;IAO1C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAmB5C"}

package/dist/codegen.js

@@ -0,0 +1,38 @@
+import { Step } from "./step.js";
+// Builds generated files, such as an OpenAPI spec and the client made from it,
+// and stages them. With `when`, it builds only when nx says that one of those
+// projects is affected by the staged files: a hand-kept list of inputs would
+// miss a file, and an edit that is not staged is not part of the commit.
+export class Codegen extends Step {
+    name = 'codegen';
+    #when;
+    #run;
+    #stage;
+    constructor({ when, run, stage }) {
+        super();
+        this.#when = when;
+        this.#run = run;
+        this.#stage = stage;
+    }
+    async run(commit) {
+        if (this.#when !== undefined) {
+            const affected = new Set(await commit.affected());
+            if (!this.#when.some((project) => affected.has(project)))
+                return this.skip(`none of ${this.#when.join(', ')} is affected`);
+        }
+        try {
+            for (const target of this.#run)
+                await commit.nx('run', target);
+        }
+        catch (error) {
+            // A failed build is the step's outcome: the author reads the reason that
+            // the target gave, not a stack trace of the hook.
+            if (!(error instanceof Error))
+                throw error;
+            return this.fail(error.message.trimEnd());
+        }
+        await commit.stage(this.#stage);
+        return this.pass(`ran ${this.#run.join(', ')}; staged ${this.#stage.join(', ')}`);
+    }
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,IAAI,EAAE,MAAM,WAAW,CAAC;AAY/C,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,MAAM,OAAO,OAAQ,SAAQ,IAAI;IACtB,IAAI,GAAG,SAAS,CAAC;IACjB,KAAK,CAAgC;IACrC,IAAI,CAAoB;IACxB,MAAM,CAAoB;IAEnC,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAkB;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACtD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC;YACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yEAAyE;YACzE,kDAAkD;YAClD,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CACd,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC;IACJ,CAAC;CACF"}

package/dist/commit.d.ts

@@ -0,0 +1,15 @@
+export declare class Commit {
+    #private;
+    readonly root: string;
+    constructor(root: string, environment: NodeJS.ProcessEnv);
+    staged(): Promise<string[]>;
+    files(): Promise<string[]>;
+    blob(path: string): Promise<string>;
+    touches(globs: readonly string[]): Promise<boolean>;
+    inSnapshot<T>(work: (folder: string) => Promise<T>): Promise<T>;
+    modified(): Promise<string[]>;
+    stage(paths: readonly string[]): Promise<void>;
+    nx(...args: string[]): Promise<string>;
+    affected(): Promise<string[]>;
+}
+//# sourceMappingURL=commit.d.ts.map

package/dist/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../src/commit.ts"],"names":[],"mappings":"AAaA,qBAAa,MAAM;;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGV,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU;IAMlD,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAc3B,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYhC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7B,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnD,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS/D,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM7B,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBtC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAiCpC"}

package/dist/commit.js

@@ -0,0 +1,95 @@
+import { execFile } from 'node:child_process';
+import { mkdtempDisposable } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, matchesGlob } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+// The staged commit: the index of the repo at `root`. Each read of a staged
+// file goes to its staged copy, never to the working tree, because other
+// sessions can edit the working tree while the hook runs. The environment is
+// the hook's own, so git keeps the index that `git commit` gave it in
+// GIT_INDEX_FILE.
+export class Commit {
+    root;
+    #environment;
+    constructor(root, environment) {
+        this.root = root;
+        this.#environment = environment;
+    }
+    // The paths that the commit adds, copies, modifies or renames.
+    async staged() {
+        const output = await this.#git('diff', '--cached', '--name-only', '--diff-filter=ACMR', '-z');
+        return output.split('\0').filter((path) => path !== '');
+    }
+    // The staged paths whose staged copy is the content of a file. The staged
+    // copy of a link is the path that it points to, and that of a submodule is
+    // a commit id, so a check of their content would judge the wrong text.
+    async files() {
+        const entries = await this.#git('ls-files', '--stage', '-z');
+        const files = new Set(entries
+            .split('\0')
+            .filter((entry) => /^100(644|755) /.test(entry))
+            .map((entry) => entry.slice(entry.indexOf('\t') + 1)));
+        return (await this.staged()).filter((path) => files.has(path));
+    }
+    // The staged copy of one file.
+    blob(path) {
+        return this.#git('cat-file', 'blob', `:${path}`);
+    }
+    // Whether the commit stages a path that matches one of the globs.
+    async touches(globs) {
+        const staged = await this.staged();
+        return staged.some((path) => globs.some((glob) => matchesGlob(path, glob)));
+    }
+    // Runs `work` on a copy of the staged tree in a temporary folder, for a
+    // check that reads many files at once. The folder is removed afterwards.
+    async inSnapshot(work) {
+        await using snapshot = await mkdtempDisposable(join(tmpdir(), 'git-hooks-'));
+        await this.#git('checkout-index', '--all', `--prefix=${snapshot.path}/`);
+        return work(snapshot.path);
+    }
+    // The tracked files whose working-tree copy differs from the staged copy.
+    async modified() {
+        const output = await this.#git('diff', '--name-only', '-z');
+        return output.split('\0').filter((path) => path !== '');
+    }
+    // Stages files that a step wrote itself. A step never stages anything else.
+    async stage(paths) {
+        await this.#git('add', '--', ...paths);
+    }
+    // Runs the repo's own nx with no daemon, so a hook started from a GUI or an
+    // agent shell does not leave a daemon behind or read its stale graph.
+    async nx(...args) {
+        const { stdout } = await execFileAsync(join(this.root, 'node_modules/.bin/nx'), args, {
+            cwd: this.root,
+            env: { ...this.#environment, NX_DAEMON: 'false' },
+            encoding: 'utf8',
+            maxBuffer: 2 ** 30,
+        });
+        return stdout;
+    }
+    // The nx projects that the staged files affect. The files come from the
+    // staged commit, so an edit that is only in the working tree affects nothing.
+    async affected() {
+        const staged = await this.staged();
+        if (staged.length === 0)
+            return [];
+        const output = await this.nx('show', 'projects', '--affected', `--files=${staged.join(',')}`, '--json');
+        const projects = JSON.parse(output);
+        if (!Array.isArray(projects) ||
+            !projects.every((project) => typeof project === 'string'))
+            throw new TypeError(`nx show projects gave ${output.trim()}, not a list of names`);
+        return projects;
+    }
+    async #git(...args) {
+        const { stdout } = await execFileAsync('git', args, {
+            cwd: this.root,
+            env: this.#environment,
+            encoding: 'utf8',
+            // A staged file of any size, not Node's default of 1 MiB.
+            maxBuffer: 2 ** 30,
+        });
+        return stdout;
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/commit.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,7 @@
+import type { Commit } from './commit.ts';
+import { type Outcome, Step } from './step.ts';
+export declare class Format extends Step {
+    readonly name = "format";
+    run(commit: Commit): Promise<Outcome>;
+}
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAK/C,qBAAa,MAAO,SAAQ,IAAI;IAC9B,QAAQ,CAAC,IAAI,YAAY;IAEnB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAgC5C"}

package/dist/format.js

@@ -0,0 +1,41 @@
+import { join } from 'node:path';
+import { check, getFileInfo, resolveConfig } from 'prettier';
+import { Step } from "./step.js";
+// Checks the staged copy of each staged file with the repo's Prettier config,
+// and changes nothing. A step that formatted and staged files would also stage
+// the edits that another session made to them at the same moment.
+export class Format extends Step {
+    name = 'format';
+    async run(commit) {
+        const unformatted = [];
+        const ignorePath = join(commit.root, '.prettierignore');
+        for (const path of await commit.files()) {
+            const file = join(commit.root, path);
+            // Prettier gives no parser for a file that .prettierignore names or that
+            // it cannot format, so no list of extensions here.
+            const { inferredParser } = await getFileInfo(file, { ignorePath });
+            if (inferredParser === null)
+                continue;
+            const options = await resolveConfig(file);
+            try {
+                const source = await commit.blob(path);
+                const formatted = await check(source, { ...options, filepath: file });
+                if (!formatted)
+                    unformatted.push({ path });
+            }
+            catch (error) {
+                const [reason = ''] = String(error).split('\n');
+                unformatted.push({ path, reason });
+            }
+        }
+        if (unformatted.length === 0)
+            return this.pass('the staged files are formatted');
+        const paths = unformatted.map(({ path }) => path);
+        return this.fail([
+            `${unformatted.length} staged files are not formatted:`,
+            ...unformatted.map(({ path, reason }) => reason === undefined ? `  ${path}` : `  ${path} (${reason})`),
+            `Run \`npx prettier --write ${paths.join(' ')}\`, stage them, and commit again.`,
+        ].join('\n'));
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG7D,OAAO,EAAgB,IAAI,EAAE,MAAM,WAAW,CAAC;AAE/C,8EAA8E;AAC9E,+EAA+E;AAC/E,kEAAkE;AAClE,MAAM,OAAO,MAAO,SAAQ,IAAI;IACrB,IAAI,GAAG,QAAQ,CAAC;IAEzB,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,MAAM,WAAW,GAAwC,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACxD,KAAK,MAAM,IAAI,IAAI,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,yEAAyE;YACzE,mDAAmD;YACnD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACnE,IAAI,cAAc,KAAK,IAAI;gBAAE,SAAS;YACtC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtE,IAAI,CAAC,SAAS;oBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,CACd;YACE,GAAG,WAAW,CAAC,MAAM,kCAAkC;YACvD,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CACtC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,MAAM,GAAG,CAC7D;YACD,8BAA8B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,mCAAmC;SACjF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Codegen } from './codegen.ts';
+export { Commit } from './commit.ts';
+export { Format } from './format.ts';
+export { preCommit } from './scripts/pre-commit.ts';
+export { type Outcome, Step } from './step.ts';
+export { Sync } from './sync.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { Codegen } from "./codegen.js";
+export { Commit } from "./commit.js";
+export { Format } from "./format.js";
+export { preCommit } from "./scripts/pre-commit.js";
+export { Step } from "./step.js";
+export { Sync } from "./sync.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAgB,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/scripts/pre-commit.d.ts

@@ -0,0 +1,3 @@
+import type { Step } from '../step.ts';
+export declare function preCommit(steps: readonly Step[]): Promise<void>;
+//# sourceMappingURL=pre-commit.d.ts.map

package/dist/scripts/pre-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-commit.d.ts","sourceRoot":"","sources":["../../src/scripts/pre-commit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAarE"}

package/dist/scripts/pre-commit.js

@@ -0,0 +1,20 @@
+import { Commit } from "../commit.js";
+// What a repo's `.husky/pre-commit.ts` calls. Git runs the hook at the root of
+// the work tree, so the current folder is the repo. This is the one module
+// that prints and reads the environment, as a script may.
+export async function preCommit(steps) {
+    const commit = new Commit(process.cwd(), process.env);
+    for (const step of steps) {
+        const outcome = await step.run(commit);
+        const [first = '', ...rest] = outcome.message.split('\n');
+        console.error(`${step.name.padEnd(9)} ${first}`);
+        for (const line of rest)
+            console.error(`${' '.repeat(10)}${line}`);
+        if (outcome.kind === 'fail') {
+            console.error('✖ commit stopped by the pre-commit hook');
+            process.exitCode = 1;
+            return;
+        }
+    }
+}
+//# sourceMappingURL=pre-commit.js.map

package/dist/scripts/pre-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-commit.js","sourceRoot":"","sources":["../../src/scripts/pre-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,+EAA+E;AAC/E,2EAA2E;AAC3E,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAsB;IACpD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QACjD,KAAK,MAAM,IAAI,IAAI,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACnE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACzD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/step.d.ts

@@ -0,0 +1,13 @@
+import type { Commit } from './commit.ts';
+export interface Outcome {
+    readonly kind: 'pass' | 'skip' | 'fail';
+    readonly message: string;
+}
+export declare abstract class Step {
+    abstract readonly name: string;
+    abstract run(commit: Commit): Promise<Outcome>;
+    protected pass(message?: string): Outcome;
+    protected skip(message: string): Outcome;
+    protected fail(message: string): Outcome;
+}
+//# sourceMappingURL=step.d.ts.map

package/dist/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAKD,8BAAsB,IAAI;IACxB,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9C,SAAS,CAAC,IAAI,CAAC,OAAO,SAAK,GAAG,OAAO;IAIrC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIxC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC"}

package/dist/step.js

@@ -0,0 +1,15 @@
+// One check or task of a hook. A subclass names itself and says what it does
+// with the staged commit; the hook runs the steps in order and stops the
+// commit at the first fail.
+export class Step {
+    pass(message = '') {
+        return { kind: 'pass', message };
+    }
+    skip(message) {
+        return { kind: 'skip', message };
+    }
+    fail(message) {
+        return { kind: 'fail', message };
+    }
+}
+//# sourceMappingURL=step.js.map

package/dist/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AASA,6EAA6E;AAC7E,yEAAyE;AACzE,4BAA4B;AAC5B,MAAM,OAAgB,IAAI;IAKd,IAAI,CAAC,OAAO,GAAG,EAAE;QACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC;IAES,IAAI,CAAC,OAAe;QAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC;IAES,IAAI,CAAC,OAAe;QAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/sync.d.ts

@@ -0,0 +1,11 @@
+import type { Commit } from './commit.ts';
+import { type Outcome, Step } from './step.ts';
+export declare class Sync extends Step {
+    #private;
+    readonly name = "sync";
+    constructor({ stage, }?: {
+        stage?: readonly string[];
+    });
+    run(commit: Commit): Promise<Outcome>;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAU/C,qBAAa,IAAK,SAAQ,IAAI;;IAC5B,QAAQ,CAAC,IAAI,UAAU;gBAGX,EACV,KAA6B,GAC9B,GAAE;QAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAO;IAK/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAmB5C"}

package/dist/sync.js

@@ -0,0 +1,38 @@
+import { matchesGlob } from 'node:path';
+import { Step } from "./step.js";
+// Runs `nx sync`, then stages the files that it wrote. `sync.applyChanges`
+// in nx.json applies only in an interactive terminal, so a commit from a GUI
+// client or an agent shell would miss the synced files.
+//
+// A file counts as synced when it changed during the run and matches `stage`:
+// the file names that the repo's sync generators write. Any other change
+// during the run, or a file that was already modified before it, belongs to
+// another session that edits the same working tree.
+export class Sync extends Step {
+    name = 'sync';
+    #globs;
+    constructor({ stage = ['**/tsconfig*.json'], } = {}) {
+        super();
+        this.#globs = stage;
+    }
+    async run(commit) {
+        const before = new Set(await commit.modified());
+        try {
+            await commit.nx('sync');
+        }
+        catch (error) {
+            // A failed sync is the step's outcome: the author reads nx's reason, not
+            // a stack trace of the hook.
+            if (!(error instanceof Error))
+                throw error;
+            return this.fail(error.message.trimEnd());
+        }
+        const synced = (await commit.modified()).filter((path) => !before.has(path) &&
+            this.#globs.some((glob) => matchesGlob(path, glob)));
+        if (synced.length === 0)
+            return this.pass('nx sync wrote nothing to stage');
+        await commit.stage(synced);
+        return this.pass(`staged what nx sync wrote: ${synced.join(', ')}`);
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EAAgB,IAAI,EAAE,MAAM,WAAW,CAAC;AAE/C,2EAA2E;AAC3E,6EAA6E;AAC7E,wDAAwD;AACxD,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,4EAA4E;AAC5E,oDAAoD;AACpD,MAAM,OAAO,IAAK,SAAQ,IAAI;IACnB,IAAI,GAAG,MAAM,CAAC;IACd,MAAM,CAAoB;IAEnC,YAAY,EACV,KAAK,GAAG,CAAC,mBAAmB,CAAC,MACI,EAAE;QACnC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yEAAyE;YACzE,6BAA6B;YAC7B,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAC7C,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CACtD,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC5E,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@zukhruf/git-hooks",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.41",
+  "description": "Git hooks written in TypeScript. A pre-commit hook runs steps in order against the staged commit: it checks the staged copy of each file with Prettier and changes nothing, runs nx sync and stages only the files that sync wrote, and builds generated files when nx says their projects are affected. A repo adds a step of its own as a class.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JanuaryLabs/zukhruf",
+    "directory": "packages/git-hooks"
+  },
+  "bugs": {
+    "url": "https://github.com/JanuaryLabs/zukhruf/issues"
+  },
+  "homepage": "https://github.com/JanuaryLabs/zukhruf/tree/main/packages/git-hooks#readme",
+  "keywords": [
+    "git",
+    "hooks",
+    "pre-commit",
+    "prettier",
+    "staged",
+    "index",
+    "nx",
+    "sync",
+    "codegen"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@zukhruf/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/spec/**",
+    "!**/*.tsbuildinfo",
+    "!**/*.test.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "nx": ">=21.0.0",
+    "prettier": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "nx": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "prettier": "^3.9.9"
+  }
+}