@codesweep-ai/ui 0.2.1-dev.20260901200135.3160175 → 0.2.1-dev.20260908060059.c1aae9a

package/README.md

@@ -1,7 +1,7 @@
 # @codesweep-ai/ui
 
 [![ci](https://github.com/codesweep-ai/ui/actions/workflows/ci.yml/badge.svg)](https://github.com/codesweep-ai/ui/actions/workflows/ci.yml)
-[![license: Apache-2.0](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](https://github.com/codesweep-ai/ui/blob/main/LICENSE)
+[![license: Apache-2.0](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/LICENSE)
 ![React](https://img.shields.io/badge/react-18%20%C2%B7%2019-informational)
 ![Themes](https://img.shields.io/badge/themes-light%20%C2%B7%20dark-lightgrey)
 
@@ -46,7 +46,7 @@ export function RunStatus() {
 }
 ```
 
-[INSTALL.md](https://github.com/codesweep-ai/ui/blob/main/INSTALL.md) has the rest: the prerequisites, which stylesheets a
+[INSTALL.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/INSTALL.md) has the rest: the prerequisites, which stylesheets a
 project needs, and the boot script that applies a theme before React paints. To
 look at the components before installing anything, start with the catalogue
 app below.
@@ -80,9 +80,9 @@ filesystem.
 ## Finding a component
 
 The package ships dozens of components and patterns.
-[CATALOG.md](https://github.com/codesweep-ai/ui/blob/main/CATALOG.md) indexes them by intent, so search it for what you are
+[CATALOG.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/CATALOG.md) indexes them by intent, so search it for what you are
 building rather than scanning a list. Each entry links to that component's
-specification under [`components/`](https://github.com/codesweep-ai/ui/tree/main/components), which holds its props, its
+specification under [`components/`](https://github.com/codesweep-ai/ui/tree/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/components), which holds its props, its
 visual spec, and the DOM hooks it guarantees.
 
 The catalogue also gives the order to decide in. Match an entry and compose it,
@@ -93,32 +93,39 @@ fits.
 
 Light and dark both ship. `ThemeToggle` renders the control, `useTheme` reads
 and sets the value, and `themeBootScript` applies the stored choice before the
-page paints. [MANUAL.md](https://github.com/codesweep-ai/ui/blob/main/MANUAL.md) covers all three.
+page paints. [MANUAL.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/MANUAL.md) covers all three.
 
 The tokens beneath both themes cover colour, space, radius, type and elevation.
 Every one is a CSS custom property, and section 4 of
-[DESIGN_SYSTEM_SPEC.md](https://github.com/codesweep-ai/ui/blob/main/DESIGN_SYSTEM_SPEC.md) lists them. A component
+[DESIGN_SYSTEM_SPEC.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/DESIGN_SYSTEM_SPEC.md) lists them. A component
 stylesheet reads tokens and never literal values, which `npm run check`
 enforces.
 
 ## Docs
 
 The documentation lives in the [codesweep-ai/ui](https://github.com/codesweep-ai/ui)
-GitHub repository, and none of it ships in this package.
-
-- [INSTALL.md](https://github.com/codesweep-ai/ui/blob/main/INSTALL.md) · getting the package, and the setup it needs once
-- [MANUAL.md](https://github.com/codesweep-ai/ui/blob/main/MANUAL.md) · what the package exports, the entry points, theming and the DOM contract
-- [CATALOG.md](https://github.com/codesweep-ai/ui/blob/main/CATALOG.md) · every component and pattern, indexed by intent
-- [DESIGN_SYSTEM_SPEC.md](https://github.com/codesweep-ai/ui/blob/main/DESIGN_SYSTEM_SPEC.md) · the tokens, the architecture and the conventions
-- [CONTRIBUTING.md](https://github.com/codesweep-ai/ui/blob/main/CONTRIBUTING.md) · working on the package
-- [AGENTS.md](https://github.com/codesweep-ai/ui/blob/main/AGENTS.md) · where an agent looks first
+GitHub repository rather than in this package. Every link below is pinned
+to `c1aae9a30fd763d7f2e41df69606ea6c07aec9dc`, the commit this build came from, so it describes what you
+installed and not whatever `main` holds when you follow it.
+
+`catalog.json` is the exception: it ships beside the code. It is the same
+index as `CATALOG.md`, as data, and it cannot disagree with the build it
+came in.
+
+- [INSTALL.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/INSTALL.md) · getting the package, and the setup it needs once
+- [MANUAL.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/MANUAL.md) · what the package exports, the entry points, theming and the DOM contract
+- [CATALOG.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/CATALOG.md) · every component and pattern, indexed by intent
+- [DESIGN_SYSTEM_SPEC.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/DESIGN_SYSTEM_SPEC.md) · the tokens, the architecture and the conventions
+- [CHANGELOG.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/CHANGELOG.md) · what an upgrade between versions asks of you
+- [CONTRIBUTING.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/CONTRIBUTING.md) · working on the package
+- [AGENTS.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/AGENTS.md) · where an agent looks first
 
 ## Contributing
 
 Bug reports and pull requests are welcome.
-[CONTRIBUTING.md](https://github.com/codesweep-ai/ui/blob/main/CONTRIBUTING.md) says how to work on the package, and applies
+[CONTRIBUTING.md](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/CONTRIBUTING.md) says how to work on the package, and applies
 to coding agents as well as to people.
 
 ## License
 
-[Apache-2.0](https://github.com/codesweep-ai/ui/blob/main/LICENSE).
+[Apache-2.0](https://github.com/codesweep-ai/ui/blob/c1aae9a30fd763d7f2e41df69606ea6c07aec9dc/LICENSE).