@popgrids/embed 0.0.5 → 0.0.7

package/AGENTS.md

@@ -1,4 +1,4 @@
-# Project Instructions (popgrids-embed)
+# Project Instructions (`packages/embed`)
 
 This project contains the embeddable Web Component discussion widget for PopGrids. It is a lightweight, self-contained client-side bundle designed to be embedded on third-party websites.
 
@@ -13,11 +13,12 @@ This project contains the embeddable Web Component discussion widget for PopGrid
 - **Build System**: Vite.
   - `vite.config.ts` builds the library version.
   - `vite.embed.config.ts` builds the single self-contained embeddable JS script.
+  - `vite.loader.config.ts` builds `dist/loader.js` from [loader.ts](./src/loader.ts): the tiny classic script served at `https://cdn.popgrids.io/embed.js`, which loads this release's `embed.js`.
 
 ## Core Development Commands
 
 - `pnpm run dev` — Watch-builds both library and embed scripts.
-- `pnpm run build` — Clean and build both targets (`dist/`).
+- `pnpm run build` — Clean and build all three targets (`dist/`).
 - `pnpm run demo:dev` — Launches concurrently the dev watch compiler and a live-reload server (`live-server`) on port 5500.
 
 ## Component Conventions
@@ -121,35 +122,24 @@ We propagate state using a custom context pattern instead of passing props manua
 ## Releasing
 
 This package publishes to npm as [`@popgrids/embed`](https://www.npmjs.com/package/@popgrids/embed)
-using [Changesets](https://github.com/changesets/changesets). Same flow as `popgrids-ui`.
-
-- **Every change that affects the published output** needs a changeset: `pnpm changeset`, pick the
-  bump (patch/minor/major), write a one-line summary. Commit the generated file in `.changeset/`.
-- **On merge to `main`**, `.github/workflows/release.yml` runs: if pending changesets exist it runs
-  `changeset version` (bumps `package.json` + writes `CHANGELOG.md`), commits `chore: version
-  packages`, then `changeset publish` builds (`prepublishOnly` → `typecheck` + `build`) and publishes.
-- **Auth is npm OIDC trusted publishing** — no `NPM_TOKEN`. The workflow needs `id-token: write` and
-  a trusted publisher configured on npmjs.com for this package (repo `popgrids/popgrids-embed`,
-  workflow `release.yml`).
-- `.github/workflows/ci.yml` typechecks + builds every PR.
+through the monorepo's changesets flow; see "Releasing ui and embed" in the root `AGENTS.md`.
+
+- **Every change that affects the published output** needs a changeset (`pnpm changeset` from the
+  root). web's Composer preview bundles the workspace copy, so it picks up an embed change on the
+  next deploy, released or not; customer sites get it only once it's released.
+- **Auth is npm OIDC trusted publishing** — no `NPM_TOKEN`. The trusted publisher on npmjs.com
+  points at repo `popgrids/popgrids`, workflow `release.yml`.
+- `prepublishOnly` runs `check` + `build`. The root `.github/workflows/ci.yml` runs embed's `check`
+  and `build` on every PR that touches it.
 - The published package ships both entries: `.` (the library, deps external) and `./embed` /
-  `dist/embed.js` (the self-contained CDN bundle, also the `unpkg`/`jsdelivr` target).
-
-## Plan Mode
-
-- Make the plan extremely concise. Sacrifice grammar for the sake of concision.
-- At the end of each plan, give me a list of unresolved questions to answer, if any.
-
-## Agent skills
-
-### Issue tracker
-
-Issues and specs live as GitHub issues in `popgrids/popgrids-embed`. See `docs/agents/issue-tracker.md`.
-
-### Triage labels
-
-Default label vocabulary (`needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`, `wontfix`). See `docs/agents/triage-labels.md`.
-
-### Domain docs
-
-Single-context: `CONTEXT.md` + `docs/adr/` at the repo root. See `docs/agents/domain.md`.
+  `dist/embed.js` (the self-contained CDN bundle, also the `unpkg`/`jsdelivr` target), plus
+  `dist/loader.js`.
+- **Customer sites load releases from `cdn.popgrids.io`**, never from `main`. After a release,
+  `.github/workflows/embed-cdn.yml` copies the npm tarball's `embed.js`, its map and `loader.js` to
+  `embed/<version>/` in the `popgrids` R2 bucket (cached for a year), then that `loader.js` to
+  `embed.js` (cached 5 minutes). To roll back, run that workflow by hand with an earlier version
+  (0.0.7 or later; older releases have no loader). It uses the `CLOUDFLARE_R2_API_TOKEN` secret, an
+  R2 token scoped to the `popgrids` bucket, and writes only under the `embed` prefix: the same
+  bucket serves the marketing videos.
+
+Issues, triage labels, domain docs, and Plan Mode are shared across the monorepo; see the root `AGENTS.md`.

package/README.md

@@ -38,15 +38,31 @@ import type { AuthUser, Comment, CommentAuthor, Grid } from "@popgrids/embed";
 
 ### Script tag / CDN
 
-The `./embed` subpath is a single self-contained bundle with every dependency inlined — nothing else
-to load:
+Add one tag where the grid should appear:
 
 ```html
-<script type="module" src="https://unpkg.com/@popgrids/embed/dist/embed.js"></script>
+<script src="https://cdn.popgrids.io/embed.js" data-key="pk_your_public_key" async></script>
+```
+
+The grid renders right after the tag and takes its `data-*` attributes (see below), so
+`data-id="article-hero"` on the tag names the thread. Repeat the tag for more grids; the widget
+loads once.
+
+`https://cdn.popgrids.io/embed.js` always serves the latest release, cached for 5 minutes. It's a
+tiny loader for that release's bundle, which lives at an immutable, versioned URL. To pin a version,
+load its loader instead: `https://cdn.popgrids.io/embed/0.0.7/loader.js`.
+
+To place grids yourself, leave out `data-key` and add `<pop-grid>` elements anywhere on the page:
+
+```html
+<script src="https://cdn.popgrids.io/embed.js" async></script>
 
 <pop-grid data-key="pk_your_public_key"></pop-grid>
 ```
 
+The `./embed` subpath (`dist/embed.js`) is the bundle itself: a self-contained ES module with every
+dependency inlined, also on unpkg and jsDelivr.
+
 ## `<pop-grid>` attributes
 
 | Attribute      | Required | Description                                                                       |
@@ -54,6 +70,9 @@ to load:
 | `data-key`     | yes      | Your grid's public key (`pk_…`).                                                |
 | `data-api-url` | no       | Base URL of the PopGrids API. Defaults to `https://www.popgrids.io`.           |
 | `data-id`      | no       | Names the thread. Same `data-id` = same discussion across pages. Defaults to the page's canonical URL. |
+| `data-demo`    | no       | Demo mode: no API, realtime or sign-in. Shows the data assigned to the element's `demo` property (`{ grid, comments }`, type `DemoData`). |
+
+The element's `open` property reads or sets whether the panel is open, e.g. `grid.open = true` to show it from your own control.
 
 ## License
 

package/dist/components/pop-comment-thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pop-comment-thread.d.ts","sourceRoot":"","sources":["../../src/components/pop-comment-thread.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAgE7D,qBAAa,gBAAiB,SAAQ,WAAW;IAC3B,SAAS,EAAG,SAAS,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAS;IAEzB,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU;IAMnC,SAAS,CAAC,YAAY;IAgBtB,SAAS,CAAC,WAAW,IAAI,MAAM;CAsChC"}
+{"version":3,"file":"pop-comment-thread.d.ts","sourceRoot":"","sources":["../../src/components/pop-comment-thread.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAuE7D,qBAAa,gBAAiB,SAAQ,WAAW;IAC3B,SAAS,EAAG,SAAS,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAS;IAEzB,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU;IAMnC,SAAS,CAAC,YAAY;IAoBtB,SAAS,CAAC,WAAW,IAAI,MAAM;CAsChC"}

package/dist/components/pop-comment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pop-comment.d.ts","sourceRoot":"","sources":["../../src/components/pop-comment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AA0S7D,qBAAa,UAAW,SAAQ,WAAW;IACrB,SAAS,EAAG,SAAS,CAAC;IACjB,SAAS,EAAG,cAAc,CAAC;IAEpD,MAAM,KAAK,kBAAkB,aAE5B;IAED,iBAAiB;IAIjB,kBAAkB;IAIlB,IAAI,IAAI,IAAI,IAAI,GAAG,IAAI,CAEtB;IAED,IAAI,iBAAiB,IAAI,IAAI,GAAG,IAAI,CAEnC;IAED,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAa;IAEtC,OAAO,CAAC,eAAe,CAQrB;IAEF,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,aAAa;YAaP,aAAa;YASb,WAAW;IAYzB,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK;IAoD9B,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,oBAAoB;IAMpB,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,eAAe;IAOvB,SAAS,CAAC,YAAY;IA8BtB,SAAS,CAAC,WAAW,IAAI,MAAM;CAoHhC"}
+{"version":3,"file":"pop-comment.d.ts","sourceRoot":"","sources":["../../src/components/pop-comment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AA0S7D,qBAAa,UAAW,SAAQ,WAAW;IACrB,SAAS,EAAG,SAAS,CAAC;IACjB,SAAS,EAAG,cAAc,CAAC;IAEpD,MAAM,KAAK,kBAAkB,aAE5B;IAED,iBAAiB;IAIjB,kBAAkB;IAIlB,IAAI,IAAI,IAAI,IAAI,GAAG,IAAI,CAEtB;IAED,IAAI,iBAAiB,IAAI,IAAI,GAAG,IAAI,CAEnC;IAED,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAa;IAEtC,OAAO,CAAC,eAAe,CAQrB;IAEF,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,aAAa;YAaP,aAAa;YASb,WAAW;IAYzB,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK;IAoD9B,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,oBAAoB;IAMpB,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,eAAe;IAOvB,SAAS,CAAC,YAAY;IAkCtB,SAAS,CAAC,WAAW,IAAI,MAAM;CAoHhC"}

package/dist/components/pop-feed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pop-feed.d.ts","sourceRoot":"","sources":["../../src/components/pop-feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAqM7D,qBAAa,OAAQ,SAAQ,WAAW;IAClB,SAAS,EAAG,SAAS,CAAC;IACjB,SAAS,EAAG,cAAc,CAAC;IAEpD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,cAAc,CAAuB;IAE7C,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU;IAOnC,iBAAiB;IAMjB,oBAAoB;IAOpB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAc/B,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,SAAS;IAejB,SAAS,CAAC,YAAY;IAuBtB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,MAAM;IAmEd,SAAS,CAAC,WAAW,IAAI,MAAM;CAmBhC"}
+{"version":3,"file":"pop-feed.d.ts","sourceRoot":"","sources":["../../src/components/pop-feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAqM7D,qBAAa,OAAQ,SAAQ,WAAW;IAClB,SAAS,EAAG,SAAS,CAAC;IACjB,SAAS,EAAG,cAAc,CAAC;IAEpD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,cAAc,CAAuB;IAE7C,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU;IAOnC,iBAAiB;IAMjB,oBAAoB;IAOpB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAc/B,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,SAAS;IAejB,SAAS,CAAC,YAAY;IAuBtB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,MAAM;IAuEd,SAAS,CAAC,WAAW,IAAI,MAAM;CAmBhC"}

package/dist/components/pop-grid.d.ts

@@ -1,9 +1,21 @@
+import { DemoData } from '../store/grid-store.js';
 import { BaseElement } from './base-element.js';
 export declare class PopGrid extends BaseElement {
     private _initialized;
     private _floatingCleanup?;
     private _store;
     private _authStore;
+    private _demo?;
+    /**
+     * The grid and comments a `data-demo` grid shows instead of fetching its
+     * own — the host page supplies them, so no sample data ships in the bundle.
+     * Shows the loading skeleton until it's set.
+     */
+    get demo(): DemoData | undefined;
+    set demo(data: DemoData);
+    /** Whether the panel is open. Setting it opens or closes the panel; the visitor can still toggle it as usual. */
+    get open(): boolean;
+    set open(value: boolean);
     protected get styleSheets(): CSSStyleSheet[];
     static get observedAttributes(): string[];
     connectedCallback(): void;

package/dist/components/pop-grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pop-grid.d.ts","sourceRoot":"","sources":["../../src/components/pop-grid.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAmC7D,qBAAa,OAAQ,SAAQ,WAAW;IACtC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAkB;IAEpC,SAAS,KAAK,WAAW,oBAExB;IAMD,MAAM,KAAK,kBAAkB,aAE5B;IAED,iBAAiB;IA+CjB,OAAO,CAAC,4BAA4B;IAkCpC,OAAO,CAAC,6BAA6B;IAOrC,kBAAkB;IAIlB,mBAAmB;IAInB,qBAAqB;IAIrB,iBAAiB;IAIjB,yBAAyB;IAIzB,oBAAoB;IAQpB,SAAS,CAAC,YAAY;IAuFtB,SAAS,CAAC,WAAW,IAAI,MAAM;CAQhC"}
+{"version":3,"file":"pop-grid.d.ts","sourceRoot":"","sources":["../../src/components/pop-grid.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,QAAQ,EAAsB,MAAM,wBAAwB,CAAC;AAGtF,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAmC7D,qBAAa,OAAQ,SAAQ,WAAW;IACtC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,KAAK,CAAC,CAAW;IAEzB;;;;OAIG;IACH,IAAI,IAAI,IAAI,QAAQ,GAAG,SAAS,CAE/B;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAGtB;IAED,iHAAiH;IACjH,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAEtB;IAED,SAAS,KAAK,WAAW,oBAExB;IAMD,MAAM,KAAK,kBAAkB,aAE5B;IAED,iBAAiB;IAuDjB,OAAO,CAAC,4BAA4B;IAkCpC,OAAO,CAAC,6BAA6B;IAOrC,kBAAkB;IAIlB,mBAAmB;IAInB,qBAAqB;IAIrB,iBAAiB;IAIjB,yBAAyB;IAIzB,oBAAoB;IAQpB,SAAS,CAAC,YAAY;IA6CtB,SAAS,CAAC,WAAW,IAAI,MAAM;CAQhC"}

package/dist/components/pop-widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pop-widget.d.ts","sourceRoot":"","sources":["../../src/components/pop-widget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAkJ7D,qBAAa,SAAU,SAAQ,WAAW;IACpB,SAAS,EAAG,SAAS,CAAC;IAE1C,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,SAAS,CAAC,OAAO;IAQjB,SAAS,CAAC,YAAY;IAmBtB,SAAS,CAAC,WAAW,IAAI,MAAM;CAiDhC"}
+{"version":3,"file":"pop-widget.d.ts","sourceRoot":"","sources":["../../src/components/pop-widget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAkJ7D,qBAAa,SAAU,SAAQ,WAAW;IACpB,SAAS,EAAG,SAAS,CAAC;IAE1C,SAAS,KAAK,WAAW,oBAExB;IAED,SAAS,CAAC,MAAM;;MAEd;IAEF,SAAS,CAAC,OAAO;IAQjB,SAAS,CAAC,YAAY;IAmBtB,SAAS,CAAC,WAAW,IAAI,MAAM;CA+ChC"}