${
diff --git a/packages/widget/src/base.js b/packages/widget/src/base.js
index 485f18a..8452f44 100644
--- a/packages/widget/src/base.js
+++ b/packages/widget/src/base.js
@@ -27,34 +27,75 @@ export function canRegisterElements() {
return typeof globalThis.HTMLElement === "function" && typeof globalThis.customElements === "object";
}
+/**
+ * Default values for widget theme tokens.
+ *
+ * `--gov-*` names are the historical prefix (from Nostr-Governance). `--bitgate-*`
+ * is the agreed prefix. Usage sites prefer the new name, then the old one, then
+ * this default, so existing pages and `--gov-*` overrides keep working.
+ *
+ * @type {Readonly<{
+ * fg: string,
+ * muted: string,
+ * border: string,
+ * surface: string,
+ * warn: string,
+ * danger: string,
+ * radius: string,
+ * }>}
+ */
+export const THEME_DEFAULTS = Object.freeze({
+ fg: "currentColor",
+ muted: "color-mix(in srgb, currentColor 60%, transparent)",
+ border: "color-mix(in srgb, currentColor 20%, transparent)",
+ surface: "color-mix(in srgb, canvas 96%, currentColor)",
+ warn: "#b45309",
+ danger: "#b91c1c",
+ radius: "8px",
+});
+
+/**
+ * CSS value for a theme token: `--bitgate-*` wins, then deprecated `--gov-*`,
+ * then the existing default.
+ *
+ * `--bitgate-*` is deliberately not assigned on `:host`. Assigning it would
+ * make `var(--bitgate-*, …)` always hit and ignore `--gov-*` overrides.
+ *
+ * @param {keyof typeof THEME_DEFAULTS} name
+ * @returns {string}
+ */
+export function themeVar(name) {
+ return `var(--bitgate-${name}, var(--gov-${name}, ${THEME_DEFAULTS[name]}))`;
+}
+
/** Base styles shared by every element, scoped inside each shadow root. */
export const BASE_STYLES = `
:host {
- --gov-fg: currentColor;
- --gov-muted: color-mix(in srgb, currentColor 60%, transparent);
- --gov-border: color-mix(in srgb, currentColor 20%, transparent);
- --gov-surface: color-mix(in srgb, canvas 96%, currentColor);
- --gov-warn: #b45309;
- --gov-danger: #b91c1c;
- --gov-radius: 8px;
+ --gov-fg: ${THEME_DEFAULTS.fg};
+ --gov-muted: ${THEME_DEFAULTS.muted};
+ --gov-border: ${THEME_DEFAULTS.border};
+ --gov-surface: ${THEME_DEFAULTS.surface};
+ --gov-warn: ${THEME_DEFAULTS.warn};
+ --gov-danger: ${THEME_DEFAULTS.danger};
+ --gov-radius: ${THEME_DEFAULTS.radius};
display: block;
- color: var(--gov-fg);
+ color: ${themeVar("fg")};
font: inherit;
}
:host([hidden]) { display: none; }
button {
font: inherit;
color: inherit;
- background: var(--gov-surface);
- border: 1px solid var(--gov-border);
- border-radius: var(--gov-radius);
+ background: ${themeVar("surface")};
+ border: 1px solid ${themeVar("border")};
+ border-radius: ${themeVar("radius")};
padding: 0.4em 0.8em;
cursor: pointer;
}
- button:hover:not(:disabled) { border-color: var(--gov-fg); }
+ button:hover:not(:disabled) { border-color: ${themeVar("fg")}; }
button:disabled { opacity: 0.5; cursor: not-allowed; }
.reason {
- color: var(--gov-muted);
+ color: ${themeVar("muted")};
font-size: 0.875em;
}
.row { display: flex; gap: 0.5em; align-items: center; flex-wrap: wrap; }
diff --git a/packages/widget/src/expose-version.js b/packages/widget/src/expose-version.js
new file mode 100644
index 0000000..7c5bef7
--- /dev/null
+++ b/packages/widget/src/expose-version.js
@@ -0,0 +1,29 @@
+import { VERSION } from "@bitgate/core";
+
+/**
+ * Publish `window.bitgate.version` for script-tag integrators.
+ *
+ * Additive: creates `window.bitgate` when missing, otherwise writes `version`
+ * onto the existing object so a host-provided namespace is not replaced.
+ * No-op in Node (no `window`).
+ *
+ * @param {Record
} [target] - Defaults to `globalThis.window`
+ * @returns {Record|null} The namespace that received `version`
+ */
+export function exposeBitGateVersion(target) {
+ const root =
+ target ??
+ (typeof globalThis.window !== "undefined"
+ ? /** @type {Record} */ (globalThis.window)
+ : null);
+ if (!root || typeof root !== "object") {
+ return null;
+ }
+
+ const existing = root.bitgate;
+ const ns =
+ existing && typeof existing === "object" && !Array.isArray(existing) ? existing : {};
+ ns.version = VERSION;
+ root.bitgate = ns;
+ return ns;
+}
diff --git a/packages/widget/src/index.js b/packages/widget/src/index.js
index 0e84329..de3da41 100644
--- a/packages/widget/src/index.js
+++ b/packages/widget/src/index.js
@@ -21,9 +21,11 @@ export {
} from "@bitgate/runtime";
export {
+ VERSION,
SOCIAL_POLICY,
COMMERCE_POLICY,
ADMIN_ONLY_POLICY,
+ ALLOWLIST_POLICY,
POLICY_PRESETS,
getPolicyPreset,
createPolicyDefinition,
@@ -42,6 +44,7 @@ export {
export {
BASE_STYLES,
+ THEME_DEFAULTS,
GovernanceElement,
canRegisterElements,
defineElement,
@@ -49,8 +52,11 @@ export {
requestContext,
shortenKey,
targetFromAttributes,
+ themeVar,
} from "./base.js";
+export { exposeBitGateVersion } from "./expose-version.js";
+
export {
BitGateError,
BitGateProvider,
@@ -76,9 +82,12 @@ export {
} from "./admin.js";
import { defineAdminElements } from "./admin.js";
+import { exposeBitGateVersion } from "./expose-version.js";
import { defineProviderElements } from "./provider.js";
import { defineViewerElements } from "./viewer.js";
+exposeBitGateVersion();
+
/**
* Register every governance element.
*
diff --git a/packages/widget/src/provider.js b/packages/widget/src/provider.js
index 0550a07..18a8917 100644
--- a/packages/widget/src/provider.js
+++ b/packages/widget/src/provider.js
@@ -151,7 +151,7 @@ export class BitGateProvider extends ProviderBase {
if (!policy) {
throw new Error(
- `Unknown policy preset "${policyName}". Use social, commerce, admin-only, or set .policy directly.`,
+ `Unknown policy preset "${policyName}". Use social, commerce, admin-only, allowlist, or set .policy directly.`,
);
}
if (relays.length === 0) {
diff --git a/packages/widget/src/viewer.js b/packages/widget/src/viewer.js
index 5e5b74a..d558f8c 100644
--- a/packages/widget/src/viewer.js
+++ b/packages/widget/src/viewer.js
@@ -10,6 +10,7 @@ import {
escapeHtml,
shortenKey,
targetFromAttributes,
+ themeVar,
} from "./base.js";
/**
@@ -161,7 +162,7 @@ export class GovernanceVeil extends GovernanceElement {
position: absolute; inset: 0; display: grid; place-content: center;
gap: 0.5em; text-align: center; padding: 1em;
}
- .warn { color: var(--gov-warn); }
+ .warn { color: ${themeVar("warn")}; }
diff --git a/packages/widget/test/build-version.test.js b/packages/widget/test/build-version.test.js
new file mode 100644
index 0000000..fae137b
--- /dev/null
+++ b/packages/widget/test/build-version.test.js
@@ -0,0 +1,27 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { build } from "esbuild";
+import { describe, expect, it } from "vitest";
+
+import { bitgateVersionPlugin, readLibraryVersion } from "../../../scripts/esbuild-bitgate-version.mjs";
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const versionJs = join(HERE, "..", "..", "core", "src", "version.js");
+
+describe("build-time version injection", () => {
+ it("replaces the version module with package.json's version", async () => {
+ const version = readLibraryVersion();
+ const result = await build({
+ entryPoints: [versionJs],
+ bundle: true,
+ write: false,
+ format: "esm",
+ platform: "neutral",
+ plugins: [bitgateVersionPlugin(version)],
+ });
+
+ const bundled = result.outputFiles[0].text;
+ expect(bundled).toContain(`VERSION = ${JSON.stringify(version)}`);
+ expect(bundled).not.toContain("Keep this string in lockstep");
+ });
+});
diff --git a/packages/widget/test/provider.test.js b/packages/widget/test/provider.test.js
index fca1dfe..ddffa46 100644
--- a/packages/widget/test/provider.test.js
+++ b/packages/widget/test/provider.test.js
@@ -135,6 +135,11 @@ describe("
", () => {
expect(provider.runtime.policies.policy.id).toBe("bitgate-commerce");
});
+ it("accepts the allowlist policy preset", async () => {
+ const provider = await mountProvider({ policy: "allowlist" });
+ expect(provider.runtime.policies.policy.id).toBe("bitgate-allowlist");
+ });
+
it("defaults to administrative-only governance", async () => {
const provider = await mountProvider({ policy: null });
expect(provider.runtime.policies.policy.id).toBe("bitgate-admin-only");
@@ -154,6 +159,7 @@ describe("", () => {
const provider = await mountProvider({ policy: "invented" });
expect(provider.runtime).toBeNull();
expect(provider.getAttribute("data-error")).toMatch(/Unknown policy preset/);
+ expect(provider.getAttribute("data-error")).toMatch(/allowlist/);
});
it("reports a missing relays attribute", async () => {
diff --git a/packages/widget/test/theme.test.js b/packages/widget/test/theme.test.js
new file mode 100644
index 0000000..0d30a52
--- /dev/null
+++ b/packages/widget/test/theme.test.js
@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+
+import { BASE_STYLES, THEME_DEFAULTS, themeVar } from "../src/base.js";
+
+describe("theme tokens", () => {
+ it("resolves --bitgate-* first, then deprecated --gov-*, then the default", () => {
+ for (const name of Object.keys(THEME_DEFAULTS)) {
+ expect(themeVar(/** @type {keyof typeof THEME_DEFAULTS} */ (name))).toBe(
+ `var(--bitgate-${name}, var(--gov-${name}, ${THEME_DEFAULTS[name]}))`,
+ );
+ }
+ });
+
+ it("keeps --gov-* host defaults so existing overrides still apply", () => {
+ for (const [name, value] of Object.entries(THEME_DEFAULTS)) {
+ expect(BASE_STYLES).toContain(`--gov-${name}: ${value}`);
+ }
+ });
+
+ it("does not assign --bitgate-* on :host (that would shadow --gov-* overrides)", () => {
+ expect(BASE_STYLES).not.toMatch(/--bitgate-[a-z]+:/);
+ });
+
+ it("uses the fallback chain at every painted token", () => {
+ expect(BASE_STYLES).toContain(themeVar("fg"));
+ expect(BASE_STYLES).toContain(themeVar("muted"));
+ expect(BASE_STYLES).toContain(themeVar("border"));
+ expect(BASE_STYLES).toContain(themeVar("surface"));
+ expect(BASE_STYLES).toContain(themeVar("radius"));
+ });
+});
diff --git a/packages/widget/test/version.test.js b/packages/widget/test/version.test.js
new file mode 100644
index 0000000..f62c267
--- /dev/null
+++ b/packages/widget/test/version.test.js
@@ -0,0 +1,28 @@
+// @vitest-environment happy-dom
+
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+
+import { VERSION, exposeBitGateVersion } from "../src/index.js";
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const rootPkg = JSON.parse(readFileSync(join(HERE, "..", "..", "..", "package.json"), "utf8"));
+
+describe("VERSION", () => {
+ it("matches package.json", () => {
+ expect(VERSION).toBe(rootPkg.version);
+ });
+
+ it("is published on window.bitgate when the widget is imported", () => {
+ expect(/** @type {any} */ (window).bitgate.version).toBe(VERSION);
+ });
+
+ it("writes version onto an existing window.bitgate object", () => {
+ const target = { bitgate: { extra: true } };
+ exposeBitGateVersion(target);
+ expect(target.bitgate.version).toBe(VERSION);
+ expect(target.bitgate.extra).toBe(true);
+ });
+});
diff --git a/scripts/esbuild-bitgate-version.mjs b/scripts/esbuild-bitgate-version.mjs
new file mode 100644
index 0000000..4ce0534
--- /dev/null
+++ b/scripts/esbuild-bitgate-version.mjs
@@ -0,0 +1,30 @@
+/**
+ * esbuild plugin: replace `@bitgate/core`'s version module with the value from
+ * package.json so browser bundles cannot drift from the package.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+
+/** @returns {string} */
+export function readLibraryVersion() {
+ return JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8")).version;
+}
+
+/**
+ * @param {string} [injected]
+ * @returns {import("esbuild").Plugin}
+ */
+export function bitgateVersionPlugin(injected = readLibraryVersion()) {
+ return {
+ name: "bitgate-version",
+ setup(pluginBuild) {
+ pluginBuild.onLoad({ filter: /[/\\]core[/\\]src[/\\]version\.js$/ }, () => ({
+ contents: `export const VERSION = ${JSON.stringify(injected)};\n`,
+ loader: "js",
+ }));
+ },
+ };
+}