@savvy-web/silk 1.1.2 → 1.3.0

package/packages/silk-effects/dist/dev/pkg/errors/ChangesetConfigError.js

@@ -5,10 +5,11 @@ import { Data } from "effect";
 * Raised when the `.changeset/config.json` file cannot be read or decoded.
 *
 * @remarks
-* Returned by {@link ChangesetConfigReader.read} when the file is missing,
+* Returned by `ChangesetConfigReader.read` when the file is missing,
 * contains invalid JSON, or fails Effect Schema validation.
 *
 * @since 0.1.0
+* @public
 */
 var ChangesetConfigError = class extends Data.TaggedError("ChangesetConfigError") {
 	get message() {

package/packages/silk-effects/dist/dev/pkg/schemas/VersioningSchemas.cjs

@@ -34,11 +34,12 @@ const SnapshotConfig = effect.Schema.Struct({
 *
 * @remarks
 * Represents the parsed `.changeset/config.json` file. All fields are optional
-* to allow partial configs. Use {@link SilkChangesetConfigFile} when the Silk changelog
+* to allow partial configs. Use {@link (SilkChangesetConfigFile:type)} when the Silk changelog
 * adapter is detected.
 *
 * @since 0.1.0
 */
+/** @public */
 const ChangesetConfigFile = effect.Schema.Struct({
 	changelog: effect.Schema.optional(effect.Schema.Union(effect.Schema.String, effect.Schema.Array(effect.Schema.Unknown), effect.Schema.Literal(false))),
 	commit: effect.Schema.optional(effect.Schema.Union(effect.Schema.Boolean, effect.Schema.String, effect.Schema.Array(effect.Schema.Unknown))),
@@ -58,12 +59,13 @@ const ChangesetConfigFile = effect.Schema.Struct({
 * Extended changeset config for repos using the `@savvy-web/changesets` changelog adapter.
 *
 * @remarks
-* Extends {@link ChangesetConfigFile} with a `_isSilk` marker flag that is automatically
+* Extends {@link (ChangesetConfigFile:type)} with a `_isSilk` marker flag that is automatically
 * set to `true`. Detected by {@link ChangesetConfigReader} when the `changelog` field
 * references `@savvy-web/changesets`.
 *
 * @since 0.1.0
 */
+/** @public */
 const SilkChangesetConfigFile = effect.Schema.extend(ChangesetConfigFile, effect.Schema.Struct({ _isSilk: effect.Schema.optionalWith(effect.Schema.Boolean, { default: () => true }) }));
 /**
 * Versioning strategy classification for a workspace.
@@ -74,16 +76,18 @@ const SilkChangesetConfigFile = effect.Schema.extend(ChangesetConfigFile, effect
 * - `"independent"` — multiple publishable packages with independent version bumps.
 *
 * @since 0.1.0
+* @public
 */
 const VersioningStrategyType = effect.Schema.Literal("single", "fixed-group", "independent");
 /**
 * Output of the versioning strategy detection, combining the strategy type with group metadata.
 *
 * @remarks
-* Produced by {@link VersioningStrategy.detect} and consumed by {@link TagStrategy.determine}
+* Produced by `VersioningStrategy.detect` and consumed by `TagStrategy.determine`
 * to decide on the appropriate git-tag format.
 *
 * @since 0.1.0
+* @public
 */
 const VersioningStrategyResult = effect.Schema.Struct({
 	type: VersioningStrategyType,

package/packages/silk-effects/dist/dev/pkg/schemas/VersioningSchemas.js

@@ -34,11 +34,12 @@ const SnapshotConfig = Schema.Struct({
 *
 * @remarks
 * Represents the parsed `.changeset/config.json` file. All fields are optional
-* to allow partial configs. Use {@link SilkChangesetConfigFile} when the Silk changelog
+* to allow partial configs. Use {@link (SilkChangesetConfigFile:type)} when the Silk changelog
 * adapter is detected.
 *
 * @since 0.1.0
 */
+/** @public */
 const ChangesetConfigFile = Schema.Struct({
 	changelog: Schema.optional(Schema.Union(Schema.String, Schema.Array(Schema.Unknown), Schema.Literal(false))),
 	commit: Schema.optional(Schema.Union(Schema.Boolean, Schema.String, Schema.Array(Schema.Unknown))),
@@ -58,12 +59,13 @@ const ChangesetConfigFile = Schema.Struct({
 * Extended changeset config for repos using the `@savvy-web/changesets` changelog adapter.
 *
 * @remarks
-* Extends {@link ChangesetConfigFile} with a `_isSilk` marker flag that is automatically
+* Extends {@link (ChangesetConfigFile:type)} with a `_isSilk` marker flag that is automatically
 * set to `true`. Detected by {@link ChangesetConfigReader} when the `changelog` field
 * references `@savvy-web/changesets`.
 *
 * @since 0.1.0
 */
+/** @public */
 const SilkChangesetConfigFile = Schema.extend(ChangesetConfigFile, Schema.Struct({ _isSilk: Schema.optionalWith(Schema.Boolean, { default: () => true }) }));
 /**
 * Versioning strategy classification for a workspace.
@@ -74,16 +76,18 @@ const SilkChangesetConfigFile = Schema.extend(ChangesetConfigFile, Schema.Struct
 * - `"independent"` — multiple publishable packages with independent version bumps.
 *
 * @since 0.1.0
+* @public
 */
 const VersioningStrategyType = Schema.Literal("single", "fixed-group", "independent");
 /**
 * Output of the versioning strategy detection, combining the strategy type with group metadata.
 *
 * @remarks
-* Produced by {@link VersioningStrategy.detect} and consumed by {@link TagStrategy.determine}
+* Produced by `VersioningStrategy.detect` and consumed by `TagStrategy.determine`
 * to decide on the appropriate git-tag format.
 *
 * @since 0.1.0
+* @public
 */
 const VersioningStrategyResult = Schema.Struct({
 	type: VersioningStrategyType,

package/packages/silk-effects/dist/dev/pkg/services/ChangesetConfig.cjs

@@ -11,6 +11,7 @@ let effect = require("effect");
 * to `mode: "none"` and empty/false defaults.
 *
 * @since 0.4.0
+* @public
 */
 var ChangesetConfig = class extends effect.Context.Tag("@savvy-web/silk-effects/ChangesetConfig")() {
 	/**
@@ -36,6 +37,7 @@ const isSilk = (cfg) => "_isSilk" in cfg && cfg._isSilk === true;
 * `ChangesetConfigReaderLive` + a platform layer (`NodeContext.layer`).
 *
 * @since 0.4.0
+* @public
 */
 const ChangesetConfigLive = effect.Layer.effect(ChangesetConfig, effect.Effect.gen(function* () {
 	const reader = yield* require_ChangesetConfigReader.ChangesetConfigReader;

package/packages/silk-effects/dist/dev/pkg/services/ChangesetConfig.js

@@ -11,6 +11,7 @@ import { Context, Effect, Layer, Option } from "effect";
 * to `mode: "none"` and empty/false defaults.
 *
 * @since 0.4.0
+* @public
 */
 var ChangesetConfig = class extends Context.Tag("@savvy-web/silk-effects/ChangesetConfig")() {
 	/**
@@ -36,6 +37,7 @@ const isSilk = (cfg) => "_isSilk" in cfg && cfg._isSilk === true;
 * `ChangesetConfigReaderLive` + a platform layer (`NodeContext.layer`).
 *
 * @since 0.4.0
+* @public
 */
 const ChangesetConfigLive = Layer.effect(ChangesetConfig, Effect.gen(function* () {
 	const reader = yield* ChangesetConfigReader;

package/packages/silk-effects/dist/dev/pkg/services/ChangesetConfigReader.cjs

@@ -26,8 +26,8 @@ function isSilkChangelog(changelog) {
 *
 * @remarks
 * Automatically detects whether the config uses the Silk changelog adapter
-* (`@savvy-web/changesets`) and decodes as {@link SilkChangesetConfigFile} or the
-* standard {@link ChangesetConfigFile} accordingly.
+* (`@savvy-web/changesets`) and decodes as {@link (SilkChangesetConfigFile:type)} or the
+* standard {@link (ChangesetConfigFile:type)} accordingly.
 *
 * @example
 * ```typescript
@@ -43,6 +43,7 @@ function isSilkChangelog(changelog) {
 * ```
 *
 * @since 0.1.0
+* @public
 */
 var ChangesetConfigReader = class extends effect.Context.Tag("@savvy-web/silk-effects/ChangesetConfigReader")() {};
 /**
@@ -53,6 +54,7 @@ var ChangesetConfigReader = class extends effect.Context.Tag("@savvy-web/silk-ef
 * `BunContext.layer` to satisfy this dependency.
 *
 * @since 0.1.0
+* @public
 */
 const ChangesetConfigReaderLive = effect.Layer.effect(ChangesetConfigReader, effect.Effect.gen(function* () {
 	const fs = yield* _effect_platform.FileSystem.FileSystem;

package/packages/silk-effects/dist/dev/pkg/services/ChangesetConfigReader.js

@@ -26,8 +26,8 @@ function isSilkChangelog(changelog) {
 *
 * @remarks
 * Automatically detects whether the config uses the Silk changelog adapter
-* (`@savvy-web/changesets`) and decodes as {@link SilkChangesetConfigFile} or the
-* standard {@link ChangesetConfigFile} accordingly.
+* (`@savvy-web/changesets`) and decodes as {@link (SilkChangesetConfigFile:type)} or the
+* standard {@link (ChangesetConfigFile:type)} accordingly.
 *
 * @example
 * ```typescript
@@ -43,6 +43,7 @@ function isSilkChangelog(changelog) {
 * ```
 *
 * @since 0.1.0
+* @public
 */
 var ChangesetConfigReader = class extends Context.Tag("@savvy-web/silk-effects/ChangesetConfigReader")() {};
 /**
@@ -53,6 +54,7 @@ var ChangesetConfigReader = class extends Context.Tag("@savvy-web/silk-effects/C
 * `BunContext.layer` to satisfy this dependency.
 *
 * @since 0.1.0
+* @public
 */
 const ChangesetConfigReaderLive = Layer.effect(ChangesetConfigReader, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;

package/packages/silk-effects/dist/dev/pkg/services/SilkPublishability.cjs

@@ -1,5 +1,5 @@
 const require_ChangesetConfig = require('./ChangesetConfig.cjs');
-const require_index = require('../../../../../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect_platform@0.96.1_effect@3.21.3__effect@3.21.3/node_modules/workspaces-effect/index.cjs');
+const require_index = require('../../../../../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/index.cjs');
 let effect = require("effect");
 let node_path = require("node:path");
 let _effect_platform = require("@effect/platform");
@@ -20,7 +20,7 @@ const DEFAULT_REGISTRIES = {
 *
 * @remarks
 * The npm public registry and GitHub Packages both accept provenance attestations through the
-* Sigstore/OIDC trusted-publishing flow, so a {@link PublishTarget} bound to either is marked
+* Sigstore/OIDC trusted-publishing flow, so a `PublishTarget` bound to either is marked
 * `provenance: true` by default — this is what gates the release action's attestation step. JSR
 * and custom registries do not participate and resolve to `false`. Matching is endpoint-based
 * (not target-key based) so a custom key pointed at one of these registries still opts in.
@@ -36,7 +36,7 @@ const provenanceForRegistry = (registry) => {
 	return hostname === "registry.npmjs.org" || hostname === "npm.pkg.github.com";
 };
 /**
-* Silk publishability rules over `workspaces-effect`'s {@link PublishTarget}.
+* Silk publishability rules over `workspaces-effect`'s `PublishTarget`.
 *
 * @remarks
 * In silk mode `private: true` is the norm on workspace `package.json`; publishability is
@@ -44,6 +44,7 @@ const provenanceForRegistry = (registry) => {
 * default. All helpers are static so a consumer sees the full rule surface in one place.
 *
 * @since 0.4.0
+* @public
 */
 var SilkPublishability = class {
 	/**
@@ -52,7 +53,7 @@ var SilkPublishability = class {
 	*
 	* - A non-empty `publishConfig.targets` map (the bundler's Record-map form) makes the
 	*   package publishable regardless of `private`. With a `binding` (post-prod-build), one
-	*   {@link PublishTarget} is emitted per resolved registry target, its `directory` set to
+	*   `PublishTarget` is emitted per resolved registry target, its `directory` set to
 	*   the bound group's `dist/prod/<group>/pkg` dir. Without a binding (pre-build), one
 	*   placeholder target is emitted per declared key so publishability and target counts
 	*   are correct; the directory is best-effort and unused until the build writes the
@@ -115,7 +116,7 @@ var SilkPublishability = class {
 		return [];
 	}
 	/**
-	* Resolve a package's publish targets via {@link PublishabilityDetector}, then drop any
+	* Resolve a package's publish targets via {@link SilkPublishability}, then drop any
 	* whose built `directory` package.json is `private: true`. Returned targets keep the
 	* detector's original (possibly package-relative) `directory`.
 	*/
@@ -131,7 +132,7 @@ var SilkPublishability = class {
 	}
 	/**
 	* The publishable, non-ignored packages, resolved through the single
-	* {@link PublishabilityDetector} (which already honors changeset ignore in adaptive mode).
+	* {@link SilkPublishability} (which already honors changeset ignore in adaptive mode).
 	*/
 	static listPublishable(root) {
 		return effect.Effect.gen(function* () {
@@ -167,24 +168,26 @@ const readRaw = (fs, packageJsonPath) => fs.readFileString(packageJsonPath).pipe
 *
 * @remarks
 * Returns `null` when the file is missing/unreadable/malformed — i.e. before the prod build
-* has run. {@link SilkPublishability.detect} falls back to declared-key placeholders in that
-* case. Used by the silk {@link PublishabilityDetector} layers and the workspace analyzer.
+* has run. `SilkPublishability.detect` falls back to declared-key placeholders in that
+* case. Used by the silk {@link SilkPublishability} layers and the workspace analyzer.
 *
 * @param fs - The FileSystem service.
 * @param pkgPath - Absolute path to the package directory.
 * @since 1.0.0
+* @public
 */
 const readTargetsBinding = (fs, pkgPath) => fs.readFileString((0, node_path.join)(pkgPath, "dist", "prod", "targets.json")).pipe(effect.Effect.flatMap((content) => effect.Effect.try({
 	try: () => JSON.parse(content),
 	catch: () => /* @__PURE__ */ new Error("invalid targets.json")
 })), effect.Effect.orElseSucceed(() => null));
 /**
-* Override of `workspaces-effect`'s {@link PublishabilityDetector} Tag with pure silk rules.
+* Override of `workspaces-effect`'s {@link SilkPublishability} Tag with pure silk rules.
 *
 * @remarks Requires `FileSystem` (captured at layer build); `detect` reads the raw
-* `package.json` from `pkg.packageJsonPath` and applies {@link SilkPublishability.detect}.
+* `package.json` from `pkg.packageJsonPath` and applies `SilkPublishability.detect`.
 *
 * @since 0.4.0
+* @public
 */
 const SilkPublishabilityDetectorLive = effect.Layer.effect(require_index.PublishabilityDetector, effect.Effect.gen(function* () {
 	const fs = yield* _effect_platform.FileSystem.FileSystem;
@@ -196,13 +199,14 @@ const SilkPublishabilityDetectorLive = effect.Layer.effect(require_index.Publish
 	}) };
 }));
 /**
-* Ignore-aware override of {@link PublishabilityDetector}. `detect` short-circuits to `[]`
-* for changeset-ignored packages, then dispatches on {@link ChangesetConfig.mode}:
-* `none` → `[]`; `silk` → {@link SilkPublishability.detect}; `vanilla` → the library default.
+* Ignore-aware override of {@link SilkPublishability}. `detect` short-circuits to `[]`
+* for changeset-ignored packages, then dispatches on `ChangesetConfig.mode`:
+* `none` → `[]`; `silk` → `SilkPublishability.detect`; `vanilla` → the library default.
 *
 * @remarks Requires `FileSystem` + {@link ChangesetConfig} at build.
 *
 * @since 0.4.0
+* @public
 */
 const PublishabilityDetectorAdaptiveLive = effect.Layer.effect(require_index.PublishabilityDetector, effect.Effect.gen(function* () {
 	const fs = yield* _effect_platform.FileSystem.FileSystem;

package/packages/silk-effects/dist/dev/pkg/services/SilkPublishability.js

@@ -1,5 +1,5 @@
 import { ChangesetConfig } from "./ChangesetConfig.js";
-import { PublishTarget, PublishabilityDetector, PublishabilityDetectorLive, WorkspaceDiscovery } from "../../../../../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect_platform@0.96.1_effect@3.21.3__effect@3.21.3/node_modules/workspaces-effect/index.js";
+import { PublishTarget, PublishabilityDetector, PublishabilityDetectorLive, WorkspaceDiscovery } from "../../../../../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/index.js";
 import { Effect, Layer } from "effect";
 import { isAbsolute, join } from "node:path";
 import { FileSystem } from "@effect/platform";
@@ -20,7 +20,7 @@ const DEFAULT_REGISTRIES = {
 *
 * @remarks
 * The npm public registry and GitHub Packages both accept provenance attestations through the
-* Sigstore/OIDC trusted-publishing flow, so a {@link PublishTarget} bound to either is marked
+* Sigstore/OIDC trusted-publishing flow, so a `PublishTarget` bound to either is marked
 * `provenance: true` by default — this is what gates the release action's attestation step. JSR
 * and custom registries do not participate and resolve to `false`. Matching is endpoint-based
 * (not target-key based) so a custom key pointed at one of these registries still opts in.
@@ -36,7 +36,7 @@ const provenanceForRegistry = (registry) => {
 	return hostname === "registry.npmjs.org" || hostname === "npm.pkg.github.com";
 };
 /**
-* Silk publishability rules over `workspaces-effect`'s {@link PublishTarget}.
+* Silk publishability rules over `workspaces-effect`'s `PublishTarget`.
 *
 * @remarks
 * In silk mode `private: true` is the norm on workspace `package.json`; publishability is
@@ -44,6 +44,7 @@ const provenanceForRegistry = (registry) => {
 * default. All helpers are static so a consumer sees the full rule surface in one place.
 *
 * @since 0.4.0
+* @public
 */
 var SilkPublishability = class {
 	/**
@@ -52,7 +53,7 @@ var SilkPublishability = class {
 	*
 	* - A non-empty `publishConfig.targets` map (the bundler's Record-map form) makes the
 	*   package publishable regardless of `private`. With a `binding` (post-prod-build), one
-	*   {@link PublishTarget} is emitted per resolved registry target, its `directory` set to
+	*   `PublishTarget` is emitted per resolved registry target, its `directory` set to
 	*   the bound group's `dist/prod/<group>/pkg` dir. Without a binding (pre-build), one
 	*   placeholder target is emitted per declared key so publishability and target counts
 	*   are correct; the directory is best-effort and unused until the build writes the
@@ -115,7 +116,7 @@ var SilkPublishability = class {
 		return [];
 	}
 	/**
-	* Resolve a package's publish targets via {@link PublishabilityDetector}, then drop any
+	* Resolve a package's publish targets via {@link SilkPublishability}, then drop any
 	* whose built `directory` package.json is `private: true`. Returned targets keep the
 	* detector's original (possibly package-relative) `directory`.
 	*/
@@ -131,7 +132,7 @@ var SilkPublishability = class {
 	}
 	/**
 	* The publishable, non-ignored packages, resolved through the single
-	* {@link PublishabilityDetector} (which already honors changeset ignore in adaptive mode).
+	* {@link SilkPublishability} (which already honors changeset ignore in adaptive mode).
 	*/
 	static listPublishable(root) {
 		return Effect.gen(function* () {
@@ -167,24 +168,26 @@ const readRaw = (fs, packageJsonPath) => fs.readFileString(packageJsonPath).pipe
 *
 * @remarks
 * Returns `null` when the file is missing/unreadable/malformed — i.e. before the prod build
-* has run. {@link SilkPublishability.detect} falls back to declared-key placeholders in that
-* case. Used by the silk {@link PublishabilityDetector} layers and the workspace analyzer.
+* has run. `SilkPublishability.detect` falls back to declared-key placeholders in that
+* case. Used by the silk {@link SilkPublishability} layers and the workspace analyzer.
 *
 * @param fs - The FileSystem service.
 * @param pkgPath - Absolute path to the package directory.
 * @since 1.0.0
+* @public
 */
 const readTargetsBinding = (fs, pkgPath) => fs.readFileString(join(pkgPath, "dist", "prod", "targets.json")).pipe(Effect.flatMap((content) => Effect.try({
 	try: () => JSON.parse(content),
 	catch: () => /* @__PURE__ */ new Error("invalid targets.json")
 })), Effect.orElseSucceed(() => null));
 /**
-* Override of `workspaces-effect`'s {@link PublishabilityDetector} Tag with pure silk rules.
+* Override of `workspaces-effect`'s {@link SilkPublishability} Tag with pure silk rules.
 *
 * @remarks Requires `FileSystem` (captured at layer build); `detect` reads the raw
-* `package.json` from `pkg.packageJsonPath` and applies {@link SilkPublishability.detect}.
+* `package.json` from `pkg.packageJsonPath` and applies `SilkPublishability.detect`.
 *
 * @since 0.4.0
+* @public
 */
 const SilkPublishabilityDetectorLive = Layer.effect(PublishabilityDetector, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;
@@ -196,13 +199,14 @@ const SilkPublishabilityDetectorLive = Layer.effect(PublishabilityDetector, Effe
 	}) };
 }));
 /**
-* Ignore-aware override of {@link PublishabilityDetector}. `detect` short-circuits to `[]`
-* for changeset-ignored packages, then dispatches on {@link ChangesetConfig.mode}:
-* `none` → `[]`; `silk` → {@link SilkPublishability.detect}; `vanilla` → the library default.
+* Ignore-aware override of {@link SilkPublishability}. `detect` short-circuits to `[]`
+* for changeset-ignored packages, then dispatches on `ChangesetConfig.mode`:
+* `none` → `[]`; `silk` → `SilkPublishability.detect`; `vanilla` → the library default.
 *
 * @remarks Requires `FileSystem` + {@link ChangesetConfig} at build.
 *
 * @since 0.4.0
+* @public
 */
 const PublishabilityDetectorAdaptiveLive = Layer.effect(PublishabilityDetector, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;