{"_id":"@aura-adaptive/aura-ui-adaptor","_rev":"8-952e861cba2d36ec4e344879cbd95a4e","name":"@aura-adaptive/aura-ui-adaptor","dist-tags":{"latest":"2.0.0"},"versions":{"1.0.0":{"name":"@aura-adaptive/aura-ui-adaptor","version":"1.0.0","keywords":["react","adaptive-ui","design-system","personalization","ui-adaptation","accessibility","ml-personalization"],"author":{"name":"Team_Aura"},"license":"MIT","_id":"@aura-adaptive/aura-ui-adaptor@1.0.0","maintainers":[{"name":"findevcode","email":"s.engineering2290@gmail.com"}],"dist":{"shasum":"f5bb72bcf7a7f7349c958da48e04615b0e81b629","tarball":"https://registry.npmjs.org/@aura-adaptive/aura-ui-adaptor/-/aura-ui-adaptor-1.0.0.tgz","fileCount":33,"integrity":"sha512-B1TtsKxcguvQ2uyTPc9OJct2qomr2Kkr9hnIUiN87qrvICXJlLg0Ah0r/xI0VTmLc2FdOt48Tm5HKTbw4ZzS+A==","signatures":[{"sig":"MEUCIQCm1RH93RaJ62+t4PvGxOFjMUYERDwKusLs5BdgQiWW6gIgeqh6/VcK93pxD6UZVXkobRuCooDLt1Ep3+Jc8xFHr0E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":443747},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"},"./package.json":"./package.json"},"gitHead":"6e1f7d15e713d9cab0e80578348f311a4e6d7362","scripts":{"build":"npm run clean && rollup -c","clean":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"","prepublishOnly":"npm run build"},"_npmUser":{"name":"findevcode","email":"s.engineering2290@gmail.com"},"_npmVersion":"10.8.2","description":"React library for ML-driven adaptive UI components based on JSON rules","directories":{},"sideEffects":false,"_nodeVersion":"20.19.5","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.2.3","tslib":"^2.8.1","rollup":"^4.52.4","react-dom":"^19.2.3","typescript":"^5.9.3","@types/react":"^19.2.7","@types/react-dom":"^19.2.3","@rollup/plugin-json":"^6.1.0","@rollup/plugin-commonjs":"^26.0.3","rollup-plugin-typescript2":"^0.36.0","@rollup/plugin-node-resolve":"^15.3.1","rollup-plugin-peer-deps-external":"^2.2.4"},"peerDependencies":{"react":"^18.0.0 || ^19.0.0","react-dom":"^18.0.0 || ^19.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aura-ui-adaptor_1.0.0_1772916775406_0.36608283324249835","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aura-adaptive/aura-ui-adaptor","version":"1.0.1","keywords":["react","adaptive-ui","design-system","personalization","ui-adaptation","accessibility","ml-personalization"],"author":{"name":"Team_Aura"},"license":"MIT","_id":"@aura-adaptive/aura-ui-adaptor@1.0.1","maintainers":[{"name":"findevcode","email":"s.engineering2290@gmail.com"}],"dist":{"shasum":"0d30d96cf6c91d7547142b42e5e2936ad89362c2","tarball":"https://registry.npmjs.org/@aura-adaptive/aura-ui-adaptor/-/aura-ui-adaptor-1.0.1.tgz","fileCount":33,"integrity":"sha512-R5+DreFiNr11IqwfgdPsKAVzYrutJkfzOuLyoP6zw/K4KLPdYvpXP+iRkqKT1FnKxJf22OWfc2M8oPxube9+HQ==","signatures":[{"sig":"MEQCIEJKl9Gv4F1xm7TMUgp7u+GnDIsvdvIOu058qiw+9l+CAiBjnhogReZROjOG7b2Ni8ij8CpV78m/tpmjNn5D/KbYrg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":444821},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"},"./package.json":"./package.json"},"gitHead":"04eb98ce360523c5a9b8a816119dc4e2d2dba85a","scripts":{"build":"npm run clean && rollup -c","clean":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"","prepublishOnly":"npm run build"},"_npmUser":{"name":"findevcode","email":"s.engineering2290@gmail.com"},"_npmVersion":"10.8.2","description":"React library for ML-driven adaptive UI components based on JSON rules","directories":{},"sideEffects":false,"_nodeVersion":"20.19.5","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.2.3","tslib":"^2.8.1","rollup":"^4.52.4","react-dom":"^19.2.3","typescript":"^5.9.3","@types/react":"^19.2.7","@types/react-dom":"^19.2.3","@rollup/plugin-json":"^6.1.0","@rollup/plugin-commonjs":"^26.0.3","rollup-plugin-typescript2":"^0.36.0","@rollup/plugin-node-resolve":"^15.3.1","rollup-plugin-peer-deps-external":"^2.2.4"},"peerDependencies":{"react":"^18.0.0 || ^19.0.0","react-dom":"^18.0.0 || ^19.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aura-ui-adaptor_1.0.1_1772966821735_0.978358066548175","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aura-adaptive/aura-ui-adaptor","version":"1.1.0","keywords":["react","adaptive-ui","design-system","personalization","ui-adaptation","accessibility","ml-personalization"],"author":{"name":"Team_Aura"},"license":"MIT","_id":"@aura-adaptive/aura-ui-adaptor@1.1.0","maintainers":[{"name":"findevcode","email":"s.engineering2290@gmail.com"}],"dist":{"shasum":"b6c96dfa377bd7d19a61b0fac5fb91a39aa349cf","tarball":"https://registry.npmjs.org/@aura-adaptive/aura-ui-adaptor/-/aura-ui-adaptor-1.1.0.tgz","fileCount":47,"integrity":"sha512-fE5HNe5v4i64eRJ4B6vEYyHDSwHF9Yy0ayXcRYHFXXlKcF/Vq3+qcZjJ5srMP0fycUNRovYXmUnbhXsfzMuXOA==","signatures":[{"sig":"MEUCIFPbo52wgw42+Av0sphuPuKucT8u/5oeFwgDyk01o8BLAiEAyTPaLoK1adv2pRSGnRds/rkWSyfX76tbnEodFnKqYlo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":816981},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"},"./package.json":"./package.json"},"gitHead":"2ff60c26e02f4fa4406a39270c2143280018ef49","scripts":{"build":"npm run clean && rollup -c","clean":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"","prepublishOnly":"npm run build"},"_npmUser":{"name":"findevcode","email":"s.engineering2290@gmail.com"},"_npmVersion":"10.8.2","description":"React library for ML-driven adaptive UI components based on JSON rules","directories":{},"sideEffects":false,"_nodeVersion":"18.20.8","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.2.3","tslib":"^2.8.1","dotenv":"^17.3.1","rollup":"^4.52.4","react-dom":"^19.2.3","typescript":"^5.9.3","@types/node":"^25.3.5","@types/react":"^19.2.7","@types/react-dom":"^19.2.3","@rollup/plugin-json":"^6.1.0","@rollup/plugin-replace":"^6.0.3","@rollup/plugin-commonjs":"^26.0.3","rollup-plugin-typescript2":"^0.36.0","@rollup/plugin-node-resolve":"^15.3.1","rollup-plugin-peer-deps-external":"^2.2.4"},"peerDependencies":{"react":"^18.0.0 || ^19.0.0","react-dom":"^18.0.0 || ^19.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aura-ui-adaptor_1.1.0_1773074949498_0.4008761228211595","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@aura-adaptive/aura-ui-adaptor","version":"1.1.1","keywords":["react","adaptive-ui","design-system","personalization","ui-adaptation","accessibility","ml-personalization"],"author":{"name":"Team_Aura"},"license":"MIT","_id":"@aura-adaptive/aura-ui-adaptor@1.1.1","maintainers":[{"name":"findevcode","email":"s.engineering2290@gmail.com"}],"dist":{"shasum":"9309aa44ad950464d84294a889a6f5920c497e29","tarball":"https://registry.npmjs.org/@aura-adaptive/aura-ui-adaptor/-/aura-ui-adaptor-1.1.1.tgz","fileCount":48,"integrity":"sha512-woNP0AbcHDNH5vCCvX31v9n9++v9mN6DIvPw7oaqV7GHgx061ajj52EIuuaNbfQlVJKQc3csrNh4alcIhc035w==","signatures":[{"sig":"MEYCIQD25ThPttyu8NaNYymXzfiLuWhRtrK511dXufM0CJ7TCwIhAMjW9sNAMWUtN7JEW/1ji1O1AGHudA1dElQ/g6cDd3Sq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2250505},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"},"./package.json":"./package.json"},"gitHead":"29c7c3f26051d41e17aa9b4df2967aba0e9756d2","scripts":{"build":"npm run clean && rollup -c","clean":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"","prepublishOnly":"npm run build"},"_npmUser":{"name":"findevcode","email":"s.engineering2290@gmail.com"},"_npmVersion":"11.11.0","description":"React library for ML-driven adaptive UI components based on JSON rules","directories":{},"sideEffects":false,"_nodeVersion":"25.8.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.2.3","tslib":"^2.8.1","dotenv":"^17.3.1","rollup":"^4.52.4","react-dom":"^19.2.3","typescript":"^5.9.3","@types/node":"^25.3.5","@types/react":"^19.2.7","@types/react-dom":"^19.2.3","@rollup/plugin-json":"^6.1.0","@rollup/plugin-replace":"^6.0.3","@rollup/plugin-commonjs":"^26.0.3","@rollup/plugin-typescript":"^12.3.0","@rollup/plugin-node-resolve":"^15.3.1","rollup-plugin-peer-deps-external":"^2.2.4"},"peerDependencies":{"react":"^18.0.0 || ^19.0.0","react-dom":"^18.0.0 || ^19.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aura-ui-adaptor_1.1.1_1777897804906_0.6188871144336046","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@aura-adaptive/aura-ui-adaptor","version":"2.0.0","description":"React library for ML-driven adaptive UI components based on JSON rules","main":"dist/index.cjs","module":"dist/index.mjs","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"},"./package.json":"./package.json"},"sideEffects":false,"scripts":{"clean":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"","build":"npm run clean && rollup -c","prepublishOnly":"npm run build"},"peerDependencies":{"react":"^18.0.0 || ^19.0.0","react-dom":"^18.0.0 || ^19.0.0"},"devDependencies":{"@rollup/plugin-commonjs":"^26.0.3","@rollup/plugin-json":"^6.1.0","@rollup/plugin-node-resolve":"^15.3.1","@rollup/plugin-replace":"^6.0.3","@rollup/plugin-typescript":"^12.3.0","@types/node":"^25.3.5","@types/react":"^19.2.7","@types/react-dom":"^19.2.3","dotenv":"^17.3.1","react":"^19.2.3","react-dom":"^19.2.3","rollup":"^4.52.4","rollup-plugin-peer-deps-external":"^2.2.4","tslib":"^2.8.1","typescript":"^5.9.3"},"type":"module","keywords":["react","adaptive-ui","design-system","personalization","ui-adaptation","accessibility","ml-personalization"],"publishConfig":{"access":"public"},"engines":{"node":">=18"},"author":{"name":"Team_Aura"},"license":"MIT","gitHead":"aa912c94875865b77c1c3cab1bb35396c78bd202","_id":"@aura-adaptive/aura-ui-adaptor@2.0.0","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-rmbilKj1G4fG/ozX163G42T3tGP6iGrfpNL2PrFqGL5AROrhGqFhB/Ecc1tk1BO26R8L2iTwOyzpX9yd/K2sMw==","shasum":"2cfc43d283bb042972a0de7fed6053bf2e63579a","tarball":"https://registry.npmjs.org/@aura-adaptive/aura-ui-adaptor/-/aura-ui-adaptor-2.0.0.tgz","fileCount":54,"unpackedSize":2604714,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGXKFr8lhh9xY55EYJPHRzfcEf2E6Mv1cXHC/osCa5ybAiEA6yo3EOJZLWSsoKv8AE70Brzeei3HReV2JXTG7WwIMQw="}]},"_npmUser":{"name":"findevcode","email":"s.engineering2290@gmail.com"},"directories":{},"maintainers":[{"name":"findevcode","email":"s.engineering2290@gmail.com"},{"name":"keizer2002","email":"pahanabhayawardhane@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aura-ui-adaptor_2.0.0_1778174266750_0.436528986502285"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-07T20:52:55.280Z","modified":"2026-05-07T17:17:47.115Z","1.0.0":"2026-03-07T20:52:55.574Z","1.0.1":"2026-03-08T10:47:01.917Z","1.1.0":"2026-03-09T16:49:09.674Z","1.1.1":"2026-05-04T12:30:05.112Z","2.0.0":"2026-05-07T17:17:46.972Z"},"author":{"name":"Team_Aura"},"license":"MIT","keywords":["react","adaptive-ui","design-system","personalization","ui-adaptation","accessibility","ml-personalization"],"description":"React library for ML-driven adaptive UI components based on JSON rules","maintainers":[{"name":"findevcode","email":"s.engineering2290@gmail.com"},{"name":"keizer2002","email":"pahanabhayawardhane@gmail.com"}],"readme":"# @aura-adaptive/aura-ui-adaptor\n\n[](https://www.npmjs.com/package/@aura-adaptive/aura-ui-adaptor)\n[](https://opensource.org/licenses/MIT)\n\n**@aura-adaptive/aura-ui-adaptor** is a token-first React adaptive UI runtime and component library. It adapts UI presentation in real time from AURA profile data, exposes token-driven CSS variables and `a-*` utility classes, and keeps the optional adaptive component layer for teams that want ready-made primitives.\n\n## Features\n\n- **ML-Driven Personalization:** Automatically adapts UI components using profiles from the AURA browser extension.\n- **Extensive Component Library:** Offers a wide range of adaptive primitives (Buttons, Cards, Inputs, Tables, Dialogs, etc.).\n- **Accessibility First:** Applies adaptive design tokens for typography, spacing, contrast, motion, layout, and interaction comfort.\n- **Behavior-Aware Adaptation:** Uses lightweight runtime interaction signals such as click rate, scroll speed, and interaction timing to support adaptive UI refinement.\n- **Token-Driven Utility Classes:** Injects optional `a-*` utility classes such as `a-card`, `a-readable`, and `a-action-primary`.\n- **Adaptive CSS Variables:** Updates `:root` variables whenever the active ML profile changes.\n- **Seamless Integration:** Easy-to-use `AdaptiveProvider` and hooks for effortless adoption in existing React applications.\n- **Fallback Mechanism:** Built-in prediction models ensure a graceful fallback when the extension is not available.\n\n## Installation\n\nInstall the package via npm:\n\n```bash\nnpm install @aura-adaptive/aura-ui-adaptor\n```\n\nOr using yarn:\n\n```bash\nyarn add @aura-adaptive/aura-ui-adaptor\n```\nOr using pnpm:\n\n```bash\npnpm add @aura-adaptive/aura-ui-adaptor\n```\n\n> **Note:** This package requires `react` and `react-dom` (v18 or v19) as peer dependencies.\n\n## Quick Start\n\nWrap your application's root with the `AdaptiveProvider` and start using the adaptive components.\n\n```tsx\nimport React from 'react';\nimport {\n AdaptiveProvider,\n AdaptiveButton,\n AdaptiveText,\n AdaptiveProfileInspector,\n} from \"@aura-adaptive/aura-ui-adaptor\";\n\nexport function App() {\n return (\n \n \n \n Welcome to AURA\n \n Experience a dynamically adapting user interface.\n \n alert('Clicked!')}>\n Get Started\n \n \n \n \n );\n}\n\n```\n\nNo CSS import is required. `AdaptiveProvider` injects the AURA utility classes once and updates the adaptive CSS variables whenever tokens change.\n\n## AURA Utility Classes\n\nThe utility layer is intentionally small and AURA-specific. Classes describe adaptive UI intent rather than fixed visual values:\n\n- `a-page`, `a-section`, `a-stack`, `a-cluster`, `a-flow`, `a-grid-adaptive`\n- `a-readable`, `a-heading`, `a-subheading`, `a-caption`, `a-muted`, `a-emphasis`\n- `a-surface`, `a-panel`, `a-card`, `a-divider`, `a-border-adaptive`\n- `a-action-primary`, `a-action-secondary`, `a-action-quiet`, `a-control`, `a-input`\n- `a-touch-target`, `a-focus-ring`, `a-alert`, `a-alert-success`, `a-alert-warning`, `a-alert-danger`\n- `a-assistive`, `a-tooltip-target`, `a-interactive`\n\nThe class names remain stable. Their behavior changes through AURA CSS variables derived from the active ML profile.\n\nExample:\n\n```tsx\n\n```\n\nWhen AURA updates `font_size`, `target_size`, `contrast_mode`, `reduced_motion`, or spacing values, the button updates automatically.\n\n## CSS Variables\n\n`AdaptiveProvider` writes variables such as:\n\n```css\n--aura-color-background\n--aura-color-surface\n--aura-color-text\n--aura-color-primary\n--aura-color-on-primary\n--aura-font-size-body\n--aura-font-size-heading\n--aura-line-height\n--aura-spacing-gap-x\n--aura-spacing-gap-y\n--aura-spacing-pad-x\n--aura-spacing-pad-y\n--aura-control-min-target-size\n--aura-motion-duration\n```\n\nYou can use them in your own CSS too:\n\n```css\n.checkout-summary {\n background: var(--aura-color-surface);\n color: var(--aura-color-text);\n padding: var(--aura-spacing-pad-y) var(--aura-spacing-pad-x);\n font-size: var(--aura-font-size-body);\n line-height: var(--aura-line-height);\n}\n```\n\n## Privacy-Conscious Runtime Signals\n\n`@aura-adaptive/aura-ui-adaptor` includes lightweight behavior-signal monitoring as part of its adaptive runtime, such as click patterns, scroll activity, interaction timing, viewport changes, and adaptation-related events. These signals are used to improve interface personalization and adaptation quality, not to capture private user content. The package is designed to avoid collecting passwords, form input values, or raw user-entered text. Developers should ensure that their application-level privacy notice accurately reflects the use of adaptive interaction signals where required.\n\n## Optional Profile Inspector\n\nRender `` anywhere inside `AdaptiveProvider` to add a draggable floating AURA button. Clicking it opens a read-only inspector panel that shows:\n\n- user/runtime state\n- extension availability and login status\n- extension storage profiles for personalized, adaptive, and final selection\n- the live profile currently applied by `AdaptiveProvider`\n- differences between the final extension profile and the applied runtime profile\n- fallback/runtime details when the extension path is unavailable\n\nThis inspector is a separate module. `AdaptiveProvider` does not mount it automatically and its existing behavior is unchanged when the inspector is not rendered.\n\n## API Reference\n\n### UI Components\n\n| Layout & Containers | Forms & Inputs | Feedback & Navigation | Typography & Media |\n|---------------------|----------------|-----------------------|--------------------|\n| `AdaptiveCard` | `AdaptiveInput` | `AdaptiveAlert` | `AdaptiveText` |\n| `AdaptiveGrid` | `AdaptiveSelect` | `AdaptiveDialog` | `AdaptiveImageFilter` |\n| `AdaptiveDrawer` | `AdaptiveSwitch` | `AdaptiveTooltip` | |\n| `AdaptiveList` | `AdaptiveCheckbox` | `AdaptiveMenu` | |\n| `AdaptiveTable` | `AdaptiveTextarea` | `AdaptiveNavbar` | |\n| `AdaptiveDropdown` | `AdaptiveButton` | `AdaptivePagination` | |\n\n\n## Contributing\n\nWe welcome contributions! Please feel free to submit a Pull Request or open an issue if you have suggestions or find bugs.\n\nTo build the project locally:\n\n```bash\nnpm install\nnpm run build\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}