ai-img 0.2.0 → 0.2.2

package/.bunli/commands.gen.ts

@@ -27,7 +27,7 @@ const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
       name: 'batch',
       description: 'Batch generate images from a JSONL file',
       options: {
-        'input': { type: 'z.string.min', required: true, hasDefault: false, description: 'Input JSONL file path (one job per line)', short: 'i', min: 1, minLength: 1, fileType: 'file', schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":729,"end":730,"loc":{"start":{"line":29,"column":33,"index":729},"end":{"line":29,"column":34,"index":730}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
+        'input': { type: 'z.string.min', required: true, hasDefault: false, description: 'Input JSONL file path (one job per line)', short: 'i', min: 1, minLength: 1, fileType: 'file', schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":801,"end":802,"loc":{"start":{"line":32,"column":33,"index":801},"end":{"line":32,"column":34,"index":802}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
         'outDir': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Output directory', short: 'o', fileType: 'directory', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'concurrency': { type: 'z.coerce.number.min.max.optional', required: false, hasDefault: false, description: 'Concurrent API calls', short: 'c', min: 1, max: 25, minLength: 1, maxLength: 25, schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'model': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Model ID to use (default varies by provider)', short: 'm', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
@@ -81,12 +81,13 @@ const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
       name: 'edit',
       description: 'Edit an existing image with AI',
       options: {
-        'prompt': { type: 'z.string.min', required: true, hasDefault: false, description: 'Text prompt for editing', short: 'p', min: 1, minLength: 1, schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":712,"end":713,"loc":{"start":{"line":24,"column":34,"index":712},"end":{"line":24,"column":35,"index":713}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
-        'input': { type: 'z.string.min', required: true, hasDefault: false, description: 'Input image path(s) - first image is primary', short: 'i', min: 1, minLength: 1, fileType: 'path', schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":823,"end":824,"loc":{"start":{"line":28,"column":33,"index":823},"end":{"line":28,"column":34,"index":824}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
+        'prompt': { type: 'z.string.min', required: true, hasDefault: false, description: 'Text prompt for editing', short: 'p', min: 1, minLength: 1, schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":760,"end":761,"loc":{"start":{"line":26,"column":34,"index":760},"end":{"line":26,"column":35,"index":761}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
+        'input': { type: 'z.string.min', required: true, hasDefault: false, description: 'Input image path(s) - first image is primary', short: 'i', min: 1, minLength: 1, fileType: 'path', schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":871,"end":872,"loc":{"start":{"line":30,"column":33,"index":871},"end":{"line":30,"column":34,"index":872}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
         'mask': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Mask image path (for partial edits)', short: 'm', fileType: 'path', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'model': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Model ID to use (default varies by provider)', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'provider': { type: 'z.string.optional', required: false, hasDefault: false, description: 'AI provider: openai, google, fal (auto-detected if omitted)', short: 'P', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'size': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Image size', short: 's', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
+        'aspectRatio': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Aspect ratio (e.g., 16:9, 4:3, 1:1)', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'count': { type: 'z.coerce.number.min.max.optional', required: false, hasDefault: false, description: 'Number of images to generate', short: 'c', min: 1, max: 10, minLength: 1, maxLength: 10, schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'output': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Output file path', short: 'o', fileType: 'file', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'outDir': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Output directory', fileType: 'directory', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
@@ -98,7 +99,7 @@ const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
       name: 'generate',
       description: 'Generate new images from a text prompt',
       options: {
-        'prompt': { type: 'z.string.min', required: true, hasDefault: false, description: 'Text prompt for image generation', short: 'p', min: 1, minLength: 1, schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":718,"end":719,"loc":{"start":{"line":24,"column":34,"index":718},"end":{"line":24,"column":35,"index":719}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
+        'prompt': { type: 'z.string.min', required: true, hasDefault: false, description: 'Text prompt for image generation', short: 'p', min: 1, minLength: 1, schema: {"type":"zod","method":"min","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":766,"end":767,"loc":{"start":{"line":26,"column":34,"index":766},"end":{"line":26,"column":35,"index":767}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
         'model': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Model ID to use (default varies by provider)', short: 'm', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'provider': { type: 'z.string.optional', required: false, hasDefault: false, description: 'AI provider: openai, google, fal (auto-detected if omitted)', short: 'P', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
         'size': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Image size (e.g., 1024x1024, 1536x1024)', short: 's', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },

package/.bunli/release-state.json

@@ -0,0 +1,21 @@
+{
+  "packageName": "ai-img",
+  "targetVersion": "0.2.2",
+  "tag": "v0.2.2",
+  "options": {
+    "publishNpm": true,
+    "publishGitHub": true,
+    "binaryEnabled": false,
+    "platforms": []
+  },
+  "status": "in_progress",
+  "completedSteps": [
+    "run-tests",
+    "update-version",
+    "build-project",
+    "create-git-tag"
+  ],
+  "createdAt": "2026-03-07T19:33:42.759Z",
+  "updatedAt": "2026-03-07T19:33:53.002Z",
+  "currentStep": "publish-npm"
+}

package/README.md

@@ -123,6 +123,12 @@ Runtime precedence is:
 
 `config init/set/unset` defaults to `--target user`. Use `--target project` to write local project config.
 
+Image dimensions are model-aware:
+- Set `aiImg.defaults.size` for size-based models.
+- Set `aiImg.defaults.aspectRatio` for aspect-ratio-based models.
+- If neither is configured, `ai-img` uses a blessed model preset when known, otherwise it leaves dimensions unset and uses the provider/model default.
+- Existing `size` defaults are automatically converted for blessed Google image models when possible.
+
 For preview mode specifically, precedence is:
 1. `--image-mode` flag
 2. `aiImg.preview.mode` config
@@ -138,6 +144,7 @@ For preview mode specifically, precedence is:
       "provider": "openai",
       "model": "gpt-image-1.5",
       "size": "1024x1024",
+      "aspectRatio": "1:1",
       "output": "output.png",
       "outDir": "./output"
     },
@@ -166,6 +173,14 @@ For preview mode specifically, precedence is:
 }
 ```
 
+Set either `size` or `aspectRatio` for a given workflow. If both exist in config, `ai-img` prefers the model-native option for the selected blessed model.
+
+Batch JSONL jobs can also override dimensions per job with either field:
+
+```json
+{"prompt":"Green terminal UI", "aspectRatio":"16:9"}
+```
+
 ### Terminal Preview Notes
 
 - Preview mode values: `off`, `auto`, `on`

package/ai-img.schema.json

@@ -24,6 +24,10 @@
               "type": "string",
               "pattern": "^\\d+x\\d+$"
             },
+            "aspectRatio": {
+              "type": "string",
+              "pattern": "^\\d+:\\d+$"
+            },
             "output": {
               "type": "string",
               "minLength": 1