@hyperframes/parsers 0.7.15

package/dist/springEase.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Damped harmonic oscillator solver for GSAP CustomEase spring curves.
+ *
+ * Generates an SVG path data string compatible with `CustomEase.create(id, data)`.
+ * The solver supports underdamped (bouncy), critically damped, and overdamped
+ * spring configurations. Output is normalized to x ∈ [0,1] with y starting at 0
+ * and settling to 1.
+ */
+interface SpringPreset {
+    name: string;
+    label: string;
+    mass: number;
+    stiffness: number;
+    damping: number;
+}
+declare const SPRING_PRESETS: SpringPreset[];
+/**
+ * Solve a damped harmonic oscillator and return a GSAP CustomEase data string.
+ *
+ * The output is an SVG path (`M0,0 L... L...`) that CustomEase.create() accepts.
+ * The curve is normalized so x spans [0,1] and the spring settles at y = 1.
+ *
+ * @param mass - Spring mass (> 0)
+ * @param stiffness - Spring stiffness constant (> 0)
+ * @param damping - Damping coefficient (> 0)
+ * @param steps - Number of sample points (default 120)
+ */
+declare function generateSpringEaseData(mass: number, stiffness: number, damping: number, steps?: number): string;
+
+export { SPRING_PRESETS, type SpringPreset, generateSpringEaseData };

package/dist/springEase.js

@@ -0,0 +1,44 @@
+// src/springEase.ts
+var SPRING_PRESETS = [
+  { name: "spring-gentle", label: "Gentle", mass: 1, stiffness: 100, damping: 15 },
+  { name: "spring-bouncy", label: "Bouncy", mass: 1, stiffness: 180, damping: 12 },
+  { name: "spring-stiff", label: "Stiff", mass: 1, stiffness: 300, damping: 20 },
+  { name: "spring-wobbly", label: "Wobbly", mass: 1, stiffness: 120, damping: 8 },
+  { name: "spring-heavy", label: "Heavy", mass: 3, stiffness: 200, damping: 20 }
+];
+function generateSpringEaseData(mass, stiffness, damping, steps = 120) {
+  const w0 = Math.sqrt(stiffness / mass);
+  const zeta = damping / (2 * Math.sqrt(stiffness * mass));
+  let settleDuration;
+  if (zeta < 1) {
+    settleDuration = Math.min(5 / (zeta * w0), 10);
+  } else {
+    const decayRate = zeta * w0 - w0 * Math.sqrt(zeta * zeta - 1);
+    settleDuration = Math.min(4 / Math.max(decayRate, 0.01), 10);
+  }
+  const simDuration = Math.max(settleDuration, 1);
+  const segments = ["M0,0"];
+  for (let i = 1; i <= steps; i++) {
+    const t = i / steps;
+    const simT = t * simDuration;
+    let value;
+    if (zeta < 1) {
+      const wd = w0 * Math.sqrt(1 - zeta * zeta);
+      value = 1 - Math.exp(-zeta * w0 * simT) * (Math.cos(wd * simT) + zeta * w0 / wd * Math.sin(wd * simT));
+    } else if (zeta === 1) {
+      value = 1 - (1 + w0 * simT) * Math.exp(-w0 * simT);
+    } else {
+      const s1 = -w0 * (zeta - Math.sqrt(zeta * zeta - 1));
+      const s2 = -w0 * (zeta + Math.sqrt(zeta * zeta - 1));
+      value = 1 + (s1 * Math.exp(s2 * simT) - s2 * Math.exp(s1 * simT)) / (s2 - s1);
+    }
+    segments.push(`${t.toFixed(4)},${value.toFixed(4)}`);
+  }
+  segments[segments.length - 1] = "1,1";
+  return `${segments[0]} L${segments.slice(1).join(" ")}`;
+}
+export {
+  SPRING_PRESETS,
+  generateSpringEaseData
+};
+//# sourceMappingURL=springEase.js.map

package/dist/springEase.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/springEase.ts"],"sourcesContent":["/**\n * Damped harmonic oscillator solver for GSAP CustomEase spring curves.\n *\n * Generates an SVG path data string compatible with `CustomEase.create(id, data)`.\n * The solver supports underdamped (bouncy), critically damped, and overdamped\n * spring configurations. Output is normalized to x ∈ [0,1] with y starting at 0\n * and settling to 1.\n */\n\nexport interface SpringPreset {\n  name: string;\n  label: string;\n  mass: number;\n  stiffness: number;\n  damping: number;\n}\n\nexport const SPRING_PRESETS: SpringPreset[] = [\n  { name: \"spring-gentle\", label: \"Gentle\", mass: 1, stiffness: 100, damping: 15 },\n  { name: \"spring-bouncy\", label: \"Bouncy\", mass: 1, stiffness: 180, damping: 12 },\n  { name: \"spring-stiff\", label: \"Stiff\", mass: 1, stiffness: 300, damping: 20 },\n  { name: \"spring-wobbly\", label: \"Wobbly\", mass: 1, stiffness: 120, damping: 8 },\n  { name: \"spring-heavy\", label: \"Heavy\", mass: 3, stiffness: 200, damping: 20 },\n];\n\n/**\n * Solve a damped harmonic oscillator and return a GSAP CustomEase data string.\n *\n * The output is an SVG path (`M0,0 L... L...`) that CustomEase.create() accepts.\n * The curve is normalized so x spans [0,1] and the spring settles at y = 1.\n *\n * @param mass - Spring mass (> 0)\n * @param stiffness - Spring stiffness constant (> 0)\n * @param damping - Damping coefficient (> 0)\n * @param steps - Number of sample points (default 120)\n */\nexport function generateSpringEaseData(\n  mass: number,\n  stiffness: number,\n  damping: number,\n  steps = 120,\n): string {\n  const w0 = Math.sqrt(stiffness / mass);\n  const zeta = damping / (2 * Math.sqrt(stiffness * mass));\n\n  // Determine simulation duration: time until oscillation settles within threshold of 1.0.\n  // Underdamped: ~5 time constants. Critically/overdamped: characteristic decay time.\n  let settleDuration: number;\n  if (zeta < 1) {\n    settleDuration = Math.min(5 / (zeta * w0), 10);\n  } else {\n    const decayRate = zeta * w0 - w0 * Math.sqrt(zeta * zeta - 1);\n    settleDuration = Math.min(4 / Math.max(decayRate, 0.01), 10);\n  }\n  const simDuration = Math.max(settleDuration, 1);\n\n  const segments: string[] = [\"M0,0\"];\n\n  for (let i = 1; i <= steps; i++) {\n    const t = i / steps;\n    const simT = t * simDuration;\n    let value: number;\n\n    if (zeta < 1) {\n      // Underdamped — oscillates before settling\n      const wd = w0 * Math.sqrt(1 - zeta * zeta);\n      value =\n        1 -\n        Math.exp(-zeta * w0 * simT) *\n          (Math.cos(wd * simT) + ((zeta * w0) / wd) * Math.sin(wd * simT));\n    } else if (zeta === 1) {\n      // Critically damped — fastest approach without oscillation\n      value = 1 - (1 + w0 * simT) * Math.exp(-w0 * simT);\n    } else {\n      // Overdamped — slow exponential approach\n      const s1 = -w0 * (zeta - Math.sqrt(zeta * zeta - 1));\n      const s2 = -w0 * (zeta + Math.sqrt(zeta * zeta - 1));\n      value = 1 + (s1 * Math.exp(s2 * simT) - s2 * Math.exp(s1 * simT)) / (s2 - s1);\n    }\n\n    segments.push(`${t.toFixed(4)},${value.toFixed(4)}`);\n  }\n\n  // Force exact endpoint\n  segments[segments.length - 1] = \"1,1\";\n\n  return `${segments[0]} L${segments.slice(1).join(\" \")}`;\n}\n"],"mappings":";AAiBO,IAAM,iBAAiC;AAAA,EAC5C,EAAE,MAAM,iBAAiB,OAAO,UAAU,MAAM,GAAG,WAAW,KAAK,SAAS,GAAG;AAAA,EAC/E,EAAE,MAAM,iBAAiB,OAAO,UAAU,MAAM,GAAG,WAAW,KAAK,SAAS,GAAG;AAAA,EAC/E,EAAE,MAAM,gBAAgB,OAAO,SAAS,MAAM,GAAG,WAAW,KAAK,SAAS,GAAG;AAAA,EAC7E,EAAE,MAAM,iBAAiB,OAAO,UAAU,MAAM,GAAG,WAAW,KAAK,SAAS,EAAE;AAAA,EAC9E,EAAE,MAAM,gBAAgB,OAAO,SAAS,MAAM,GAAG,WAAW,KAAK,SAAS,GAAG;AAC/E;AAaO,SAAS,uBACd,MACA,WACA,SACA,QAAQ,KACA;AACR,QAAM,KAAK,KAAK,KAAK,YAAY,IAAI;AACrC,QAAM,OAAO,WAAW,IAAI,KAAK,KAAK,YAAY,IAAI;AAItD,MAAI;AACJ,MAAI,OAAO,GAAG;AACZ,qBAAiB,KAAK,IAAI,KAAK,OAAO,KAAK,EAAE;AAAA,EAC/C,OAAO;AACL,UAAM,YAAY,OAAO,KAAK,KAAK,KAAK,KAAK,OAAO,OAAO,CAAC;AAC5D,qBAAiB,KAAK,IAAI,IAAI,KAAK,IAAI,WAAW,IAAI,GAAG,EAAE;AAAA,EAC7D;AACA,QAAM,cAAc,KAAK,IAAI,gBAAgB,CAAC;AAE9C,QAAM,WAAqB,CAAC,MAAM;AAElC,WAAS,IAAI,GAAG,KAAK,OAAO,KAAK;AAC/B,UAAM,IAAI,IAAI;AACd,UAAM,OAAO,IAAI;AACjB,QAAI;AAEJ,QAAI,OAAO,GAAG;AAEZ,YAAM,KAAK,KAAK,KAAK,KAAK,IAAI,OAAO,IAAI;AACzC,cACE,IACA,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,KACvB,KAAK,IAAI,KAAK,IAAI,IAAM,OAAO,KAAM,KAAM,KAAK,IAAI,KAAK,IAAI;AAAA,IACpE,WAAW,SAAS,GAAG;AAErB,cAAQ,KAAK,IAAI,KAAK,QAAQ,KAAK,IAAI,CAAC,KAAK,IAAI;AAAA,IACnD,OAAO;AAEL,YAAM,KAAK,CAAC,MAAM,OAAO,KAAK,KAAK,OAAO,OAAO,CAAC;AAClD,YAAM,KAAK,CAAC,MAAM,OAAO,KAAK,KAAK,OAAO,OAAO,CAAC;AAClD,cAAQ,KAAK,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,IAAI,MAAM,KAAK;AAAA,IAC5E;AAEA,aAAS,KAAK,GAAG,EAAE,QAAQ,CAAC,CAAC,IAAI,MAAM,QAAQ,CAAC,CAAC,EAAE;AAAA,EACrD;AAGA,WAAS,SAAS,SAAS,CAAC,IAAI;AAEhC,SAAO,GAAG,SAAS,CAAC,CAAC,KAAK,SAAS,MAAM,CAAC,EAAE,KAAK,GAAG,CAAC;AACvD;","names":[]}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@hyperframes/parsers",
+  "version": "0.7.15",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/heygen-com/hyperframes",
+    "directory": "packages/parsers"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json",
+    "./gsap-parser": {
+      "import": "./dist/gsapParserExports.js",
+      "types": "./dist/gsapParserExports.d.ts"
+    },
+    "./gsap-parser-acorn": {
+      "import": "./dist/gsapParserAcorn.js",
+      "types": "./dist/gsapParserAcorn.d.ts"
+    },
+    "./gsap-writer-acorn": {
+      "import": "./dist/gsapWriterAcorn.js",
+      "types": "./dist/gsapWriterAcorn.d.ts"
+    },
+    "./gsap-constants": {
+      "import": "./dist/gsapConstants.js",
+      "types": "./dist/gsapConstants.d.ts"
+    },
+    "./spring-ease": {
+      "import": "./dist/springEase.js",
+      "types": "./dist/springEase.d.ts"
+    },
+    "./hf-ids": {
+      "import": "./dist/hfIds.js",
+      "types": "./dist/hfIds.d.ts"
+    },
+    "./gsap-parser-recast": {
+      "import": "./dist/gsapParser.js",
+      "types": "./dist/gsapParser.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.27.0",
+    "acorn": "^8.17.0",
+    "acorn-walk": "^8.3.5",
+    "linkedom": "^0.18.12",
+    "magic-string": "^0.30.21",
+    "recast": "^0.23.11"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "tsup": "^8.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4",
+    "@hyperframes/core": "0.7.15"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}