@quonfig/cli 0.0.74 → 0.2.0

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.74 linux-x64 node-v24.4.1
+@quonfig/cli/0.2.0 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -201,7 +201,7 @@ EXAMPLES
   $ qfg activity restore my.flag --yes
 ```
 
-_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/activity.ts)_
 
 ## `qfg activity deleted`
 
@@ -230,7 +230,7 @@ EXAMPLES
   $ qfg activity deleted --json
 ```
 
-_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/activity/deleted.ts)_
 
 ## `qfg activity feed`
 
@@ -265,7 +265,7 @@ EXAMPLES
   $ qfg activity feed --json
 ```
 
-_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/activity/feed.ts)_
 
 ## `qfg activity history [NAME]`
 
@@ -299,7 +299,7 @@ EXAMPLES
   $ qfg activity history request.timeout --json
 ```
 
-_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/activity/history.ts)_
 
 ## `qfg activity restore [NAME]`
 
@@ -338,7 +338,7 @@ EXAMPLES
   $ qfg activity restore request.timeout --type config --yes
 ```
 
-_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/activity/restore.ts)_
 
 ## `qfg audit-log [NAME]`
 
@@ -366,7 +366,7 @@ EXAMPLES
   $ qfg audit-log my.flag
 ```
 
-_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/audit-log.ts)_
 
 ## `qfg cleanup`
 
@@ -407,7 +407,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key
 ```
 
-_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/cleanup.ts)_
+_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/cleanup.ts)_
 
 ## `qfg cleanup list`
 
@@ -453,7 +453,7 @@ EXAMPLES
   $ qfg cleanup list --json
 ```
 
-_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/cleanup/list.ts)_
+_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/cleanup/list.ts)_
 
 ## `qfg cleanup remove [NAME]`
 
@@ -498,7 +498,7 @@ EXAMPLES
   $ qfg cleanup remove my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/cleanup/remove.ts)_
+_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/cleanup/remove.ts)_
 
 ## `qfg cleanup status [NAME]`
 
@@ -538,7 +538,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/cleanup/status.ts)_
+_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/cleanup/status.ts)_
 
 ## `qfg cleanup verify [NAME]`
 
@@ -584,7 +584,7 @@ EXAMPLES
   $ qfg cleanup verify my.flag.key && qfg delete my.flag.key
 ```
 
-_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/cleanup/verify.ts)_
+_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/cleanup/verify.ts)_
 
 ## `qfg config-schema`
 
@@ -613,7 +613,7 @@ EXAMPLES
   $ qfg config-schema --json-schema    # full JSON Schema document (copy into your editor)
 ```
 
-_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -700,7 +700,7 @@ EXAMPLES
   $ qfg set-rollout my.new.flag --environment production --true-percent 20
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/create.ts)_
 
 ## `qfg delete NAME`
 
@@ -746,7 +746,7 @@ EXAMPLES
   $ qfg delete my.config --yes
 ```
 
-_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -950,7 +950,7 @@ EXAMPLES
   $ qfg generate --targets node-ts -o ./dist # combine with targets
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -973,7 +973,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -1005,7 +1005,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/get.ts)_
 
 ## `qfg history NAME`
 
@@ -1031,7 +1031,7 @@ EXAMPLES
   $ qfg history my.flag
 ```
 
-_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/history.ts)_
 
 ## `qfg info [NAME]`
 
@@ -1079,7 +1079,7 @@ EXAMPLES
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -1119,7 +1119,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -1149,7 +1149,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -1189,7 +1189,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/list.ts)_
 
 ## `qfg log`
 
@@ -1214,7 +1214,7 @@ EXAMPLES
   $ qfg log --limit 5
 ```
 
-_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/log.ts)_
 
 ## `qfg log-level NAME`
 
@@ -1279,7 +1279,7 @@ EXAMPLES
   $ qfg log-level log-level.my-app --target=Chatty --value=INFO --environment=production
 ```
 
-_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -1304,7 +1304,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -1327,7 +1327,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1392,7 +1392,7 @@ EXAMPLES
   $ qfg migrate --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1430,7 +1430,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1462,7 +1462,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1493,7 +1493,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1548,7 +1548,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1595,7 +1595,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1644,7 +1644,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1695,7 +1695,7 @@ EXAMPLES
   $ qfg run --env DATABASE_URL=db.url --preserve-env --environment=staging -- npm test
 ```
 
-_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1733,7 +1733,7 @@ EXAMPLES
   $ qfg schema my-schema --set-json-schema=@schemas/my-schema.json --protected
 ```
 
-_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1760,7 +1760,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1792,7 +1792,7 @@ EXAMPLES
   $ qfg sdk-key create --environment staging --type browser
 ```
 
-_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1821,7 +1821,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1848,7 +1848,7 @@ EXAMPLES
   $ qfg sdk-key revoke a1b2c3d4-e5f6-7890-abcd-ef1234567890
 ```
 
-_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg serve`
 
@@ -1906,7 +1906,7 @@ EXAMPLES
   $ qfg serve --port 6581 --frontend-sdk-key PUBLIC_KEY
 ```
 
-_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/serve.ts)_
+_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/serve.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1982,7 +1982,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -2073,7 +2073,7 @@ EXAMPLES
   $ qfg set-rollout my.variant.flag --environment production --weights "a:33,b:33,c:34" --hash-by user.id
 ```
 
-_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -2105,7 +2105,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -2212,7 +2212,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -2235,7 +2235,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -2258,7 +2258,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -2271,7 +2271,7 @@ USAGE
 
 FLAGS
   --dir=<value>    Local directory to push (defaults to current directory)
-  --force          Force push even if remote already has commits
+  --force          Accepted and ignored (no-op). Bootstrap never rewrites the workspace history.
   --skip-validate  Skip config validation before pushing
 
 GLOBAL FLAGS
@@ -2291,7 +2291,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2325,7 +2325,7 @@ EXAMPLES
   $ qfg workspace create my-team --org 11111111-1111-1111-1111-111111111111
 ```
 
-_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2353,7 +2353,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.74/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.2.0/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/codegen/json-schema-to-zod.js

@@ -58,6 +58,126 @@ function schemaFromObject(schema) {
     }
     return base;
 }
+/**
+ * JSON Schema object branch check for tag detection: `type: "object"`, or no type with `properties`.
+ */
+function isObjectBranch(schema) {
+    if (!isObject(schema)) {
+        return false;
+    }
+    if (schema.type === 'object') {
+        return true;
+    }
+    return schema.type === undefined && isObject(schema.properties);
+}
+/**
+ * The single value a property schema pins, from `const` or a one-value `enum`.
+ */
+function pinnedValue(schema) {
+    if (!isObject(schema)) {
+        return undefined;
+    }
+    if (schema.const !== undefined) {
+        return { value: schema.const };
+    }
+    if (Array.isArray(schema.enum) && schema.enum.length === 1) {
+        return { value: schema.enum[0] };
+    }
+    return undefined;
+}
+/**
+ * Finds the tag of a tagged oneOf/anyOf: every branch is an object, and exactly one property name is
+ * required and pinned to a single value (`const` or one-value `enum`) in every branch, with a
+ * different value in each. Returns undefined when there is no such property, or more than one.
+ */
+function findUnionTag(branches) {
+    if (branches.length < 2 || !branches.every((branch) => isObjectBranch(branch))) {
+        return undefined;
+    }
+    const objectBranches = branches;
+    const [first] = objectBranches;
+    const firstProperties = isObject(first.properties) ? first.properties : {};
+    const candidates = Object.keys(firstProperties).filter((key) => {
+        const values = [];
+        for (const branch of objectBranches) {
+            const properties = isObject(branch.properties) ? branch.properties : {};
+            const required = Array.isArray(branch.required) ? branch.required : [];
+            const pinned = pinnedValue(properties[key]);
+            if (!pinned || !required.includes(key)) {
+                return false;
+            }
+            values.push(pinned.value);
+        }
+        return new Set(values.map((value) => JSON.stringify(value))).size === values.length;
+    });
+    return candidates.length === 1 ? candidates[0] : undefined;
+}
+function schemaFromUnion(branches) {
+    if (branches.length === 0) {
+        return z.never();
+    }
+    const options = branches.map((item) => schemaToZod(item));
+    if (options.length === 1) {
+        return options[0];
+    }
+    const tag = findUnionTag(branches);
+    // discriminatedUnion needs every option to be a plain object schema (no default/other wrapper)
+    if (tag && options.every((option) => option instanceof z.ZodObject)) {
+        return z.discriminatedUnion(tag, options);
+    }
+    return z.union(options);
+}
+const STRUCTURAL_KEYWORDS = ['type', 'properties', 'const', 'enum', '$ref', 'items'];
+/**
+ * A branch is structural when it describes a shape (type, properties, const, enum, $ref, items or a
+ * schema-valued additionalProperties), as opposed to adding constraints only (required, format,
+ * pattern, min/max...) to the sibling `type`.
+ */
+function isStructuralBranch(branch) {
+    if (!isObject(branch)) {
+        return false;
+    }
+    return STRUCTURAL_KEYWORDS.some((key) => branch[key] !== undefined) || isObject(branch.additionalProperties);
+}
+/**
+ * A oneOf/anyOf is only a union when at least one branch is structural. When every branch is
+ * constraint-only it can't change the type, so the sibling `type` decides it.
+ */
+function hasStructuralBranch(branches) {
+    return branches.some((branch) => isStructuralBranch(branch));
+}
+/**
+ * oneOf/anyOf, checked before `type` so a union next to `type: "object"` (or no type) isn't lost.
+ * Sibling `properties` are kept as an intersection with the union.
+ */
+function schemaFromCombinator(schema, branches) {
+    const union = schemaFromUnion(branches);
+    // schemaFromObject reads only properties/required/additionalProperties, so the combinator isn't re-entered
+    if (isObject(schema.properties) && Object.keys(schema.properties).length > 0) {
+        return z.intersection(schemaFromObject(schema), union);
+    }
+    return union;
+}
+const MAX_TUPLE_MIN_ITEMS = 8;
+function schemaFromArray(schema) {
+    if (Array.isArray(schema.prefixItems)) {
+        const items = schema.prefixItems.map((item) => schemaToZod(item));
+        return z.tuple(items);
+    }
+    const item = schema.items === undefined ? z.any() : schemaToZod(schema.items);
+    const { maxItems, minItems } = schema;
+    // `minItems: n` with no upper bound is a tuple of n items plus a rest: [T, T, ...T[]].
+    // Above MAX_TUPLE_MIN_ITEMS the tuple would be unreadable, so it stays a plain array.
+    if (typeof minItems === 'number' &&
+        Number.isInteger(minItems) &&
+        minItems >= 1 &&
+        minItems <= MAX_TUPLE_MIN_ITEMS &&
+        maxItems === undefined) {
+        const fixed = Array.from({ length: minItems }, () => item);
+        return z.tuple(fixed).rest(item);
+    }
+    return z.array(item);
+}
 function schemaToZod(schema) {
     if (!isObject(schema)) {
         return z.any();
@@ -70,6 +190,12 @@ function schemaToZod(schema) {
     else if (schema.const !== undefined) {
         result = z.literal(schema.const);
     }
+    else if (Array.isArray(schema.oneOf) && hasStructuralBranch(schema.oneOf)) {
+        result = schemaFromCombinator(schema, schema.oneOf);
+    }
+    else if (Array.isArray(schema.anyOf) && hasStructuralBranch(schema.anyOf)) {
+        result = schemaFromCombinator(schema, schema.anyOf);
+    }
     else if (Array.isArray(schema.type)) {
         result = schemaFromTypeArray(schema, schema.type);
     }
@@ -96,16 +222,7 @@ function schemaToZod(schema) {
                 break;
             }
             case 'array': {
-                if (Array.isArray(schema.prefixItems)) {
-                    const items = schema.prefixItems.map((item) => schemaToZod(item));
-                    result = z.tuple(items);
-                }
-                else if (schema.items === undefined) {
-                    result = z.array(z.any());
-                }
-                else {
-                    result = z.array(schemaToZod(schema.items));
-                }
+                result = schemaFromArray(schema);
                 break;
             }
             case 'object':
@@ -119,18 +236,6 @@ function schemaToZod(schema) {
                 break;
             }
             default: {
-                if (Array.isArray(schema.oneOf)) {
-                    const options = schema.oneOf.map((item) => schemaToZod(item));
-                    result =
-                        options.length === 1 ? options[0] : z.union(options);
-                    break;
-                }
-                if (Array.isArray(schema.anyOf)) {
-                    const options = schema.anyOf.map((item) => schemaToZod(item));
-                    result =
-                        options.length === 1 ? options[0] : z.union(options);
-                    break;
-                }
                 if (Array.isArray(schema.allOf) && schema.allOf.length === 1) {
                     result = schemaToZod(schema.allOf[0]);
                     break;

package/dist/codegen/language-mappers/zod-base-mapper.d.ts

@@ -1,6 +1,11 @@
 import { z } from 'zod';
 import { $ZodFunctionArgs, $ZodFunctionOut, $ZodType, util } from 'zod/v4/core';
 export declare abstract class ZodBaseMapper {
+    /**
+     * Resolves the fixed tuple item at `index`. Mappers that emit value accessors override this to
+     * resolve the item at its indexed path rather than at the tuple's own path.
+     */
+    protected resolveTupleItem(item: $ZodType, _index: number): string;
     resolveType(type: $ZodType): string;
     /**
      * Hook for handling meta descriptions on schemas.
@@ -20,6 +25,7 @@ export declare abstract class ZodBaseMapper {
     protected abstract function(args: string, returns: string): string;
     protected abstract functionArguments(value?: $ZodFunctionArgs): string;
     protected abstract functionReturns(value: $ZodFunctionOut): string;
+    protected abstract intersection(left: string, right: string): string;
     protected abstract literal(value: string | number | boolean | null): string;
     protected abstract never(): string;
     protected abstract null(): string;
@@ -28,7 +34,11 @@ export declare abstract class ZodBaseMapper {
     protected abstract optional(wrappedType: string): string;
     protected abstract record(keyType: string, valueType: string): string;
     protected abstract string(): string;
-    protected abstract tuple(wrappedTypes: string[]): string;
+    /**
+     * @param wrappedTypes The fixed leading items
+     * @param rest The rest element type (`z.tuple([...]).rest(x)`), when the tuple has one
+     */
+    protected abstract tuple(wrappedTypes: string[], rest?: string): string;
     protected abstract undefined(): string;
     protected abstract union(wrappedTypes: string[]): string;
     protected abstract unknown(): string;