@savvy-web/silk 2.0.0 → 2.1.0

package/packages/silk-effects/dist/dev/pkg/changesets/categories/index.cjs

@@ -1,317 +0,0 @@
-
-//#region ../silk-effects/dist/dev/pkg/changesets/categories/index.js
-/**
-* Breaking changes -- backward-incompatible changes.
-*
-* @remarks
-* Priority 1 (highest). This category has no associated commit types;
-* it is resolved by the `!` suffix on any conventional commit type
-* (e.g., `feat!:`, `fix!:`). Use {@link resolveCommitType} with
-* `breaking: true` to map to this category.
-*
-* @internal
-*/
-const BREAKING_CHANGES = {
-	heading: "Breaking Changes",
-	priority: 1,
-	commitTypes: [],
-	description: "Backward-incompatible changes"
-};
-/**
-* Features -- new functionality.
-*
-* @remarks
-* Priority 2. Maps from the `feat` conventional commit type.
-*
-* @internal
-*/
-const FEATURES = {
-	heading: "Features",
-	priority: 2,
-	commitTypes: ["feat"],
-	description: "New functionality"
-};
-/**
-* Bug Fixes -- bug corrections.
-*
-* @remarks
-* Priority 3. Maps from the `fix` conventional commit type.
-*
-* @internal
-*/
-const BUG_FIXES = {
-	heading: "Bug Fixes",
-	priority: 3,
-	commitTypes: ["fix"],
-	description: "Bug corrections"
-};
-/**
-* Performance -- performance improvements.
-*
-* @remarks
-* Priority 4. Maps from the `perf` conventional commit type.
-*
-* @internal
-*/
-const PERFORMANCE = {
-	heading: "Performance",
-	priority: 4,
-	commitTypes: ["perf"],
-	description: "Performance improvements"
-};
-/**
-* Documentation -- documentation changes.
-*
-* @remarks
-* Priority 5. Maps from the `docs` conventional commit type.
-*
-* @internal
-*/
-const DOCUMENTATION = {
-	heading: "Documentation",
-	priority: 5,
-	commitTypes: ["docs"],
-	description: "Documentation changes"
-};
-/**
-* Refactoring -- code restructuring without behavior change.
-*
-* @remarks
-* Priority 6. Maps from the `refactor` conventional commit type.
-*
-* @internal
-*/
-const REFACTORING = {
-	heading: "Refactoring",
-	priority: 6,
-	commitTypes: ["refactor"],
-	description: "Code restructuring"
-};
-/**
-* Tests -- test additions or modifications.
-*
-* @remarks
-* Priority 7. Maps from the `test` conventional commit type.
-*
-* @internal
-*/
-const TESTS = {
-	heading: "Tests",
-	priority: 7,
-	commitTypes: ["test"],
-	description: "Test additions or modifications"
-};
-/**
-* Build System -- build configuration changes.
-*
-* @remarks
-* Priority 8. Maps from the `build` conventional commit type.
-*
-* @internal
-*/
-const BUILD_SYSTEM = {
-	heading: "Build System",
-	priority: 8,
-	commitTypes: ["build"],
-	description: "Build configuration changes"
-};
-/**
-* CI -- continuous integration changes.
-*
-* @remarks
-* Priority 9. Maps from the `ci` conventional commit type.
-*
-* @internal
-*/
-const CI = {
-	heading: "CI",
-	priority: 9,
-	commitTypes: ["ci"],
-	description: "Continuous integration changes"
-};
-/**
-* Dependencies -- dependency updates.
-*
-* @remarks
-* Priority 10. Maps from the `deps` conventional commit type and also
-* from `chore(deps)` via the {@link resolveCommitType} function.
-*
-* @internal
-*/
-const DEPENDENCIES = {
-	heading: "Dependencies",
-	priority: 10,
-	commitTypes: ["deps"],
-	description: "Dependency updates"
-};
-/**
-* Maintenance -- general maintenance tasks.
-*
-* @remarks
-* Priority 11. Maps from the `chore` and `style` conventional commit types.
-* Note that `chore(deps)` is redirected to {@link DEPENDENCIES} by
-* {@link resolveCommitType}.
-*
-* @internal
-*/
-const MAINTENANCE = {
-	heading: "Maintenance",
-	priority: 11,
-	commitTypes: ["chore", "style"],
-	description: "General maintenance"
-};
-/**
-* Reverts -- reverted changes.
-*
-* @remarks
-* Priority 12. Maps from the `revert` conventional commit type.
-*
-* @internal
-*/
-const REVERTS = {
-	heading: "Reverts",
-	priority: 12,
-	commitTypes: ["revert"],
-	description: "Reverted changes"
-};
-/**
-* Other -- uncategorized changes.
-*
-* @remarks
-* Priority 13 (lowest). This category has no associated commit types;
-* it serves as the fallback for any commit type not recognized by the
-* category system. Resolved by {@link resolveCommitType} when no other
-* category matches.
-*
-* @internal
-*/
-const OTHER = {
-	heading: "Other",
-	priority: 13,
-	commitTypes: [],
-	description: "Uncategorized changes"
-};
-/**
-* All 13 categories ordered by priority (ascending).
-*
-* @remarks
-* This array provides the canonical ordering for section headings in
-* CHANGELOG output. Breaking Changes appear first, Other appears last.
-* The array is frozen (`as const`) to prevent accidental mutation.
-*
-* @internal
-*/
-const CATEGORIES = [
-	BREAKING_CHANGES,
-	FEATURES,
-	BUG_FIXES,
-	PERFORMANCE,
-	DOCUMENTATION,
-	REFACTORING,
-	TESTS,
-	BUILD_SYSTEM,
-	CI,
-	DEPENDENCIES,
-	MAINTENANCE,
-	REVERTS,
-	OTHER
-];
-/**
-* Set of all valid section heading strings (case-insensitive lookup).
-* Used by Layer 1 (remark-lint) to validate changeset headings.
-*/
-const headingToCategory = new Map(CATEGORIES.map((cat) => [cat.heading.toLowerCase(), cat]));
-/**
-* Map from commit type string to its category.
-* Handles standard commit types. For `chore(deps)` and breaking `!` suffix,
-* use {@link resolveCommitType} instead.
-*/
-const commitTypeToCategory = /* @__PURE__ */ new Map();
-for (const cat of CATEGORIES) for (const commitType of cat.commitTypes) commitTypeToCategory.set(commitType, cat);
-/**
-* Resolve a conventional commit type (with optional scope and `!` suffix) to a category.
-*
-* @remarks
-* This function implements the full commit-type-to-category mapping logic,
-* including special cases:
-* - Any commit with `breaking: true` maps to {@link BREAKING_CHANGES}
-* - `chore` with scope `deps` maps to {@link DEPENDENCIES} (not Maintenance)
-* - Unrecognized types fall through to {@link OTHER}
-*
-* @param type - The commit type (e.g., `"feat"`, `"fix"`, `"chore"`)
-* @param scope - Optional scope (e.g., `"deps"` in `chore(deps):`)
-* @param breaking - Whether the commit has a `!` suffix indicating a breaking change
-* @returns The resolved section category
-*
-* @internal
-*/
-function resolveCommitType(type, scope, breaking) {
-	if (breaking) return BREAKING_CHANGES;
-	if (type === "chore" && scope === "deps") return DEPENDENCIES;
-	return commitTypeToCategory.get(type) ?? OTHER;
-}
-/**
-* Look up a category by its section heading text.
-*
-* @remarks
-* Comparison is case-insensitive: `"features"`, `"Features"`, and
-* `"FEATURES"` all match the Features category.
-*
-* @param heading - The heading text (e.g., `"Features"`, `"Bug Fixes"`)
-* @returns The matching category, or `undefined` if not recognized
-*
-* @internal
-*/
-function fromHeading(heading) {
-	return headingToCategory.get(heading.toLowerCase());
-}
-/**
-* Check whether a heading string matches a known category.
-*
-* @remarks
-* Comparison is case-insensitive. Useful for validating that a markdown
-* heading in a changeset file corresponds to a recognized section.
-*
-* @param heading - The heading text to check
-* @returns `true` if the heading matches a known category
-*
-* @internal
-*/
-function isValidHeading(heading) {
-	return headingToCategory.has(heading.toLowerCase());
-}
-/**
-* Get all valid section heading strings.
-*
-* @remarks
-* Returns the headings in priority order, matching the order of {@link CATEGORIES}.
-* Useful for generating help text or validation error messages that list
-* accepted headings.
-*
-* @returns Array of heading strings (e.g., `["Breaking Changes", "Features", ...]`)
-*
-* @internal
-*/
-function allHeadings() {
-	return CATEGORIES.map((cat) => cat.heading);
-}
-
-//#endregion
-exports.BREAKING_CHANGES = BREAKING_CHANGES;
-exports.BUG_FIXES = BUG_FIXES;
-exports.BUILD_SYSTEM = BUILD_SYSTEM;
-exports.CATEGORIES = CATEGORIES;
-exports.CI = CI;
-exports.DEPENDENCIES = DEPENDENCIES;
-exports.DOCUMENTATION = DOCUMENTATION;
-exports.FEATURES = FEATURES;
-exports.MAINTENANCE = MAINTENANCE;
-exports.OTHER = OTHER;
-exports.PERFORMANCE = PERFORMANCE;
-exports.REFACTORING = REFACTORING;
-exports.REVERTS = REVERTS;
-exports.TESTS = TESTS;
-exports.allHeadings = allHeadings;
-exports.fromHeading = fromHeading;
-exports.isValidHeading = isValidHeading;
-exports.resolveCommitType = resolveCommitType;

package/packages/silk-effects/dist/dev/pkg/changesets/categories/index.js

@@ -1,299 +0,0 @@
-//#region ../silk-effects/dist/dev/pkg/changesets/categories/index.js
-/**
-* Breaking changes -- backward-incompatible changes.
-*
-* @remarks
-* Priority 1 (highest). This category has no associated commit types;
-* it is resolved by the `!` suffix on any conventional commit type
-* (e.g., `feat!:`, `fix!:`). Use {@link resolveCommitType} with
-* `breaking: true` to map to this category.
-*
-* @internal
-*/
-const BREAKING_CHANGES = {
-	heading: "Breaking Changes",
-	priority: 1,
-	commitTypes: [],
-	description: "Backward-incompatible changes"
-};
-/**
-* Features -- new functionality.
-*
-* @remarks
-* Priority 2. Maps from the `feat` conventional commit type.
-*
-* @internal
-*/
-const FEATURES = {
-	heading: "Features",
-	priority: 2,
-	commitTypes: ["feat"],
-	description: "New functionality"
-};
-/**
-* Bug Fixes -- bug corrections.
-*
-* @remarks
-* Priority 3. Maps from the `fix` conventional commit type.
-*
-* @internal
-*/
-const BUG_FIXES = {
-	heading: "Bug Fixes",
-	priority: 3,
-	commitTypes: ["fix"],
-	description: "Bug corrections"
-};
-/**
-* Performance -- performance improvements.
-*
-* @remarks
-* Priority 4. Maps from the `perf` conventional commit type.
-*
-* @internal
-*/
-const PERFORMANCE = {
-	heading: "Performance",
-	priority: 4,
-	commitTypes: ["perf"],
-	description: "Performance improvements"
-};
-/**
-* Documentation -- documentation changes.
-*
-* @remarks
-* Priority 5. Maps from the `docs` conventional commit type.
-*
-* @internal
-*/
-const DOCUMENTATION = {
-	heading: "Documentation",
-	priority: 5,
-	commitTypes: ["docs"],
-	description: "Documentation changes"
-};
-/**
-* Refactoring -- code restructuring without behavior change.
-*
-* @remarks
-* Priority 6. Maps from the `refactor` conventional commit type.
-*
-* @internal
-*/
-const REFACTORING = {
-	heading: "Refactoring",
-	priority: 6,
-	commitTypes: ["refactor"],
-	description: "Code restructuring"
-};
-/**
-* Tests -- test additions or modifications.
-*
-* @remarks
-* Priority 7. Maps from the `test` conventional commit type.
-*
-* @internal
-*/
-const TESTS = {
-	heading: "Tests",
-	priority: 7,
-	commitTypes: ["test"],
-	description: "Test additions or modifications"
-};
-/**
-* Build System -- build configuration changes.
-*
-* @remarks
-* Priority 8. Maps from the `build` conventional commit type.
-*
-* @internal
-*/
-const BUILD_SYSTEM = {
-	heading: "Build System",
-	priority: 8,
-	commitTypes: ["build"],
-	description: "Build configuration changes"
-};
-/**
-* CI -- continuous integration changes.
-*
-* @remarks
-* Priority 9. Maps from the `ci` conventional commit type.
-*
-* @internal
-*/
-const CI = {
-	heading: "CI",
-	priority: 9,
-	commitTypes: ["ci"],
-	description: "Continuous integration changes"
-};
-/**
-* Dependencies -- dependency updates.
-*
-* @remarks
-* Priority 10. Maps from the `deps` conventional commit type and also
-* from `chore(deps)` via the {@link resolveCommitType} function.
-*
-* @internal
-*/
-const DEPENDENCIES = {
-	heading: "Dependencies",
-	priority: 10,
-	commitTypes: ["deps"],
-	description: "Dependency updates"
-};
-/**
-* Maintenance -- general maintenance tasks.
-*
-* @remarks
-* Priority 11. Maps from the `chore` and `style` conventional commit types.
-* Note that `chore(deps)` is redirected to {@link DEPENDENCIES} by
-* {@link resolveCommitType}.
-*
-* @internal
-*/
-const MAINTENANCE = {
-	heading: "Maintenance",
-	priority: 11,
-	commitTypes: ["chore", "style"],
-	description: "General maintenance"
-};
-/**
-* Reverts -- reverted changes.
-*
-* @remarks
-* Priority 12. Maps from the `revert` conventional commit type.
-*
-* @internal
-*/
-const REVERTS = {
-	heading: "Reverts",
-	priority: 12,
-	commitTypes: ["revert"],
-	description: "Reverted changes"
-};
-/**
-* Other -- uncategorized changes.
-*
-* @remarks
-* Priority 13 (lowest). This category has no associated commit types;
-* it serves as the fallback for any commit type not recognized by the
-* category system. Resolved by {@link resolveCommitType} when no other
-* category matches.
-*
-* @internal
-*/
-const OTHER = {
-	heading: "Other",
-	priority: 13,
-	commitTypes: [],
-	description: "Uncategorized changes"
-};
-/**
-* All 13 categories ordered by priority (ascending).
-*
-* @remarks
-* This array provides the canonical ordering for section headings in
-* CHANGELOG output. Breaking Changes appear first, Other appears last.
-* The array is frozen (`as const`) to prevent accidental mutation.
-*
-* @internal
-*/
-const CATEGORIES = [
-	BREAKING_CHANGES,
-	FEATURES,
-	BUG_FIXES,
-	PERFORMANCE,
-	DOCUMENTATION,
-	REFACTORING,
-	TESTS,
-	BUILD_SYSTEM,
-	CI,
-	DEPENDENCIES,
-	MAINTENANCE,
-	REVERTS,
-	OTHER
-];
-/**
-* Set of all valid section heading strings (case-insensitive lookup).
-* Used by Layer 1 (remark-lint) to validate changeset headings.
-*/
-const headingToCategory = new Map(CATEGORIES.map((cat) => [cat.heading.toLowerCase(), cat]));
-/**
-* Map from commit type string to its category.
-* Handles standard commit types. For `chore(deps)` and breaking `!` suffix,
-* use {@link resolveCommitType} instead.
-*/
-const commitTypeToCategory = /* @__PURE__ */ new Map();
-for (const cat of CATEGORIES) for (const commitType of cat.commitTypes) commitTypeToCategory.set(commitType, cat);
-/**
-* Resolve a conventional commit type (with optional scope and `!` suffix) to a category.
-*
-* @remarks
-* This function implements the full commit-type-to-category mapping logic,
-* including special cases:
-* - Any commit with `breaking: true` maps to {@link BREAKING_CHANGES}
-* - `chore` with scope `deps` maps to {@link DEPENDENCIES} (not Maintenance)
-* - Unrecognized types fall through to {@link OTHER}
-*
-* @param type - The commit type (e.g., `"feat"`, `"fix"`, `"chore"`)
-* @param scope - Optional scope (e.g., `"deps"` in `chore(deps):`)
-* @param breaking - Whether the commit has a `!` suffix indicating a breaking change
-* @returns The resolved section category
-*
-* @internal
-*/
-function resolveCommitType(type, scope, breaking) {
-	if (breaking) return BREAKING_CHANGES;
-	if (type === "chore" && scope === "deps") return DEPENDENCIES;
-	return commitTypeToCategory.get(type) ?? OTHER;
-}
-/**
-* Look up a category by its section heading text.
-*
-* @remarks
-* Comparison is case-insensitive: `"features"`, `"Features"`, and
-* `"FEATURES"` all match the Features category.
-*
-* @param heading - The heading text (e.g., `"Features"`, `"Bug Fixes"`)
-* @returns The matching category, or `undefined` if not recognized
-*
-* @internal
-*/
-function fromHeading(heading) {
-	return headingToCategory.get(heading.toLowerCase());
-}
-/**
-* Check whether a heading string matches a known category.
-*
-* @remarks
-* Comparison is case-insensitive. Useful for validating that a markdown
-* heading in a changeset file corresponds to a recognized section.
-*
-* @param heading - The heading text to check
-* @returns `true` if the heading matches a known category
-*
-* @internal
-*/
-function isValidHeading(heading) {
-	return headingToCategory.has(heading.toLowerCase());
-}
-/**
-* Get all valid section heading strings.
-*
-* @remarks
-* Returns the headings in priority order, matching the order of {@link CATEGORIES}.
-* Useful for generating help text or validation error messages that list
-* accepted headings.
-*
-* @returns Array of heading strings (e.g., `["Breaking Changes", "Features", ...]`)
-*
-* @internal
-*/
-function allHeadings() {
-	return CATEGORIES.map((cat) => cat.heading);
-}
-
-//#endregion
-export { BREAKING_CHANGES, BUG_FIXES, BUILD_SYSTEM, CATEGORIES, CI, DEPENDENCIES, DOCUMENTATION, FEATURES, MAINTENANCE, OTHER, PERFORMANCE, REFACTORING, REVERTS, TESTS, allHeadings, fromHeading, isValidHeading, resolveCommitType };

package/packages/silk-effects/dist/dev/pkg/changesets/categories/types.cjs

@@ -1,65 +0,0 @@
-let effect = require("effect");
-
-//#region ../silk-effects/dist/dev/pkg/changesets/categories/types.js
-/**
-* Section category schema and type definitions.
-*
-* @remarks
-* Section categories define how changes are grouped and ordered in release
-* notes and CHANGELOGs. Each category maps conventional commit types to a
-* display heading with a priority for ordering. Categories are used across
-* all three processing layers: remark-lint pre-validation (Layer 1),
-* changelog formatting (Layer 2), and remark-transform post-processing
-* (Layer 3).
-*
-* @see {@link CATEGORIES} for the predefined list of 13 section categories
-* @see {@link resolveCommitType} for mapping commit types to categories
-* @see {@link https://effect.website/docs/schema/introduction | Effect Schema documentation}
-*
-*/
-/**
-* Schema for a section category that defines how changes are grouped in release notes.
-*
-* @remarks
-* A section category has four fields:
-* - `heading` -- the display heading used in CHANGELOG output (e.g., `"Features"`, `"Bug Fixes"`)
-* - `priority` -- an integer controlling display order (lower = higher priority)
-* - `commitTypes` -- conventional commit type prefixes that map to this category (e.g., `["feat"]`)
-* - `description` -- a brief human-readable description for documentation
-*
-* Categories with an empty `commitTypes` array are resolved through other means:
-* `BREAKING_CHANGES` is resolved via the `!` suffix on any commit type, and
-* `OTHER` is the fallback for unrecognized types.
-*
-* @example
-* ```typescript
-* import { Schema } from "effect";
-* import { SectionCategorySchema } from "@savvy-web/changesets";
-* import type { SectionCategory } from "@savvy-web/changesets";
-*
-* const category: SectionCategory = Schema.decodeUnknownSync(SectionCategorySchema)({
-* 	heading: "Features",
-* 	priority: 2,
-* 	commitTypes: ["feat"],
-* 	description: "New functionality",
-* });
-* ```
-*
-* @see {@link SectionCategory} for the inferred TypeScript type
-* @see {@link CATEGORIES} for all predefined categories
-*
-* @public
-*/
-const SectionCategorySchema = effect.Schema.Struct({
-	/** Display heading used in CHANGELOG output. */
-	heading: effect.Schema.String,
-	/** Priority for ordering (lower = higher priority). */
-	priority: effect.Schema.Number,
-	/** Conventional commit types that map to this category. */
-	commitTypes: effect.Schema.Array(effect.Schema.String),
-	/** Brief description for documentation. */
-	description: effect.Schema.String
-});
-
-//#endregion
-exports.SectionCategorySchema = SectionCategorySchema;