ui-style-kit-css 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-05-24
+
+### Added
+
+- Full project wiki under `wiki/`
+- `CODE_OF_CONDUCT.md`
+- SEO support files for GitHub Pages demo:
+  - `robots.txt`
+  - `sitemap.xml`
+  - `site.webmanifest`
+  - `browserconfig.xml`
+  - `.nojekyll`
+  - `favicon.svg`
+  - `assets/seo/og-preview.svg`
+- `llms.txt`
+- Professional repository scaffolding:
+  - `CONTRIBUTING.md`
+  - `SECURITY.md`
+  - `.editorconfig`
+  - `.gitattributes`
+  - `.github/workflows/ci.yml`
+  - GitHub issue and pull request templates
+  - Dependabot config
+- Stylelint configuration:
+  - `.stylelintrc.json`
+  - `.stylelintignore`
+  - package scripts and dev dependencies
+
+### Changed
+
+- Expanded `index.html` with comprehensive SEO, social metadata, and JSON-LD structured data.
+- Updated README with quality, community, and SEO sections.

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,64 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity or expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment include:
+
+- Using welcoming and inclusive language
+- Respecting different viewpoints and experiences
+- Giving and accepting constructive feedback
+- Focusing on what is best for the community and the project
+- Showing empathy and kindness toward other community members
+
+Examples of unacceptable behavior include:
+
+- Sexualized language or imagery, and unwelcome sexual attention or advances
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address, without explicit permission
+- Other conduct that could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to behavior they deem inappropriate, threatening, offensive, or harmful.
+
+Maintainers may remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all project spaces and also applies when an individual is officially representing the project in public spaces. Examples include using an official project email address, posting via official social channels, or acting as an appointed representative at events.
+
+## Reporting
+
+If you experience or witness unacceptable behavior, report it to the maintainers as soon as possible.
+
+- Preferred contact: [Foscat](https://github.com/Foscat) or [Email Me](mailto:fosterkyle6456@gmail.com)
+- Alternative: open a private report through repository maintainers on GitHub
+
+All reports will be reviewed promptly and handled with care and discretion. Maintainers will respect the privacy and security of the reporter to the extent possible.
+
+## Enforcement Guidelines
+
+Maintainers may follow these Community Impact Guidelines when determining consequences:
+
+1. Correction
+For minor or first-time issues, maintainers may provide a private written warning with clarification of expected behavior.
+
+2. Warning
+For a violation involving a single incident or a pattern of behavior, maintainers may issue a warning with clear consequences for continued behavior.
+
+3. Temporary Ban
+For serious or repeated violations, maintainers may impose a temporary ban from community interaction and project participation.
+
+4. Permanent Ban
+For sustained inappropriate behavior, harassment, or threats to community safety, maintainers may impose a permanent ban from any sort of public interaction within the project.
+
+## Attribution
+
+This Code of Conduct is informed by the Contributor Covenant and common open source community moderation practices.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kyle Foster
+
+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,222 @@
+# UI Style Kit CSS
+
+**UI Style Kit CSS** is a CSS-only theme and visual style preset library for standardizing websites, dashboards, admin tools, and customer-facing pages.
+
+It is designed to be separate from, but complementary to, **Interactive Surface CSS**. Use this library for visual identity, color themes, UI style presets, and native HTML coverage. Use Interactive Surface CSS for interaction-state animation systems and surface behavior.
+
+## Features
+
+- 11 UI style systems
+- 10 shared color schemes
+- `light`, `dark`, and `contrast` modes
+- one combined CSS entry file
+- optional per-style CSS files
+- CSS-only native HTML element coverage
+- visible focus states
+- reduced-motion support
+- high-contrast and forced-colors support
+- print styles
+- NPM/CDN-friendly package structure
+
+## Wiki
+
+Extended documentation lives in [`wiki/`](wiki/):
+
+- [`wiki/Home.md`](wiki/Home.md)
+- [`wiki/Installation-and-Setup.md`](wiki/Installation-and-Setup.md)
+- [`wiki/Theming-Model.md`](wiki/Theming-Model.md)
+- [`wiki/Class-API.md`](wiki/Class-API.md)
+- [`wiki/UI-Systems.md`](wiki/UI-Systems.md)
+- [`wiki/Accessibility.md`](wiki/Accessibility.md)
+
+## Community
+
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Contributing Guide](CONTRIBUTING.md)
+- [Security Policy](SECURITY.md)
+
+## Quality
+
+```bash
+npm install
+npm run lint:css
+```
+
+Auto-fix style issues:
+
+```bash
+npm run lint:css:fix
+```
+
+## Demo SEO Files
+
+The demo page includes production SEO/social metadata plus supporting files for GitHub Pages:
+
+- `index.html` comprehensive metadata + JSON-LD
+- `robots.txt`
+- `sitemap.xml`
+- `site.webmanifest`
+- `browserconfig.xml`
+- `.nojekyll`
+- `favicon.svg`
+- `assets/seo/og-preview.svg`
+
+## Install
+
+```bash
+npm install ui-style-kit-css
+```
+
+## Import
+
+```js
+import "ui-style-kit-css/dist/ui-style-kit.css";
+```
+
+Or import one style system only:
+
+```js
+import "ui-style-kit-css/styles/minimal-saas.css";
+import "ui-style-kit-css/styles/cyberpunk.css";
+```
+
+## Browser / CDN usage
+
+After publishing to NPM:
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ui-style-kit-css@latest/dist/ui-style-kit.min.css" />
+```
+
+Local usage:
+
+```html
+<link rel="stylesheet" href="dist/ui-style-kit.css" />
+```
+
+## Basic usage
+
+```html
+<body data-ui="minimal-saas" data-theme="arctic-indigo" data-mode="light">
+  <main class="saas-page">
+    <section class="saas-container saas-stack">
+      <article class="saas-card">
+        <h1 class="saas-title">UI Style Kit CSS</h1>
+        <p class="saas-subtitle">Switch UI systems, themes, and modes with attributes.</p>
+      </article>
+    </section>
+  </main>
+</body>
+```
+
+## UI systems
+
+| UI style | `data-ui` | Class prefix |
+|---|---:|---:|
+| Minimal SaaS | `minimal-saas` | `saas` |
+| Bento UI | `bento` | `bento` |
+| Maximalist / Playful | `maximalist` | `max` |
+| Bauhaus / Swiss Modern | `bauhaus` | `bau` |
+| Skeuomorphic / Tactile | `tactile` | `tactile` |
+| Neumorphism | `neumorphism` | `neo` |
+| Retrofuturism | `retrofuturism` | `retro` |
+| Brutalism | `brutalism` | `brutal` |
+| Cyberpunk | `cyberpunk` | `cyber` |
+| Y2K | `y2k` | `y2k` |
+| Retro Glass | `retro-glass` | `rg` |
+
+## Color themes
+
+- `midnight-gold`
+- `ocean-steel`
+- `forest-moss`
+- `sunset-ember`
+- `royal-plum`
+- `graphite-cyan`
+- `desert-sage`
+- `rose-quartz`
+- `cyber-lime`
+- `arctic-indigo`
+
+## Modes
+
+- `light`
+- `dark`
+- `contrast`
+
+## Dynamic switching
+
+```js
+document.body.dataset.ui = "cyberpunk";
+document.body.dataset.theme = "midnight-gold";
+document.body.dataset.mode = "dark";
+```
+
+## File structure
+
+```txt
+ui-style-kit-css/
+  package.json
+  README.md
+  CONTRIBUTING.md
+  SECURITY.md
+  CODE_OF_CONDUCT.md
+  LICENSE
+  index.html
+  favicon.svg
+  llms.txt
+  robots.txt
+  sitemap.xml
+  site.webmanifest
+  browserconfig.xml
+  assets/
+    seo/
+      og-preview.svg
+  .stylelintrc.json
+  .stylelintignore
+  .editorconfig
+  .gitattributes
+  .github/
+    workflows/
+      ci.yml
+  dist/
+    ui-style-kit.css
+    ui-style-kit.min.css
+  styles/
+    minimal-saas.css
+    bento.css
+    maximalist.css
+    bauhaus.css
+    tactile.css
+    neumorphism.css
+    retrofuturism.css
+    brutalism.css
+    cyberpunk.css
+    y2k.css
+    retro-glass.css
+  wiki/
+    Home.md
+    Installation-and-Setup.md
+    Theming-Model.md
+    Class-API.md
+    UI-Systems.md
+    Accessibility.md
+```
+
+## Accessibility scope
+
+UI Style Kit CSS includes CSS-only accessibility presentation helpers:
+
+- scoped native HTML defaults
+- visible `:focus-visible` styles
+- `prefers-reduced-motion` support
+- `prefers-contrast: more` support
+- `forced-colors: active` support
+- print styles
+- skip-link and visually-hidden utilities per style prefix
+
+CSS cannot guarantee accessibility by itself. Use semantic HTML, real labels, keyboard-safe JavaScript, and correct ARIA state management for interactive components.
+
+## License
+
+MIT