@wpmoo/ui 0.1.0

package/ASSET_LICENSE.md

@@ -0,0 +1,17 @@
+# WPMoo Visual Asset License
+
+WPMoo-generated visual assets are copyright (c) 2026 WPMoo
+(`wpmoo.org`). All rights reserved.
+
+These assets are not licensed under the repository's MIT source code license
+unless an individual file or directory states otherwise. This includes brand
+assets, component preview images, marketing images, screenshots, generated
+artwork, and other WPMoo-owned image assets under `static/images/`.
+
+You may view these assets as part of the Moo UI documentation and demo site.
+You may not copy, redistribute, modify, sell, sublicense, or use them in another
+product, site, template, library, training dataset, or marketing asset without
+prior written permission from WPMoo.
+
+Third-party assets remain under their own licenses. See
+`THIRD_PARTY_NOTICES.md`.

package/LICENSE

@@ -0,0 +1,32 @@
+MIT License
+
+Copyright (c) 2026 WPMoo (wpmoo.org)
+
+This license applies to the source code in this repository, except where a
+file, directory, or third-party notice states otherwise.
+
+WPMoo-generated visual assets are not licensed under the MIT License unless
+explicitly stated. This includes brand assets, component preview images,
+marketing images, screenshots, generated artwork, and other WPMoo-owned image
+assets under `static/images/`. See `ASSET_LICENSE.md`.
+
+Vendored third-party material keeps its original license and attribution.
+See `THIRD_PARTY_NOTICES.md`.
+
+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/LICENSE-MOO-CORE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WPMoo (wpmoo.org)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the WPMoo-authored portions of moo-core.css 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,83 @@
+# Moo UI
+
+**Bootstrap markup. shadcn feel.**
+
+![Moo UI catalog preview](static/images/readme-hero.webp)
+
+Moo UI is a Bootstrap 5.3 component system for teams that want the calm,
+modern feel of shadcn/ui without leaving server-rendered HTML, Bootstrap
+classes, Bootstrap Sass, or Bootstrap JavaScript behind.
+
+It keeps Bootstrap as the public contract, then shapes the catalog, component
+examples, and composed blocks into a quieter product interface language.
+
+## Philosophy
+
+- **Bootstrap is the contract.** Moo UI keeps Bootstrap markup, documented
+  behavior, `data-bs-*` APIs, Sass knobs, and `--bs-*` variables wherever
+  Bootstrap can express the need.
+- **shadcn is the visual language.** Moo UI studies shadcn/ui for restraint,
+  spacing, composition, and state language. It does not copy shadcn source,
+  React code, Tailwind code, Radix code, or example prose.
+- **HTML stays first-class.** Component examples are generated from Jinja
+  macros, so the preview and copyable source share one rendered output.
+- **No framework adoption tax.** The catalog can be browsed, built, and
+  shipped as static HTML without a SPA runtime.
+- **Product shells matter.** Moo UI includes primitives, utilities, and
+  composed blocks for Bootstrap applications that need to feel like modern
+  product software.
+
+## Documentation
+
+Browse the catalog at [ui.wpmoo.org](https://ui.wpmoo.org/). Component pages,
+blocks, examples, local development notes, and implementation contracts belong
+in the documentation rather than this README.
+
+## Package
+
+The canonical npm package is `@wpmoo/ui`:
+
+```bash
+npm install @wpmoo/ui
+```
+
+For CDN usage, load the built CSS artifact from the canonical package:
+
+```html
+<link rel="stylesheet" href="https://unpkg.com/@wpmoo/ui/dist/assets/css/moo-ui.css">
+```
+
+Bundlers can import the same stylesheet from the package export:
+
+```js
+import "@wpmoo/ui/moo-ui.css";
+```
+
+If the shorter `@moo/ui` scope is available to WPMoo, it is reserved as a
+small alias package only. Use `@wpmoo/ui` in documentation, CDN examples, and
+production installs.
+
+## Build Outputs
+
+The static build emits three CSS artifacts under `dist/assets/css/`:
+
+- `moo-ui.css` for the standalone catalog and examples.
+- `catalog.css` for documentation chrome.
+- `moo-core.css` for integrations that need the Moo component surface as an
+  opt-in native `@scope (.moo-ui)` layer.
+
+The npm package publishes only built component CSS, the optional Bootstrap
+bundle, and license/notice files. WPMoo-owned catalog and preview images are
+not included in the package.
+
+## Licensing
+
+Moo UI source code is licensed under the MIT License by WPMoo (`wpmoo.org`).
+
+WPMoo-generated visual assets, including image assets under `static/images/`,
+are not covered by the MIT source code license and remain copyright WPMoo, all
+rights reserved.
+
+Vendored third-party material keeps its original license and attribution. See
+`LICENSE`, `LICENSE-MOO-CORE.txt`, `ASSET_LICENSE.md`, and
+`THIRD_PARTY_NOTICES.md`.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,39 @@
+# Third-Party Notices
+
+## Bootstrap
+
+Moo UI vendors the official `twbs/bootstrap` v5.3.3 SCSS source and bundled
+JavaScript. Bootstrap is licensed under the MIT License; the bundled license is
+stored at `vendor/bootstrap/LICENSE`.
+
+Bootstrap's component and Button documentation are behavior, semantics, and
+accessibility references for this product.
+
+## shadcn/ui
+
+The shadcn/ui component and Button documentation are visual-intent and catalog
+coverage references. No shadcn/ui implementation source, React code, Tailwind
+code, Radix code, or example prose is bundled or copied.
+
+Moo UI documentation, example copy, component templates, styles, and inline
+SVG icons are original product work.
+
+## Lucide
+
+Moo UI vendors a build-time icon metadata subset from Iconify's Lucide icon
+set at `src/icons/lucide-icons.json` and renders selected icons into the
+generated catalog. Lucide is licensed under the ISC License. The source
+metadata identifies the Lucide project, its contributors, and the upstream
+license URL.
+
+## Geist
+
+Moo UI vendors `Geist-Variable.woff2` for catalog chrome typography only.
+Geist is licensed under the SIL Open Font License 1.1 (`OFL-1.1`); the bundled
+license is stored at `vendor/geist/LICENSE`.
+
+## WPMoo visual assets
+
+WPMoo-generated visual assets, including image assets under `static/images/`,
+are original WPMoo work and are not licensed under MIT unless explicitly
+stated. See `ASSET_LICENSE.md`.