@fuzdev/fuz_app 0.136.0 → 0.137.0

package/dist/auth/scope_kind_schema.d.ts

@@ -39,7 +39,7 @@ import { z } from 'zod';
 export declare const SCOPE_KIND_NAME_REGEX: RegExp;
 /**
  * Maximum length of a `scope_kind`, in UTF-16 code units (what
- * `String.length` and Zod's `.max()` measure). Bounds the tag where it enters
+ * `String.length` measures; enforced by `bounded_string`). Bounds the tag where it enters
  * — the grant inputs (`role_grant_offer_create`, `role_grant_assign`) copy it
  * into the row and its audit metadata — and a registered name, so no
  * registry declares a kind the grant inputs would refuse. Same value as

package/dist/auth/scope_kind_schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope_kind_schema.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/auth/scope_kind_schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAgC,CAAC;AAEnE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,oDAAoD;AACpD,eAAO,MAAM,aAAa,aASxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACrC;;;;;OAKG;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,wBAAwB,GACpC,gBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAC3C,qBAwBF,CAAC"}
+{"version":3,"file":"scope_kind_schema.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/auth/scope_kind_schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAgC,CAAC;AAEnE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,oDAAoD;AACpD,eAAO,MAAM,aAAa,aAMzB,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACrC;;;;;OAKG;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,wBAAwB,GACpC,gBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAC3C,qBAwBF,CAAC"}

package/dist/auth/scope_kind_schema.js

@@ -30,6 +30,7 @@
  * @module
  */
 import { z } from 'zod';
+import { bounded_string } from '../primitive_schemas.js';
 /**
  * Letter (lowercase a-z) start and end (or single letter), with letters
  * and underscores in between. Mirrors `RoleName`. Rejects empty strings,
@@ -39,7 +40,7 @@ import { z } from 'zod';
 export const SCOPE_KIND_NAME_REGEX = /^[a-z][a-z_]*[a-z]$|^[a-z]$/;
 /**
  * Maximum length of a `scope_kind`, in UTF-16 code units (what
- * `String.length` and Zod's `.max()` measure). Bounds the tag where it enters
+ * `String.length` measures; enforced by `bounded_string`). Bounds the tag where it enters
  * — the grant inputs (`role_grant_offer_create`, `role_grant_assign`) copy it
  * into the row and its audit metadata — and a registered name, so no
  * registry declares a kind the grant inputs would refuse. Same value as
@@ -48,10 +49,10 @@ export const SCOPE_KIND_NAME_REGEX = /^[a-z][a-z_]*[a-z]$|^[a-z]$/;
  */
 export const SCOPE_KIND_LENGTH_MAX = 64;
 /** Zod schema for valid scope-kind name strings. */
-export const ScopeKindName = z
-    .string()
-    .max(SCOPE_KIND_LENGTH_MAX, `Scope-kind names must be at most ${SCOPE_KIND_LENGTH_MAX} characters`)
-    .regex(SCOPE_KIND_NAME_REGEX, 'Scope-kind names must be lowercase letters and underscores (a-z_), no leading/trailing underscore');
+export const ScopeKindName = bounded_string({
+    max: SCOPE_KIND_LENGTH_MAX,
+    max_message: `Scope-kind names must be at most ${SCOPE_KIND_LENGTH_MAX} characters`
+}).regex(SCOPE_KIND_NAME_REGEX, 'Scope-kind names must be lowercase letters and underscores (a-z_), no leading/trailing underscore');
 /**
  * Create a scope-kind schema from a consumer-declared registry.
  *

package/dist/cli/args.d.ts

@@ -3,45 +3,51 @@
  *
  * Provides `parse_command_args` for schema-validated command parsing and
  * `create_extract_global_flags` as a factory for project-specific global flag extraction.
- * Both are used identically across tx, zzz, and mageguild.
+ *
+ * Both take `@fuzdev/fuz_schema` object schemas, the schemas `args_parse` from
+ * `@fuzdev/fuz_util/args.ts` reads, with aliases given by `meta(entry, {aliases})`.
  *
  * @module
  */
 import { type ParsedArgs } from '@fuzdev/fuz_util/args.ts';
-import { z } from 'zod';
+import { type Schema } from '@fuzdev/fuz_schema/schema.ts';
 /**
  * Discriminated union result for CLI argument parsing.
  */
-export type ParseResult<T> = {
-    success: true;
-    data: T;
+export type ParseCommandArgsResult<T> = {
+    ok: true;
+    value: T;
 } | {
-    success: false;
+    ok: false;
     error: string;
 };
 /**
- * Parse command-specific args against a Zod schema.
+ * Parse command-specific args against a fuz_schema object schema.
  *
  * Validates `remaining` args (after global flag extraction) with alias expansion
- * and returns a typed result or a prettified error string.
+ * and returns a typed result or an error string, each issue formatted by
+ * `format_issue` on a line of its own.
  *
  * @param remaining - remaining args after global flag extraction
- * @param schema - Zod schema for the command
- * @returns parse result with typed data or error message
+ * @param schema - fuz_schema object schema for the command
+ * @returns parse result with the typed value or an error message
  */
-export declare const parse_command_args: <T extends Record<string, unknown>>(remaining: ParsedArgs, schema: z.ZodType<T>) => ParseResult<T>;
+export declare const parse_command_args: <T extends Record<string, unknown>>(remaining: ParsedArgs, schema: Schema<T, any>) => ParseCommandArgsResult<T>;
 /**
  * Create a project-specific global flag extractor.
  *
  * Returns a function that separates global flags from command-specific args.
- * The schema defines which flags are global (with aliases via `.meta({aliases})`),
- * and the fallback provides defaults when parsing fails.
+ * The schema defines which flags are global (with aliases via `meta(entry, {aliases})`,
+ * read on any wrapper layer of the entry), and the fallback provides defaults
+ * when parsing fails. Every entry is global, both of a `no-` pair like `color`
+ * and `no-color` included, so `--no-color`, which `argv_parse` reads as
+ * `color: false`, never lands in `remaining`.
  *
- * @param schema - Zod schema for global flags
+ * @param schema - fuz_schema object schema for global flags
  * @param fallback - default values when parsing fails
  * @returns extractor function `(unparsed) => {flags, remaining}`
  */
-export declare const create_extract_global_flags: <T extends Record<string, unknown>>(schema: z.ZodType<T>, fallback: T) => ((unparsed: ParsedArgs) => {
+export declare const create_extract_global_flags: <T extends Record<string, unknown>>(schema: Schema<T, any>, fallback: T) => ((unparsed: ParsedArgs) => {
     flags: T;
     remaining: ParsedArgs;
 });

package/dist/cli/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAyB,KAAK,UAAU,EAAiB,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,WAAW,UAAU,EACrB,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAClB,WAAW,CAAC,CAAC,CAMf,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5E,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,KACT,CAAC,CAAC,QAAQ,EAAE,UAAU,KAAK;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAuChE,CAAC"}
+{"version":3,"file":"args.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAyB,KAAK,UAAU,EAAiB,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGzE;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,WAAW,UAAU,EACrB,QAAQ,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,KACpB,sBAAsB,CAAC,CAAC,CAM1B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5E,QAAQ,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EACtB,UAAU,CAAC,KACT,CAAC,CAAC,QAAQ,EAAE,UAAU,KAAK;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CA4ChE,CAAC"}

package/dist/cli/args.js

@@ -3,46 +3,59 @@
  *
  * Provides `parse_command_args` for schema-validated command parsing and
  * `create_extract_global_flags` as a factory for project-specific global flag extraction.
- * Both are used identically across tx, zzz, and mageguild.
+ *
+ * Both take `@fuzdev/fuz_schema` object schemas, the schemas `args_parse` from
+ * `@fuzdev/fuz_util/args.ts` reads, with aliases given by `meta(entry, {aliases})`.
  *
  * @module
  */
 import { args_parse } from '@fuzdev/fuz_util/args.ts';
-import { z } from 'zod';
-import { zod_to_schema_properties, zod_to_schema_names_with_aliases } from '@fuzdev/fuz_util/zod.ts';
+import { format_issue } from '@fuzdev/fuz_schema/schema.ts';
+import { get_schema_entries, get_schema_meta } from '@fuzdev/fuz_schema/introspect.ts';
 /**
- * Parse command-specific args against a Zod schema.
+ * Parse command-specific args against a fuz_schema object schema.
  *
  * Validates `remaining` args (after global flag extraction) with alias expansion
- * and returns a typed result or a prettified error string.
+ * and returns a typed result or an error string, each issue formatted by
+ * `format_issue` on a line of its own.
  *
  * @param remaining - remaining args after global flag extraction
- * @param schema - Zod schema for the command
- * @returns parse result with typed data or error message
+ * @param schema - fuz_schema object schema for the command
+ * @returns parse result with the typed value or an error message
  */
 export const parse_command_args = (remaining, schema) => {
     const parsed = args_parse(remaining, schema);
-    if (!parsed.success) {
-        return { success: false, error: z.prettifyError(parsed.error) };
+    if (!parsed.ok) {
+        return { ok: false, error: parsed.issues.map(format_issue).join('\n') };
     }
-    return { success: true, data: parsed.data };
+    return { ok: true, value: parsed.value };
 };
 /**
  * Create a project-specific global flag extractor.
  *
  * Returns a function that separates global flags from command-specific args.
- * The schema defines which flags are global (with aliases via `.meta({aliases})`),
- * and the fallback provides defaults when parsing fails.
+ * The schema defines which flags are global (with aliases via `meta(entry, {aliases})`,
+ * read on any wrapper layer of the entry), and the fallback provides defaults
+ * when parsing fails. Every entry is global, both of a `no-` pair like `color`
+ * and `no-color` included, so `--no-color`, which `argv_parse` reads as
+ * `color: false`, never lands in `remaining`.
  *
- * @param schema - Zod schema for global flags
+ * @param schema - fuz_schema object schema for global flags
  * @param fallback - default values when parsing fails
  * @returns extractor function `(unparsed) => {flags, remaining}`
  */
 export const create_extract_global_flags = (schema, fallback) => {
     return (unparsed) => {
         // get all global flag names and aliases from schema
-        const global_names = zod_to_schema_names_with_aliases(schema);
-        const global_props = zod_to_schema_properties(schema);
+        const global_props = to_global_props(schema);
+        const global_names = new Set();
+        for (const prop of global_props) {
+            if (prop.name === '_')
+                continue;
+            global_names.add(prop.name);
+            for (const alias of prop.aliases)
+                global_names.add(alias);
+        }
         // extract global flag values, handling aliases
         const flags_input = {};
         for (const prop of global_props) {
@@ -61,7 +74,7 @@ export const create_extract_global_flags = (schema, fallback) => {
         }
         // parse global flags
         const global_parsed = args_parse(flags_input, schema);
-        const flags = global_parsed.success ? global_parsed.data : fallback;
+        const flags = global_parsed.ok ? global_parsed.value : fallback;
         // build remaining args without global flags
         const remaining = { _: [...unparsed._] };
         for (const [key, value] of Object.entries(unparsed)) {
@@ -74,3 +87,14 @@ export const create_extract_global_flags = (schema, fallback) => {
         return { flags, remaining };
     };
 };
+// each entry of an object schema with its aliases, a `no-` pair as two entries
+const to_global_props = (schema) => {
+    const entries = get_schema_entries(schema);
+    if (!entries)
+        return [];
+    const props = [];
+    for (const name in entries) {
+        props.push({ name, aliases: get_schema_meta(entries[name], 'aliases') ?? [] });
+    }
+    return props;
+};

package/dist/cli/daemon.d.ts

@@ -13,15 +13,10 @@ import { type CommandDeps, type EnvDeps, type FetchDeps, type FsReadDeps, type F
  * Daemon info schema for `~/.{name}/run/daemon.json`.
  */
 export declare const DaemonInfo: z.ZodObject<{
-    /** Schema version. */
     version: z.ZodNumber;
-    /** Server process ID. */
     pid: z.ZodNumber;
-    /** Port the server is listening on. */
     port: z.ZodNumber;
-    /** ISO timestamp when server started. */
     started: z.ZodString;
-    /** Package version of the application. */
     app_version: z.ZodString;
 }, z.core.$strict>;
 export type DaemonInfo = z.infer<typeof DaemonInfo>;

package/dist/cli/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/cli/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,MAAM,oBAAoB,CAAC;AAI5B;;GAEG;AACH,eAAO,MAAM,UAAU;IACtB,sBAAsB;;IAEtB,yBAAyB;;IAEzB,uCAAuC;;IAEvC,yCAAyC;;IAEzC,0CAA0C;;kBAEzC,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAChC,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACjC,MAAM,MAAM,KACV,MAAM,GAAG,IAGX,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC7B,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,iBAAiB,GAAG,QAAQ,CAAC,EAC7F,MAAM,MAAM,EACZ,MAAM,UAAU,KACd,OAAO,CAAC,IAAI,CAWd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAAG,OAAO,EACzF,MAAM,MAAM,KACV,OAAO,CAAC,UAAU,GAAG,IAAI,CAwB3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAU,SAAS,WAAW,EAAE,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAG1F,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,SAAS,EACf,MAAM,MAAM,EACZ,aAAkB,EAClB,mBAAiB,KACf,OAAO,CAAC,OAAO,CAYjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GACvB,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAChC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAC3C,YAAY,GACZ,WAAW,GACX,OAAO,EACR,MAAM,MAAM,KACV,OAAO,CAAC,gBAAgB,CA2C1B,CAAC"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/cli/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,MAAM,oBAAoB,CAAC;AAI5B;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;kBAWrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAChC,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACjC,MAAM,MAAM,KACV,MAAM,GAAG,IAGX,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC7B,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,iBAAiB,GAAG,QAAQ,CAAC,EAC7F,MAAM,MAAM,EACZ,MAAM,UAAU,KACd,OAAO,CAAC,IAAI,CAWd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAAG,OAAO,EACzF,MAAM,MAAM,KACV,OAAO,CAAC,UAAU,GAAG,IAAI,CAwB3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAU,SAAS,WAAW,EAAE,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAG1F,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,SAAS,EACf,MAAM,MAAM,EACZ,aAAkB,EAClB,mBAAiB,KACf,OAAO,CAAC,OAAO,CAYjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GACvB,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAChC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAC3C,YAAY,GACZ,WAAW,GACX,OAAO,EACR,MAAM,MAAM,KACV,OAAO,CAAC,gBAAgB,CA2C1B,CAAC"}

package/dist/cli/help.d.ts

@@ -5,15 +5,20 @@
  * once with `create_help` and get back `generate_main_help`,
  * `generate_command_help`, and `get_help_text`.
  *
+ * Schemas are `@fuzdev/fuz_schema` object schemas, the ones `parse_command_args`
+ * and `create_extract_global_flags` take, read with fuz_schema's `introspect.ts`:
+ * each entry's `description` and `aliases` metadata, its default, and its type
+ * as `format_schema_type` renders it.
+ *
  * @module
  */
-import type { z } from 'zod';
-import { type ZodSchemaProperty } from '@fuzdev/fuz_util/zod.ts';
+import type { AnySchema } from '@fuzdev/fuz_schema/schema.ts';
 /**
  * Command metadata for help generation.
  */
 export interface CommandMeta<TCategory extends string = string> {
-    schema?: z.ZodType;
+    /** fuz_schema object schema for the command's args. */
+    schema?: AnySchema;
     summary: string;
     usage: string;
     category: TCategory;
@@ -41,8 +46,8 @@ export interface HelpOptions<TCategory extends string = string> {
     categories: Array<HelpCategory<TCategory>>;
     /** Example commands for main help. */
     examples: Array<string>;
-    /** Zod schema for global arguments (shown in all help output). */
-    global_args_schema: z.ZodType;
+    /** fuz_schema object schema for global arguments (shown in all help output). */
+    global_args_schema: AnySchema;
     /** Whether to use ANSI colors in output. Defaults to `true`. */
     use_colors?: boolean;
 }
@@ -57,6 +62,40 @@ export interface HelpGenerator {
     /** Get help text for a command or main help. */
     get_help_text: (command?: string, subcommand?: string) => string;
 }
+/**
+ * One arg as help output shows it, read from an entry of an object schema.
+ */
+export interface HelpArgProperty {
+    /** The entry's key, `_` for positionals. */
+    name: string;
+    /** The type the entry accepts, as `format_schema_type` renders it. */
+    type: string;
+    /** The `description` metadata, or `''`. */
+    description: string;
+    /** The default, made by calling a `with_default_fn`'s function, or `undefined`. */
+    default: unknown;
+    /** The `aliases` metadata, or `[]`. */
+    aliases: Array<string>;
+}
+/**
+ * Read the args of an object schema for help output, in order.
+ *
+ * An entry whose `no-` negation is also an entry is left out, so a pair like
+ * `color` and `no-color` is shown once, as `--no-color`.
+ *
+ * @param schema - fuz_schema object schema
+ * @returns the args, none when `schema` is not an object schema
+ */
+export declare const to_help_arg_properties: (schema: AnySchema) => Array<HelpArgProperty>;
+/**
+ * Format a default value for display, `''` for none.
+ *
+ * Strings and arrays are written as JSON, as the type column writes a string literal.
+ *
+ * @param value - the default
+ * @returns display text
+ */
+export declare const format_arg_default: (value: unknown) => string;
 /**
  * Get maximum length from array.
  *
@@ -74,7 +113,7 @@ export declare const to_max_length: <T>(items: Array<T>, to_string: (item: T) =>
  * @param prop - schema property
  * @returns formatted name string
  */
-export declare const format_arg_name: (prop: ZodSchemaProperty) => string;
+export declare const format_arg_name: (prop: HelpArgProperty) => string;
 /**
  * Create a help generator configured for an application.
  *

package/dist/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/cli/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAGN,KAAK,iBAAiB,EACtB,MAAM,yBAAyB,CAAC;AAIjC;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC7D,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC9D,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC7D,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,4CAA4C;IAC5C,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3C,sCAAsC;IACtC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,kEAAkE;IAClE,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC;IAC9B,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,MAAM,CAAC;IACjC,iDAAiD;IACjD,qBAAqB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,MAAM,CAAC;IACtE,gDAAgD;IAChD,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACjE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,KAAG,MACb,CAAC;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,iBAAiB,KAAG,MAWzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,SAAS,MAAM,EACnD,SAAS,WAAW,CAAC,SAAS,CAAC,KAC7B,aAoHF,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/cli/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,8BAA8B,CAAC;AAY1E;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC7D,uDAAuD;IACvD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC9D,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC7D,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,4CAA4C;IAC5C,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3C,sCAAsC;IACtC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,gFAAgF;IAChF,kBAAkB,EAAE,SAAS,CAAC;IAC9B,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,MAAM,CAAC;IACjC,iDAAiD;IACjD,qBAAqB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,MAAM,CAAC;IACtE,gDAAgD;IAChD,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,KAAG,KAAK,CAAC,eAAe,CAe/E,CAAC;AA6BF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,MAMnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,KAAG,MACb,CAAC;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,eAAe,KAAG,MAWvD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,SAAS,MAAM,EACnD,SAAS,WAAW,CAAC,SAAS,CAAC,KAC7B,aAoHF,CAAC"}

package/dist/cli/help.js

@@ -5,10 +5,87 @@
  * once with `create_help` and get back `generate_main_help`,
  * `generate_command_help`, and `get_help_text`.
  *
+ * Schemas are `@fuzdev/fuz_schema` object schemas, the ones `parse_command_args`
+ * and `create_extract_global_flags` take, read with fuz_schema's `introspect.ts`:
+ * each entry's `description` and `aliases` metadata, its default, and its type
+ * as `format_schema_type` renders it.
+ *
  * @module
  */
-import { zod_to_schema_properties, zod_format_value } from '@fuzdev/fuz_util/zod.ts';
+import { format_schema_type, get_schema_fields, get_schema_meta } from '@fuzdev/fuz_schema/introspect.ts';
 import { colors } from './util.js';
+/**
+ * Read the args of an object schema for help output, in order.
+ *
+ * An entry whose `no-` negation is also an entry is left out, so a pair like
+ * `color` and `no-color` is shown once, as `--no-color`.
+ *
+ * @param schema - fuz_schema object schema
+ * @returns the args, none when `schema` is not an object schema
+ */
+export const to_help_arg_properties = (schema) => {
+    const fields = get_schema_fields(schema);
+    const names = new Set(fields.map((f) => f.name));
+    const properties = [];
+    for (const field of fields) {
+        if (names.has('no-' + field.name))
+            continue;
+        properties.push({
+            name: field.name,
+            type: format_schema_type(field.schema),
+            description: field.description ?? '',
+            default: to_field_default(field),
+            aliases: get_schema_meta(field.schema, 'aliases') ?? []
+        });
+    }
+    return properties;
+};
+// the default a field's help shows: a `with_default_fn`'s is made by calling its `make`,
+// as each parse that fills the key in does, found by walking the layers `get_schema_fields`
+// reads, whose first `optional` or default it is when `default_computed`
+const to_field_default = (field) => {
+    if (!field.default_computed)
+        return field.default;
+    let layer = field.schema;
+    for (;;) {
+        switch (layer.kind) {
+            case 'with_default_fn':
+                return layer.def.make();
+            case 'optional':
+            case 'nullable':
+            case 'with_default':
+                layer = layer.def.schema;
+                break;
+            case 'pipe':
+                layer = layer.def[0];
+                break;
+            case 'lazy':
+                layer = layer.def();
+                break;
+            default:
+                return undefined;
+        }
+    }
+};
+/**
+ * Format a default value for display, `''` for none.
+ *
+ * Strings and arrays are written as JSON, as the type column writes a string literal.
+ *
+ * @param value - the default
+ * @returns display text
+ */
+export const format_arg_default = (value) => {
+    if (value === undefined)
+        return '';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string' || typeof value === 'object')
+        return JSON.stringify(value);
+    if (typeof value === 'boolean' || typeof value === 'number')
+        return String(value);
+    return '';
+};
 /**
  * Get maximum length from array.
  *
@@ -50,7 +127,7 @@ export const create_help = (options) => {
         ? colors
         : { green: '', yellow: '', blue: '', red: '', cyan: '', dim: '', bold: '', reset: '' };
     const generate_global_options = () => {
-        const properties = zod_to_schema_properties(options.global_args_schema);
+        const properties = to_help_arg_properties(options.global_args_schema);
         const max_width = to_max_length(properties, (p) => `  ${format_arg_name(p)}`);
         return properties.map((prop) => {
             const name = format_arg_name(prop);
@@ -65,7 +142,7 @@ export const create_help = (options) => {
         lines.push(`${c.yellow}Usage${c.reset}: ${meta.usage}`);
         lines.push('');
         if (meta.schema) {
-            const properties = zod_to_schema_properties(meta.schema);
+            const properties = to_help_arg_properties(meta.schema);
             const flag_props = properties.filter((p) => p.name !== '_');
             const positional_prop = properties.find((p) => p.name === '_');
             if (positional_prop?.description) {
@@ -79,7 +156,7 @@ export const create_help = (options) => {
                 for (const prop of flag_props) {
                     const name = format_arg_name(prop).padEnd(longest_name);
                     const type = prop.type.padEnd(longest_type);
-                    const def = zod_format_value(prop.default);
+                    const def = format_arg_default(prop.default);
                     const desc = prop.description || '';
                     const default_str = def ? ` (default: ${def})` : '';
                     lines.push(`  ${name}  ${type}  ${desc}${default_str}`);

package/dist/http/auth_shape.d.ts

@@ -134,33 +134,6 @@ export declare const RouteAuth: z.ZodObject<{
     }>;
     roles: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
     credential_types: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-    /**
-     * The capability a **narrowed** api token's scope must admit to reach this
-     * route, in the `<section>:<id>` vocabulary a denial reports back as
-     * `required_scope`:
-     *
-     * - `surface:<name>` — a non-RPC surface, refused to every narrowed token
-     *   whatever its method list says (token scoping's rule that a narrowed
-     *   token is RPC-only). `surface:audit_stream`, `surface:fact_bare`, and
-     *   `surface:app_surface` are the spine's route-spec ones; a consumer names
-     *   its own without registering it.
-     * - `rpc:<method>` — one action method, refused unless the token lists it.
-     *   What a route bridged from an `ActionSpec` declares: it carries the
-     *   method's identity but never reaches the dispatcher's per-method gate.
-     *
-     * Declaring it makes the guard resolver mount the refusal ahead of the role
-     * gate, instead of the route hand-rolling the check in its handler (which
-     * the auth phase has already role-gated by then, so a narrowed token whose
-     * account lacks the role would be told about the role rather than about the
-     * scope).
-     *
-     * Opt-in rather than blanket: the account REST routes cross no boundary, and
-     * the RPC endpoint runs its own per-method check inside the dispatcher — and
-     * both are route specs too.
-     *
-     * Typed as a plain string here to keep `http/` from importing `auth/`; the
-     * resolver parses it at registration and throws on a malformed one.
-     */
     required_scope: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type RouteAuth = z.infer<typeof RouteAuth>;

package/dist/http/auth_shape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth_shape.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/http/auth_shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,6DAGtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAGtD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa;;;;EAA2C,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;IAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;;kBAyCF,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAUlD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,SAAS,KAAG,OACA,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,KAAG,OAAgC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAAkC,CAAC;AAEnF,wEAAwE;AACxE,eAAO,MAAM,YAAY,GAAI,MAAM,SAAS,KAAG,OAA+B,CAAC;AAE/E,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,GAAI,MAAM,SAAS,KAAG,OAC3B,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,SAAS,KAAG,OACQ,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,GAAI,MAAM,SAAS,KAAG,OACwB,CAAC;AAYvF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAIhE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sCAAsC,GAClD,MAAM,SAAS,EACf,OAAO,WAAW,EAClB,SAAS,MAAM,KACb,IAmBF,CAAC"}
+{"version":3,"file":"auth_shape.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/http/auth_shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,6DAGtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAGtD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa;;;;EAA2C,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;kBAyEnB,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAUlD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,SAAS,KAAG,OACA,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,KAAG,OAAgC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAAkC,CAAC;AAEnF,wEAAwE;AACxE,eAAO,MAAM,YAAY,GAAI,MAAM,SAAS,KAAG,OAA+B,CAAC;AAE/E,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,GAAI,MAAM,SAAS,KAAG,OAC3B,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,SAAS,KAAG,OACQ,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,GAAI,MAAM,SAAS,KAAG,OACwB,CAAC;AAYvF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAIhE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sCAAsC,GAClD,MAAM,SAAS,EACf,OAAO,WAAW,EAClB,SAAS,MAAM,KACb,IAmBF,CAAC"}

package/dist/primitive_schemas.d.ts

@@ -1,6 +1,6 @@
 /**
- * Reusable validator-schema primitives — `Username`, `UsernameProvided`,
- * `Email`. Lives at the top level (not inside `auth/` or `http/`) because
+ * Reusable validator-schema primitives — `bounded_string`, `Username`,
+ * `UsernameProvided`, `Email`. Lives at the top level (not inside `auth/` or `http/`) because
  * these shapes don't depend on or imply any domain — accounts hold a
  * username and email, but invites, password resets, future cell-sharing,
  * and other surfaces all reach for the same primitives without going
@@ -15,11 +15,45 @@
  * @module
  */
 import { z } from 'zod';
+/** Length bounds for `bounded_string`, in UTF-16 code units. */
+export interface BoundedStringOptions {
+    /** Shortest string admitted. Omit for no lower bound. */
+    min?: number;
+    /** Longest string admitted. */
+    max: number;
+    /** Message for the over-`max` issue, in place of Zod's default. */
+    max_message?: string;
+}
+/**
+ * A string schema whose length is bounded in UTF-16 code units — what
+ * `String.length` measures, and what the Rust spine counts
+ * (`encode_utf16().count()`), so an astral-plane character costs two on both.
+ * Every `.min()` / `.max()` length bound on a wire string in the package is
+ * built here, bar a bare `.min(1)`, which reads the same in either count.
+ *
+ * Zod's `.min()` / `.max()` alone don't pin the unit: depending on the
+ * installed Zod they count code units or Unicode code points, and the peer
+ * range admits both. The schema still carries them — they are what puts
+ * `minLength` / `maxLength` in the generated JSON Schema — and a check beside
+ * them settles the verdict on `String.length`: it adds the over-`max` or
+ * under-`min` issue when Zod raised none, and withdraws one Zod raised for a
+ * string that is within the bound in units. The issue it adds has the fields
+ * of Zod's own and, like Zod's, lets the checks chained after it run, so a
+ * refusal reads the same whichever count Zod used.
+ *
+ * Returns a plain `ZodString`, so format checks, `.brand()`, `.nullish()` and
+ * `.meta()` chain as usual. Don't chain a further `.min()` / `.max()` — pass
+ * the bound here.
+ *
+ * @param options - the bounds, in UTF-16 code units
+ * @returns the bounded string schema
+ */
+export declare const bounded_string: ({ min, max, max_message }: BoundedStringOptions) => z.ZodString;
 /** Minimum username length (must have start + middle + end characters). */
 export declare const USERNAME_LENGTH_MIN = 3;
-/** Maximum username length (matches GitHub's limit). */
+/** Maximum username length (matches GitHub's limit). The grammar is ASCII, so units and characters agree. */
 export declare const USERNAME_LENGTH_MAX = 39;
-/** Maximum length for username input on login/lookup — more permissive than `USERNAME_LENGTH_MAX` for forward-compatibility if the creation limit is raised. */
+/** Maximum length for username input on login/lookup, in UTF-16 code units, measured before trimming — more permissive than `USERNAME_LENGTH_MAX` for forward-compatibility if the creation limit is raised. */
 export declare const USERNAME_PROVIDED_LENGTH_MAX = 255;
 /**
  * Username for account creation — starts with letter, alphanumeric/dash/underscore middle, ends with alphanumeric. No @ or . allowed.

package/dist/primitive_schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitive_schemas.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/primitive_schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,gKAAgK;AAChK,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,wDAKc,CAAC;AACpC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,wDAKqE,CAAC;AACnG,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAqBpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK,aAYhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC"}
+{"version":3,"file":"primitive_schemas.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/primitive_schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACpC,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,GAAI,2BAA2B,oBAAoB,KAAG,CAAC,CAAC,SA8ClF,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,6GAA6G;AAC7G,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,gNAAgN;AAChN,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,wDAEc,CAAC;AACpC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,wDAEqE,CAAC;AACnG,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAqBpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK,aAYhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC"}