@helix3/helix-cli 0.1.5-helix3.33 → 0.1.6-helix3.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helix3/helix-cli",
-  "version": "0.1.5-helix3.33",
+  "version": "0.1.6-helix3.34",
   "description": "helix — the HELIX creator CLI: scaffold, validate, and publish Instant Worlds",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",

package/vendor/ability-manifest.mjs

@@ -1,4 +1,4 @@
-// @helix/humanoid-character@0.2.2 — ability.json validator (frozen C3 contract).
+// @helix/humanoid-character@0.2.7 — ability.json validator (frozen C3 contract).
 // Generated by emit-schemas; vendored by @hypersoniclabs/helix-cli. Do not edit; changes require ability-v2.
 
 // src/core/config/paths.ts
@@ -34,6 +34,318 @@ function nearestKey(key, candidates) {
   return best !== void 0 && bestDist <= Math.max(2, Math.floor(key.length * 0.4)) ? best : void 0;
 }
 
+// src/core/input/gamepadStandard.ts
+var StandardButton = {
+  faceDown: 0,
+  faceRight: 1,
+  faceLeft: 2,
+  faceUp: 3,
+  bumperL: 4,
+  bumperR: 5,
+  triggerL: 6,
+  triggerR: 7,
+  select: 8,
+  start: 9,
+  stickL: 10,
+  stickR: 11,
+  dpadUp: 12,
+  dpadDown: 13,
+  dpadLeft: 14,
+  dpadRight: 15
+};
+var StandardAxis = {
+  leftStick: [0, 1],
+  rightStick: [2, 3]
+};
+var BUTTON_NAMES = Object.keys(StandardButton);
+var AXIS_NAMES = Object.keys(StandardAxis);
+
+// src/core/input/standardActions.ts
+var STANDARD_ACTIONS = [
+  // ---- character / gameplay ----
+  {
+    id: "move",
+    kind: "vec2",
+    domain: "character",
+    context: "gameplay",
+    bindings: { composite: { up: ["KeyW"], down: ["KeyS"], left: ["KeyA"], right: ["KeyD"] }, stick: "leftStick" },
+    label: "Move",
+    description: "Planar movement (vec2; WASD composite or left stick)",
+    touch: "stick"
+  },
+  {
+    id: "look",
+    kind: "vec2",
+    domain: "character",
+    context: "gameplay",
+    bindings: { stick: "rightStick" },
+    label: "Look",
+    description: "Camera look (pointer delta or right stick). First-person pointer lock auto-acquires on the T toggle and re-acquires on a canvas click (Esc releases); third-person and touch use unlocked drag",
+    touch: "drag"
+  },
+  {
+    id: "jump",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["Space"], pad: "faceDown" },
+    label: "Jump",
+    description: "Jump (when grounded)",
+    touch: "button"
+  },
+  {
+    id: "sprint",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["ShiftLeft", "ShiftRight"], pad: "stickL" },
+    label: "Sprint",
+    description: "Sprint-tier speed while held (touch: auto by stick magnitude)",
+    touch: "none"
+  },
+  {
+    // AltLeft is the browser-safe primary (Ctrl+W closes the tab and cannot be prevented);
+    // Ctrl stays bound for fullscreen/wrapped builds where the genre convention applies.
+    id: "walk",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["AltLeft", "ControlLeft", "ControlRight"] },
+    label: "Walk",
+    description: "Force walk-tier speed while held",
+    touch: "none"
+  },
+  {
+    id: "crouch",
+    kind: "toggle",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["KeyC"], pad: "faceRight" },
+    label: "Crouch",
+    description: "Toggle crouch",
+    touch: "button"
+  },
+  {
+    id: "primary",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { mouseButtons: [0], pad: "triggerR" },
+    label: "Primary",
+    description: "Primary use/fire (abilities bind this instead of minting a private fire action)",
+    touch: "button"
+  },
+  {
+    id: "secondary",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { mouseButtons: [2], pad: "triggerL" },
+    label: "Aim / secondary",
+    description: "Secondary use \u2014 the character system will drive aim-down-sights from this id",
+    touch: "button"
+  },
+  {
+    id: "interact",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["KeyE"], pad: "faceLeft" },
+    label: "Interact",
+    description: "Contextual world interaction (doors, pickups, NPCs)",
+    touch: "button"
+  },
+  {
+    id: "reload",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["KeyR"], pad: "faceUp" },
+    label: "Reload",
+    description: "Reload / secondary contextual action",
+    touch: "button"
+  },
+  // Direct slot select is keyboard-only (digits); the gamepad cycles via equipPrev/equipNext instead.
+  ...Array.from({ length: 9 }, (_, i) => ({
+    id: `ability${i + 1}`,
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: [`Digit${i + 1}`] },
+    label: `Ability ${i + 1}`,
+    description: `Ability/item slot ${i + 1} (direct select; pad players cycle with equipPrev/equipNext)`,
+    touch: "radial"
+  })),
+  {
+    id: "equipNext",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["BracketRight"], pad: "bumperR" },
+    label: "Next equip",
+    description: "Cycle the active ability/equip slot forward (1-9). Slot state is game-side \u2014 worlds/abilities consume this",
+    touch: "none"
+  },
+  {
+    id: "equipPrev",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["BracketLeft"], pad: "bumperL" },
+    label: "Previous equip",
+    description: "Cycle the active ability/equip slot back (1-9). Slot state is game-side \u2014 worlds/abilities consume this",
+    touch: "none"
+  },
+  {
+    id: "melee",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["KeyV"], pad: "stickR" },
+    label: "Melee",
+    description: "Melee strike. No built-in behavior \u2014 worlds/abilities consume it",
+    touch: "button"
+  },
+  {
+    id: "emote",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["KeyG"], pad: "dpadDown" },
+    label: "Emote",
+    description: "Emote/gesture. No built-in behavior yet \u2014 reserved for the future emote system",
+    touch: "button"
+  },
+  {
+    id: "zoom",
+    kind: "delta",
+    domain: "character",
+    context: "gameplay",
+    bindings: { wheel: "y", deltaRate: 1200, withModifier: { stick: "rightStick" } },
+    label: "Zoom",
+    description: "Camera zoom delta (wheel px; pinch on touch; hold modifier + right stick on pad \u2014 forward zooms in). Positive = zoom out",
+    touch: "pinch"
+  },
+  {
+    id: "modifier",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { pad: "dpadRight" },
+    label: "Modifier",
+    description: "Held chord layer: while down, withModifier bindings resolve (zoom on the right stick) and their sources go quiet for their normal owners",
+    touch: "hold"
+  },
+  {
+    id: "cameraMode",
+    kind: "button",
+    domain: "character",
+    context: "gameplay",
+    bindings: { keys: ["KeyT"], pad: "dpadLeft" },
+    label: "Camera",
+    description: "Cycle the camera: first-person \u2192 third-person \u2192 shoulder right \u2192 shoulder left. allowModeToggle gates the FP\u2194TP legs, allowShoulderSwap the shoulder legs; all-gated = inert",
+    touch: "button"
+  },
+  // ---- world / system (worlds opt in via registerStandardActions) ----
+  {
+    // Not Escape — the SDK owns Escape (tablet overlay) and pointer-lock exit rides it at browser level.
+    id: "pause",
+    kind: "button",
+    domain: "world",
+    context: "gameplay",
+    bindings: { keys: ["KeyP"], pad: "start" },
+    label: "Pause",
+    description: "Open the pause/system menu",
+    touch: "button"
+  },
+  {
+    id: "inventory",
+    kind: "button",
+    domain: "world",
+    context: "gameplay",
+    bindings: { keys: ["Tab", "KeyI"], pad: "select" },
+    label: "Inventory",
+    description: "Open the inventory (worlds push the menu context)",
+    touch: "button"
+  },
+  {
+    id: "map",
+    kind: "button",
+    domain: "world",
+    context: "gameplay",
+    bindings: { keys: ["KeyM"] },
+    label: "Map",
+    description: "Toggle the map/overview",
+    touch: "button"
+  },
+  {
+    // Keyboard PTT stays SDK-side (the reserved KeyB / pttKey listener — pointer-lock focus lives in
+    // the iframe); this action is the pad/touch leg. attachVoice registers it and forwards to setPttDown.
+    id: "voicePTT",
+    kind: "button",
+    domain: "world",
+    context: "global",
+    bindings: { withModifier: { pad: "bumperR" } },
+    label: "Push to talk",
+    description: "Hold to talk in PTT voice mode (modifier + right bumper on pad; keyboard uses the SDK pttKey, default B). Global context \u2014 keeps working under menus. Auto-registered when the world attaches voice",
+    touch: "hold"
+  },
+  {
+    id: "confirm",
+    kind: "button",
+    domain: "world",
+    context: "menu",
+    bindings: { keys: ["Enter", "Space"], pad: "faceDown" },
+    label: "Confirm",
+    description: "Accept the focused menu item",
+    touch: "tap"
+  },
+  {
+    id: "cancel",
+    kind: "button",
+    domain: "world",
+    context: "menu",
+    bindings: { keys: ["Backspace"], pad: "faceRight" },
+    label: "Cancel",
+    description: "Back out of the current menu level",
+    touch: "button"
+  },
+  {
+    // Right stick: 'look' is gameplay-context so the stick is free in menus — the "look becomes
+    // navigate" handoff, mirroring how pointer lock releases when a menu opens.
+    id: "uiNavigate",
+    kind: "vec2",
+    domain: "world",
+    context: "menu",
+    bindings: { composite: { up: ["ArrowUp"], down: ["ArrowDown"], left: ["ArrowLeft"], right: ["ArrowRight"] }, stick: "rightStick" },
+    label: "Navigate",
+    description: "Move the menu focus",
+    touch: "swipe"
+  },
+  {
+    id: "tabPrev",
+    kind: "button",
+    domain: "world",
+    context: "menu",
+    bindings: { keys: ["KeyQ"], pad: "bumperL" },
+    label: "Previous tab",
+    description: "Cycle menu tabs left",
+    touch: "swipe"
+  },
+  {
+    id: "tabNext",
+    kind: "button",
+    domain: "world",
+    context: "menu",
+    bindings: { keys: ["KeyE"], pad: "bumperR" },
+    label: "Next tab",
+    description: "Cycle menu tabs right",
+    touch: "swipe"
+  }
+];
+var byId = new Map(STANDARD_ACTIONS.map((a) => [a.id, a]));
+var STANDARD_CHARACTER_ACTION_IDS = STANDARD_ACTIONS.filter((a) => a.domain === "character").map((a) => a.id);
+
 // src/bundle/abilityManifest.ts
 var ABILITY_ID_PATTERN = "^[a-z0-9](?:[a-z0-9-]{1,48})[a-z0-9]$";
 var SEMVER_PATTERN = "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?$";
@@ -243,15 +555,22 @@ function validateAbilityManifest(value) {
           issues.push({ path, message: `must be an object (got ${typeName(action)})` });
           return;
         }
-        const actionId = checkQualifiedName(action.id, `${path}.id`, issues, id, "action");
+        const isStandard = typeof action.id === "string" && STANDARD_CHARACTER_ACTION_IDS.includes(action.id);
+        const actionId = isStandard ? action.id : checkQualifiedName(action.id, `${path}.id`, issues, id, "action");
         if (actionId !== void 0) {
           if (actionIds.includes(actionId)) issues.push({ path: `${path}.id`, message: `duplicate action id '${actionId}'` });
           actionIds.push(actionId);
         }
+        if (isStandard && action.kind !== void 0) {
+          issues.push({ path: `${path}.kind`, message: `standard action '${actionId}' takes its kind from the platform registry \u2014 omit kind` });
+        }
+        if (isStandard && action.defaultBinding !== void 0) {
+          issues.push({ path: `${path}.defaultBinding`, message: `standard action '${actionId}' takes its bindings from the platform registry \u2014 omit defaultBinding` });
+        }
         if (action.kind !== void 0 && (typeof action.kind !== "string" || !["button", "toggle", "vec2"].includes(action.kind))) {
           issues.push({ path: `${path}.kind`, message: "must be one of: button, toggle, vec2" });
         }
-        if (action.defaultBinding !== void 0) checkBindings(action.defaultBinding, `${path}.defaultBinding`, issues);
+        if (!isStandard && action.defaultBinding !== void 0) checkBindings(action.defaultBinding, `${path}.defaultBinding`, issues);
         for (const key of Object.keys(action)) {
           if (!["id", "kind", "defaultBinding"].includes(key)) issues.push({ path: `${path}.${key}`, message: "unknown field (allowed: id, kind, defaultBinding)" });
         }
@@ -371,7 +690,10 @@ var ABILITY_V1_JSON_SCHEMA = {
   required: ["schemaVersion", "id", "version", "title", "system", "activation", "configSchema", "entry"],
   properties: {
     $schema: { type: "string", description: "Editor convenience \u2014 ignored by the validator." },
-    schemaVersion: { const: 1, description: "Payload schema version. Post-freeze changes bump this (ability-v2), never edit v1." },
+    schemaVersion: {
+      const: 1,
+      description: "Payload schema version. Post-freeze changes bump this (ability-v2), never edit v1. One deliberate pre-public exception (2026-07-20): bare STANDARD character action ids became legal in `actions` \u2014 a backward-compatible loosening (every previously-valid manifest still validates). The freeze is absolute once the platform is public."
+    },
     id: {
       type: "string",
       pattern: ABILITY_ID_PATTERN,
@@ -459,7 +781,10 @@ var ABILITY_V1_JSON_SCHEMA = {
         additionalProperties: false,
         required: ["id"],
         properties: {
-          id: { type: "string", description: "Qualified action id '<abilityId>.<action>', e.g. 'fly.toggle'." },
+          id: {
+            type: "string",
+            description: "Qualified action id '<abilityId>.<action>' (e.g. 'fly.toggle') \u2014 or a bare STANDARD character action id (e.g. 'primary', 'reload'): the platform registry then owns kind + bindings, so omit both fields."
+          },
           kind: { enum: ["button", "toggle", "vec2"], default: "button", description: "Action kind (mirrors the system input service)." },
           defaultBinding: {
             type: "object",
@@ -526,7 +851,7 @@ var ABILITY_V1_JSON_SCHEMA = {
 
 // src/core/identity.ts
 var SYSTEM_ID = "humanoid-character";
-var SYSTEM_VERSION = "0.2.2";
+var SYSTEM_VERSION = "0.2.7";
 var SKELETON_STANDARD = "helix-humanoid@1";
 var SYSTEM_IDENTITY = { id: SYSTEM_ID, version: SYSTEM_VERSION, skeleton: SKELETON_STANDARD };
 export {