@savvy-web/silk 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,82 @@
+# @savvy-web/silk
+
+[![npm](https://img.shields.io/npm/v/@savvy-web%2Fsilk?label=npm&color=cb3837)](https://www.npmjs.com/package/@savvy-web/silk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-4caf50.svg)](https://opensource.org/licenses/MIT)
+
+The single package you install to get the whole [Silk Suite](https://github.com/savvy-web/systems) dev-tooling system: drop-in config entry points for changesets, commitlint and lint-staged, a Biome preset and — through its peers — the `savvy` CLI. Each subpath re-exports the matching logic from `@savvy-web/silk-effects` in the exact module shape the consuming tool's config loader expects.
+
+## Install
+
+```bash
+npm install --save-dev @savvy-web/silk
+# or
+pnpm add -D @savvy-web/silk
+```
+
+Installing `silk` pulls [`@savvy-web/cli`](https://www.npmjs.com/package/@savvy-web/cli) and [`@savvy-web/mcp`](https://www.npmjs.com/package/@savvy-web/mcp) along with the real tools its configs reference (Biome, husky, commitlint, changesets, lint-staged, markdownlint), so the versions stay in lockstep.
+
+## Quick start
+
+After install, seed the config files and wire the git hooks:
+
+```bash
+npx savvy init
+# writes the changeset, commit and lint configs and wires husky to the savvy subcommands
+```
+
+The configs `savvy init` writes reference the `@savvy-web/silk` subpaths shown below. You can also write them by hand.
+
+## Config entry points
+
+Point each tool's config at the matching subpath.
+
+Commitlint (`commitlint.config.ts`) re-exports the auto-detecting config:
+
+```ts
+export { default } from "@savvy-web/silk/commitlint";
+```
+
+Markdownlint (`.markdownlint-cli2.jsonc`) loads the changeset rule module:
+
+```jsonc
+{
+  "customRules": ["@savvy-web/silk/changesets/markdownlint"]
+}
+```
+
+Changesets (`.changeset/config.json`) loads the changelog formatter:
+
+```json
+{
+  "changelog": "@savvy-web/silk/changesets/changelog"
+}
+```
+
+Biome (`biome.jsonc`) extends the bundled preset:
+
+```jsonc
+{
+  "extends": ["@savvy-web/silk/biome"]
+}
+```
+
+## Export map
+
+| Subpath | What it provides |
+| ------- | ---------------- |
+| `./changesets` | Changeset class and service surface |
+| `./changesets/changelog` | `ChangelogFunctions` default for `.changeset/config.json` |
+| `./changesets/markdownlint` | markdownlint-cli2 rules (default array plus named rules) |
+| `./changesets/remark` | remark transform plugins, presets and lint rules |
+| `./commitlint` | Auto-detecting `CommitlintConfig` plus types |
+| `./commitlint/static` | Static config default with no auto-detection |
+| `./commitlint/prompt` | commitizen adapter |
+| `./commitlint/formatter` | Custom commitlint error formatter |
+| `./lint` | lint-staged handlers, `Preset`, `createConfig` and workspace utils |
+| `./biome` | Static Biome preset asset |
+
+The package ships dual-format ESM and CommonJS, because some loaders — markdownlint-cli2's custom-rule loader among them — `require()` these subpaths from a CommonJS context.
+
+## License
+
+[MIT](LICENSE)

package/cjs/commitlint/index.cjs

@@ -77892,12 +77892,16 @@ Default "index" lookups for the main are deprecated for ES modules.`, "Deprecati
                 clearCache
             };
         }));
-        const commitlint_CommitlintConfig = commitlint_namespaceObject.CommitlintConfig;
+        const commitlint_CommitlintConfig = {
+            silk (options) {
+                return commitlint_namespaceObject.CommitlintConfig.silk(options);
+            }
+        };
         const commitlint_COMMIT_TYPES = commitlint_namespaceObject.COMMIT_TYPES;
         const commitlint_COMMIT_TYPE_DEFINITIONS = commitlint_namespaceObject.COMMIT_TYPE_DEFINITIONS;
         const commitlint_TDD_SCOPE_PATTERN = commitlint_namespaceObject.TDD_SCOPE_PATTERN;
         const commitlint_TDD_STATES = commitlint_namespaceObject.TDD_STATES;
-        const src_commitlint = commitlint_namespaceObject.CommitlintConfig;
+        const src_commitlint = commitlint_CommitlintConfig;
     },
     buffer (module) {
         "use strict";

package/cjs/{commitlint.d.cts → commitlint/index.d.cts}

@@ -15,11 +15,16 @@ export declare const COMMIT_TYPE_DEFINITIONS: readonly Commitlint.CommitTypeDefi
 
 export declare const COMMIT_TYPES: readonly ["ai", "build", "chore", "ci", "docs", "feat", "fix", "perf", "refactor", "release", "revert", "style", "tdd", "test"];
 
-export declare const CommitlintConfig: typeof Commitlint.CommitlintConfig;
+declare const CommitlintConfig: {
+    silk(options?: Commitlint.ConfigOptions): CommitlintUserConfig;
+};
+export { CommitlintConfig }
+export default CommitlintConfig;
 
 export declare type CommitlintPlugin = Commitlint.CommitlintPlugin;
 
-export declare type CommitlintUserConfig = Commitlint.CommitlintUserConfig;
+export declare interface CommitlintUserConfig extends Commitlint.CommitlintUserConfig {
+}
 
 export declare type CommitType = Commitlint.CommitType;
 
@@ -27,9 +32,6 @@ export declare type CommitTypeDefinition = Commitlint.CommitTypeDefinition;
 
 export declare type ConfigOptions = Commitlint.ConfigOptions;
 
-declare const _default: typeof Commitlint.CommitlintConfig;
-export default _default;
-
 export declare type PromptConfig = Commitlint.PromptConfig;
 
 export declare type PromptSettings = Commitlint.PromptSettings;

package/cjs/lint/index.cjs

@@ -77926,7 +77926,20 @@ Default "index" lookups for the main are deprecated for ES modules.`, "Deprecati
         const lint_TypeScript = lint_namespaceObject.TypeScript;
         const lint_Yaml = lint_namespaceObject.Yaml;
         const lint_createConfig = lint_namespaceObject.createConfig;
-        const lint_Preset = lint_namespaceObject.Preset;
+        const lint_Preset = {
+            minimal (extend) {
+                return lint_namespaceObject.Preset.minimal(extend);
+            },
+            standard (extend) {
+                return lint_namespaceObject.Preset.standard(extend);
+            },
+            silk (extend) {
+                return lint_namespaceObject.Preset.silk(extend);
+            },
+            get (name, extend) {
+                return lint_namespaceObject.Preset.get(name, extend);
+            }
+        };
         const lint_Command = lint_namespaceObject.Command;
         const lint_Filter = lint_namespaceObject.Filter;
         const lint_getWorkspaceRoot = lint_namespaceObject.getWorkspaceRoot;

package/cjs/{lint.d.cts → lint/index.d.cts}

@@ -259,9 +259,14 @@ export declare const POST_CHECKOUT_HOOK_PATH = ".husky/post-checkout";
 
 export declare const POST_MERGE_HOOK_PATH = ".husky/post-merge";
 
-export declare const Preset: typeof Lint.Preset;
+export declare const Preset: {
+    minimal(extend?: Lint.PresetExtendOptions): LintStagedConfig;
+    standard(extend?: Lint.PresetExtendOptions): LintStagedConfig;
+    silk(extend?: Lint.PresetExtendOptions): LintStagedConfig;
+    get(name: "minimal" | "standard" | "silk", extend?: Lint.PresetExtendOptions): LintStagedConfig;
+};
 
-export declare type Preset = typeof Lint.Preset;
+export declare type Preset = typeof Preset;
 
 export declare type PresetExtendOptions = Lint.PresetExtendOptions;
 

package/esm/{commitlint.d.ts → commitlint/index.d.ts}

@@ -15,11 +15,16 @@ export declare const COMMIT_TYPE_DEFINITIONS: readonly Commitlint.CommitTypeDefi
 
 export declare const COMMIT_TYPES: readonly ["ai", "build", "chore", "ci", "docs", "feat", "fix", "perf", "refactor", "release", "revert", "style", "tdd", "test"];
 
-export declare const CommitlintConfig: typeof Commitlint.CommitlintConfig;
+declare const CommitlintConfig: {
+    silk(options?: Commitlint.ConfigOptions): CommitlintUserConfig;
+};
+export { CommitlintConfig }
+export default CommitlintConfig;
 
 export declare type CommitlintPlugin = Commitlint.CommitlintPlugin;
 
-export declare type CommitlintUserConfig = Commitlint.CommitlintUserConfig;
+export declare interface CommitlintUserConfig extends Commitlint.CommitlintUserConfig {
+}
 
 export declare type CommitType = Commitlint.CommitType;
 
@@ -27,9 +32,6 @@ export declare type CommitTypeDefinition = Commitlint.CommitTypeDefinition;
 
 export declare type ConfigOptions = Commitlint.ConfigOptions;
 
-declare const _default: typeof Commitlint.CommitlintConfig;
-export default _default;
-
 export declare type PromptConfig = Commitlint.PromptConfig;
 
 export declare type PromptSettings = Commitlint.PromptSettings;

package/esm/commitlint/index.js

@@ -1,9 +1,13 @@
 import { commitlint_namespaceObject as dev_commitlint_namespaceObject } from "../792.js";
-const CommitlintConfig = dev_commitlint_namespaceObject.CommitlintConfig;
+const CommitlintConfig = {
+    silk (options) {
+        return dev_commitlint_namespaceObject.CommitlintConfig.silk(options);
+    }
+};
 const COMMIT_TYPES = dev_commitlint_namespaceObject.COMMIT_TYPES;
 const COMMIT_TYPE_DEFINITIONS = dev_commitlint_namespaceObject.COMMIT_TYPE_DEFINITIONS;
 const TDD_SCOPE_PATTERN = dev_commitlint_namespaceObject.TDD_SCOPE_PATTERN;
 const TDD_STATES = dev_commitlint_namespaceObject.TDD_STATES;
-const commitlint = dev_commitlint_namespaceObject.CommitlintConfig;
+const commitlint = CommitlintConfig;
 export default commitlint;
 export { COMMIT_TYPES, COMMIT_TYPE_DEFINITIONS, CommitlintConfig, TDD_SCOPE_PATTERN, TDD_STATES };

package/esm/{lint.d.ts → lint/index.d.ts}

@@ -259,9 +259,14 @@ export declare const POST_CHECKOUT_HOOK_PATH = ".husky/post-checkout";
 
 export declare const POST_MERGE_HOOK_PATH = ".husky/post-merge";
 
-export declare const Preset: typeof Lint.Preset;
+export declare const Preset: {
+    minimal(extend?: Lint.PresetExtendOptions): LintStagedConfig;
+    standard(extend?: Lint.PresetExtendOptions): LintStagedConfig;
+    silk(extend?: Lint.PresetExtendOptions): LintStagedConfig;
+    get(name: "minimal" | "standard" | "silk", extend?: Lint.PresetExtendOptions): LintStagedConfig;
+};
 
-export declare type Preset = typeof Lint.Preset;
+export declare type Preset = typeof Preset;
 
 export declare type PresetExtendOptions = Lint.PresetExtendOptions;
 

package/esm/lint/index.js

@@ -8,7 +8,20 @@ const ShellScripts = dev_lint_namespaceObject.ShellScripts;
 const TypeScript = dev_lint_namespaceObject.TypeScript;
 const Yaml = dev_lint_namespaceObject.Yaml;
 const createConfig = dev_lint_namespaceObject.createConfig;
-const Preset = dev_lint_namespaceObject.Preset;
+const Preset = {
+    minimal (extend) {
+        return dev_lint_namespaceObject.Preset.minimal(extend);
+    },
+    standard (extend) {
+        return dev_lint_namespaceObject.Preset.standard(extend);
+    },
+    silk (extend) {
+        return dev_lint_namespaceObject.Preset.silk(extend);
+    },
+    get (name, extend) {
+        return dev_lint_namespaceObject.Preset.get(name, extend);
+    }
+};
 const Command = dev_lint_namespaceObject.Command;
 const Filter = dev_lint_namespaceObject.Filter;
 const getWorkspaceRoot = dev_lint_namespaceObject.getWorkspaceRoot;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@savvy-web/silk",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "private": false,
   "description": "The single Silk Suite dev-tooling package — changeset, commitlint, lint, and biome conventions",
   "homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk",
@@ -22,56 +22,52 @@
   "type": "module",
   "exports": {
     "./changesets": {
-      "types": "./esm/changesets.d.ts",
+      "types": "./esm/changesets/index.d.ts",
       "import": "./esm/changesets/index.js",
       "require": "./cjs/changesets/index.cjs"
     },
     "./changesets/changelog": {
-      "types": "./esm/changesets/changelog.d.ts",
+      "types": "./esm/changesets/changelog/index.d.ts",
       "import": "./esm/changesets/changelog/index.js",
       "require": "./cjs/changesets/changelog/index.cjs"
     },
     "./changesets/markdownlint": {
-      "types": "./esm/changesets/markdownlint.d.ts",
+      "types": "./esm/changesets/markdownlint/index.d.ts",
       "import": "./esm/changesets/markdownlint/index.js",
       "require": "./cjs/changesets/markdownlint/index.cjs"
     },
     "./changesets/remark": {
-      "types": "./esm/changesets/remark.d.ts",
+      "types": "./esm/changesets/remark/index.d.ts",
       "import": "./esm/changesets/remark/index.js",
       "require": "./cjs/changesets/remark/index.cjs"
     },
     "./commitlint": {
-      "types": "./esm/commitlint.d.ts",
+      "types": "./esm/commitlint/index.d.ts",
       "import": "./esm/commitlint/index.js",
       "require": "./cjs/commitlint/index.cjs"
     },
     "./commitlint/static": {
-      "types": "./esm/commitlint/static.d.ts",
+      "types": "./esm/commitlint/static/index.d.ts",
       "import": "./esm/commitlint/static/index.js",
       "require": "./cjs/commitlint/static/index.cjs"
     },
     "./commitlint/prompt": {
-      "types": "./esm/commitlint/prompt.d.ts",
+      "types": "./esm/commitlint/prompt/index.d.ts",
       "import": "./esm/commitlint/prompt/index.js",
       "require": "./cjs/commitlint/prompt/index.cjs"
     },
     "./commitlint/formatter": {
-      "types": "./esm/commitlint/formatter.d.ts",
+      "types": "./esm/commitlint/formatter/index.d.ts",
       "import": "./esm/commitlint/formatter/index.js",
       "require": "./cjs/commitlint/formatter/index.cjs"
     },
     "./lint": {
-      "types": "./esm/lint.d.ts",
+      "types": "./esm/lint/index.d.ts",
       "import": "./esm/lint/index.js",
       "require": "./cjs/lint/index.cjs"
     },
     "./biome": "./biome/silk.jsonc"
   },
-  "dependencies": {
-    "@savvy-web/cli": "0.1.0",
-    "@savvy-web/mcp": "0.1.0"
-  },
   "peerDependencies": {
     "@biomejs/biome": "2.4.16",
     "@changesets/cli": "^2.31.0",
@@ -85,7 +81,9 @@
     "markdownlint-cli2": "^0.22.1",
     "markdownlint-cli2-formatter-codequality": "^0.0.7",
     "turbo": "^2.9.16",
-    "typescript": "^6.0.0"
+    "typescript": "^6.0.0",
+    "@savvy-web/cli": "0.2.1",
+    "@savvy-web/mcp": "0.2.1"
   },
   "peerDependenciesMeta": {
     "@biomejs/biome": {
@@ -109,6 +107,7 @@
     "0~postcss.js",
     "0~typescript.js",
     "0~yaml.js",
+    "README.md",
     "biome/silk.jsonc",
     "cjs",
     "esm",