@ng-brutalism/ui 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to `@ng-brutalism/ui` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Breaking Changes (pre-publish, still 0.x)
+
+- **Class names**: `Component`/`Directive` suffix dropped. `NbCardComponent` → `NbCard`, `NbButtonDirective` → `NbButton`, `NbSelectComponent` → `NbSelect`, `NbAccordionComponent` → `NbAccordion`, etc.
+- **`defaultValue` removed from `<nb-accordion>`**: use `[value]="..."` for one-way initial value or `[(value)]` for two-way binding.
+- **`defaultValue` and `defaultOpen` removed from `<nb-select>`**: use `[value]` / `[(value)]` and `[open]` / `[(open)]` respectively.
+
+### Internal
+
+- Async code highlighting migrated to `resource()` (Angular 21 stable API).
+- Router navigation state in navbar, docs-shell, and TOC migrated to `toSignal()`.
+- Portfolio typewriter animation and greeting cycle migrated to `toObservable + switchMap`.
+- Portfolio journey map sync migrated to `toObservable + subscribe`.
+- Event handlers renamed to reflect actions rather than triggering events.
+
+## [0.1.0] — 2026-05-21
+
+Initial public release.
+
+### Added
+
+**Form controls**
+- `NbButton`
+- `NbCheckbox`
+- `NbInput`
+- `NbInputGroup`
+- `NbLabel`
+- `NbNativeSelect` (directive on native `<select>`)
+- `NbSelect` (custom select component)
+- `NbTextarea`
+
+**Layout & content**
+- `NbAccordion`
+- `NbAvatar`
+- `NbBadge`
+- `NbCard`
+- `NbImageCard`
+- `NbMarquee`
+- `NbTitle`
+
+**Overlays**
+- `NbDialog`
+
+**Foundation**
+- MIT license, Angular 21 + Tailwind v4 peer dependencies
+- `styles.css` single-import entrypoint (default theme)
+- `theme.css` token-only entrypoint for advanced theming
+- Optional `provideNgBrutalism()` provider
+- CSS custom properties as the primary theming surface
+
+**Notes**
+- Pre-1.0: minor versions may include breaking changes while APIs settle.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Khang Tran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# @ng-brutalism/ui
+
+Build loud. Stay sharp.
+
+`@ng-brutalism/ui` gives modern Angular apps a token-driven component system
+with directive-first APIs, keyboard-ready interactions, hard-edged visuals, and
+Tailwind v4 ergonomics from the first import.
+
+[![npm version](https://img.shields.io/npm/v/@ng-brutalism/ui.svg)](https://www.npmjs.com/package/@ng-brutalism/ui)
+[![npm downloads](https://img.shields.io/npm/dm/@ng-brutalism/ui.svg)](https://www.npmjs.com/package/@ng-brutalism/ui)
+[![CI](https://github.com/khangtrannn/ng-brutalism/actions/workflows/ci.yml/badge.svg)](https://github.com/khangtrannn/ng-brutalism/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/@ng-brutalism/ui.svg)](https://github.com/khangtrannn/ng-brutalism/blob/main/LICENSE)
+
+[Documentation](https://ngbrutalism.khangtran.dev) ·
+[npm](https://www.npmjs.com/package/@ng-brutalism/ui) ·
+[GitHub](https://github.com/khangtrannn/ng-brutalism)
+
+![demo](https://raw.githubusercontent.com/khangtrannn/ng-brutalism/main/docs/assets/introduction.gif)
+
+## Install
+
+Requires Node 20.19+ or 22.12+, Angular 21, and Tailwind CSS v4.
+
+Automatic setup:
+
+```sh
+ng add @ng-brutalism/ui
+```
+
+The schematic installs the package, configures Tailwind CSS v4 when needed, and
+adds the bundled styles to your global stylesheet.
+
+Manual setup:
+
+```sh
+npm install @ng-brutalism/ui
+# or
+pnpm add @ng-brutalism/ui
+```
+
+Import the styles once in your global CSS:
+
+```css
+@import 'tailwindcss';
+@import '@ng-brutalism/ui/styles.css';
+```
+
+Use a component:
+
+```ts
+import { Component } from '@angular/core';
+import { NbButton } from '@ng-brutalism/ui';
+
+@Component({
+  selector: 'app-root',
+  imports: [NbButton],
+  template: `<button nbButton>Click</button>`,
+})
+export class App {}
+```
+
+## Why it stands out
+
+- **Angular first**: Built as Angular primitives with directive APIs,
+  signal-friendly internals, and native interaction patterns that fit modern
+  Angular apps.
+- **Loud by default**: Chunky borders, offset shadows, punchy color, and compact
+  motion make interfaces feel instantly brutalist.
+- **Easy to bend**: CSS custom properties and Tailwind utilities keep theme
+  overrides local, visible, and predictable.
+
+Optional — configure a subset of theme tokens from TypeScript at bootstrap.
+Sets the corresponding `--nb-*` custom properties for these keys. Tokens
+outside `NbThemeConfig` (e.g. `--nb-background`, `--nb-field-bg`) must still be
+overridden in CSS.
+
+```ts
+import { provideNgBrutalism } from '@ng-brutalism/ui';
+
+bootstrapApplication(App, {
+  providers: [
+    provideNgBrutalism({
+      theme: {
+        primary: '#ffd166',
+        radius: '4px',
+        borderWidth: '3px',
+      },
+    }),
+  ],
+});
+```
+
+## What it looks like
+
+![showcase](https://raw.githubusercontent.com/khangtrannn/ng-brutalism/main/docs/assets/showcase-portfolio.png)
+
+## Documentation
+
+Full guides, component API tables, and live examples:
+[https://ngbrutalism.khangtran.dev](https://ngbrutalism.khangtran.dev)
+
+## Status
+
+`@ng-brutalism/ui` is pre-1.0. The component APIs are usable today, but minor
+versions may include breaking changes while the library settles.
+
+## License
+
+MIT