@kouji-ui/core 0.0.2 → 0.0.3

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @kouji-ui/core@0.0.2 build /home/runner/work/kouji-ui/kouji-ui/packages/core
+> @kouji-ui/core@0.0.3 build /home/runner/work/kouji-ui/kouji-ui/packages/core
 > ng-packagr -p ng-package.json
 
 Building Angular Package
@@ -23,5 +23,5 @@ Built Angular Package
 - to:   /home/runner/work/kouji-ui/kouji-ui/dist/kj-core
 ------------------------------------------------------------------------------
 
-Build at: 2026-05-04T20:37:30.262Z - Time: 4059ms
+Build at: 2026-05-04T21:22:08.979Z - Time: 4682ms
 

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @kouji-ui/core
 
+## 0.0.3
+
+### Patch Changes
+
+- c177d1e: Rewrite README with real install/usage docs, primitive index, and design principles. Replaces the Angular CLI scaffold placeholder.
+
 ## 0.0.2
 
 ### Patch Changes

package/README.md

@@ -1,64 +1,96 @@
-# KjCore
+# @kouji-ui/core
 
-This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 21.2.0.
+Headless Angular 21 UI primitives — directives over CDK with WCAG 2.1 AAA semantics and zero CSS.
 
-## Code scaffolding
+You write the markup. You write the styles. The library wires up keyboard navigation, ARIA, focus management, and state.
 
-Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+[Documentation](https://kouji-ui.onrender.com) · [GitHub](https://github.com/kouji-dev/kouji-ui)
 
-```bash
-ng generate component component-name
-```
-
-For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
-
-```bash
-ng generate --help
-```
-
-## Building
-
-To build the library, run:
+## Install
 
 ```bash
-ng build kj-core
+pnpm add @kouji-ui/core @angular/cdk
 ```
 
-This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+Peer dependencies: `@angular/common` `@angular/core` `@angular/cdk` — all `^21.0.0`.
 
-### Publishing the Library
+## Quick start
 
-Once the project is built, you can publish your library by following these steps:
+Every primitive is a standalone directive. Import it where you use it.
 
-1. Navigate to the `dist` directory:
+```ts
+import { Component } from '@angular/core';
+import { KjButton } from '@kouji-ui/core';
 
-   ```bash
-   cd dist/kj-core
-   ```
+@Component({
+  selector: 'app-example',
+  imports: [KjButton],
+  template: `<button kjButton (click)="save()">Save</button>`,
+})
+export class ExampleComponent {
+  save() { /* ... */ }
+}
+```
 
-2. Run the `npm publish` command to publish your library to the npm registry:
-   ```bash
-   npm publish
-   ```
+The directive owns the keyboard contract, ARIA roles, and focus ring — not the look. Style the host element however you want.
+
+### A more involved example: dialog
+
+```ts
+import { Component } from '@angular/core';
+import {
+  KjDialog,
+  KjDialogTrigger,
+  KjDialogOverlay,
+  KjDialogTitle,
+  KjDialogClose,
+} from '@kouji-ui/core';
+
+@Component({
+  selector: 'app-confirm',
+  imports: [KjDialog, KjDialogTrigger, KjDialogOverlay, KjDialogTitle, KjDialogClose],
+  template: `
+    <button [kjDialogTrigger]="confirm">Delete</button>
+
+    <ng-template #confirm>
+      <div kjDialog>
+        <div kjDialogOverlay></div>
+        <h2 kjDialogTitle>Delete this item?</h2>
+        <p>This action cannot be undone.</p>
+        <button kjDialogClose>Cancel</button>
+        <button kjDialogClose (click)="delete()">Delete</button>
+      </div>
+    </ng-template>
+  `,
+})
+export class ConfirmComponent {
+  delete() { /* ... */ }
+}
+```
 
-## Running unit tests
+Focus trap, Escape-to-close, scroll lock, ARIA wiring — all handled.
 
-To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
+## What's included
 
-```bash
-ng test
-```
+| Domain          | Primitives                                                  |
+| --------------- | ----------------------------------------------------------- |
+| Buttons & inputs | `KjButton`, `KjInput`, `KjCheckbox`, `KjRadio`, `KjToggle`, `KjSelect` |
+| Form composition | `KjFormField`, `KjFormLabel`, `KjFormError`                 |
+| Overlays         | `KjDialog`, `KjPopover`, `KjTooltip`, `KjToast`, `KjMenu`   |
+| Navigation       | `KjTabs`, `KjAccordion`                                     |
+| Data display     | `KjTable`, `KjBadge`, `KjAvatar`, `KjChart`                 |
+| A11y primitives  | `KjFocusTrap`, `KjFocusRing`, `KjLiveRegion`, `KjRovingTabindex`, `KjVisuallyHidden`, `KjAriaDescribedBy` |
 
-## Running end-to-end tests
+Every primitive ships with examples and an inputs reference at [kouji-ui.onrender.com](https://kouji-ui.onrender.com).
 
-For end-to-end (e2e) testing, run:
-
-```bash
-ng e2e
-```
+## Design principles
 
-Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+- **Headless** — directives, not components. You own the DOM and CSS.
+- **WCAG 2.1 AAA target** — keyboard contracts, focus management, ARIA, and contrast all designed for AAA.
+- **CDK-aligned** — wraps `@angular/cdk` primitives where it makes sense (overlay, focus-trap), never reimplements from scratch.
+- **Signals-first** — public APIs use `input()` / `signal()` / `effect()`.
+- **Zero runtime CSS** — no shipped stylesheet. Bring your own design system.
 
-## Additional Resources
+## License
 
-For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
+MIT © [kouji-dev](https://github.com/kouji-dev)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kouji-ui/core",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Headless Angular 21 UI primitives — directives over CDK with WCAG 2.1 AAA semantics and zero CSS.",
   "license": "MIT",
   "repository": {