@franzenzenhofer/asanakit 0.1.0

package/dist/standards/keypoints.js

@@ -0,0 +1,118 @@
+import { add, fromPolar, lerp, sub } from '../core/vec2.js';
+export const MEDIAPIPE_33 = [
+    'nose', 'left_eye_inner', 'left_eye', 'left_eye_outer', 'right_eye_inner', 'right_eye', 'right_eye_outer',
+    'left_ear', 'right_ear', 'mouth_left', 'mouth_right',
+    'left_shoulder', 'right_shoulder', 'left_elbow', 'right_elbow', 'left_wrist', 'right_wrist',
+    'left_pinky', 'right_pinky', 'left_index', 'right_index', 'left_thumb', 'right_thumb',
+    'left_hip', 'right_hip', 'left_knee', 'right_knee', 'left_ankle', 'right_ankle',
+    'left_heel', 'right_heel', 'left_foot_index', 'right_foot_index',
+];
+export const COCO_17 = [
+    'nose', 'left_eye', 'right_eye', 'left_ear', 'right_ear',
+    'left_shoulder', 'right_shoulder', 'left_elbow', 'right_elbow', 'left_wrist', 'right_wrist',
+    'left_hip', 'right_hip', 'left_knee', 'right_knee', 'left_ankle', 'right_ankle',
+];
+const COCO_EDGES = [
+    [0, 1], [0, 2], [1, 3], [2, 4], [5, 6], [5, 7], [7, 9], [6, 8], [8, 10],
+    [5, 11], [6, 12], [11, 12], [11, 13], [13, 15], [12, 14], [14, 16],
+];
+const MEDIAPIPE_EDGES = [
+    [0, 2], [0, 5], [2, 7], [5, 8], [9, 10],
+    [11, 12], [11, 13], [13, 15], [15, 17], [15, 19], [15, 21],
+    [12, 14], [14, 16], [16, 18], [16, 20], [16, 22],
+    [11, 23], [12, 24], [23, 24], [23, 25], [25, 27], [27, 29], [27, 31],
+    [24, 26], [26, 28], [28, 30], [28, 32],
+];
+/**
+ * The rig has no facial bones, so eyes, ears and mouth are derived from the head
+ * bone's axis. They are approximations by construction - honest ones, and enough
+ * for a consumer that only needs head orientation.
+ */
+const facePoints = (skeleton) => {
+    const head = skeleton.bones.head;
+    const axis = sub(head.end, head.start);
+    const forward = fromPolar(head.worldAngle - 90, 1);
+    const centre = lerp(head.start, head.end, 0.55);
+    const size = Math.hypot(axis[0], axis[1]);
+    const at = (fwd, up, side) => add(add(centre, fromPolar(head.worldAngle, up * size)), fromPolar(head.worldAngle - 90, (fwd + side) * size));
+    return {
+        nose: add(centre, fromPolar(head.worldAngle - 90, 0.42 * size)),
+        left_eye: at(0.3, 0.12, 0.08),
+        left_eye_inner: at(0.32, 0.12, 0.03),
+        left_eye_outer: at(0.26, 0.12, 0.14),
+        right_eye: at(0.3, 0.12, -0.08),
+        right_eye_inner: at(0.32, 0.12, -0.03),
+        right_eye_outer: at(0.26, 0.12, -0.14),
+        left_ear: at(-0.1, 0.06, 0.22),
+        right_ear: at(-0.1, 0.06, -0.22),
+        mouth_left: at(0.3, -0.18, 0.09),
+        mouth_right: at(0.3, -0.18, -0.09),
+        _forward: forward,
+    };
+};
+const heel = (skeleton, side) => {
+    const foot = skeleton.bones[side === 'L' ? 'footL' : 'footR'];
+    return add(foot.start, fromPolar(foot.worldAngle + 180, foot.length * 0.35));
+};
+const hand = (skeleton, side, spread) => {
+    const h = skeleton.bones[side === 'L' ? 'handL' : 'handR'];
+    return add(h.end, fromPolar(h.worldAngle + spread, h.length * 0.3));
+};
+const pointFor = (name, skeleton, face) => {
+    const l = skeleton.landmarks;
+    const table = {
+        left_shoulder: l.shoulderL,
+        right_shoulder: l.shoulderR,
+        left_elbow: l.elbowL,
+        right_elbow: l.elbowR,
+        left_wrist: l.wristL,
+        right_wrist: l.wristR,
+        left_index: l.handTipL,
+        right_index: l.handTipR,
+        left_pinky: hand(skeleton, 'L', 55),
+        right_pinky: hand(skeleton, 'R', 55),
+        left_thumb: hand(skeleton, 'L', -55),
+        right_thumb: hand(skeleton, 'R', -55),
+        left_hip: l.hipJointL,
+        right_hip: l.hipJointR,
+        left_knee: l.kneeL,
+        right_knee: l.kneeR,
+        left_ankle: l.ankleL,
+        right_ankle: l.ankleR,
+        left_foot_index: l.toeL,
+        right_foot_index: l.toeR,
+        left_heel: heel(skeleton, 'L'),
+        right_heel: heel(skeleton, 'R'),
+    };
+    const point = table[name] ?? face[name];
+    if (point === undefined)
+        throw new Error(`No geometry for keypoint "${name}"`);
+    return point;
+};
+export const toKeypoints = (skeleton, format, options = {}) => {
+    const names = format === 'coco17' ? COCO_17 : MEDIAPIPE_33;
+    const face = facePoints(skeleton);
+    const raw = names.map((name) => pointFor(name, skeleton, face));
+    const normalize = options.normalize === true;
+    const xs = raw.map((p) => p[0]);
+    const ys = raw.map((p) => p[1]);
+    const minX = Math.min(...xs);
+    const minY = Math.min(...ys);
+    const span = Math.max(Math.max(...xs) - minX, Math.max(...ys) - minY, 1e-6);
+    return {
+        format,
+        space: normalize ? 'normalized' : 'stature',
+        edges: format === 'coco17' ? COCO_EDGES : MEDIAPIPE_EDGES,
+        keypoints: names.map((name, index) => {
+            const p = raw[index];
+            return {
+                index,
+                name,
+                // Image space is y-down, so normalising also flips the axis.
+                x: normalize ? (p[0] - minX) / span : p[0],
+                y: normalize ? 1 - (p[1] - minY) / span : p[1],
+            };
+        }),
+    };
+};
+//# sourceMappingURL=keypoints.js.map

package/dist/standards/keypoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypoints.js","sourceRoot":"","sources":["../../src/standards/keypoints.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAa,MAAM,iBAAiB,CAAC;AAEvE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB;IACzG,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa;IACpD,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa;IAC3F,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa;IACrF,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa;IAC/E,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB;CACxD,CAAC;AAEX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW;IACxD,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa;IAC3F,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa;CACvE,CAAC;AAEX,MAAM,UAAU,GAA2C;IACzD,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACvE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;CACnE,CAAC;AAEF,MAAM,eAAe,GAA2C;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACvC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACpE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;CACvC,CAAC;AAuBF;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,QAAkB,EAAwB,EAAE;IAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1C,MAAM,EAAE,GAAG,CAAC,GAAW,EAAE,EAAU,EAAE,IAAY,EAAQ,EAAE,CACzD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAEhH,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAC/D,QAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;QAC7B,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACpC,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACpC,SAAS,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC;QAC/B,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC;QACtC,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC;QACtC,QAAQ,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;QAC9B,SAAS,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC;QAChC,UAAU,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAChC,WAAW,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;QAClC,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,QAAkB,EAAE,IAAe,EAAQ,EAAE;IACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,QAAkB,EAAE,IAAe,EAAE,MAAc,EAAQ,EAAE;IACzE,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,QAAkB,EAAE,IAA0B,EAAQ,EAAE;IACtF,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAyB;QAClC,aAAa,EAAE,CAAC,CAAC,SAAS;QAC1B,cAAc,EAAE,CAAC,CAAC,SAAS;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM;QACrB,UAAU,EAAE,CAAC,CAAC,MAAM;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM;QACrB,UAAU,EAAE,CAAC,CAAC,QAAQ;QACtB,WAAW,EAAE,CAAC,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;QACnC,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;QACpC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACpC,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACrC,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,KAAK;QAClB,UAAU,EAAE,CAAC,CAAC,KAAK;QACnB,UAAU,EAAE,CAAC,CAAC,MAAM;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM;QACrB,eAAe,EAAE,CAAC,CAAC,IAAI;QACvB,gBAAgB,EAAE,CAAC,CAAC,IAAI;QACxB,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;KAChC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAAkB,EAClB,MAAsB,EACtB,UAA2B,EAAE,EAChB,EAAE;IACf,MAAM,KAAK,GAAsB,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;IAC9E,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAEhE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;IAE5E,OAAO;QACL,MAAM;QACN,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QAC3C,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe;QACzD,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAS,CAAC;YAC7B,OAAO;gBACL,KAAK;gBACL,IAAI;gBACJ,6DAA6D;gBAC7D,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1C,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAC/C,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC,CAAC"}

package/docs/AUTHORING.md

@@ -0,0 +1,144 @@
+# Authoring poses
+
+A pose is a YAML file. Nothing is drawn imperatively: you describe a body, and asanakit
+solves and renders it. This guide is written to be followed by a person or by a model.
+
+## The coordinate system
+
+Angles are **degrees**, measured **counter-clockwise from the +x axis**:
+
+```
+            90  (up)
+             |
+  180 -------+------- 0   (right, and the way a side-view figure faces)
+             |
+           -90  (down)
+```
+
+The figure is one unit tall (sole to crown). The ground is `y = 0`.
+
+## The two ways to angle a bone
+
+| Block | Meaning | Use it for |
+|---|---|---|
+| `joints:` | rotation **relative to the parent bone**, from anatomical neutral (standing, arms down) | small deviations from standing |
+| `world:` | the bone's **absolute direction** on the page | everything else |
+
+`world` is what you want almost always. "The front thigh points down and back at -125°"
+is something you can reason about and check by eye. Chaining five relative rotations is not.
+
+A bone listed in `world` ignores its rest angle and its parent's rotation. Its **children
+still hang off it**, so pinning the thigh and then flexing the knee with `joints: {shinL: 40}`
+works exactly as you would expect.
+
+> **The single most common mistake:** you tilt the pelvis with `root.rotation` and forget
+> that every unpinned limb rotates with it. Tilt the pelvis to fold forward, and the legs
+> swing up into the air. **If you set `root.rotation`, pin the legs in `world`.**
+
+## Bones you can angle
+
+```
+pelvis  spine  neck  head
+clavicleL/R  upperArmL/R  forearmL/R  handL/R
+hipL/R  thighL/R  shinL/R  footL/R
+```
+
+`root.rotation` aims the pelvis (90 = upright). Rotating a bone rotates everything below it.
+
+Positive `shinL` **flexes the knee** (heel toward the buttock). Positive `forearmL` flexes
+the elbow. Neither joint bends the other way, and the validator will tell you so.
+
+## Landmarks you can point at
+
+Used by `contact`, annotations and props:
+
+```
+hipCenter waist chest neckBase headCenter headTop
+shoulderL/R elbowL/R wristL/R handTipL/R
+hipJointL/R kneeL/R ankleL/R toeL/R
+```
+
+## Views
+
+| view | what it means |
+|---|---|
+| `front` | the figure faces you. Left and right limbs **mirror**: `upperArmL: 90` and `upperArmR: 90` raise both arms outward. |
+| `side` | profile, facing **+x** (to the right). Limbs **do not mirror** - both arms swing the same way, because you see both from the same side. The left/right offset becomes depth and nearly vanishes. |
+| `back` | like `front`. |
+| `three-quarter` | between the two. |
+
+Set `flip: true` to face the other way. Set `mirror: true` to swap which limb does what
+(the other side of an asymmetric asana). Sequences apply both to render "second side".
+
+## Contact points: the thing that keeps you honest
+
+```yaml
+contact: [toeL, toeR, handTipL, handTipR]
+```
+
+This is the pose's claim about which parts of the body are on the floor. `asanakit lint`
+checks it against the solved figure and fails if a hand that was supposed to reach the mat
+is hovering 9 cm above it. **Every pose must declare its contact points.**
+
+## The loop
+
+```bash
+npx tsx src/cli/index.ts lint my-pose                       # anatomy + contact check
+npx tsx src/cli/index.ts render my-pose -o out/p.png -w 500 -h 500 --scale 500
+```
+
+Then **look at the PNG**. Lint proves the pose is physically possible; only your eye proves
+it is the right posture. Iterate until both agree.
+
+## A complete example
+
+```yaml
+asanakit: 1
+id: adho-mukha-svanasana
+name: Downward-Facing Dog
+sanskrit: Adho Mukha Śvānāsana
+discipline: yoga
+family: inversion
+difficulty: 2
+description: An inverted V. Hips lift back and up, heels press down.
+tags: [ashtanga, surya-namaskara-a, inversion]
+breath: exhale
+drishti: nabi-chakra
+cues:
+  - Lift the sit bones, lengthen the spine
+contact: [toeL, toeR, handTipL, handTipR]
+figure:
+  view: side
+  grounded: true
+  root:
+    rotation: -48        # pelvis aims down-and-forward: the torso ramps to the hands
+  world:
+    thighL: -125         # legs ramp down-and-back to the feet
+    thighR: -125
+    shinL: -125          # straight leg: shin collinear with thigh
+    shinR: -125
+    footL: -20
+    footR: -20
+    spine: -48
+    neck: -48
+    head: -48            # head hangs between the arms, in line with the spine
+    upperArmL: -50       # arms continue the line of the spine to the floor
+    upperArmR: -50
+    forearmL: -50
+    forearmR: -50
+    handL: -8            # palm flat
+    handR: -8
+props:
+  - type: mat
+muscles:
+  engaged: [deltoid, triceps, quadriceps, serratus]
+  stretched: [hamstrings, gastrocnemius, latissimus]
+```
+
+## Reference
+
+- `asanakit vocab` prints every joint, landmark, muscle, style and view name.
+- `asanakit schema` prints the JSON Schema for the format.
+- Props: `mat`, `ground`, `block`, `strap`, `wall`, `surfboard`, `wave`.
+- Annotations: `angle`, `line`, `plumb`, `arrow`, `label`, `point`.
+- Muscles for `engaged`/`stretched`: run `asanakit vocab`.

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@franzenzenhofer/asanakit",
+  "version": "0.1.0",
+  "description": "Programmatic stick-figure and anatomical infographic engine for yoga and surf postures. Declarative pose format, deterministic SVG/PNG output, CLI-first, AI-driveable.",
+  "keywords": [
+    "yoga",
+    "surf",
+    "asana",
+    "stick-figure",
+    "anatomy",
+    "infographic",
+    "svg",
+    "png",
+    "pose",
+    "skeleton",
+    "kinematics",
+    "cli",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Franz Enzenhofer",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/franzenzenhofer/asanakit.git"
+  },
+  "homepage": "https://github.com/franzenzenhofer/asanakit#readme",
+  "bugs": {
+    "url": "https://github.com/franzenzenhofer/asanakit/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "asanakit": "dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "poses",
+    "docs/AUTHORING.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/cli/index.js",
+    "dev": "tsx src/cli/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage",
+    "gallery": "tsx scripts/gallery.ts",
+    "verify": "npm run typecheck && npm run lint && npm run test && npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "dependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "commander": "^14.0.1",
+    "culori": "^4.0.2",
+    "d3-path": "^3.1.0",
+    "d3-shape": "^3.2.0",
+    "gl-matrix": "^3.4.4",
+    "svgo": "^4.0.2",
+    "xmlbuilder2": "^4.0.3",
+    "yaml": "^2.8.1",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.38.0",
+    "@types/d3-path": "^3.1.1",
+    "@types/d3-shape": "^3.1.8",
+    "@types/node": "^24.9.2",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.38.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2",
+    "vitest": "^3.2.4"
+  },
+  "allowScripts": {
+    "sharp@0.34.5": true,
+    "esbuild@0.28.1": true,
+    "@resvg/resvg-js@2.6.2": true
+  }
+}

package/poses/surf/bottom-turn.pose.yaml

@@ -0,0 +1,47 @@
+asanakit: 1
+id: bottom-turn
+name: Bottom Turn
+english: Bottom Turn
+discipline: surf
+family: turning
+difficulty: 4
+description: The turn at the base of the wave that sets up everything after it. The surfer compresses deep, drives the weight through the heels and the rail, and reaches the inside arm toward the wave face while the eyes go back up to the lip.
+tags: [surf, turning, rail, power]
+cues:
+  - Compress low and drive from the heels
+  - Look where you want to go - back up at the lip
+contact: [toeL, toeR]
+figure:
+  view: side
+  grounded: true
+  root:
+    rotation: 55
+  world:
+    spine: 45
+    neck: 68
+    head: 82
+    thighL: -25
+    shinL: -100
+    footL: -15
+    thighR: -60
+    shinR: -145
+    footR: -10
+    upperArmL: -5
+    forearmL: 15
+    handL: 20
+    upperArmR: -150
+    forearmR: -140
+    handR: -135
+props:
+  - type: wave
+    amplitude: 0.45
+    length: 3.4
+    y: -0.2
+  - type: surfboard
+    under: [ankleL, ankleR]
+    rotation: 10
+    length: 1.15
+    offset: [0, -0.1]
+muscles:
+  engaged: [quadriceps, gluteus, obliques, erectorSpinae, adductors]
+  stretched: [hipFlexors, latissimus]

package/poses/surf/cutback.pose.yaml

@@ -0,0 +1,47 @@
+asanakit: 1
+id: cutback
+name: Cutback
+english: Cutback
+discipline: surf
+family: turning
+difficulty: 4
+description: The turn that takes the surfer back to the power source. Out on the shoulder the board is swung around by the torso - the chest and both arms lead the rotation back toward the breaking part of the wave, the weight settles over the tail and the front leg extends.
+tags: [surf, turning, rotation, flow]
+cues:
+  - Turn your chest and arms first, the board follows
+  - Weight back over the tail to pivot, not the nose
+contact: [toeL, toeR]
+figure:
+  view: side
+  grounded: true
+  root:
+    rotation: 82
+  world:
+    spine: 100
+    neck: 118
+    head: 145
+    thighL: -45
+    shinL: -105
+    footL: -20
+    thighR: -85
+    shinR: -135
+    footR: -15
+    upperArmL: -178
+    forearmL: -172
+    handL: -170
+    upperArmR: 132
+    forearmR: 158
+    handR: 162
+props:
+  - type: wave
+    amplitude: 0.42
+    length: 3.4
+    y: -0.22
+  - type: surfboard
+    under: [ankleL, ankleR]
+    rotation: 4
+    length: 1.15
+    offset: [0, -0.1]
+muscles:
+  engaged: [obliques, erectorSpinae, gluteus, quadriceps, deltoid]
+  stretched: [pectoralis, hamstrings]

package/poses/surf/duck-dive.pose.yaml

@@ -0,0 +1,47 @@
+asanakit: 1
+id: duck-dive
+name: Duck Dive
+english: Duck Dive
+discipline: surf
+family: prone
+difficulty: 3
+description: How a shortboarder gets under a broken wave. Both arms straighten and drive the nose deep under the water, the head follows it down, and one knee then punches into the tail to sink the whole board while the wave passes overhead.
+tags: [surf, prone, paddling, defensive, shortboard]
+cues:
+  - Straight arms - push the nose down, do not pull it toward you
+  - Knee into the tail only once the nose is already under
+contact: [handTipL, handTipR]
+figure:
+  view: side
+  grounded: true
+  root:
+    rotation: -30
+  world:
+    spine: -38
+    neck: -34
+    head: -30
+    upperArmL: -56
+    forearmL: -56
+    handL: -56
+    upperArmR: -50
+    forearmR: -50
+    handR: -50
+    thighL: 168
+    shinL: 142
+    footL: 150
+    thighR: -175
+    shinR: 95
+    footR: 70
+props:
+  - type: wave
+    amplitude: 0.5
+    length: 3.2
+    y: 0.55
+    facing: left
+  - type: surfboard
+    at: [0.023, 0.108]
+    rotation: -32
+    length: 1.35
+muscles:
+  engaged: [triceps, deltoid, latissimus, rectusAbdominis, hipFlexors]
+  stretched: [pectoralis, quadriceps]

package/poses/surf/noseride.pose.yaml

@@ -0,0 +1,48 @@
+asanakit: 1
+id: noseride
+name: Noseride
+english: Noseride
+discipline: surf
+family: trim
+difficulty: 4
+description: The longboard reward. With the tail held in the wave the surfer walks to the front of the board and stands tall and still on the nose, legs long, arms loose, doing as little as possible while the board trims along the face.
+tags: [surf, longboard, trim, nose, style]
+cues:
+  - Stand tall and quiet - do nothing and let the board trim
+  - Stay behind the tail's hold, never lunge at the nose
+contact: [toeL, toeR]
+figure:
+  view: side
+  grounded: true
+  root:
+    rotation: 90
+  world:
+    spine: 95
+    neck: 90
+    head: 88
+    thighL: -80
+    shinL: -95
+    footL: -15
+    thighR: -100
+    shinR: -112
+    footR: -12
+    upperArmL: -60
+    forearmL: -50
+    handL: -45
+    upperArmR: -112
+    forearmR: -102
+    handR: -100
+props:
+  - type: wave
+    amplitude: 0.3
+    length: 3.6
+    y: -0.18
+    breaking: false
+  - type: surfboard
+    under: [ankleL, ankleR]
+    rotation: -2
+    length: 1.7
+    offset: [-0.5, -0.1]
+muscles:
+  engaged: [gastrocnemius, tibialisAnterior, quadriceps, erectorSpinae]
+  stretched: [hamstrings, pectoralis]

package/poses/surf/paddling.pose.yaml

@@ -0,0 +1,48 @@
+asanakit: 1
+id: paddling
+name: Paddling
+english: Paddling
+discipline: surf
+family: prone
+difficulty: 1
+description: Where ninety percent of surfing actually happens. The surfer lies prone and centred on the deck, chest lifted off the board, legs together over the tail, and pulls through the water one long arm at a time while the other arm recovers.
+tags: [surf, prone, paddling, fundamental, endurance]
+cues:
+  - Chest up, back long - do not lie flat
+  - Reach past your head and pull the water all the way to the hip
+contact: [hipCenter, kneeL, ankleL, ankleR]
+figure:
+  view: side
+  grounded: true
+  root:
+    rotation: 0
+  world:
+    spine: 34
+    neck: 44
+    head: 28
+    upperArmL: 4
+    forearmL: -2
+    handL: -8
+    upperArmR: 145
+    forearmR: 196
+    handR: 200
+    thighL: 180
+    shinL: 180
+    footL: 180
+    thighR: 177
+    shinR: 176
+    footR: 176
+props:
+  - type: wave
+    amplitude: 0.22
+    length: 3.6
+    y: -0.35
+    breaking: false
+  - type: surfboard
+    under: [hipCenter, chest]
+    rotation: 0
+    length: 1.5
+    offset: [-0.12, -0.13]
+muscles:
+  engaged: [latissimus, deltoid, trapezius, erectorSpinae, triceps]
+  stretched: [pectoralis, rectusAbdominis]

package/poses/surf/pop-up.pose.yaml

@@ -0,0 +1,47 @@
+asanakit: 1
+id: pop-up
+name: Pop-Up
+english: Pop-Up
+discipline: surf
+family: transition
+difficulty: 3
+description: The one explosive move that turns a paddler into a surfer. The hands press down on the deck under the chest, the hips lift, the back foot loads the tail and the front foot swings through under the body to land in the stance. It happens in one beat, without a knee ever touching the deck.
+tags: [surf, transition, dynamic, fundamental]
+cues:
+  - Press the deck away and lift the hips first
+  - Swing the front foot under your chest - never through a knee
+contact: [handTipL, handTipR, toeR]
+figure:
+  view: side
+  grounded: true
+  root:
+    rotation: 30
+  world:
+    spine: 26
+    neck: 18
+    head: 10
+    upperArmL: -80
+    forearmL: -85
+    handL: -88
+    upperArmR: -94
+    forearmR: -91
+    handR: -88
+    thighL: -2
+    shinL: -114
+    footL: 5
+    thighR: -145
+    shinR: -152
+    footR: -178
+props:
+  - type: wave
+    amplitude: 0.35
+    length: 3.4
+    y: -0.3
+  - type: surfboard
+    under: [handTipL, toeR]
+    rotation: 0
+    length: 1.3
+    offset: [0, -0.09]
+muscles:
+  engaged: [triceps, pectoralis, deltoid, rectusAbdominis, hipFlexors, serratus]
+  stretched: [hamstrings, gluteus]