@ticketlayer/elements 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ticketlayer Ltd
+
+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,55 @@
+# Ticketlayer Elements
+
+Embeddable UI components for selling tickets with Ticketlayer: event lists
+and cards, ticket and seat selection, cart, checkout, order confirmation,
+tickets and a customer account, built with Stencil as framework-agnostic web
+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/` |
+
+Every element binds to the `@ticketlayer/live` client the host page publishes
+(`createLiveClient`), so nothing here takes an API key.
+
+```html
+<script src="https://cdn.staging.t9r.dev/v1/ticketlayer.js"
+        data-publishable-key="tlpk_..."
+        data-api-url="https://live.staging.t9r.dev"
+        data-checkout-base="https://hbo.staging.t9r.dev"></script>
+<tl-event-list></tl-event-list>
+<tl-cart-badge></tl-cart-badge>
+```
+
+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.
+
+- [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`).
+
+## Development
+
+```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
+```
+
+`CLAUDE.md` is the working agreement (build, test, release, conventions),
+`AGENTS.md` the rules for changing an element, and
+`.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`.
+
+## License
+
+MIT