@ticketlayer/elements 0.3.2 → 0.4.0

package/README.md

@@ -8,7 +8,7 @@ components.
 | Package | What |
 |---|---|
 | `@ticketlayer/elements` | the web components (`<tl-event-list>`, `<tl-cart>`, ...), lazy-loaded via `loader/` or bundled from `dist/` |
-| `@ticketlayer/elements-react` | React wrappers (`<TlEventList />`, `<TlCart />`, ...), built from the same source in `react/` |
+| `@ticketlayer/elements-react` | React wrappers (`<TlEventList />`, `<TlCart />`, ...), generated from this build in `../elements-react` |
 
 Every element binds to the `@ticketlayer/live` client the host page publishes
 (`createLiveClient`), so nothing here takes an API key.
@@ -24,31 +24,32 @@ Every element binds to the `@ticketlayer/live` client the host page publishes
 
 The `@ticketlayer/live` drop-in above loads the Elements bundle itself from
 `/elements/v1/ticketlayer-elements/ticketlayer-elements.esm.js` on the same
-CDN. Neither package is on npm yet: the first release waits on the
-`NPM_TOKEN` secret (see [Releasing](#development)); the CDN image is built
-from `main` on every push.
+CDN; the CDN image is built from `main` on every push.
 
 - [docs/USAGE.md](docs/USAGE.md) - installation, wiring the client, theming, events, framework notes
 - [docs/COMPONENTS.md](docs/COMPONENTS.md) - props, events and examples for the post-purchase and account components
-- [elements.catalogue.json](elements.catalogue.json) - the machine-readable catalogue of every element: props, events, slots, CSS custom properties, supported runtimes and category. Generated from the build (`npm run build:catalogue`) and checked in CI (`npm run test:catalogue`).
+- [elements.catalogue.json](elements.catalogue.json) - the machine-readable catalogue of every element: props, events, slots, CSS custom properties, supported runtimes and category. Generated by `pnpm build:catalogue` after a build (the build itself does not write it, so the check can fail) and checked in CI (`pnpm test:catalogue`).
 
 ## Development
 
+From the repository root, after `pnpm install`:
+
 ```bash
-npm install
-npm run build        # stencil build, React wrappers (react/dist), catalogue
-npm run dev          # stencil dev server
-npm test             # spec tests
-npm run test:catalogue
+pnpm --filter @ticketlayer/elements build        # stencil build
+pnpm --filter @ticketlayer/elements build:catalogue   # then the catalogue, explicitly
+pnpm --filter @ticketlayer/elements-react build  # the React wrappers, from that build
+pnpm --filter @ticketlayer/elements dev          # stencil dev server
+pnpm --filter @ticketlayer/elements test         # spec tests
+pnpm --filter @ticketlayer/elements test:catalogue
 ```
 
-`CLAUDE.md` is the working agreement (build, test, release, conventions),
-`AGENTS.md` the rules for changing an element, and
+`CLAUDE.md` here is the working agreement for this package, the root
+`AGENTS.md` the rules for changing an element, and the root
 `.claude/skills/add-element/SKILL.md` the walkthrough for adding one.
 
-Releases are driven by [changesets](.changeset/README.md): both packages are
-versioned together and published to npm with provenance by the release
-workflow on merge to `main`.
+Releases are driven by [changesets](../../.changeset/README.md): the
+workspace's packages are versioned as a linked group and published to npm
+with provenance by the release workflow on merge to `main`.
 
 ## License