{"_id":"@aikdna/kdna-react","_rev":"8-9534139aa12284797cd8f5b48d149846","name":"@aikdna/kdna-react","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"@aikdna/kdna-react","version":"0.1.0","keywords":["kdna","kdna-react","react","components","hooks","judgment-asset"],"license":"Apache-2.0","_id":"@aikdna/kdna-react@0.1.0","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"homepage":"https://github.com/aikdna/kdna-react","bugs":{"url":"https://github.com/aikdna/kdna-react/issues"},"dist":{"shasum":"0cbe956bb22f1342c42bcc0aba4b7ec7668def17","tarball":"https://registry.npmjs.org/@aikdna/kdna-react/-/kdna-react-0.1.0.tgz","fileCount":13,"integrity":"sha512-bEryJ7Y+V9kG9bf7GuZEkIOdhLJSz/8SmBe54CgD/uz4kUDoAGLB+s0sH6j2yCVMVgLC+Ur8BER0tmgyeGXToA==","signatures":[{"sig":"MEYCIQChD3/tymd6ksL38NIlzRIuTNmPx6gJ388O+tXq6lVg1wIhAO80CmdLB5pmOtc//+aKTz4WYwV7GVsx0D1rAwd/l0Vj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33725},"type":"module","engines":{"node":">=18"},"exports":{".":"./src/index.js"},"gitHead":"5ca68e75c04862ebdd123e7d1e4e3d5badad7a76","scripts":{"ci":"npm test && npm run build && npm pack --dry-run --json","test":"node --test tests/**/*.test.js","build":"node scripts/build.js"},"_npmUser":{"name":"code2mp4","email":"hi@code2mp4.com"},"repository":{"url":"git+https://github.com/aikdna/kdna-react.git","type":"git"},"_npmVersion":"10.9.8","description":"React components and hooks for building KDNA-integrated web applications — file dropzone, load-plan gate, password unlock, license activation, and asset inspector.","directories":{},"_nodeVersion":"22.22.3","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"react":"^18.3.1","react-dom":"^18.3.1"},"peerDependencies":{"react":">=18","react-dom":">=18"},"_npmOperationalInternal":{"tmp":"tmp/kdna-react_0.1.0_1783068081314_0.5834960273034429","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aikdna/kdna-react","version":"0.1.1","keywords":["kdna","kdna-react","react","components","hooks","judgment-asset"],"license":"Apache-2.0","_id":"@aikdna/kdna-react@0.1.1","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"homepage":"https://github.com/aikdna/kdna-react","bugs":{"url":"https://github.com/aikdna/kdna-react/issues"},"dist":{"shasum":"eaf9173fcd0717280733419d9c97b23949a2fcda","tarball":"https://registry.npmjs.org/@aikdna/kdna-react/-/kdna-react-0.1.1.tgz","fileCount":14,"integrity":"sha512-FLrrNQV+n2ZLDchqNUclgddESBKDwPBsdTiP9xzjx4TUGepB0MHMjsdgb2NwlZbrDggREOWtl6PKZytbd0TMzg==","signatures":[{"sig":"MEUCIHaAxhXS+66DcE+AI0ZuKPJr8IZAViQURWzpPHUr6BaiAiEAsQad8bJv1++LwuL6fz9cTgkXvER+FVJ0y0JQZ+mgAM4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aikdna%2fkdna-react@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":35315},"type":"module","engines":{"node":">=18"},"exports":{".":"./src/index.js"},"gitHead":"f19bfac23dc54430a542c35db79f8e3460f5bbd5","scripts":{"ci":"npm test && npm run lint && npm run build && npm pack --dry-run --json","lint":"node scripts/lint.js","test":"node --test tests/react.test.js","build":"node scripts/build.js","prepublishOnly":"npm run ci"},"_npmUser":{"name":"code2mp4","email":"hi@code2mp4.com"},"repository":{"url":"git+https://github.com/aikdna/kdna-react.git","type":"git"},"_npmVersion":"10.9.8","description":"React components and hooks for building KDNA-integrated web applications — file dropzone, load-plan gate, password unlock, license activation, and asset inspector.","directories":{},"_nodeVersion":"22.23.1","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"react":"^18.3.1","react-dom":"^18.3.1"},"peerDependencies":{"react":">=18","react-dom":">=18"},"_npmOperationalInternal":{"tmp":"tmp/kdna-react_0.1.1_1783089248061_0.34749723604249105","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@aikdna/kdna-react","version":"0.1.2","keywords":["kdna","kdna-react","react","components","hooks","judgment-asset"],"license":"Apache-2.0","_id":"@aikdna/kdna-react@0.1.2","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"homepage":"https://github.com/aikdna/kdna-react","bugs":{"url":"https://github.com/aikdna/kdna-react/issues"},"dist":{"shasum":"0b0b12b34cb20e7de7c3057c227e1fc0fb552546","tarball":"https://registry.npmjs.org/@aikdna/kdna-react/-/kdna-react-0.1.2.tgz","fileCount":16,"integrity":"sha512-NClqSw6xEhWb9soh5z3Gn7l4PFJhBJ4pueSYlhsrUvHERtuOD4SioB6ie8UdLb7JrGx+Scpt+FAfwyFvISuwcg==","signatures":[{"sig":"MEUCIHzuDRWBUmxAHZ0kgjJrTDokzmQAHGmvPNs+3pEfGvlfAiEApqZ5tRfdNuFZ47wayrQ1bCuBvO0XYob4aUq6Fuu8Gn4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38327},"type":"module","engines":{"node":">=18"},"exports":{".":"./src/index.js"},"gitHead":"72ff6dcd692290863482ee91839b5ac1fa830000","scripts":{"ci":"npm test && npm run lint && npm run build && npm pack --dry-run --json","lint":"node scripts/lint.js","test":"node --test tests/react.test.js","build":"node scripts/build.js","prepublishOnly":"npm run ci"},"_npmUser":{"name":"code2mp4","email":"hi@code2mp4.com"},"repository":{"url":"git+https://github.com/aikdna/kdna-react.git","type":"git"},"_npmVersion":"10.9.8","description":"React components and hooks for building KDNA-integrated web applications — file dropzone, load-plan gate, password unlock, license activation, and asset inspector.","directories":{},"_nodeVersion":"22.22.3","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"react":"^18.3.1","react-dom":"^18.3.1"},"peerDependencies":{"react":">=18","react-dom":">=18"},"_npmOperationalInternal":{"tmp":"tmp/kdna-react_0.1.2_1783732581745_0.7457048445749235","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aikdna/kdna-react","version":"0.2.0","keywords":["kdna","kdna-react","react","components","hooks","judgment-asset"],"license":"Apache-2.0","_id":"@aikdna/kdna-react@0.2.0","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"homepage":"https://github.com/aikdna/kdna-react","bugs":{"url":"https://github.com/aikdna/kdna-react/issues"},"dist":{"shasum":"84713f668b43976530bd23dfca7a5110d027cc29","tarball":"https://registry.npmjs.org/@aikdna/kdna-react/-/kdna-react-0.2.0.tgz","fileCount":17,"integrity":"sha512-+EAVFLTNF8WZ2W3w4Lv8ZOzcFxcCcKItSOa9Ea7f7nI0GzkpuIjXGkzoIQxkw9CvafOrXRSqORMaYTfcvr2WFQ==","signatures":[{"sig":"MEYCIQCm6f8hXPzppSRgs5aUgNVo/z7un7wQ8+bYARzPD8WrIQIhANg5ahDragi1mVpEGTkeav0HUR8zDwAQUTsg6RMlkYfd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aikdna%2fkdna-react@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":59204},"type":"module","types":"./src/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./src/index.d.ts","default":"./src/index.js"}},"gitHead":"b012419be197a5f3ce8d1e4b13cf9552cadef069","scripts":{"ci":"npm test && npm run typecheck && npm run lint && npm run build && npm pack --dry-run --json","lint":"node scripts/lint.js","test":"node --test tests/react.test.js","build":"node scripts/build.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run ci"},"_npmUser":{"name":"code2mp4","email":"hi@code2mp4.com"},"repository":{"url":"git+https://github.com/aikdna/kdna-react.git","type":"git"},"_npmVersion":"10.9.8","description":"React components and hooks for building KDNA-integrated web applications — file dropzone, load-plan gate, password unlock, license activation, and asset inspector.","directories":{},"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"devDependencies":{"react":"^18.3.1","react-dom":"^18.3.1","typescript":"^5.9.3"},"peerDependencies":{"react":">=18","react-dom":">=18"},"_npmOperationalInternal":{"tmp":"tmp/kdna-react_0.2.0_1783900879379_0.5626494999418663","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@aikdna/kdna-react","version":"0.3.0","keywords":["kdna","kdna-react","react","components","hooks","judgment-asset"],"license":"Apache-2.0","_id":"@aikdna/kdna-react@0.3.0","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"homepage":"https://github.com/aikdna/kdna-react","bugs":{"url":"https://github.com/aikdna/kdna-react/issues"},"dist":{"shasum":"954b6b64527e067d4c6e89752406650291170848","tarball":"https://registry.npmjs.org/@aikdna/kdna-react/-/kdna-react-0.3.0.tgz","fileCount":18,"integrity":"sha512-kyylKWlpe5vzrRTlHgqYutU0ul5AsDmMqgwAMyN4IzWUCoZmGO712ZnHM8Esu/GsgEoHFc0fKI6SAmyocGYsxQ==","signatures":[{"sig":"MEYCIQCItp02wRrW8S3vOvZvDW4VZHp3LHKTdTbFKd5Dj2UxiAIhAOxD4bhpTgIPxPhH2ceBHp9XHp9Ou1jq9xxWaHQOah9K","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aikdna%2fkdna-react@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":302437},"type":"module","types":"./src/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./src/index.d.ts","default":"./src/index.js"}},"gitHead":"986f2956e07f357b2bd92a499b4e9153871c5e6b","scripts":{"ci":"npm run ci:boundary && npm run validators:check && npm test && npm run typecheck && npm run lint && npm run build && npm run size && npm run public:check && npm run naming:check && npm run package:runtime-check && npm pack --dry-run --json","lint":"node scripts/lint.js","size":"node scripts/size.js","test":"node --test tests/react.test.js tests/components.test.js tests/release-context.test.cjs","build":"node scripts/build.js","typecheck":"tsc --noEmit","ci:boundary":"node scripts/check-ci-boundary.js && node scripts/test-ci-boundary-hostile.js","naming:check":"node scripts/check-naming-integrity.js","public:check":"node scripts/check-public-surface.js","prepublishOnly":"npm run ci","release:context":"node scripts/verify-release-context.cjs","validators:check":"node scripts/generate-runtime-validators.js --check","validators:generate":"node scripts/generate-runtime-validators.js --write","package:runtime-check":"node scripts/check-packed-runtime-boundary.js","test:web-stack-integration":"node --test tests/web-stack-integration.test.js"},"_npmUser":{"name":"code2mp4","email":"hi@code2mp4.com"},"repository":{"url":"git+https://github.com/aikdna/kdna-react.git","type":"git"},"_npmVersion":"10.9.8","description":"React components and hooks for building KDNA-integrated web applications — file dropzone, load-plan gate, password unlock, license activation, and asset inspector.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@aikdna/kdna-web-client":"0.2.2"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.17.1","react":"^18.3.1","esbuild":"^0.25.6","react-dom":"^18.3.1","typescript":"^5.9.3","ajv-formats":"^3.0.1","@types/react":"18.3.31","@aikdna/kdna-core":"0.20.0","react-test-renderer":"18.3.1","@aikdna/kdna-web-server":"0.3.0","@aikdna/kdna-activation-server":"0.2.0"},"peerDependencies":{"react":">=18 <20","react-dom":">=18 <20"},"_npmOperationalInternal":{"tmp":"tmp/kdna-react_0.3.0_1784370542750_0.8058594363730447","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@aikdna/kdna-react","version":"0.4.0","description":"React components and hooks for building KDNA-integrated web applications — file dropzone, load-plan gate, password unlock, license activation, and asset inspector.","type":"module","exports":{".":{"types":"./src/index.d.ts","default":"./src/index.js"}},"types":"./src/index.d.ts","scripts":{"ci":"npm run ci:boundary && npm run validators:check && npm test && npm run typecheck && npm run lint && npm run build && npm run size && npm run public:check && npm run naming:check && npm run package:runtime-check && npm pack --dry-run --json","ci:boundary":"node scripts/check-ci-boundary.js && node scripts/test-ci-boundary-hostile.js","test":"node --test tests/react.test.js tests/components.test.js tests/regexp-safety.test.js tests/release-context.test.cjs","test:web-stack-integration":"node --test tests/web-stack-integration.test.js","typecheck":"tsc --noEmit","lint":"node scripts/lint.js","build":"node scripts/build.js","size":"node scripts/size.js","validators:generate":"node scripts/generate-runtime-validators.js --write","validators:check":"node scripts/generate-runtime-validators.js --check","naming:check":"node scripts/check-naming-integrity.js","public:check":"node scripts/check-public-surface.js","package:runtime-check":"node scripts/check-packed-runtime-boundary.js","release:context":"node scripts/verify-release-context.cjs","prepublishOnly":"npm run ci"},"engines":{"node":">=20"},"peerDependencies":{"react":">=18 <20","react-dom":">=18 <20"},"devDependencies":{"@aikdna/kdna-activation-server":"0.2.0","@aikdna/kdna-core":"0.20.0","@aikdna/kdna-web-server":"0.3.0","@types/react":"18.3.31","ajv":"^8.17.1","ajv-formats":"^3.0.1","esbuild":"^0.25.6","react":"^18.3.1","react-dom":"^18.3.1","react-test-renderer":"18.3.1","typescript":"^5.9.3"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/aikdna/kdna-react.git"},"bugs":{"url":"https://github.com/aikdna/kdna-react/issues"},"homepage":"https://github.com/aikdna/kdna-react","keywords":["kdna","kdna-react","react","components","hooks","judgment-asset"],"dependencies":{"@aikdna/kdna-web-client":"0.3.0"},"_id":"@aikdna/kdna-react@0.4.0","gitHead":"32cadf1e9b04a143cd95415b59de4f73186575e5","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-mz2BDPPYuaM+eFAanev5Qw2Wq5yOmr9kF0RaOoVDoUoTSSnqDENCCOttZoC1EU3bWQfP9xG/iXFDhyDgR5unXw==","shasum":"45fc48607988edb9769b43a30aa3c645a780de31","tarball":"https://registry.npmjs.org/@aikdna/kdna-react/-/kdna-react-0.4.0.tgz","fileCount":18,"unpackedSize":314242,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aikdna%2fkdna-react@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEIQZ897+zcY6U0uhwW+qJx4JmY15OsBGx1uc6PgYtjvAiBCBjLuTvNjG1K6fmcjbE9bn8YNztRvkmJoLCL59WqmEw=="}]},"_npmUser":{"name":"code2mp4","email":"hi@code2mp4.com"},"directories":{},"maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kdna-react_0.4.0_1786162635223_0.8605202174343347"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-03T08:41:21.118Z","modified":"2026-08-08T04:17:15.694Z","0.1.0":"2026-07-03T08:41:21.470Z","0.1.1":"2026-07-03T14:34:08.196Z","0.1.2":"2026-07-11T01:16:21.882Z","0.2.0":"2026-07-13T00:01:19.538Z","0.3.0":"2026-07-18T10:29:02.942Z","0.4.0":"2026-08-08T04:17:15.370Z"},"bugs":{"url":"https://github.com/aikdna/kdna-react/issues"},"license":"Apache-2.0","homepage":"https://github.com/aikdna/kdna-react","keywords":["kdna","kdna-react","react","components","hooks","judgment-asset"],"repository":{"type":"git","url":"git+https://github.com/aikdna/kdna-react.git"},"description":"React components and hooks for building KDNA-integrated web applications — file dropzone, load-plan gate, password unlock, license activation, and asset inspector.","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"readme":"# @aikdna/kdna-react\n\n**React components and hooks for KDNA-integrated web applications.**\n\n> **Status:** Experimental published React integration at its exact package\n> coordinate. Component availability is not a complete Host-experience or\n> production-readiness claim.\n\nDrop in `<KDNAFileDropzone>` to let users select a `.kdna` file.\nUse `<KDNALoadPlanGate>` to render content only when the asset is\nloaded. Wrap `<KDNAPasswordUnlockDialog>` around any encrypted asset.\n\nNetworking, bounded response parsing, public-field projection, and Runtime\nCapsule validation come from the exact `@aikdna/kdna-web-client@0.2.2`\nruntime dependency. Pair the components with `@aikdna/kdna-web-server@0.3.0`\nor a compatible server. Password and license inputs exist briefly in the\nbrowser form state, are cleared before and after each request, and are never\npersisted by this package. Decryption remains server-side.\n\n> New to KDNA? → [KDNA Core](https://github.com/aikdna/kdna)\n>\n> Need browser utilities without React? →\n> [@aikdna/kdna-web-client](https://github.com/aikdna/kdna-web-client)\n>\n> Need the server-side adapter? →\n> [@aikdna/kdna-web-server](https://github.com/aikdna/kdna-web-server)\n\n[![npm](https://img.shields.io/npm/v/@aikdna/kdna-react)](https://www.npmjs.com/package/@aikdna/kdna-react)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)\n\n---\n\n## Install\n\n```bash\nnpm install @aikdna/kdna-react\n```\n\nNode.js 20 or later is required for SSR, testing, and build tooling. React 18\nor 19 is supported as a peer dependency. npm installs the exact Web Client\nruntime automatically. The components call the KDNA server through the\n`endpoint` props you provide.\n\n---\n\n## Quick start\n\n```jsx\nimport {\n  KDNAFileDropzone,\n  KDNALoadPlanGate,\n  KDNAPasswordUnlockDialog,\n  KDNAAssetInspector,\n} from '@aikdna/kdna-react'\nimport { useState } from 'react'\n\nfunction UploadedKDNAViewer({ fileId, inspect }) {\n  const [unlockedContent, setUnlockedContent] = useState(null)\n\n  if (unlockedContent) {\n    return <pre>{JSON.stringify(unlockedContent, null, 2)}</pre>\n  }\n\n  return (\n    <KDNALoadPlanGate fileId={fileId} endpoint=\"/api/kdna\">\n      {({ status, content }) =>\n        status === 'locked' ? (\n          <KDNAPasswordUnlockDialog\n            fileId={fileId}\n            endpoint=\"/api/kdna\"\n            onUnlock={(result) => setUnlockedContent(result.content)}\n          />\n        ) : status === 'loaded' ? (\n          <pre>{JSON.stringify(content, null, 2)}</pre>\n        ) : (\n          <KDNAAssetInspector inspect={inspect} />\n        )\n      }\n    </KDNALoadPlanGate>\n  )\n}\n\nexport function KDNAViewer() {\n  return (\n    <KDNAFileDropzone endpoint=\"/api/kdna\">\n      {({ fileId, inspect }) => fileId\n        ? <UploadedKDNAViewer key={fileId} fileId={fileId} inspect={inspect} />\n        : <p>Select a .kdna file to begin.</p>}\n    </KDNAFileDropzone>\n  )\n}\n```\n\nFile selection is explicit authority for this operation. Applications that\npersist an attachment must show exact identity, digest, scope, and reason and\nprovide disable/switch/rollback controls. These components do not infer\nauthorization from uploaded-file presence.\n\n---\n\n## Components\n\n### `<KDNAFileDropzone>`\n\nA drag-and-drop and click-to-browse file selector for `.kdna` files.\nCalls `/api/kdna/inspect` on selection and provides the result to\nchildren via render props.\n\n```jsx\n<KDNAFileDropzone endpoint=\"/api/kdna\">\n  {({ inspect, loading, error }) => (\n    <p>{error ? `Upload failed (${error.code || 'KDNA_UPLOAD_FAILED'}).`\n      : loading ? 'Uploading…' : inspect?.domain}</p>\n  )}\n</KDNAFileDropzone>\n```\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `endpoint` | `string` | required | Base URL of the KDNA server adapter |\n| `onError` | `(err: Error) => void` | — | Called when upload or inspect fails |\n| `maxSizeBytes` | `number` | `10485760` | Reject files larger than this |\n| `disabled` | `boolean` | `false` | Disable browse and drop interactions |\n| `className` | `string` | — | Added to the root element |\n| `label` | `string` | `'Choose a KDNA file'` | Accessible label for the hidden file input |\n| `children` | `render prop` | required | Receives `{ file, fileId, inspect, loading, error, reset }` |\n\n→ [Full reference](./docs/components/KDNAFileDropzone.md)\n\n---\n\n### `<KDNALoadPlanGate>`\n\nEvaluates the LoadPlan and manages the full state machine:\n`idle → checking → ready | locked | error`, then auto-loads ready\nassets and exposes loaded content when available.\n\n```jsx\n<KDNALoadPlanGate fileId={fileId} endpoint=\"/api/kdna\" profile=\"compact\">\n  {({ status, content, missing, loading, load }) => { /* ... */ }}\n</KDNALoadPlanGate>\n```\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `fileId` | `string` | required | File ID from `<KDNAFileDropzone>` or `uploadKDNA` |\n| `endpoint` | `string` | required | Base URL of the KDNA server adapter |\n| `profile` | `string` | `'compact'` | Load profile to request |\n| `children` | `render prop` | required | Receives state object |\n\n→ [Full reference](./docs/components/KDNALoadPlanGate.md)\n\n---\n\n### `<KDNAPasswordUnlockDialog>`\n\nA modal dialog that prompts the user for a password, submits it\nto `/load`, and calls `onUnlock` with the result.\n\n```jsx\n<KDNAPasswordUnlockDialog\n  fileId={fileId}\n  endpoint=\"/api/kdna\"\n  onUnlock={(result) => setContent(result.content)}\n  onCancel={() => setShowDialog(false)}\n/>\n```\n\n| Prop | Type | Default | Description |\n|------|------|---------|-------------|\n| `fileId` | `string` | required | |\n| `endpoint` | `string` | required | |\n| `profile` | `string` | `'compact'` | |\n| `onUnlock` | `(result) => void` | — | Called on successful load |\n| `onCancel` | `() => void` | — | Called when dialog is dismissed |\n| `onError` | `(err: Error) => void` | — | Called when unlock fails |\n| `hint` | `string \\| null` | — | Password hint text |\n| `title` | `string` | `'Unlock asset'` | Dialog title |\n\n→ [Full reference](./docs/components/KDNAPasswordUnlockDialog.md)\n\n---\n\n### `<KDNALicenseActivationForm>`\n\nAccepts a license key, calls `/activate`, and provides a structurally bounded\nentitlement record containing the server-provided signature on success. The\ninput is password-masked and cleared before and after the request. The browser\nchecks response shape, active state, lease, expiry, and binding. The optional\n`client` is a caller-declared label, not authorization authority; allowlist\nenforcement and signature verification remain authoritative server/runtime\nresponsibility.\n\n```jsx\n<KDNALicenseActivationForm\n  domain=\"kdna:creator:asset\"\n  endpoint=\"/api/kdna\"\n  machineFingerprint={sha256DeviceFingerprint}\n  client=\"my-kdna-app\"\n  onActivated={(entitlement) => setEntitlement(entitlement)}\n/>\n```\n\nSupply `machineFingerprint` only when your application has an issuer-approved,\ncanonical 64-character lowercase SHA-256 device fingerprint. The component\ndoes not invent hardware identity. Omit it for an unbound license.\n\n→ [Full reference](./docs/components/KDNALicenseActivationForm.md)\n\n---\n\n### `<KDNAAssetInspector>`\n\nRead-only display of the bounded public `/inspect` projection. Shows domain,\nversion, title, description, current LoadPlan state/action, default and\navailable profiles, and encryption status.\n\n```jsx\n<KDNAAssetInspector inspect={inspect} />\n```\n\n→ [Full reference](./docs/components/KDNAAssetInspector.md)\n\n---\n\n## Hooks\n\n### `useKDNA(options?)`\n\nManage load-plan state and explicit `/load` calls for a file that\nhas already been uploaded to the server.\n\n```js\nconst { content, status, error, load } = useKDNA({\n  fileId,\n  profile: 'compact',\n  endpoint: '/api/kdna',\n})\n\nif (status === 'ready') await load()\n```\n\n→ [Full reference](./docs/hooks/useKDNA.md)\n\n---\n\n### `useKDNALoadPlan(options?)`\n\nManage the load-plan state machine for a file that has already\nbeen uploaded.\n\n```js\nconst { status, missing, refresh, plan } = useKDNALoadPlan({\n  fileId,\n  endpoint: '/api/kdna',\n})\n```\n\n→ [Full reference](./docs/hooks/useKDNALoadPlan.md)\n\n---\n\n## Styling\n\nComponents are intentionally unstyled. Bring your own\nCSS, or wrap the render-prop state in your app's design system.\n\n## Consumption traces\n\nApplications that use the KDNA consumption runtime can render a trace alongside\ntheir own UI. Every public trace helper, viewer, and `useTrace` projection\nvalidates the complete JudgmentTrace schema closure pinned to an audited KDNA\nCore commit and fails closed on unknown or inconsistent nested evidence. They\nkeep Capsule delivery, Host execution, semantic consumption, and conformance\nas separate evidence layers. A correlated response proves delivery and\nexecution; it does not prove that a model semantically consumed the judgment\nor that the result conforms to it.\n\nThe viewer exposes the primary asset identity, budget comparison, result\ndigest, and provenance without rendering free-form warning or error messages;\nit shows only warning counts and bounded issue codes/phases. `useTrace` returns\nthe validated trace evidence to application code, which must still treat\nproducer-supplied strings as untrusted and avoid logging them. Browser\nvalidation proves schema conformance only; authoritative cryptographic and\nsemantic conformance checks remain server-side KDNA Core responsibilities.\nThe package exports matching TypeScript declarations for the complete public\nJavaScript surface.\n\n---\n\n## Related packages\n\n| Package | Role |\n|---------|------|\n| [`@aikdna/kdna-core`](https://github.com/aikdna/kdna) | KDNA format and runtime |\n| [`@aikdna/kdna-web-server`](https://github.com/aikdna/kdna-web-server) | Server-side adapter |\n| [`@aikdna/kdna-web-client`](https://github.com/aikdna/kdna-web-client) | Browser utilities (no React) |\n| [`create-kdna-web-app`](https://github.com/aikdna/create-kdna-web-app) | Project scaffolding CLI |\n\n---\n\n## License\n\nApache 2.0 — see [LICENSE](./LICENSE).\n","readmeFilename":"README.md"}