human2ai 0.1.2 → 0.1.4

package/locales/en/common.json

@@ -48,7 +48,8 @@
       "label": "Category",
       "all": "All types",
       "visual": "Visual",
-      "ui": "UI"
+      "ui": "UI",
+      "spatial": "3D"
     },
     "creator": {
       "label": "Creator",
@@ -66,11 +67,12 @@
     },
     "description": {
       "heading": "Design specification",
-      "placeholder": "Describe the layout, proportions, visual hierarchy, and decorative treatment."
+      "placeholder": "Describe the layout, proportions, visual hierarchy, and decorative treatment.",
+      "spatialPlaceholder": "Describe forms, proportions, materials, palette, lighting, and camera treatment."
     },
     "searchPlaceholder": "Search styles",
     "deleteTitle": "Delete this style?",
-    "deleteDescription": "The style and all of its reference images will be permanently deleted.",
+    "deleteDescription": "The style and all of its reference images and models will be permanently deleted.",
     "empty": "No styles yet",
     "noMatches": "No matching styles",
     "loading": "Loading styles",
@@ -82,6 +84,13 @@
     "promptSummary": {
       "label": "Style summary",
       "placeholder": "Summarize the defining visual traits in one sentence."
+    },
+    "model": {
+      "label": "Model example",
+      "loading": "Loading model",
+      "failed": "Could not preview the model",
+      "reset": "Reset model view",
+      "controls": "Drag to rotate, scroll to zoom. When focused, use arrow keys to rotate, + / − to zoom, and Home to reset."
     }
   },
   "notes": {
@@ -254,8 +263,6 @@
       "quadrilateral": "Rectangle",
       "textRegion": "Text region"
     },
-    "showGuideGrid": "Show grid",
-    "hideGuideGrid": "Hide grid",
     "canvasZoom": "Current zoom",
     "zoomOut": "Zoom out",
     "zoomIn": "Zoom in",
@@ -300,7 +307,16 @@
       "left": "left",
       "lightSourceNumber": "Light source {{index}}",
       "lightSourceGuidance": "- Like ordinary shape regions, light markers describe approximate visual intent and spatial relationships. Pale yellow identifies lighting, not color temperature. A source is distinct from the area it illuminates: interpret its origin and contribution in the scene. Rectangles suggest band-shaped or extended illumination; circles suggest localized illumination. Retain the broad lighting placement, extension trend and contribution to subject and space, while freely adapting width, length, curvature, continuity, edges and strength to the scene. User instructions and node notes take precedence; otherwise the Agent chooses. Do not infer fixed width, straight constant-width strips, full-frame coverage, medium-strong contrast or thumbnail prominence from the reference. Consider sources individually while allowing their visible effects to split, overlap or blend. Review whether the overall lighting broadly echoes the composition rather than comparing edges, segments or widths; tighten a constraint only when the user explicitly requests it, and do not ignore the authored lighting intent entirely.",
-      "lightBandGuidance": "Light-band intent: broadly retain the extended or band-like illumination and its spatial role here. Its realization may narrow, widen, curve, break up or blend with the scene; a complete, straight, constant-width or conspicuous stripe is not required. User instructions and this node’s notes take precedence for width, length, edges and strength; otherwise the Agent interprets them freely. An approximate overall correspondence is sufficient."
+      "lightBandGuidance": "Light-band intent: broadly retain the extended or band-like illumination and its spatial role here. Its realization may narrow, widen, curve, break up or blend with the scene; a complete, straight, constant-width or conspicuous stripe is not required. User instructions and this node’s notes take precedence for width, length, edges and strength; otherwise the Agent interprets them freely. An approximate overall correspondence is sufficient.",
+      "planningGuidance": "Use the following plans as composition intent alongside the overall requirements and notes. Do not draw the guide lines, axes, spiral or triangle outline in the artwork. Positions are relative to the top-left of the image; angles run clockwise from the rightward horizontal.",
+      "planningGrid": "- {{type}}: {{axes}} divisions.",
+      "planningSymmetry": "- Symmetrical composition: axis through the image center ({{x}}%, {{y}}%), direction {{rotation}}°.",
+      "planningSpiral": "- Golden spiral: pole at ({{x}}%, {{y}}%), outer radius directed at {{rotation}}°, radius {{scale}}% of the shorter image side, {{winding}}.",
+      "planningClockwise": "expanding clockwise",
+      "planningCounterclockwise": "expanding counterclockwise",
+      "planningTriangle": "- Triangular composition: isosceles triangle with vertices at {{points}}.",
+      "planningRadial": "- Radial composition: convergence point ({{x}}%, {{y}}%), {{rayCount}} evenly spaced rays starting at {{rotation}}° and spanning {{spread}}° clockwise.",
+      "planningRadialFree": "- Free radial composition: convergence point ({{x}}%, {{y}}%), {{rayCount}} rays with independent directions: {{angles}} (clockwise from the rightward horizontal)."
     },
     "depth": {
       "label": "Depth",
@@ -346,6 +362,52 @@
     },
     "lightSource": {
       "toggle": "Use as light source"
+    },
+    "textRegion": {
+      "cornerLabel": "Text outline corner {{index}}",
+      "cornerHelp": "Select a text region and hold Ctrl to drag its corners. Focus a corner and use the arrow keys for fine adjustments."
+    },
+    "planning": {
+      "title": "Composition planning",
+      "add": "Add plan",
+      "empty": "No composition plans",
+      "types": {
+        "thirds": "Rule of thirds",
+        "golden-section": "Golden section",
+        "symmetry": "Symmetrical composition",
+        "golden-spiral": "Golden spiral",
+        "triangle": "Triangular composition",
+        "radial": "Radial composition"
+      },
+      "visible": "Show plan",
+      "axes": "Grid directions",
+      "both": "Horizontal and vertical",
+      "horizontal": "Horizontal",
+      "vertical": "Vertical",
+      "x": "Horizontal (%)",
+      "y": "Vertical (%)",
+      "rotation": "Rotation (°)",
+      "scale": "Spiral size (%)",
+      "mirrored": "Mirror spiral",
+      "handle": "Plan control {{index}}",
+      "help": "Shift-click to select multiple plans and drag a selected guide to move them together. Thirds, golden-section and symmetry guides stay fixed. Select thirds and golden-section plans in the sidebar. Arrow keys nudge; Delete removes a plan.",
+      "width": "Base width (%)",
+      "height": "Triangle height (%)",
+      "triangleHelp": "Drag the apex to rotate and adjust height. Drag a base corner to resize; both sides stay symmetric.",
+      "symmetryHelp": "The center stays fixed. Drag the other dot to one of eight regular directions or four frame-corner directions. Corner directions follow the frame ratio; duplicate positions merge for a square. Arrow keys step between positions.",
+      "spiralHelp": "Click the center dot to switch clockwise/counterclockwise. Drag it to move the spiral; drag the outer dot to rotate and resize.",
+      "spiralDirection": "Switch spiral direction (clockwise/counterclockwise)",
+      "rayCount": "Ray count",
+      "spread": "Spread (°)",
+      "radialHelp": "Uniform mode uses a starting direction and spread. In Free mode, drag each ray’s dot to adjust its direction; drag the center to move the convergence point. Switching to Free preserves directions; switching back to Uniform redistributes the current rays around a full circle.",
+      "lock": "Lock composition planning",
+      "unlock": "Unlock composition planning",
+      "showAll": "Show composition guides",
+      "hideAll": "Hide composition guides",
+      "radialMode": "Radial mode",
+      "radialUniform": "Uniform",
+      "radialFree": "Free",
+      "rayHandle": "Ray {{index}} direction"
     }
   },
   "uiSketch": {
@@ -498,14 +560,17 @@
   },
   "spatial": {
     "title": "3D space",
+    "spaceTab": "Space",
+    "workspaceViews": "3D workspace view",
+    "cameraPreviewPending": "Preview available after saving",
     "newSpace": "New 3D space",
     "newInProject": "New 3D space in {{project}}",
     "untitled": "Untitled 3D space",
     "objects": "Scene objects",
     "cameras": "Cameras",
-    "addCharacter": "Add character",
+    "addCharacter": "Character",
     "character": "Character",
-    "addCamera": "Add camera",
+    "addCamera": "Camera",
     "camera": "Camera {{number}}",
     "box": "Box",
     "sphere": "Sphere",
@@ -544,8 +609,6 @@
     "loadFailed": "Could not load the 3D space",
     "saveFailed": "Could not save. Try again.",
     "conflict": "The space has changed. Reload to continue.",
-    "saving": "Saving space",
-    "saved": "Space saved",
     "duplicate": "Duplicate scene object",
     "deleteConfirm": "Delete this scene object?",
     "empty": "No objects in this space",
@@ -587,6 +650,7 @@
     "resetPose": "Reset pose",
     "resetPoseHint": "Restore the default pose and clear this character’s locks. Can be undone.",
     "showRig": "Show joints and bones",
+    "showCameras": "Show cameras",
     "lightingEffects": "Lighting effects",
     "jointLeftWrist": "Left wrist",
     "jointLeftAnkle": "Left ankle",
@@ -655,7 +719,20 @@
     "downloadReference": "Download PNG",
     "referenceLoadFailed": "Could not load reference",
     "cameraBox": "Camera box",
-    "addCameraBox": "Add camera box",
+    "cameraBoxTab": "Camera box",
+    "cameraBoxFrontToggle": "Front",
+    "cameraBoxBackToggle": "Back",
+    "cameraBoxLeftToggle": "Left",
+    "cameraBoxRightToggle": "Right",
+    "cameraBoxTopToggle": "Top",
+    "cameraBoxBottomToggle": "Bottom",
+    "copyObservationImage": "Copy observation image",
+    "downloadObservationImage": "Download observation image",
+    "observationCopyFailed": "Could not copy the observation image. Try again or download it.",
+    "observationDownloadFailed": "Could not download the observation image. Try again.",
+    "noCameraBoxes": "No camera boxes",
+    "noObservationDirections": "Select at least one direction",
+    "addCameraBox": "Camera box",
     "cameraBoxSize": "Edge length (m)",
     "cameraBoxResolution": "Tile resolution",
     "cameraBoxView": "Observation view",
@@ -670,14 +747,17 @@
     "fitCameraBoxHands": "Fit all hands",
     "cameraBoxHint": "Six inward orthographic views show only the box interior. Directions rotate with the box. Use the sheet to understand the pose and the main camera for composition.",
     "cameraBoxTargetError": "Specify exactly one of --camera or --box.",
-    "cameraBoxViewTargetError": "--view requires --box.",
+    "cameraBoxViewTargetError": "Observation-view options require --box.",
     "cameraBoxViewError": "--view must be sheet, front, back, left, right, top, or bottom.",
-    "cameraBoxGenerationGuidance": "The main camera sets the final composition. The six-view sheet shows the same scene at one moment; labels identify box-local directions, not anatomical left and right. Use auxiliary views to understand occlusion, digit ownership, and approximate bending intent. Produce a single image without a contact-sheet layout, duplicated subjects, direction labels, or joint/body guide lines. Correct anatomy and finger contact naturally instead of reproducing the references pixel for pixel.",
+    "cameraBoxViewsError": "Choose 1–6 distinct directions from front, back, left, right, top, bottom, separated by commas.",
+    "cameraBoxViewConflict": "Use either --view or --views, not both.",
+    "cameraBoxGenerationGuidance": "The main camera sets the final composition. The observation sheet shows the same scene at one moment; labels identify box-local directions, not anatomical left and right. Use auxiliary views to understand occlusion, digit ownership, and approximate bending intent. Produce a single image without a contact-sheet layout, duplicated subjects, direction labels, or joint/body guide lines. Correct anatomy and finger contact naturally instead of reproducing the references pixel for pixel.",
     "referenceSkeleton": "Skeleton",
     "renderPassError": "--pass must be one of {{passes}}.",
     "appearance": "Model style",
     "appearanceQuaternius": "Human model",
-    "appearanceGeometric": "Geometric mannequin"
+    "appearanceGeometric": "Geometric mannequin",
+    "editObject": "Edit object"
   },
   "canvasHistory": {
     "undo": "Undo",

package/migrations/0009_spatial_styles.sql

@@ -0,0 +1,31 @@
+-- Rebuild the category constraint while keeping foreign keys enabled. Dropping
+-- the old parent cascades its references and clears bindings; restore both
+-- inside the migration transaction without changing session revisions.
+CREATE TEMP TABLE spatial_style_references AS SELECT * FROM style_reference_images;
+CREATE TEMP TABLE spatial_style_bindings AS
+  SELECT id, style_id FROM sessions WHERE style_id IS NOT NULL;
+
+CREATE TABLE style_entries_with_spatial (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL CHECK (length(trim(name)) > 0),
+  category TEXT NOT NULL CHECK (category IN ('visual', 'ui', 'spatial')),
+  creator_type TEXT NOT NULL CHECK (creator_type IN ('user', 'agent')),
+  description TEXT NOT NULL CHECK (length(trim(description)) > 0),
+  revision INTEGER NOT NULL DEFAULT 1 CHECK (revision > 0),
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  prompt_summary TEXT
+) STRICT;
+
+INSERT INTO style_entries_with_spatial SELECT * FROM style_entries;
+DROP TABLE style_entries;
+ALTER TABLE style_entries_with_spatial RENAME TO style_entries;
+CREATE INDEX style_entries_updated_idx ON style_entries (updated_at DESC, id);
+
+INSERT INTO style_reference_images SELECT * FROM spatial_style_references;
+UPDATE sessions
+SET style_id = (SELECT style_id FROM spatial_style_bindings WHERE id = sessions.id)
+WHERE id IN (SELECT id FROM spatial_style_bindings);
+
+DROP TABLE spatial_style_references;
+DROP TABLE spatial_style_bindings;

package/migrations/0010_style_preview_models.sql

@@ -0,0 +1,8 @@
+CREATE TABLE style_preview_models (
+  style_id TEXT PRIMARY KEY REFERENCES style_entries(id) ON DELETE CASCADE,
+  id TEXT NOT NULL UNIQUE,
+  relative_path TEXT NOT NULL,
+  original_filename TEXT NOT NULL,
+  byte_size INTEGER NOT NULL CHECK (byte_size > 0),
+  created_at TEXT NOT NULL
+) STRICT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "human2ai",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local visual collaboration workspace for people and AI agents, with a browser UI and CLI.",
   "license": "MIT",
   "author": "贾思斋",