@rafters/shared 0.5.4 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafters/shared",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "Shared W3C DTCG schemas, base types, and utilities for Rafters design system",
   "homepage": "https://rafters.studio",
   "license": "MIT",
@@ -24,11 +24,11 @@
   },
   "dependencies": {
     "comment-parser": "^1.4.1",
-    "zod": "^4.1.12"
+    "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@types/node": "24.10.0",
-    "typescript": "5.9.3",
+    "@types/node": "^24",
+    "typescript": "^7.0.2",
     "vitest": "^5.0.0",
     "zocker": "3.0.0"
   },

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from './component-intelligence';
 export * from './import-pending';
+export * from './studio-errors';
 export * from './types';
 export * from './version';

package/src/studio-errors.ts

@@ -0,0 +1,28 @@
+/**
+ * Studio error codes (#2876): every refusal from rafters studio's
+ * /__rafters/set and /__rafters/tokens names exactly one of these, so Studio
+ * and any agent writing through the endpoint can respond without parsing the
+ * message. The CLI README's Studio section gives each code's status, details
+ * and the response Studio should make.
+ */
+export const STUDIO_ERROR_CODES = [
+  'method-not-allowed',
+  'origin-refused',
+  'unsupported-media-type',
+  'body-not-json',
+  'body-invalid',
+  'reason-required',
+  'unknown-token',
+  'token-invalid',
+  'literal-color',
+  'name-rejected',
+  'name-taken',
+  'token-in-use',
+  'token-undeletable',
+  'circular-dependency',
+  'nothing-to-undo',
+  'color-out-of-gamut',
+  'internal',
+] as const;
+
+export type StudioErrorCode = (typeof STUDIO_ERROR_CODES)[number];

package/src/types.ts

@@ -464,6 +464,12 @@ export const ColorValueSchema = z.object({
       reason: z.enum(['lightness-bounds', 'gamut']),
     })
     .optional(),
+  // The lightness ladder a normalized scale was built on (createNormalizedScale);
+  // 'custom' when the caller supplied the ladder. Absent for buildColorValue.
+  scaleStyle: z.enum(['deep', 'compact', 'custom']).optional(),
+  // The scale position the source colour sits at, e.g. '200'. Absent for
+  // buildColorValue, whose seed always lands on '600'.
+  anchor: z.string().optional(),
 });
 
 export type ColorValue = z.infer<typeof ColorValueSchema>;

package/src/version.ts

@@ -4,4 +4,4 @@
  * Written by packages/cli/scripts/sync-version.ts from the CLI's own
  * package.json version at build time -- do not edit by hand.
  */
-export const RAFTERS_VERSION = '0.5.4';
+export const RAFTERS_VERSION = '0.6.0';