{
  "id": "gsap-fa5c18e802b2",
  "sourceId": "gsap",
  "title": "convertToPath()",
  "sourceUrl": "https://demos.gsap.com/demo/converttopath",
  "demoUrl": "https://codepen.io/GreenSock/pen/gagNeR",
  "sourceStatus": "unresolved",
  "sourceReason": "Public page unavailable through web browsing",
  "sourceRevision": null,
  "sourceLicense": null,
  "originalDemoAcquired": false,
  "disposition": "ready_for_independent_study",
  "evidenceBasis": "catalog_linked_api",
  "studyId": "gsap-fa5c18e802b2",
  "sharedStudyCanonicalId": null,
  "label": "Independently authored documentation study; original Pen unavailable",
  "catalogEvidence": {
    "localPath": "artifacts/full-import/gsap/remaining-docs/catalog-evidence.json",
    "sha256": "4f2a4f9aa64456b85b905b562b60d7733629b41026787b3057cba29e8b10de69",
    "bytes": 30117,
    "recordId": "gsap-fa5c18e802b2"
  },
  "sourceInputs": [
    {
      "kind": "authored-study-specification",
      "localPath": "artifacts/full-import/gsap/remaining-docs/study-specs.json",
      "sha256": "cbb89331eda8783b5cf2f173b326b9195eeabfb223374fb60019161d9f46d4a6",
      "bytes": 52279,
      "recordId": "gsap-fa5c18e802b2"
    },
    {
      "kind": "official-catalog-metadata",
      "localPath": "artifacts/full-import/gsap/remaining-docs/catalog-evidence.json",
      "sha256": "4f2a4f9aa64456b85b905b562b60d7733629b41026787b3057cba29e8b10de69",
      "bytes": 30117,
      "recordId": "gsap-fa5c18e802b2"
    },
    {
      "kind": "official-documentation-evidence",
      "localPath": "artifacts/full-import/gsap/remaining-docs/official-documentation-evidence.json",
      "sha256": "bfa25f561e61c597569cf1bc0b3538e6dce4b9985a932775ceab41e665ca24a2",
      "bytes": 11430,
      "recordIds": [
        "convert",
        "morph"
      ]
    },
    {
      "kind": "original-library-source",
      "localPath": "artifacts/full-import/gsap/library/src/gsap-core.js",
      "sha256": "8063816e0e7c3e6c07970fb06feafb06146fd266db5d8346419176b3d496e284",
      "gitBlob": "c673b9e2e0ee04832afb13cb892ae75f503e268c",
      "revision": "13e2b790546426a1a2e0e9b409f3f8dc6d6611f2",
      "sourcePath": "src/gsap-core.js",
      "ranges": [
        {
          "id": "tween-factories",
          "startLine": 2637,
          "endLine": 2657,
          "rangeSha256": "23ae9d51865c9b7966bbc3b6cdbdb560fc790ff19e3b8bb524a3493fbf60c58a"
        }
      ]
    },
    {
      "kind": "original-library-source",
      "localPath": "artifacts/full-import/gsap/library/src/MorphSVGPlugin.js",
      "sha256": "ed1a050ea542e5f7918b079f1a9d7094baa7ca2eef4a03c9700fc975f330859b",
      "gitBlob": "16ca88dddb9dca68d6823e903e87685e031c6a39",
      "revision": "13e2b790546426a1a2e0e9b409f3f8dc6d6611f2",
      "sourcePath": "src/MorphSVGPlugin.js",
      "ranges": [
        {
          "id": "morph-convert-api",
          "startLine": 847,
          "endLine": 854,
          "rangeSha256": "af9fad8bb68b4770c92909a707a270c24fb17ca7be1c4af7f51a90036e1bf532"
        },
        {
          "id": "morph-smooth-endpoint",
          "startLine": 675,
          "endLine": 692,
          "rangeSha256": "b8dd321271beb04d7e3b0f262dc6d550c6568185928a205cf5031ece19d5bab3"
        }
      ]
    },
    {
      "kind": "original-library-source",
      "localPath": "artifacts/full-import/gsap/library/src/utils/paths.js",
      "sha256": "37a33aa0685b114dd21562c7ec348095abaf7be022103b481947a011c1eb42fb",
      "gitBlob": "7c7337ff9923da1a2f95872f37f1551ffe4bb725",
      "revision": "13e2b790546426a1a2e0e9b409f3f8dc6d6611f2",
      "sourcePath": "src/utils/paths.js",
      "ranges": [
        {
          "id": "svg-primitive-conversion",
          "startLine": 164,
          "endLine": 226,
          "rangeSha256": "fe9d4f8a563b0c2b6d52f6517e8ffe6f4a5cfe543a6d80c2a166b0b6f7545d18"
        }
      ]
    }
  ],
  "studiedPrinciple": "Convert SVG primitive elements to path elements and inspect the DOM change before using a converted shape as a morph target.",
  "namedApis": [
    {
      "name": "MorphSVGPlugin.convertToPath(targets, swap)",
      "purpose": "Convert selected primitives; true/default swaps DOM elements and false returns detached paths.",
      "libraryEvidence": [
        "morph-convert-api",
        "svg-primitive-conversion"
      ],
      "documentationEvidence": [
        "convert"
      ]
    },
    {
      "name": "gsap.to(path, {morphSVG: targetPath})",
      "purpose": "Demonstrate an optional next step using the returned path reference.",
      "libraryEvidence": [
        "morph-smooth-endpoint",
        "tween-factories"
      ],
      "documentationEvidence": [
        "morph"
      ]
    }
  ],
  "implementationBrief": {
    "scene": "An authored SVG with a rect, circle, ellipse, line, polyline, and polygon in separate labeled cells. Use local SVG geometry and expose a small tag-name/path-data inspection panel.",
    "controls": [
      {
        "label": "Convert primitives",
        "type": "button",
        "action": "Call convertToPath on the retained primitive node references, save its returned array, then report each current tagName and d attribute."
      },
      {
        "label": "Swap elements",
        "type": "checkbox",
        "action": "Choose true or false for swap before conversion. Explain that false returns paths without inserting them."
      },
      {
        "label": "Morph selected path",
        "type": "button",
        "action": "Enabled after a swapped conversion; morph one returned path to an independently authored closed path."
      },
      {
        "label": "Reset",
        "type": "button",
        "action": "Kill the study tween and rebuild the original authored SVG primitives, then refresh retained node references."
      }
    ],
    "mechanismSteps": [
      "Load core and MorphSVGPlugin, register it, and create the original primitive nodes from the study's own geometry.",
      "Capture node references before conversion. With swap enabled, convertToPath replaces each primitive with a new path, so use the returned nodes for later animation and event bindings.",
      "Display original and resulting element types and whether each returned node is connected. Do not attach a detached return value implicitly when demonstrating swap:false.",
      "For the optional morph keep source and target coordinates in the same viewBox and use only one selected returned path.",
      "Reset by recreating primitives rather than repeatedly converting a prior path and pretending that a new conversion occurred."
    ]
  },
  "authoredDefaults": {
    "svgViewBox": "0 0 600 300",
    "swap": true,
    "morphDurationSeconds": 1,
    "ease": "power1.inOut",
    "pathGeometry": "New primitives and one new closed morph endpoint"
  },
  "verificationRequired": [
    "With swap:true all six returned elements are paths connected to the SVG and the original primitive nodes are disconnected.",
    "With swap:false the original elements remain connected and returned new paths remain detached.",
    "The optional morph uses the returned reference and changes its d attribute; reset restores the original six primitive types.",
    "Compare geometry before and after conversion at two widths, without claiming exact mathematical equality for circular cubic approximations."
  ],
  "unsupportedClaims": [
    "Original composition, assets, timing, breakpoint behavior, and live interaction are not observable in captured frames. This brief does not establish visual fidelity or recover original code.",
    "The catalog's Text Effects category does not establish a text-morphing implementation; the explicit convertToPath API link is the mechanism evidence.",
    "Original shape selection, path art, interaction, and layout are unknown.",
    "Conversion can replace nodes, so listeners bound to the old elements are not assumed to transfer."
  ],
  "dependencies": {
    "package": "gsap",
    "version": "3.15.0",
    "revision": "13e2b790546426a1a2e0e9b409f3f8dc6d6611f2",
    "repository": "https://github.com/greensock/GSAP",
    "plugins": [
      "MorphSVGPlugin"
    ],
    "registration": "gsap.registerPlugin(MorphSVGPlugin) after loading core and those plugin scripts",
    "runtimeCandidates": [
      {
        "path": "dist/gsap.js",
        "localPath": "artifacts/full-import/gsap/library/dist/gsap.js",
        "gitBlob": "ec5ffee3f099bc454f2f1c79cee6a55ba97e7400",
        "sha256": "01effe0e121c22ba0f885a3f091f3dc6d1f0d445c4fba37dcb298e314eca5cfb",
        "bytes": 179557
      },
      {
        "path": "dist/MorphSVGPlugin.js",
        "localPath": "artifacts/full-import/gsap/library/dist/MorphSVGPlugin.js",
        "gitBlob": "40531f708058713a7ad2942b74d0e1442c31431c",
        "sha256": "786b51ffe878fa747bb7e115815d438ec9113bde1303967172c34b129f5472ef",
        "bytes": 55989
      }
    ],
    "license": {
      "name": "GSAP Standard 'No Charge' License (custom, not MIT)",
      "localPath": "artifacts/full-import/gsap/licenses/gsap-standard-license.html",
      "sha256": "bf8536e67b77db780f7db0c14a645f184f554bb19e938d1e52d58986e2f10528",
      "bytes": 6988,
      "url": "https://gsap.com/community/standard-license/"
    },
    "originalDependencyVersionKnown": false
  },
  "runtimeVerified": false,
  "implementationWritten": false
}