@ankhorage/contracts 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/contracts
 
+## 0.3.0
+
+### Minor Changes
+
+- 9e27c89: Add app category theme recommendation contracts and a partial category recommendation map for theme tooling.
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -22,7 +22,13 @@ Shared public contracts for Ankhorage packages and standalone provider packages.
 ```ts
 import type { AppManifest } from '@ankhorage/contracts';
 import type { AuthAdapter } from '@ankhorage/contracts/auth';
-import type { AppMood, ColorHarmony, ColorTone } from '@ankhorage/contracts/color-theory';
+import type {
+  AppCategoryThemeRecommendation,
+  AppMood,
+  ColorHarmony,
+  ColorTone,
+} from '@ankhorage/contracts/color-theory';
+import { APP_CATEGORY_THEME_RECOMMENDATIONS } from '@ankhorage/contracts/color-theory';
 import type { DbAdapter } from '@ankhorage/contracts/db';
 ```
 
@@ -34,6 +40,17 @@ import type { DbAdapter } from '@ankhorage/contracts/db';
 
 `ColorHarmony` describes hue relationships.
 
+Category-aware theme recommendations can suggest an app mood, color tone,
+harmony, and optional primary hue without moving UI color-generation logic into
+Contracts:
+
+```ts
+const financeThemeRecommendation = APP_CATEGORY_THEME_RECOMMENDATIONS.finance_money;
+```
+
+These recommendation contracts are serializable handoff data for tooling. OKLCH,
+chroma, and semantic-token generation stay in UI/theme packages.
+
 Provider packages can implement the shared contracts without importing runtime,
 CLI, ZORA, Expo Router, or app-generation logic.
 

package/dist/color-theory.d.ts

@@ -1,3 +1,4 @@
+import type { AppCategory } from './types';
 export declare const COLOR_HARMONIES: readonly ["monochromatic", "analogous", "complementary", "triadic", "tetradic", "splitComplementary"];
 export type ColorHarmony = (typeof COLOR_HARMONIES)[number];
 export declare const COLOR_TONES: readonly ["neutral", "pastel", "earth", "mineral", "muted", "jewel", "fluorescent", "obsidian", "vaporwave", "monochromeAccent"];
@@ -14,4 +15,44 @@ export interface ColorThemeRecommendation {
     suggestedHarmony: ColorHarmony;
     suggestedPrimaryHueDegrees?: number;
 }
+export interface AppCategoryThemeRecommendation extends ColorThemeRecommendation {
+    appCategory: AppCategory;
+}
+export declare const APP_CATEGORY_THEME_RECOMMENDATIONS: {
+    readonly finance_money: {
+        readonly appCategory: "finance_money";
+        readonly appMood: "trustworthy";
+        readonly suggestedColorTone: "mineral";
+        readonly suggestedHarmony: "analogous";
+        readonly suggestedPrimaryHueDegrees: 195;
+    };
+    readonly health_fitness: {
+        readonly appCategory: "health_fitness";
+        readonly appMood: "calm";
+        readonly suggestedColorTone: "pastel";
+        readonly suggestedHarmony: "analogous";
+        readonly suggestedPrimaryHueDegrees: 155;
+    };
+    readonly developer_tools: {
+        readonly appCategory: "developer_tools";
+        readonly appMood: "focused";
+        readonly suggestedColorTone: "obsidian";
+        readonly suggestedHarmony: "analogous";
+        readonly suggestedPrimaryHueDegrees: 220;
+    };
+    readonly graphics_design: {
+        readonly appCategory: "graphics_design";
+        readonly appMood: "creative";
+        readonly suggestedColorTone: "vaporwave";
+        readonly suggestedHarmony: "splitComplementary";
+        readonly suggestedPrimaryHueDegrees: 305;
+    };
+    readonly social_community: {
+        readonly appCategory: "social_community";
+        readonly appMood: "friendly";
+        readonly suggestedColorTone: "jewel";
+        readonly suggestedHarmony: "triadic";
+        readonly suggestedPrimaryHueDegrees: 265;
+    };
+};
 //# sourceMappingURL=color-theory.d.ts.map

package/dist/color-theory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-theory.d.ts","sourceRoot":"","sources":["../src/color-theory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,uGAOlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,WAAW,kIAWd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,SAAS,gIAWZ,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,SAAS,CAAC;IAC1B,cAAc,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,SAAS,CAAC;IAC9B,gBAAgB,EAAE,YAAY,CAAC;IAC/B,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC"}
+{"version":3,"file":"color-theory.d.ts","sourceRoot":"","sources":["../src/color-theory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,eAAe,uGAOlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,WAAW,kIAWd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,SAAS,gIAWZ,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,SAAS,CAAC;IAC1B,cAAc,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,SAAS,CAAC;IAC9B,gBAAgB,EAAE,YAAY,CAAC;IAC/B,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;IAC9E,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCkC,CAAC"}

package/dist/color-theory.js

@@ -30,4 +30,41 @@ export const APP_MOODS = [
     'friendly',
     'technical',
 ];
+export const APP_CATEGORY_THEME_RECOMMENDATIONS = {
+    finance_money: {
+        appCategory: 'finance_money',
+        appMood: 'trustworthy',
+        suggestedColorTone: 'mineral',
+        suggestedHarmony: 'analogous',
+        suggestedPrimaryHueDegrees: 195,
+    },
+    health_fitness: {
+        appCategory: 'health_fitness',
+        appMood: 'calm',
+        suggestedColorTone: 'pastel',
+        suggestedHarmony: 'analogous',
+        suggestedPrimaryHueDegrees: 155,
+    },
+    developer_tools: {
+        appCategory: 'developer_tools',
+        appMood: 'focused',
+        suggestedColorTone: 'obsidian',
+        suggestedHarmony: 'analogous',
+        suggestedPrimaryHueDegrees: 220,
+    },
+    graphics_design: {
+        appCategory: 'graphics_design',
+        appMood: 'creative',
+        suggestedColorTone: 'vaporwave',
+        suggestedHarmony: 'splitComplementary',
+        suggestedPrimaryHueDegrees: 305,
+    },
+    social_community: {
+        appCategory: 'social_community',
+        appMood: 'friendly',
+        suggestedColorTone: 'jewel',
+        suggestedHarmony: 'triadic',
+        suggestedPrimaryHueDegrees: 265,
+    },
+};
 //# sourceMappingURL=color-theory.js.map

package/dist/color-theory.js.map

@@ -1 +1 @@
-{"version":3,"file":"color-theory.js","sourceRoot":"","sources":["../src/color-theory.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe;IACf,WAAW;IACX,eAAe;IACf,SAAS;IACT,UAAU;IACV,oBAAoB;CACZ,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,QAAQ;IACR,OAAO;IACP,SAAS;IACT,OAAO;IACP,OAAO;IACP,aAAa;IACb,UAAU;IACV,WAAW;IACX,kBAAkB;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,aAAa;IACb,MAAM;IACN,SAAS;IACT,SAAS;IACT,SAAS;IACT,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;IACV,WAAW;CACH,CAAC","sourcesContent":["export const COLOR_HARMONIES = [\n  'monochromatic',\n  'analogous',\n  'complementary',\n  'triadic',\n  'tetradic',\n  'splitComplementary',\n] as const;\n\nexport type ColorHarmony = (typeof COLOR_HARMONIES)[number];\n\nexport const COLOR_TONES = [\n  'neutral',\n  'pastel',\n  'earth',\n  'mineral',\n  'muted',\n  'jewel',\n  'fluorescent',\n  'obsidian',\n  'vaporwave',\n  'monochromeAccent',\n] as const;\n\nexport type ColorTone = (typeof COLOR_TONES)[number];\n\nexport const APP_MOODS = [\n  'trustworthy',\n  'calm',\n  'focused',\n  'playful',\n  'premium',\n  'energetic',\n  'serious',\n  'creative',\n  'friendly',\n  'technical',\n] as const;\n\nexport type AppMood = (typeof APP_MOODS)[number];\n\nexport interface ColorToneLaneRecipe {\n  backgroundTone: ColorTone;\n  foregroundTone: ColorTone;\n}\n\nexport interface ColorThemeRecommendation {\n  appMood: AppMood;\n  suggestedColorTone: ColorTone;\n  suggestedHarmony: ColorHarmony;\n  suggestedPrimaryHueDegrees?: number;\n}\n"]}
+{"version":3,"file":"color-theory.js","sourceRoot":"","sources":["../src/color-theory.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe;IACf,WAAW;IACX,eAAe;IACf,SAAS;IACT,UAAU;IACV,oBAAoB;CACZ,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,QAAQ;IACR,OAAO;IACP,SAAS;IACT,OAAO;IACP,OAAO;IACP,aAAa;IACb,UAAU;IACV,WAAW;IACX,kBAAkB;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,aAAa;IACb,MAAM;IACN,SAAS;IACT,SAAS;IACT,SAAS;IACT,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;IACV,WAAW;CACH,CAAC;AAoBX,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,aAAa,EAAE;QACb,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,aAAa;QACtB,kBAAkB,EAAE,SAAS;QAC7B,gBAAgB,EAAE,WAAW;QAC7B,0BAA0B,EAAE,GAAG;KAChC;IACD,cAAc,EAAE;QACd,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,MAAM;QACf,kBAAkB,EAAE,QAAQ;QAC5B,gBAAgB,EAAE,WAAW;QAC7B,0BAA0B,EAAE,GAAG;KAChC;IACD,eAAe,EAAE;QACf,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,SAAS;QAClB,kBAAkB,EAAE,UAAU;QAC9B,gBAAgB,EAAE,WAAW;QAC7B,0BAA0B,EAAE,GAAG;KAChC;IACD,eAAe,EAAE;QACf,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,UAAU;QACnB,kBAAkB,EAAE,WAAW;QAC/B,gBAAgB,EAAE,oBAAoB;QACtC,0BAA0B,EAAE,GAAG;KAChC;IACD,gBAAgB,EAAE;QAChB,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,UAAU;QACnB,kBAAkB,EAAE,OAAO;QAC3B,gBAAgB,EAAE,SAAS;QAC3B,0BAA0B,EAAE,GAAG;KAChC;CAC8E,CAAC","sourcesContent":["import type { AppCategory } from './types';\n\nexport const COLOR_HARMONIES = [\n  'monochromatic',\n  'analogous',\n  'complementary',\n  'triadic',\n  'tetradic',\n  'splitComplementary',\n] as const;\n\nexport type ColorHarmony = (typeof COLOR_HARMONIES)[number];\n\nexport const COLOR_TONES = [\n  'neutral',\n  'pastel',\n  'earth',\n  'mineral',\n  'muted',\n  'jewel',\n  'fluorescent',\n  'obsidian',\n  'vaporwave',\n  'monochromeAccent',\n] as const;\n\nexport type ColorTone = (typeof COLOR_TONES)[number];\n\nexport const APP_MOODS = [\n  'trustworthy',\n  'calm',\n  'focused',\n  'playful',\n  'premium',\n  'energetic',\n  'serious',\n  'creative',\n  'friendly',\n  'technical',\n] as const;\n\nexport type AppMood = (typeof APP_MOODS)[number];\n\nexport interface ColorToneLaneRecipe {\n  backgroundTone: ColorTone;\n  foregroundTone: ColorTone;\n}\n\nexport interface ColorThemeRecommendation {\n  appMood: AppMood;\n  suggestedColorTone: ColorTone;\n  suggestedHarmony: ColorHarmony;\n  suggestedPrimaryHueDegrees?: number;\n}\n\nexport interface AppCategoryThemeRecommendation extends ColorThemeRecommendation {\n  appCategory: AppCategory;\n}\n\nexport const APP_CATEGORY_THEME_RECOMMENDATIONS = {\n  finance_money: {\n    appCategory: 'finance_money',\n    appMood: 'trustworthy',\n    suggestedColorTone: 'mineral',\n    suggestedHarmony: 'analogous',\n    suggestedPrimaryHueDegrees: 195,\n  },\n  health_fitness: {\n    appCategory: 'health_fitness',\n    appMood: 'calm',\n    suggestedColorTone: 'pastel',\n    suggestedHarmony: 'analogous',\n    suggestedPrimaryHueDegrees: 155,\n  },\n  developer_tools: {\n    appCategory: 'developer_tools',\n    appMood: 'focused',\n    suggestedColorTone: 'obsidian',\n    suggestedHarmony: 'analogous',\n    suggestedPrimaryHueDegrees: 220,\n  },\n  graphics_design: {\n    appCategory: 'graphics_design',\n    appMood: 'creative',\n    suggestedColorTone: 'vaporwave',\n    suggestedHarmony: 'splitComplementary',\n    suggestedPrimaryHueDegrees: 305,\n  },\n  social_community: {\n    appCategory: 'social_community',\n    appMood: 'friendly',\n    suggestedColorTone: 'jewel',\n    suggestedHarmony: 'triadic',\n    suggestedPrimaryHueDegrees: 265,\n  },\n} as const satisfies Partial<Record<AppCategory, AppCategoryThemeRecommendation>>;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "main": "./dist/index.js",
   "devDependencies": {
     "@ankhorage/devtools": "^1.0.0",

package/src/color-theory.ts

@@ -1,3 +1,5 @@
+import type { AppCategory } from './types';
+
 export const COLOR_HARMONIES = [
   'monochromatic',
   'analogous',
@@ -50,3 +52,45 @@ export interface ColorThemeRecommendation {
   suggestedHarmony: ColorHarmony;
   suggestedPrimaryHueDegrees?: number;
 }
+
+export interface AppCategoryThemeRecommendation extends ColorThemeRecommendation {
+  appCategory: AppCategory;
+}
+
+export const APP_CATEGORY_THEME_RECOMMENDATIONS = {
+  finance_money: {
+    appCategory: 'finance_money',
+    appMood: 'trustworthy',
+    suggestedColorTone: 'mineral',
+    suggestedHarmony: 'analogous',
+    suggestedPrimaryHueDegrees: 195,
+  },
+  health_fitness: {
+    appCategory: 'health_fitness',
+    appMood: 'calm',
+    suggestedColorTone: 'pastel',
+    suggestedHarmony: 'analogous',
+    suggestedPrimaryHueDegrees: 155,
+  },
+  developer_tools: {
+    appCategory: 'developer_tools',
+    appMood: 'focused',
+    suggestedColorTone: 'obsidian',
+    suggestedHarmony: 'analogous',
+    suggestedPrimaryHueDegrees: 220,
+  },
+  graphics_design: {
+    appCategory: 'graphics_design',
+    appMood: 'creative',
+    suggestedColorTone: 'vaporwave',
+    suggestedHarmony: 'splitComplementary',
+    suggestedPrimaryHueDegrees: 305,
+  },
+  social_community: {
+    appCategory: 'social_community',
+    appMood: 'friendly',
+    suggestedColorTone: 'jewel',
+    suggestedHarmony: 'triadic',
+    suggestedPrimaryHueDegrees: 265,
+  },
+} as const satisfies Partial<Record<AppCategory, AppCategoryThemeRecommendation>>;

package/src/contracts.test.ts

@@ -2,6 +2,8 @@ import { describe, expect, it } from 'bun:test';
 
 import {
   APP_CATEGORIES,
+  APP_CATEGORY_THEME_RECOMMENDATIONS,
+  APP_MOODS,
   type AppCategory,
   AUTH_PROVIDERS,
   AUTH_SIGN_IN_IDENTIFIERS,
@@ -9,6 +11,8 @@ import {
   type AuthAdapter,
   type AuthFlowConfig,
   type AuthSpec,
+  COLOR_HARMONIES,
+  COLOR_TONES,
   type DbAdapter,
   DEPLOYMENT_TARGETS,
   NAVIGATOR_TYPES,
@@ -73,6 +77,27 @@ describe('contracts', () => {
     expect(theme.dark.colorTone).toBe('neutral');
   });
 
+  it('exports app category theme recommendations with valid serialized values', () => {
+    const recommendations = Object.values(APP_CATEGORY_THEME_RECOMMENDATIONS);
+
+    expect(recommendations.length).toBeGreaterThan(0);
+
+    for (const recommendation of recommendations) {
+      expect(APP_CATEGORIES).toContain(recommendation.appCategory);
+      expect(APP_MOODS).toContain(recommendation.appMood);
+      expect(COLOR_TONES).toContain(recommendation.suggestedColorTone);
+      expect(COLOR_HARMONIES).toContain(recommendation.suggestedHarmony);
+    }
+  });
+
+  it('keeps app category theme recommendation hues in range', () => {
+    for (const recommendation of Object.values(APP_CATEGORY_THEME_RECOMMENDATIONS)) {
+      expect(Number.isFinite(recommendation.suggestedPrimaryHueDegrees)).toBe(true);
+      expect(recommendation.suggestedPrimaryHueDegrees).toBeGreaterThanOrEqual(0);
+      expect(recommendation.suggestedPrimaryHueDegrees).toBeLessThan(360);
+    }
+  });
+
   it('accepts canonical auth flow config without legacy route fields', () => {
     const authFlow: AuthFlowConfig = {
       signInRoute: '/sign-in',
@@ -147,20 +172,20 @@ describe('contracts', () => {
     const dbAdapter: DbAdapter = {
       async select() {
         await new Promise((resolve) => setTimeout(resolve, 1));
-        return { ok: true, data: [{ id: 'row-1' }] };
+        return { ok: true, data: [] };
       },
       async findById() {
         await new Promise((resolve) => setTimeout(resolve, 1));
-        return { ok: true, data: { id: 'row-1' } };
+        return { ok: true, data: null };
       },
       async insert(input) {
         const values = Array.isArray(input.values) ? input.values : [input.values];
         await new Promise((resolve) => setTimeout(resolve, 1));
         return { ok: true, data: values };
       },
-      async update(input) {
+      async update() {
         await new Promise((resolve) => setTimeout(resolve, 1));
-        return { ok: true, data: [input.values] };
+        return { ok: true, data: [] };
       },
       async delete() {
         await new Promise((resolve) => setTimeout(resolve, 1));