{"_id":"@cadbuildr/sdk-react","_rev":"5-205d354ede698cd6c4eaafe17b77962c","name":"@cadbuildr/sdk-react","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"@cadbuildr/sdk-react","version":"0.1.0","keywords":["cad","configurator","react","three-fiber","cadbuildr"],"license":"MIT","_id":"@cadbuildr/sdk-react@0.1.0","maintainers":[{"name":"clemcadbuildr","email":"clement@cadbuildr.com"}],"homepage":"https://github.com/cadbuildr/sdk-react#readme","bugs":{"url":"https://github.com/cadbuildr/sdk-react/issues"},"dist":{"shasum":"500d0c5d8c3e7f6904abda0c12132f5e67e9b8af","tarball":"https://registry.npmjs.org/@cadbuildr/sdk-react/-/sdk-react-0.1.0.tgz","fileCount":35,"integrity":"sha512-wKDhvrYwVD4r6GY1C6sjCeRGqeArPreag8YdMipbw5gjbZ7Tucn50cCdjC59NTHIs+9laIW38p13QXUcYlYNdQ==","signatures":[{"sig":"MEUCIH/RsBSxPF2vPCInBtXKCuMfxpx5d/ofYwyU0TdImz3uAiEArvBQYPShw77K9KIMFhuBa+SrNZv9ZGm1+05lsu71ZEY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60495},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"7bf0ca01949f59ea9c1cb8a7d58eead5f37286cb","scripts":{"build":"rm -f tsconfig.tsbuildinfo && tsc","prepack":"npm run build","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"clemcadbuildr","email":"clement@cadbuildr.com"},"repository":{"url":"git+https://github.com/cadbuildr/sdk-react.git","type":"git"},"_npmVersion":"11.3.0","description":"React SDK for embedding CADbuildr-authored configurators on partner storefronts.","directories":{},"sideEffects":false,"_nodeVersion":"24.1.0","dependencies":{"@cadbuildr/cad-kernel-r3f":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.0.0","three":"^0.169.0","react-dom":"^19.0.0","typescript":"^5.7.2","@types/node":"^22.10.0","@types/react":"^19.0.0","@types/three":"^0.169.0","@types/react-dom":"^19.0.0","@react-three/drei":"^10.7.7","@react-three/fiber":"^9.5.0"},"peerDependencies":{"react":">=18.2.0","three":">=0.160.0","react-dom":">=18.2.0","@react-three/drei":">=9.96.0","@react-three/fiber":">=8.16.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk-react_0.1.0_1779426878798_0.8449316694551308","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cadbuildr/sdk-react","version":"0.1.1","keywords":["cad","configurator","react","three-fiber","cadbuildr"],"license":"MIT","_id":"@cadbuildr/sdk-react@0.1.1","maintainers":[{"name":"clemcadbuildr","email":"clement@cadbuildr.com"}],"homepage":"https://github.com/cadbuildr/sdk-react#readme","bugs":{"url":"https://github.com/cadbuildr/sdk-react/issues"},"dist":{"shasum":"0181d6a3b133f9985cd9af5641af91dec146f998","tarball":"https://registry.npmjs.org/@cadbuildr/sdk-react/-/sdk-react-0.1.1.tgz","fileCount":35,"integrity":"sha512-wQa6FG+HZaYOXXX1u77U6wn+6eUxCTlgI2yB3nw7W300a1UX0EZWqlagoYS8YsxNtS1iPB4ytQxONdbyTtNozw==","signatures":[{"sig":"MEQCIAUIxp/YpkOQCnQe8apvu0EB6KqJlYev+f/gKxPqvJCaAiBdMSgCrPrUfSWP29807/wcyXKkvurlBWszuv8JwbuJlA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60495},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"7bf0ca01949f59ea9c1cb8a7d58eead5f37286cb","scripts":{"build":"rm -f tsconfig.tsbuildinfo && tsc","prepack":"npm run build","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"clemcadbuildr","email":"clement@cadbuildr.com"},"repository":{"url":"git+https://github.com/cadbuildr/sdk-react.git","type":"git"},"_npmVersion":"11.3.0","description":"React SDK for embedding CADbuildr-authored configurators on partner storefronts.","directories":{},"sideEffects":false,"_nodeVersion":"24.1.0","dependencies":{"@cadbuildr/cad-kernel-r3f":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.0.0","three":"^0.169.0","react-dom":"^19.0.0","typescript":"^5.7.2","@types/node":"^22.10.0","@types/react":"^19.0.0","@types/three":"^0.169.0","@types/react-dom":"^19.0.0","@react-three/drei":"^10.7.7","@react-three/fiber":"^9.5.0"},"peerDependencies":{"react":">=18.2.0","three":">=0.160.0","react-dom":">=18.2.0","@react-three/drei":">=9.96.0","@react-three/fiber":">=8.16.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk-react_0.1.1_1779427090417_0.8116599643194111","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@cadbuildr/sdk-react","version":"0.2.0","keywords":["cad","configurator","react","three-fiber","cadbuildr"],"license":"MIT","_id":"@cadbuildr/sdk-react@0.2.0","maintainers":[{"name":"clemcadbuildr","email":"clement@cadbuildr.com"}],"homepage":"https://github.com/cadbuildr/sdk-react#readme","bugs":{"url":"https://github.com/cadbuildr/sdk-react/issues"},"dist":{"shasum":"1cbe8498080385e964afc6c222c4f7d598bc013e","tarball":"https://registry.npmjs.org/@cadbuildr/sdk-react/-/sdk-react-0.2.0.tgz","fileCount":35,"integrity":"sha512-aekBzmh22mwhTMC9YeQRmlqY8Gg1BZj7YFumktKbntKCZPKutEmfoq5GxPc5UQE9pPFtV9epoVbket1CSNFv9A==","signatures":[{"sig":"MEUCIQDjHL4C7Uylw3S/f4QsOR89dtT5wqI4KAhuP613P98PyQIge2wgxQf7e0KyhLAmvX0h3PdT2uhCldZDnj8tic6RGRQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71856},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"2c3c4e4d4551a39f7abc6067921a689548926fd7","scripts":{"build":"rm -f tsconfig.tsbuildinfo && tsc","prepack":"npm run build","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"clemcadbuildr","email":"clement@cadbuildr.com"},"repository":{"url":"git+https://github.com/cadbuildr/sdk-react.git","type":"git"},"_npmVersion":"11.3.0","description":"React SDK for embedding CADbuildr-authored configurators on partner storefronts.","directories":{},"sideEffects":false,"_nodeVersion":"24.1.0","dependencies":{"@cadbuildr/cad-kernel-r3f":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.0.0","three":"^0.169.0","react-dom":"^19.0.0","typescript":"^5.7.2","@types/node":"^22.10.0","@types/react":"^19.0.0","@types/three":"^0.169.0","@types/react-dom":"^19.0.0","@react-three/drei":"^10.7.7","@react-three/fiber":"^9.5.0"},"peerDependencies":{"react":">=18.2.0","three":">=0.160.0","react-dom":">=18.2.0","@react-three/drei":">=9.96.0","@react-three/fiber":">=8.16.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk-react_0.2.0_1779460460392_0.846983558292199","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@cadbuildr/sdk-react","version":"0.3.0","keywords":["cad","configurator","react","three-fiber","cadbuildr"],"license":"MIT","_id":"@cadbuildr/sdk-react@0.3.0","maintainers":[{"name":"clemcadbuildr","email":"clement@cadbuildr.com"}],"homepage":"https://github.com/cadbuildr/sdk-react#readme","bugs":{"url":"https://github.com/cadbuildr/sdk-react/issues"},"dist":{"shasum":"3ffb00a23a03c691f4d55e3855ec5b7790bb8fc7","tarball":"https://registry.npmjs.org/@cadbuildr/sdk-react/-/sdk-react-0.3.0.tgz","fileCount":43,"integrity":"sha512-Kf+oyyvGfYomoePdRw3j/2Ezngz0JeL1zQlqandg2f6mA6RKbbwCK6OKDSgWyOsc/zrNymM1Z/y4hfpR5sBTzQ==","signatures":[{"sig":"MEUCICyEj8nMAYiXVWtz0lZIxXO76SZC5W+klq1iynN7lrOnAiEArT+bKAGyQlT6b4D/RxN07PZvbgQkj3tKKEYJpsH5Yyk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":104610},"main":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"rm -f tsconfig.tsbuildinfo && tsc","prepack":"npm run build","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"clemcadbuildr","email":"clement@cadbuildr.com"},"repository":{"url":"git+https://github.com/cadbuildr/sdk-react.git","type":"git"},"_npmVersion":"11.3.0","description":"React SDK for embedding CADbuildr-authored configurators on partner storefronts.","directories":{},"sideEffects":false,"_nodeVersion":"24.1.0","dependencies":{"@cadbuildr/cad-kernel-r3f":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.0.0","three":"^0.169.0","react-dom":"^19.0.0","typescript":"^5.7.2","@types/node":"^22.10.0","@types/react":"^19.0.0","@types/three":"^0.169.0","@types/react-dom":"^19.0.0","@react-three/drei":"^10.7.7","@react-three/fiber":"^9.5.0"},"peerDependencies":{"react":">=18.2.0","three":">=0.160.0","react-dom":">=18.2.0","@react-three/drei":">=9.96.0","@react-three/fiber":">=8.16.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk-react_0.3.0_1782444891338_0.6829738276459536","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@cadbuildr/sdk-react","version":"0.4.0","description":"React SDK for embedding CADbuildr-authored configurators on partner storefronts.","main":"./dist/index.js","types":"./dist/index.d.ts","sideEffects":false,"scripts":{"build":"rm -f tsconfig.tsbuildinfo && tsc","type-check":"tsc --noEmit","prepack":"npm run build","prepublishOnly":"npm run build"},"keywords":["cad","configurator","react","three-fiber","cadbuildr"],"repository":{"type":"git","url":"git+https://github.com/cadbuildr/sdk-react.git"},"license":"MIT","publishConfig":{"access":"public"},"peerDependencies":{"@react-three/drei":">=9.96.0","@react-three/fiber":">=8.16.0","react":">=18.2.0","react-dom":">=18.2.0","three":">=0.160.0"},"dependencies":{"@cadbuildr/cad-kernel-r3f":"^0.2.0"},"devDependencies":{"@react-three/drei":"^10.7.7","@react-three/fiber":"^9.5.0","@types/node":"^22.10.0","@types/react":"^19.0.0","@types/react-dom":"^19.0.0","@types/three":"^0.169.0","react":"^19.0.0","react-dom":"^19.0.0","three":"^0.169.0","typescript":"^5.7.2"},"_id":"@cadbuildr/sdk-react@0.4.0","bugs":{"url":"https://github.com/cadbuildr/sdk-react/issues"},"homepage":"https://github.com/cadbuildr/sdk-react#readme","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-wgxAinpg71xQkzGSlOtIQJ2p0nhx2yevQZ80/37z9LBSGdLNONItFi0zMg8vRio34qHvFJT+w1Myhoh8jEh6Qg==","shasum":"80b5191900ce3adc8b027ae0e21a9f32c2e531e0","tarball":"https://registry.npmjs.org/@cadbuildr/sdk-react/-/sdk-react-0.4.0.tgz","fileCount":47,"unpackedSize":114700,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBJ8tDttet+v4Vy+fLO0xIi5htUZXn1TL97+Lq9t335OAiAMU0/zBlDUUjSjO44ttGkwVMjc6Zidr4cpfQx41IRv+w=="}]},"_npmUser":{"name":"clemcadbuildr","email":"clement@cadbuildr.com"},"directories":{},"maintainers":[{"name":"clemcadbuildr","email":"clement@cadbuildr.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk-react_0.4.0_1782526572016_0.3891040152937493"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-22T05:14:38.597Z","modified":"2026-06-27T02:16:12.309Z","0.1.0":"2026-05-22T05:14:38.940Z","0.1.1":"2026-05-22T05:18:10.555Z","0.2.0":"2026-05-22T14:34:20.529Z","0.3.0":"2026-06-26T03:34:51.472Z","0.4.0":"2026-06-27T02:16:12.173Z"},"bugs":{"url":"https://github.com/cadbuildr/sdk-react/issues"},"license":"MIT","homepage":"https://github.com/cadbuildr/sdk-react#readme","keywords":["cad","configurator","react","three-fiber","cadbuildr"],"repository":{"type":"git","url":"git+https://github.com/cadbuildr/sdk-react.git"},"description":"React SDK for embedding CADbuildr-authored configurators on partner storefronts.","maintainers":[{"name":"clemcadbuildr","email":"clement@cadbuildr.com"}],"readme":"# @cadbuildr/sdk-react\n\nReact SDK for embedding CADbuildr-authored configurators on partner storefronts.\n\nThe SDK ships:\n\n- `CadbuildrProvider` — context provider that wires a kernel-api session token,\n  project id, and `KernelApiClient`.\n- `CadbuildrViewer` — a `<Canvas>` component (React Three Fiber) that consumes a\n  DAG and renders the resulting STL mesh. Pass `showTree` to overlay an assembly\n  tree with per-node show/hide toggles, and `defaultHiddenNodeNames` to start\n  with whole sub-assemblies hidden (e.g. `[\"components\"]` to show a bare PCB).\n  Shows a loading wheel while a render is in flight (`showLoadingOverlay`, on by\n  default; pass `loading` to extend it over your own bootstrap). Cold-start 5xx /\n  network errors are retried once automatically.\n- `CadbuildrLoadingOverlay` — the standalone loading wheel (self-contained SVG,\n  no CSS/deps), if you want it outside the viewer.\n- `CadbuildrPartsTree` — the standalone assembly tree (show/hide per node), if\n  you want to place it outside the viewer. Helpers `buildPartsTree`,\n  `isInstanceVisible`, etc. are exported for custom scenes.\n- `CadbuildrParameterForm` — a generic parameter UI driven by the project's\n  `parameter_ui` schema.\n- `useCadbuildrRender(dag)` hook — manual control for partners that want to\n  drive their own rendering.\n\nIt builds on top of [`@cadbuildr/cad-kernel-r3f`](https://github.com/cadbuildr/cad-kernel-r3f)\n(STL rendering) and the hosted CADbuildr kernel-api at\n`https://kernel-api.cadbuildr.com` (or your own deployment).\n\n## Install\n\n```sh\nnpm install @cadbuildr/sdk-react @cadbuildr/cad-kernel-r3f @react-three/fiber @react-three/drei three react react-dom\n```\n\n## Quick start\n\n```tsx\nimport { CadbuildrProvider, CadbuildrViewer } from \"@cadbuildr/sdk-react\";\n\nexport function App() {\n  return (\n    <CadbuildrProvider\n      baseUrl=\"https://kernel-api.cadbuildr.com\"\n      sessionToken={import.meta.env.VITE_CADBUILDR_SESSION_TOKEN}\n      projectKey=\"my-project\"\n    >\n      <CadbuildrViewer dag={myDag} />\n    </CadbuildrProvider>\n  );\n}\n```\n\nSession tokens are short-lived `cbv1.*` JWTs minted by the CADbuildr hub from\na partner SDK key (`cbsdk_*`). See the hub's `/api/v1/sdk/session-tokens`\nendpoint and the `Settings → SDK partner keys` admin UI.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}