@ultimat3/schema 22.9.0 → 22.10.0

package/CLAUDE.md

@@ -20,7 +20,8 @@ provider → t`. `char-count.ts` is imported by BOTH `validators.ts` (which reje
 `describe-value.ts` (which renders the length in the same message), because they disagreed: the
 rule counted code points and the message counted UTF-16 units, so `t.string.min(3)` refused `'👍a'`
 with "at least 3 chars, received a string of 3 characters".
-`standard.ts` and `errors.ts` depend on nothing but each other. `iso-date.ts` imports nothing and
+`standard.ts` and `errors.ts` depend on nothing but each other and `error-codes.ts`, a leaf of
+plain data that core imports ALONE so a browser graph never keeps the `SchemaError` classes. `iso-date.ts` imports nothing and
 is imported by `validators.ts` and `coerce.ts` — the two doors a `t.date` string comes through, so
 the rule that a clock time must carry an offset or `Z` has one copy, not one per door.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/schema",
-  "version": "22.9.0",
+  "version": "22.10.0",
   "description": "Ultimate's validation seam: Standard Schema interface, the t namespace, JSON Schema output",
   "license": "MIT",
   "type": "module",

package/src/error-codes.ts

@@ -0,0 +1,29 @@
+// Single responsibility: the DECLARATIONS of this package's error codes, as data — no class.
+//
+// A leaf of its own, apart from `errors.ts`, because `@ultimat3/core` registers these at load
+// (`schema-error-codes.ts`) and core's error contract is in every browser bundle that holds a typed
+// client. Declared beside `SchemaError`, the codes dragged the class in with them: a class with a
+// computed member (`[ULTIMATE_ERROR_BRAND]`) is not removable by a bundler, so every island paid
+// for a server-side validation error it can never construct. Importing only this file keeps
+// `errors.ts` out of that graph.
+
+export interface SchemaErrorCodeDeclaration {
+  readonly title: string;
+  readonly docs?: string | undefined;
+}
+
+/**
+ * Pass to `registerErrorCodes()` from a package that may import both tiers (the CLI does this
+ * at boot) so the terminal and the dev overlay render these codes identically.
+ */
+export const SCHEMA_ERROR_CODES: Readonly<Record<string, SchemaErrorCodeDeclaration>> =
+  Object.freeze({
+    X_VALIDATION_FAILED: { title: 'value did not match its schema' },
+    X_SCHEMA_UNSUPPORTED: { title: 'the active schema provider cannot do this' },
+    X_SCHEMA_DISCRIMINANT_INVALID: {
+      title: 'a discriminated union member can never be dispatched to',
+    },
+    X_SCHEMA_DEFAULT_UNSHAREABLE: {
+      title: 'a schema default cannot be copied per parse',
+    },
+  });

package/src/errors.ts

@@ -2,6 +2,7 @@
 // import `@ultimat3/core`, so `SchemaError` reproduces the `UltimateError` shape structurally
 // and carries the same `Symbol.for('ultimate.error')` brand — `isUltimateError()` still matches.
 
+import { SCHEMA_ERROR_CODES } from './error-codes';
 import { formatIssues } from './standard';
 
 /**
@@ -48,30 +49,9 @@ export const ULTIMATE_ERROR_BRAND: unique symbol = Symbol.for('ultimate.error');
  */
 const ERROR_DOCS_URL = 'https://github.com/developerz-ai/ultimate/wiki/Error-Codes';
 
-export interface SchemaErrorCodeDeclaration {
-  readonly title: string;
-  readonly docs?: string | undefined;
-}
-
-/**
- * Pass to `registerErrorCodes()` from a package that may import both tiers (the CLI does this
- * at boot) so the terminal and the dev overlay render these codes identically.
- */
-export const SCHEMA_ERROR_CODES: Readonly<Record<string, SchemaErrorCodeDeclaration>> =
-  Object.freeze({
-    X_VALIDATION_FAILED: { title: 'value did not match its schema' },
-    X_SCHEMA_UNSUPPORTED: { title: 'the active schema provider cannot do this' },
-    X_SCHEMA_DISCRIMINANT_INVALID: {
-      title: 'a discriminated union member can never be dispatched to',
-    },
-    X_SCHEMA_DEFAULT_UNSHAREABLE: {
-      title: 'a schema default cannot be copied per parse',
-    },
-  });
-
 /**
- * Derived, never re-typed: the declarations above are the single source, so a title edited there
- * cannot fall out of step with what `SchemaError` renders locally.
+ * Derived, never re-typed: the declarations in `error-codes.ts` are the single source, so a title
+ * edited there cannot fall out of step with what `SchemaError` renders locally.
  */
 const TITLES: Readonly<Record<string, string>> = Object.freeze(
   Object.fromEntries(

package/src/index.ts

@@ -25,8 +25,9 @@ export type { QuerySource } from './coerce';
 export { coerceInput, coerceNode, coerceQuery } from './coerce';
 export { describeValue, expected } from './describe-value';
 export { discriminatedUnionSchema } from './discriminated-union';
+export type { SchemaErrorCodeDeclaration } from './error-codes';
+export { SCHEMA_ERROR_CODES } from './error-codes';
 export type {
-  SchemaErrorCodeDeclaration,
   SchemaErrorInit,
   SchemaErrorJSON,
   ValidationIssue,
@@ -34,7 +35,6 @@ export type {
 export {
   DiscriminantInvalidError,
   isSchemaError,
-  SCHEMA_ERROR_CODES,
   SchemaError,
   SchemaUnsupportedError,
   ULTIMATE_ERROR_BRAND,