@savvy-web/mcp 1.3.5 → 1.4.0

package/content/packages/rspress-builder/api/interface/rspresspluginoptions.md

@@ -1,76 +0,0 @@
----
-id: packages/rspress-builder/api/interface/rspresspluginoptions
-title: "RspressPluginOptions — rspress-builder interface"
-summary: "Options for `definePlugin`. Deliberately small — RSPress plugins have a fixed shape."
-tier: packages
-source: generated
-tags: [rspress-builder, api]
-priority: 0.3
-related: []
----
-
-# RspressPluginOptions
-
-Options for `definePlugin`. Deliberately small — RSPress plugins have a fixed shape.
-
-```ts
-interface RspressPluginOptions
-```
-
-## Members
-
-### apiModel
-
-```ts
-readonly apiModel?: BuildConfigInput["meta"];
-```
-
-API-model generation. Defaults to on (documents plugin options AND runtime components). `false` opts out.
-
-### define
-
-```ts
-readonly define?: Record<string, string>;
-```
-
-Build-wide compile-time global replacements forwarded to every partition (the bundler's `define` is [build](silk://packages/rspress-builder/api/function/build)-wide; there is no per-bundle define). Merged AFTER the `import.meta.env` identity map, so a user key may override it intentionally. Values are inserted verbatim (string literals must be quoted).
-
-### dtsBundledPackages
-
-```ts
-readonly dtsBundledPackages?: ReadonlyArray<string>;
-```
-
-Packages whose declarations are inlined into the bundled dts (e.g. [`@rspress/core`]).
-
-### jsx
-
-```ts
-readonly jsx?: BuildConfigInput["jsx"];
-```
-
-JSX override; defaults to tsconfig-inferred.
-
-### plugin
-
-```ts
-readonly plugin?: RspressBundleOptions;
-```
-
-Tuning for the plugin (`.`) bundle (node, bundled).
-
-### runtime
-
-```ts
-readonly runtime?: boolean | RspressBundleOptions;
-```
-
-Enable the `./runtime` bundle (browser, bundleless, CSS modules, React/`@theme` external). `true` (default) builds it; `false` disables it; an object tunes its externals. This does not auto-detect the filesystem — pass `false` for a plugin with no runtime.
-
-### transform
-
-```ts
-readonly transform?: BuildConfigInput["transform"];
-```
-
-Final package.json mutation; defaults to the bundler's defaultManifestTransform.

package/content/packages/rspress-builder/api.md

@@ -1,22 +0,0 @@
----
-id: packages/rspress-builder/api
-title: "@savvy-web/rspress-builder — API reference"
-summary: "@savvy-web/rspress-builder API reference: 4 documented symbols."
-tier: packages
-source: generated
-tags: [rspress-builder, api]
-priority: 0.4
-related: []
----
-
-# @savvy-web/rspress-builder — API reference
-
-## function
-
-- [`build`](silk://packages/rspress-builder/api/function/build) — Front door for building an RSPress plugin. Applies the definePlugin preset and runs the build, deriving `cwd` and `argv` from `process.argv`. For advanced use, definePlugin and `runBuild` remain exported.
-- [`definePlugin`](silk://packages/rspress-builder/api/function/defineplugin) — Build an RSPress plugin package: a Node plugin entry (`.`) plus a browser, bundleless, CSS-module React runtime entry (`./runtime`). Returns a standard `BuildConfig`; hand it to `runBuild` from a self-executing `savvy.build.ts`.
-
-## interface
-
-- [`RspressBundleOptions`](silk://packages/rspress-builder/api/interface/rspressbundleoptions) — Per-bundle externals tuning for a single partition (plugin or runtime).
-- [`RspressPluginOptions`](silk://packages/rspress-builder/api/interface/rspresspluginoptions) — Options for `definePlugin`. Deliberately small — RSPress plugins have a fixed shape.

package/content/packages/silk/export-map.md

@@ -1,67 +0,0 @@
----
-id: packages/silk/export-map
-title: silk subpath export map
-summary: Load when wiring a config file to a @savvy-web/silk subpath, or auditing the export map.
-tier: packages
-source: hand
-tags: [silk]
-priority: 0.5
-related: [packages/silk/install-and-setup]
----
-
-## What
-
-`@savvy-web/silk` has no root barrel. It exposes a set of nested config-integration
-entry points, each loaded by a different external tool. The nested subpaths mirror
-exactly the module shapes those tools load, rather than implying a coherent library
-API.
-
-## API
-
-```text
-./changesets              ← changeset class/services API surface
-./changesets/changelog    ← ChangelogFunctions default for .changeset/config.json
-./changesets/markdownlint ← markdownlint-cli2 rules (default array + named)
-./changesets/remark       ← remark transform plugins + presets + lint rules
-./commitlint              ← CommitlintConfig (auto-detecting factory) + types
-./commitlint/static       ← static config default (no auto-detection)
-./commitlint/prompt       ← commitizen adapter
-./commitlint/formatter    ← custom error formatter
-./lint                    ← handlers / Preset / createConfig / utils / section data
-./biome                   ← static silk.jsonc asset (copied, not a shim)
-```
-
-The shim contract per subpath:
-
-- `./changesets/changelog` — default export is the `@changesets/types`
-  `ChangelogFunctions` object the Changesets CLI loads from the config's
-  `changelog` field.
-- `./changesets/markdownlint` — default export is the rule array markdownlint-cli2
-  loads, plus the named rule objects.
-- `./changesets/remark` — named exports for every transform plugin, preset, and
-  lint rule remark configs import.
-- `./commitlint/static` — default export is the static config object (no
-  auto-detection); the root `./commitlint` default-exports the auto-detecting
-  `CommitlintConfig` factory.
-- `./lint` — the full lint-staged consumer surface (handlers, `Preset`,
-  `createConfig`, workspace utils, section/template data). CLI commands are
-  deliberately NOT re-exported here — those belong to the `savvy` CLI.
-
-## Layer
-
-The `exports` field in silk's `package.json` is the authoritative wiring; the shim
-files under `src/` are the single source of truth for the exact reshaping. The
-`./biome` entry is a copied asset, not a shim.
-
-## Usage
-
-A markdownlint config loading the Silk rules:
-
-```text
-extends: "@savvy-web/silk/biome"            # biome.jsonc
-@savvy-web/silk/changesets/markdownlint     # markdownlint-cli2 customRules
-```
-
-## Related
-
-Install and setup: `silk://packages/silk/install-and-setup`.

package/content/packages/silk/install-and-setup.md

@@ -1,59 +0,0 @@
----
-id: packages/silk/install-and-setup
-title: Installing @savvy-web/silk
-summary: Load when installing the Silk dev-tooling system into a consumer repo.
-tier: packages
-source: hand
-tags: [silk, init]
-priority: 0.5
-related: [packages/silk/export-map, packages/cli/init-and-check]
----
-
-## What
-
-`@savvy-web/silk` is the single package a consumer installs to get the whole Silk
-Suite dev-tooling system. It is an install surface, not a library: each subpath
-export is a thin config-integration **shim** that re-exports `@savvy-web/silk-effects`
-logic shaped into the exact module form an external tool's config loader expects.
-The shims carry no logic. It is a `fixed` changeset group with `@savvy-web/cli`.
-
-## API
-
-A shim is a drop-in replacement: a config file that imported a subpath of one of
-the three old packages (`@savvy-web/changesets`, `@savvy-web/commitlint`,
-`@savvy-web/lint-staged`) works unchanged after swapping the import to the matching
-`@savvy-web/silk` subpath. Each shim reproduces the **module shape** the loader
-consumes — default vs named, array vs object — not just the symbols. The full
-subpath map is at `silk://packages/silk/export-map`.
-
-## Layer
-
-silk's only dependency is `@savvy-web/silk-effects` (`workspace:*`). Its
-`peerDependencies` declare `@savvy-web/cli` (install-wiring) plus the merged
-real-tool peers (`@biomejs/biome` optional, `husky`, `@commitlint/*`, `commitizen`,
-`@changesets/cli`, `lint-staged`, `markdownlint-cli2`) via `catalog:silkPeers`.
-silk ships dual-format (esm + cjs) because some consumers `require()` its subpaths
-from CommonJS — notably markdownlint-cli2's custom-rule loader, which loads
-`./changesets/markdownlint` through a CJS path; silk-effects therefore also exposes
-a CJS entry. Dual-format is mandatory, not cosmetic.
-
-## Usage
-
-The consumer model:
-
-```text
-install @savvy-web/silk
-  → autoInstallPeers pulls cli (the savvy bin) + biome/husky/@commitlint/
-    @changesets/lint-staged/markdownlint
-  → savvy init seeds configs that reference @savvy-web/silk/* and wires husky
-    hooks to savvy subcommands
-  → at runtime both silk (via shims) and cli (via handlers) resolve their logic
-    from silk-effects
-```
-
-The Biome preset is referenced as `extends: "@savvy-web/silk/biome"`.
-
-## Related
-
-The export map: `silk://packages/silk/export-map`. The `init` step that follows
-install: `silk://packages/cli/init-and-check`.

package/content/packages/silk-effects/api/class/analyzedworkspace.md

@@ -1,121 +0,0 @@
----
-id: packages/silk-effects/api/class/analyzedworkspace
-title: "AnalyzedWorkspace — silk-effects class"
-summary: "A fully analyzed workspace with publish targets, versioning status, and release group membership."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# AnalyzedWorkspace
-
-A fully analyzed workspace with publish targets, versioning status, and release group membership.
-
-```ts
-class AnalyzedWorkspace extends AnalyzedWorkspace_base
-```
-
-## Members
-
-### [Equal.symbol]
-
-```ts
-[Equal.symbol](that: Equal.Equal): boolean;
-```
-
-### [Hash.symbol]
-
-```ts
-[Hash.symbol](): number;
-```
-
-### findByName
-
-```ts
-static findByName: {
-    (name: string): (workspaces: ReadonlyArray<AnalyzedWorkspace>) => Option.Option<AnalyzedWorkspace>;
-    (workspaces: ReadonlyArray<AnalyzedWorkspace>, name: string): Option.Option<AnalyzedWorkspace>;
-  };
-```
-
-### hasTarget
-
-```ts
-hasTarget(shorthand: "npm" | "github" | "jsr"): boolean;
-```
-
-### isFixed
-
-```ts
-get isFixed(): boolean;
-```
-
-### isLinked
-
-```ts
-get isLinked(): boolean;
-```
-
-### isPublishable
-
-```ts
-get isPublishable(): boolean;
-```
-
-### isReleasable
-
-```ts
-get isReleasable(): boolean;
-```
-
-### isRoot
-
-```ts
-get isRoot(): boolean;
-```
-
-### pretty
-
-```ts
-static pretty: (self: AnalyzedWorkspace) => string;
-```
-
-Pretty-print an [AnalyzedWorkspace](silk://packages/silk-effects/api/class/analyzedworkspace) instance.
-
-### publishable
-
-```ts
-static publishable(workspaces: ReadonlyArray<AnalyzedWorkspace>): ReadonlyArray<AnalyzedWorkspace>;
-```
-
-### publishesTo
-
-```ts
-publishesTo(registry: string): boolean;
-```
-
-### releasable
-
-```ts
-static releasable(workspaces: ReadonlyArray<AnalyzedWorkspace>): ReadonlyArray<AnalyzedWorkspace>;
-```
-
-### targetFor
-
-```ts
-targetFor(registry: string): Option.Option<PublishTarget>;
-```
-
-### toJSON
-
-```ts
-toJSON(): unknown;
-```
-
-### toString
-
-```ts
-toString(): string;
-```

package/content/packages/silk-effects/api/class/biomeschemasync.md

@@ -1,33 +0,0 @@
----
-id: packages/silk-effects/api/class/biomeschemasync
-title: "BiomeSchemaSync — silk-effects class"
-summary: "Service that keeps the `$schema` URL in Biome config files in sync with a target version."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# BiomeSchemaSync
-
-Service that keeps the `$schema` URL in Biome config files in sync with a target version.
-
-```ts
-class BiomeSchemaSync extends BiomeSchemaSync_base
-```
-
-## Examples
-
-```typescript
-const result = await Effect.runPromise(
-  Effect.gen(function* () {
-    const syncer = yield* BiomeSchemaSync;
-    return yield* syncer.sync("^1.9.3");
-  }).pipe(
-    Effect.provide(BiomeSchemaSyncLive),
-    Effect.provide(NodeContext.layer),
-  )
-);
-
-```

package/content/packages/silk-effects/api/class/biomesyncerror.md

@@ -1,41 +0,0 @@
----
-id: packages/silk-effects/api/class/biomesyncerror
-title: "BiomeSyncError — silk-effects class"
-summary: "Raised when a Biome config file cannot be read or its `$schema` URL cannot be updated."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# BiomeSyncError
-
-Raised when a Biome config file cannot be read or its `$schema` URL cannot be updated.
-
-```ts
-class BiomeSyncError extends BiomeSyncError_base<{
-  readonly path: string;
-  readonly reason: string;
-}>
-```
-
-## Members
-
-### message
-
-```ts
-get message(): string;
-```
-
-### path
-
-```ts
-readonly path: string;
-```
-
-### reason
-
-```ts
-readonly reason: string;
-```

package/content/packages/silk-effects/api/class/changesetconfig.md

@@ -1,28 +0,0 @@
----
-id: packages/silk-effects/api/class/changesetconfig
-title: "ChangesetConfig — silk-effects class"
-summary: "Accessor service over a workspace root's `.changeset/config.json`."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# ChangesetConfig
-
-Accessor service over a workspace root's `.changeset/config.json`.
-
-```ts
-class ChangesetConfig extends ChangesetConfig_base
-```
-
-## Members
-
-### matches
-
-```ts
-static matches(name: string, pattern: string): boolean;
-```
-
-The one ignore matcher: exact name match, or `@scope/*` wildcard. `"@scope/*"` matches `"@scope/anything"` (prefix kept includes the trailing slash), but not the bare scope `"@scope"`.

package/content/packages/silk-effects/api/class/changesetconfigerror.md

@@ -1,41 +0,0 @@
----
-id: packages/silk-effects/api/class/changesetconfigerror
-title: "ChangesetConfigError — silk-effects class"
-summary: "Raised when the `.changeset/config.json` file cannot be read or decoded."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# ChangesetConfigError
-
-Raised when the `.changeset/config.json` file cannot be read or decoded.
-
-```ts
-class ChangesetConfigError extends ChangesetConfigError_base<{
-  readonly path: string;
-  readonly reason: string;
-}>
-```
-
-## Members
-
-### message
-
-```ts
-get message(): string;
-```
-
-### path
-
-```ts
-readonly path: string;
-```
-
-### reason
-
-```ts
-readonly reason: string;
-```

package/content/packages/silk-effects/api/class/changesetconfigreader.md

@@ -1,33 +0,0 @@
----
-id: packages/silk-effects/api/class/changesetconfigreader
-title: "ChangesetConfigReader — silk-effects class"
-summary: "Service that reads and decodes the `.changeset/config.json` for a given workspace root."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# ChangesetConfigReader
-
-Service that reads and decodes the `.changeset/config.json` for a given workspace root.
-
-```ts
-class ChangesetConfigReader extends ChangesetConfigReader_base
-```
-
-## Examples
-
-```typescript
-const result = await Effect.runPromise(
-  Effect.gen(function* () {
-    const reader = yield* ChangesetConfigReader;
-    return yield* reader.read(process.cwd());
-  }).pipe(
-    Effect.provide(ChangesetConfigReaderLive),
-    Effect.provide(NodeContext.layer),
-  )
-);
-
-```

package/content/packages/silk-effects/api/class/configdiscovery.md

@@ -1,33 +0,0 @@
----
-id: packages/silk-effects/api/class/configdiscovery
-title: "ConfigDiscovery — silk-effects class"
-summary: "Service that locates named config files within a workspace using priority-ordered search paths."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# ConfigDiscovery
-
-Service that locates named config files within a workspace using priority-ordered search paths.
-
-```ts
-class ConfigDiscovery extends ConfigDiscovery_base
-```
-
-## Examples
-
-```typescript
-const result = await Effect.runPromise(
-  Effect.gen(function* () {
-    const discovery = yield* ConfigDiscovery;
-    return yield* discovery.find("biome.json");
-  }).pipe(
-    Effect.provide(ConfigDiscoveryLive),
-    Effect.provide(NodeContext.layer),
-  )
-);
-
-```

package/content/packages/silk-effects/api/class/confignotfounderror.md

@@ -1,41 +0,0 @@
----
-id: packages/silk-effects/api/class/confignotfounderror
-title: "ConfigNotFoundError — silk-effects class"
-summary: "Raised when a config file cannot be located in any of the expected locations."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# ConfigNotFoundError
-
-Raised when a config file cannot be located in any of the expected locations.
-
-```ts
-class ConfigNotFoundError extends ConfigNotFoundError_base<{
-  readonly name: string;
-  readonly searchedPaths: ReadonlyArray<string>;
-}>
-```
-
-## Members
-
-### message
-
-```ts
-get message(): string;
-```
-
-### name
-
-```ts
-readonly name: string;
-```
-
-### searchedPaths
-
-```ts
-readonly searchedPaths: ReadonlyArray<string>;
-```

package/content/packages/silk-effects/api/class/managedsection.md

@@ -1,18 +0,0 @@
----
-id: packages/silk-effects/api/class/managedsection
-title: "ManagedSection — silk-effects class"
-summary: "Service for managing delimited sections in user-editable files. All methods use dual API (data-first and data-last). Identity-only operations (`read`, `isManag…"
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# ManagedSection
-
-Service for managing delimited sections in user-editable files. All methods use dual API (data-first and data-last). Identity-only operations (`read`, `isManaged`) take a [SectionDefinition](silk://packages/silk-effects/api/class/sectiondefinition). Content operations (`write`, `sync`, `check`) take a [SectionBlock](silk://packages/silk-effects/api/class/sectionblock).
-
-```ts
-class ManagedSection extends ManagedSection_base
-```

package/content/packages/silk-effects/api/class/resolvedtool.md

@@ -1,62 +0,0 @@
----
-id: packages/silk-effects/api/class/resolvedtool
-title: "ResolvedTool — silk-effects class"
-summary: "Result of resolving a ToolDefinition. Provides `exec` and `dlx` to build commands for the resolved tool."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# ResolvedTool
-
-Result of resolving a [ToolDefinition](silk://packages/silk-effects/api/class/tooldefinition). Provides `exec` and `dlx` to build commands for the resolved tool.
-
-```ts
-class ResolvedTool extends ResolvedTool_base
-```
-
-## Members
-
-### [Equal.symbol]
-
-```ts
-[Equal.symbol](that: Equal.Equal): boolean;
-```
-
-### [Hash.symbol]
-
-```ts
-[Hash.symbol](): number;
-```
-
-### dlx
-
-```ts
-dlx(...args: string[]): ToolCommand;
-```
-
-### exec
-
-```ts
-exec(...args: string[]): ToolCommand;
-```
-
-### hasVersionMismatch
-
-```ts
-get hasVersionMismatch(): boolean;
-```
-
-### isGlobal
-
-```ts
-get isGlobal(): boolean;
-```
-
-### isLocal
-
-```ts
-get isLocal(): boolean;
-```