@ankhorage/color-theory 0.0.3 → 0.0.5

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @ankhorage/color-theory
 
+## 0.0.5
+
+### Patch Changes
+
+- bdb341f: Update docs
+- Update Docs
+
+## 0.0.4
+
+### Patch Changes
+
+- c15063e: Add semantic status color seeds and deterministic status swatch generation helpers.
+
 ## 0.0.3
 
 ### Patch Changes

package/README.md

@@ -1,3 +1,86 @@
+<!-- markdownlint-disable MD013 MD033 -->
+<!-- This file is generated by Paradox. Do not edit manually. -->
+
 # @ankhorage/color-theory
 
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.0.4](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+
 Standalone color theory, harmony, swatch, contrast, and theme color generation utilities.
+
+## Generated documentation
+
+- [Interactive documentation app](././paradox/index.html)
+- [Public API reference](././paradox/exports.md)
+- [Component registry](././paradox/components.md)
+- [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
+- [Module relationships](././paradox/diagrams/module-relationships.mmd)
+- [Export graph](././paradox/diagrams/export-graph.mmd)
+- [assertHexColor sequence](././paradox/diagrams/sequences/assert-hex-color.mmd)
+- [getReadableForeground sequence](././paradox/diagrams/sequences/get-readable-foreground.mmd)
+- [getThemeModePrimaryHex sequence](././paradox/diagrams/sequences/get-theme-mode-primary-hex.mmd)
+- [parseHexColorOrThrow sequence](././paradox/diagrams/sequences/parse-hex-color-or-throw.mmd)
+
+## Architecture preview
+
+<details>
+<summary>Architecture overview</summary>
+
+```mermaid
+graph TD
+  package__ankhorage_color_theory["@ankhorage/color-theory"]
+  entrypoint_src_index_ts["src/index.ts"]
+  package__ankhorage_color_theory --> entrypoint_src_index_ts
+  module_src_contrast_ts["src/contrast.ts"]
+  package__ankhorage_color_theory -.-> module_src_contrast_ts
+  module_src_contrast_ts --> module_src_hex_ts
+  module_src_contrast_ts --> module_src_internal_culori_ts
+  module_src_culori_fn_ts["src/culori-fn.ts"]
+  package__ankhorage_color_theory -.-> module_src_culori_fn_ts
+  module_src_culori_ts["src/culori.ts"]
+  package__ankhorage_color_theory -.-> module_src_culori_ts
+  module_src_harmony_ts["src/harmony.ts"]
+  package__ankhorage_color_theory -.-> module_src_harmony_ts
+  module_src_harmony_ts --> module_src_hex_ts
+  module_src_harmony_ts --> module_src_internal_culori_ts
+  module_src_hex_ts["src/hex.ts"]
+  package__ankhorage_color_theory -.-> module_src_hex_ts
+  module_src_index_ts["src/index.ts"]
+  module_src_internal_culori_ts["src/internal-culori.ts"]
+  package__ankhorage_color_theory -.-> module_src_internal_culori_ts
+  module_src_internal_culori_ts --> module_src_hex_ts
+  module_src_neutral_ts["src/neutral.ts"]
+  package__ankhorage_color_theory -.-> module_src_neutral_ts
+  module_src_neutral_ts --> module_src_harmony_ts
+  module_src_neutral_ts --> module_src_hex_ts
+  module_src_neutral_ts --> module_src_internal_culori_ts
+  module_src_neutral_ts --> module_src_swatches_ts
+  module_src_semantic_status_ts["src/semantic-status.ts"]
+  package__ankhorage_color_theory -.-> module_src_semantic_status_ts
+  module_src_semantic_status_ts --> module_src_hex_ts
+  module_src_semantic_status_ts --> module_src_swatches_ts
+  module_src_semantics_ts["src/semantics.ts"]
+  package__ankhorage_color_theory -.-> module_src_semantics_ts
+  module_src_semantics_ts --> module_src_harmony_ts
+  module_src_semantics_ts --> module_src_swatches_ts
+  module_src_swatches_ts["src/swatches.ts"]
+  package__ankhorage_color_theory -.-> module_src_swatches_ts
+  module_src_swatches_ts --> module_src_hex_ts
+  module_src_swatches_ts --> module_src_internal_culori_ts
+  module_src_theme_colors_ts["src/theme-colors.ts"]
+  package__ankhorage_color_theory -.-> module_src_theme_colors_ts
+  module_src_theme_colors_ts --> module_src_harmony_ts
+  module_src_theme_colors_ts --> module_src_hex_ts
+  module_src_theme_colors_ts --> module_src_neutral_ts
+  module_src_theme_colors_ts --> module_src_swatches_ts
+```
+
+</details>
+
+## Path resolution
+
+- Config discovery: searches upward from `process.cwd()` for `paradox.config.ts/js/mjs/cjs` (required; no fallback).
+- Package root: defaults to the directory containing `paradox.config.*`; `package.root` (when relative) resolves relative to that directory.
+- Output directory: defaults to `paradox/`; `output.dir` (when relative) resolves relative to the resolved package root and must stay inside it.
+- Modes:
+  - `safe`: writes generated artifacts only under the output directory
+  - `write`: additionally updates `<packageRoot>/README.md`

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './contrast';
 export * from './harmony';
 export * from './hex';
 export * from './neutral';
+export * from './semantic-status';
 export * from './semantics';
 export * from './swatches';
 export * from './theme-colors';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@ export * from './contrast';
 export * from './harmony';
 export * from './hex';
 export * from './neutral';
+export * from './semantic-status';
 export * from './semantics';
 export * from './swatches';
 export * from './theme-colors';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC","sourcesContent":["export * from './contrast';\nexport * from './harmony';\nexport * from './hex';\nexport * from './neutral';\nexport * from './semantics';\nexport * from './swatches';\nexport * from './theme-colors';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC","sourcesContent":["export * from './contrast';\nexport * from './harmony';\nexport * from './hex';\nexport * from './neutral';\nexport * from './semantic-status';\nexport * from './semantics';\nexport * from './swatches';\nexport * from './theme-colors';\n"]}

package/dist/semantic-status.d.ts

@@ -0,0 +1,17 @@
+import type { HexColor } from './hex';
+import type { ColorSwatch, ColorSwatchDiagnostics } from './swatches';
+export declare const DEFAULT_SEMANTIC_STATUS_COLOR_SEEDS: {
+    readonly danger: "#ef4444";
+    readonly success: "#22c55e";
+    readonly warning: "#f59e0b";
+};
+export type DefaultSemanticStatusRole = keyof typeof DEFAULT_SEMANTIC_STATUS_COLOR_SEEDS;
+export type SemanticStatusSeedInput = string | HexColor;
+export interface SemanticStatusSwatches<Role extends string> {
+    seeds: Record<Role, HexColor>;
+    swatches: Record<Role, ColorSwatch>;
+    diagnostics: Record<Role, ColorSwatchDiagnostics>;
+}
+export declare function createSemanticStatusSwatches<Role extends string>(seeds: Record<Role, SemanticStatusSeedInput>): SemanticStatusSwatches<Role>;
+export declare function createDefaultSemanticStatusSwatches(): SemanticStatusSwatches<DefaultSemanticStatusRole>;
+//# sourceMappingURL=semantic-status.d.ts.map

package/dist/semantic-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-status.d.ts","sourceRoot":"","sources":["../src/semantic-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGtE,eAAO,MAAM,mCAAmC;;;;CAIL,CAAC;AAE5C,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,mCAAmC,CAAC;AAEzF,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,sBAAsB,CAAC,IAAI,SAAS,MAAM;IACzD,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;CACnD;AAED,wBAAgB,4BAA4B,CAAC,IAAI,SAAS,MAAM,EAC9D,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,uBAAuB,CAAC,GAC3C,sBAAsB,CAAC,IAAI,CAAC,CAkB9B;AAED,wBAAgB,mCAAmC,IAAI,sBAAsB,CAAC,yBAAyB,CAAC,CAEvG"}

package/dist/semantic-status.js

@@ -0,0 +1,26 @@
+import { parseHexColorOrThrow } from './hex';
+import { generateColorSwatch } from './swatches';
+export const DEFAULT_SEMANTIC_STATUS_COLOR_SEEDS = {
+    danger: '#ef4444',
+    success: '#22c55e',
+    warning: '#f59e0b',
+};
+export function createSemanticStatusSwatches(seeds) {
+    const roles = Object.keys(seeds);
+    const normalizedSeeds = {};
+    const swatches = {};
+    const diagnostics = {};
+    for (const role of roles) {
+        const seed = seeds[role];
+        const seedHex = typeof seed === 'string' ? parseHexColorOrThrow(seed) : seed;
+        normalizedSeeds[role] = seedHex;
+        const generated = generateColorSwatch(seedHex);
+        swatches[role] = generated.swatch;
+        diagnostics[role] = generated.diagnostics;
+    }
+    return { seeds: normalizedSeeds, swatches, diagnostics };
+}
+export function createDefaultSemanticStatusSwatches() {
+    return createSemanticStatusSwatches(DEFAULT_SEMANTIC_STATUS_COLOR_SEEDS);
+}
+//# sourceMappingURL=semantic-status.js.map

package/dist/semantic-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-status.js","sourceRoot":"","sources":["../src/semantic-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACuB,CAAC;AAY5C,MAAM,UAAU,4BAA4B,CAC1C,KAA4C;IAE5C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAW,CAAC;IAE3C,MAAM,eAAe,GAAG,EAA4B,CAAC;IACrD,MAAM,QAAQ,GAAG,EAA+B,CAAC;IACjD,MAAM,WAAW,GAAG,EAA0C,CAAC;IAE/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7E,eAAe,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QAEhC,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO,4BAA4B,CAAC,mCAAmC,CAAC,CAAC;AAC3E,CAAC","sourcesContent":["import type { HexColor } from './hex';\nimport { parseHexColorOrThrow } from './hex';\nimport type { ColorSwatch, ColorSwatchDiagnostics } from './swatches';\nimport { generateColorSwatch } from './swatches';\n\nexport const DEFAULT_SEMANTIC_STATUS_COLOR_SEEDS = {\n  danger: '#ef4444',\n  success: '#22c55e',\n  warning: '#f59e0b',\n} as const satisfies Record<string, string>;\n\nexport type DefaultSemanticStatusRole = keyof typeof DEFAULT_SEMANTIC_STATUS_COLOR_SEEDS;\n\nexport type SemanticStatusSeedInput = string | HexColor;\n\nexport interface SemanticStatusSwatches<Role extends string> {\n  seeds: Record<Role, HexColor>;\n  swatches: Record<Role, ColorSwatch>;\n  diagnostics: Record<Role, ColorSwatchDiagnostics>;\n}\n\nexport function createSemanticStatusSwatches<Role extends string>(\n  seeds: Record<Role, SemanticStatusSeedInput>,\n): SemanticStatusSwatches<Role> {\n  const roles = Object.keys(seeds) as Role[];\n\n  const normalizedSeeds = {} as Record<Role, HexColor>;\n  const swatches = {} as Record<Role, ColorSwatch>;\n  const diagnostics = {} as Record<Role, ColorSwatchDiagnostics>;\n\n  for (const role of roles) {\n    const seed = seeds[role];\n    const seedHex = typeof seed === 'string' ? parseHexColorOrThrow(seed) : seed;\n    normalizedSeeds[role] = seedHex;\n\n    const generated = generateColorSwatch(seedHex);\n    swatches[role] = generated.swatch;\n    diagnostics[role] = generated.diagnostics;\n  }\n\n  return { seeds: normalizedSeeds, swatches, diagnostics };\n}\n\nexport function createDefaultSemanticStatusSwatches(): SemanticStatusSwatches<DefaultSemanticStatusRole> {\n  return createSemanticStatusSwatches(DEFAULT_SEMANTIC_STATUS_COLOR_SEEDS);\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/color-theory",
   "type": "module",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Standalone color theory, harmony, swatch, contrast, and theme color generation utilities.",
   "homepage": "https://github.com/ankhorage/color-theory#readme",
   "bugs": {
@@ -61,24 +61,24 @@
     "build": "rm -rf dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.json",
     "changeset": "changeset",
     "changeset:status": "changeset status --since=origin/main",
-    "knip": "knip",
-    "lint": "eslint . --max-warnings=0",
-    "lint:fix": "eslint . --fix --max-warnings=0",
-    "format": "prettier --write .",
-    "paradox": "bunx @ankhorage/paradox",
+    "knip": "ankhorage-knip",
+    "lint": "ankhorage-eslint . --max-warnings=0",
+    "lint:fix": "ankhorage-eslint . --fix --max-warnings=0",
+    "format": "ankhorage-prettier --write .",
+    "format:check": "ankhorage-prettier --check .",
+    "docs": "paradox",
     "prepack": "bun run build",
     "test": "bun test src",
     "typecheck": "bun x tsc --noEmit -p tsconfig.json",
     "version-packages": "changeset version"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^1.0.1",
-    "@ankhorage/paradox": "^0.0.3",
+    "@ankhorage/devtools": "^1.0.5",
+    "@ankhorage/paradox": "^0.1.5",
     "@changesets/cli": "^2.31.0",
     "@types/bun": "^1.3.13",
     "@types/culori": "^4.0.1",
     "@types/node": "^25.6.0",
-    "knip": "^5.88.1",
     "typescript": "^5.9.3"
   },
   "packageManager": "bun@1.3.13"