@ankhorage/color-theory 0.0.3 → 0.0.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/color-theory
 
+## 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,27 @@
 # @ankhorage/color-theory
 
 Standalone color theory, harmony, swatch, contrast, and theme color generation utilities.
+
+## Semantic status colors
+
+Generate deterministic swatches for semantic status roles like `danger`, `success`, and `warning`.
+
+```ts
+import { createDefaultSemanticStatusSwatches } from '@ankhorage/color-theory';
+
+const status = createDefaultSemanticStatusSwatches();
+status.seeds.danger; // "#ef4444"
+status.swatches.danger[500]; // "#ef4444"
+```
+
+Override defaults by passing your own seeds (throws on invalid hex input):
+
+```ts
+import { createSemanticStatusSwatches } from '@ankhorage/color-theory';
+
+const status = createSemanticStatusSwatches({
+  danger: '#ef4444',
+  success: '#22c55e',
+  warning: '#f59e0b',
+});
+```

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.4",
   "description": "Standalone color theory, harmony, swatch, contrast, and theme color generation utilities.",
   "homepage": "https://github.com/ankhorage/color-theory#readme",
   "bugs": {