@collectivetrait/lineaui 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to Linea UI will be documented in this file.
+
+## [1.0.0] — 2026-10-08
+
+Initial public release of Linea UI.
+
+### Added
+- **Foundation** — CSS reset, typography scale, color tokens, spacing utilities
+  and an 8 px vertical-rhythm grid.
+- **Cascade layers** — all styles are organized into `core`, `blocks` and
+  `utilities` layers for predictable specificity.
+- **BEM naming** — every component follows Block, Element, Modifier conventions.
+- **Layout blocks** — section, grid, sidebar and container helpers.
+- **Content blocks** — prose, page-header, card, list, avatar, badge, code,
+  meta, quote and tag.
+- **Component blocks** — alert, breadcrumb, button-group, divider, drawer,
+  dropdown, menu, modal, navbar, pagination, progress, site-footer, skeleton,
+  spinner, steps, tabs, toast and tooltip.
+- **Form blocks** — input, select, textarea, checkbox, radio, switch, slider
+  and form-field layout with validation states.
+- **Pattern blocks** — hero sections and common page patterns.
+- **Utility classes** — spacing, display, text alignment, color and visibility
+  helpers compiled as the last layer.
+- **JavaScript modules** — drawer, dropdown, modal, tabs, toast and tooltip
+  behaviors bundled as ES modules.
+- **Theme support** — light and dark modes via `data-theme` attribute with
+  automatic OS preference detection.
+- **SCSS source** — full source available for custom builds and variable
+  overrides.
+- **CSS outputs** — pre-built `styles.css` (all-in-one), plus individual
+  `core.css`, `blocks.css` and `utilities.css` files.
+- **MIT license**.

package/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) Collective Trait
+
+MIT License
+
+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

@@ -1,3 +1,114 @@
-# Temporary Holding Version
+# Linea UI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A lightweight SCSS and JavaScript component library built on two core principles: **BEM naming** and an **8 px vertical rhythm**. Styles are organized into CSS cascade layers for predictable specificity, and every component ships with accessible defaults and a small footprint.
+
+Full documentation, live demos, and usage guides are available at **[lineaui.com](https://lineaui.com)**.
+
+## Core principles
+
+**BEM naming** — Every component follows Block–Element–Modifier conventions. Selectors are flat and predictable: `ln-button`, `ln-card__header`, `ln-button--primary`. The `ln-` prefix applies to layout and block classes; helpers and utilities use bare names (`mb-3`, `text-center`). The prefix is configurable via `config.json`. See the [BEM guide](https://lineaui.com/getting-started/bem) for details.
+
+**Vertical rhythm** — All spacing, line heights, and component sizing align to an 8 px baseline grid. This keeps text, form controls, and whitespace visually consistent across any combination of components. See the [vertical rhythm guide](https://lineaui.com/getting-started/vertical-rhythm) for details.
+
+## Quick start
+
+Include the stylesheet and script:
+
+```html
+<link rel="stylesheet" href="path/to/lineaui/dist/styles.css">
+<script type="module" src="path/to/lineaui/dist/bundle.js"></script>
+```
+
+Or import in a bundler:
+
+```js
+import 'lineaui/dist/styles.css';
+import 'lineaui';
+```
+
+To prevent a flash of unstyled content on themed pages, add the theme-init script to `<head>` before any stylesheet:
+
+```html
+<script src="path/to/lineaui/dist/theme-init.js"></script>
+```
+
+## What's included
+
+### CSS
+
+Five CSS files, each self-contained:
+
+| File | Contents |
+|------|----------|
+| `dist/styles.css` | Everything: tokens, reset, base, layout, blocks, helpers, utilities |
+| `dist/core.css` | Foundation only: tokens, reset, base, layout, helpers |
+| `dist/blocks.css` | Component styles (requires layer order declaration) |
+| `dist/utilities.css` | Utility classes (requires layer order declaration) |
+| `dist/icons.css` | Icon classes (see Icons below) |
+
+All styles are scoped to cascade layers in this order:
+
+```
+reset → tokens → base → layout → blocks → helpers → utilities
+```
+
+### JavaScript
+
+`dist/bundle.js` is an ESM bundle that auto-initializes interactive behaviors (dialogs, dropdowns, tooltips, tabs, toasts, galleries, and more) on `DOMContentLoaded` and observes the DOM for dynamically added elements.
+
+### Icons
+
+The library includes its own SVG icon set (35 icons). Each icon is a 24 × 24 filled SVG embedded via CSS masks, so icons inherit `currentColor` and scale with `font-size`. Include `dist/icons.css` alongside your main stylesheet:
+
+```html
+<link rel="stylesheet" href="path/to/lineaui/dist/icons.css">
+```
+
+```html
+<i class="ln-i-chevron-down"></i>
+<i class="ln-i-search"></i>
+```
+
+`dist/icons-manifest.json` lists every available icon with its class name and SVG source. See the [icons guide](https://lineaui.com/foundation/icons) for the full set.
+
+### SCSS source
+
+Import the SCSS source directly for custom builds:
+
+```scss
+@use 'lineaui/scss' as *;
+```
+
+Or import individual layers:
+
+```scss
+@use 'lineaui/scss/tokens';
+@use 'lineaui/scss/base';
+@use 'lineaui/scss/blocks';
+```
+
+## Cascade layers
+
+| Layer | Description |
+|-------|-------------|
+| `reset` | Normalize and box-sizing |
+| `tokens` | Design tokens as CSS custom properties (color palette, spacing scale, type scale, elevation, motion, borders) |
+| `base` | Element-level typography, forms, tables, code, media, interactive defaults |
+| `layout` | Structural primitives: container, grid, shell, section, cluster |
+| `blocks` | ~50 UI components from accordions to tooltips |
+| `helpers` | Vertical rhythm, typographic helpers |
+| `utilities` | Generated utility classes for spacing, flex, display, text, color, and more |
+
+## Development
+
+```bash
+cd lineaui
+npm install
+npm run build      # one-time build
+npm run dev        # watch mode
+npm run lint       # ESLint + Stylelint
+```
+
+## License
+
+[MIT](LICENSE)

package/config.json

@@ -0,0 +1,3 @@
+{
+  "prefix": "ln-"
+}