@c15t/browser 3.0.0-alpha.0

package/dist/index.js

@@ -0,0 +1,17 @@
+import { client_createConsentClient } from "./925.js";
+import { mountConsentUI as mount_mountConsentUI } from "./861.js";
+const PKG = '@c15t/browser';
+const src_createConsentClient = function(options = {}) {
+    return client_createConsentClient(options, {
+        mountUI: mount_mountConsentUI,
+        pkg: PKG
+    });
+};
+const src_init = function(options = {}) {
+    const client = src_createConsentClient(options);
+    client.start();
+    return client;
+};
+export { ACTION_ATTRIBUTE, ACTIVATED_ATTRIBUTE, CATEGORY_ATTRIBUTE, PREFERENCES_HASH, activateGatedScripts, custom, hosted, manifest, manifestNeedsLocation, offline, resolveRules, version } from "./925.js";
+export { mountConsentUI } from "./861.js";
+export { src_createConsentClient as createConsentClient, src_init as init };

package/dist-types/auto-init.d.ts

@@ -0,0 +1,42 @@
+import type { ConsentClientOptions } from './types';
+/** Attribute that turns auto-init off so the page calls `c15t.init()`. */
+export declare const MANUAL_ATTRIBUTE = "data-manual";
+/**
+ * Read client options from a `<script>` tag's `data-*` attributes.
+ *
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@c15t/browser/dist/c15t.js"
+ *   data-backend-url="https://your-instance.c15t.dev"
+ *   data-categories="measurement,marketing"
+ *   data-color-scheme="dark"
+ *   data-privacy-policy-url="/privacy"
+ *   defer></script>
+ * ```
+ *
+ * @param element - The script element, or `null` outside a classic script.
+ * @returns Options for `init()`.
+ */
+export declare const readScriptOptions: (element: Element | null) => ConsentClientOptions;
+/**
+ * Layer one options object over another. `ui` and its banner/dialog
+ * option objects merge, so a queued `config` can change the branding
+ * without discarding the script tag's legal links. Booleans replace
+ * the corresponding UI or surface configuration.
+ *
+ * @param base - The options underneath.
+ * @param override - The options on top.
+ * @returns The merged options.
+ */
+export declare const mergeClientOptions: (base: ConsentClientOptions, override: ConsentClientOptions) => ConsentClientOptions;
+/**
+ * Resolve the page's options: the script tag's attributes first, then each
+ * queued `config` call on top, in order.
+ *
+ * @param script - The current script element.
+ * @param configs - Options queued as `['config', options]` before load.
+ * @returns Options and whether the page asked to init itself.
+ */
+export declare const readPageOptions: (script: Element | null, configs?: ConsentClientOptions[]) => {
+    options: ConsentClientOptions;
+    manual: boolean;
+};

package/dist-types/client.d.ts

@@ -0,0 +1,51 @@
+import { custom, hosted } from '@c15t/core';
+import type { PolicyRule, Unsubscribe } from '@c15t/core';
+import type { ConsentRuntimeIABFactory } from '@c15t/core/runtime';
+import type { ConsentClient, ConsentClientOptions, ConsentUIMounter } from './types';
+export { custom, hosted };
+/** Attribute a page element can carry to drive the client on click. */
+export declare const ACTION_ATTRIBUTE = "data-c15t-action";
+/** Link fragment that opens the preference centre, matching `@c15t/astro`. */
+export declare const PREFERENCES_HASH = "#c15t-preferences";
+/** Values `data-c15t-action` accepts. */
+export type PageAction = 'accept' | 'reject' | 'customize' | 'dismiss' | 'close' | 'banner';
+/** Extra wiring the entry points hand to the client. */
+export interface CreateConsentClientContext {
+    /** Install entry-specific globals before runtime initialization. */
+    onStart?: (options: ConsentClientOptions) => () => void;
+    /** Optional CMP factory supplied exclusively by the IAB entry. */
+    createIAB?: ConsentRuntimeIABFactory;
+    /** Mounts the prebuilt UI. Absent in the headless build. */
+    mountUI?: ConsentUIMounter;
+    /** Package name reported on `window.c15t`. */
+    pkg?: string;
+}
+/**
+ * Turn preset names into policy rules.
+ *
+ * @param policyRules - Rules, preset names, or a mix.
+ * @returns Rules only, or `undefined` when none were given.
+ * @throws {Error} On a name `policyRulePresets` does not export.
+ */
+export declare const resolveRules: (policyRules: ConsentClientOptions['policyRules']) => PolicyRule[] | undefined;
+/**
+ * Create the page's consent client without starting it.
+ *
+ * Construction has no DOM or storage effects. Call {@link ConsentClient.start}
+ * to hydrate stored records, resolve the policy and mount the UI.
+ *
+ * @param options - Client options.
+ * @param context - Entry-point wiring.
+ * @returns The client.
+ * @throws {Error} When the mode cannot be resolved from the options.
+ */
+export declare const createConsentClient: (options?: ConsentClientOptions, context?: CreateConsentClientContext) => ConsentClient;
+/**
+ * Create and start a client in one call.
+ *
+ * @param options - Client options.
+ * @param context - Entry-point wiring.
+ * @returns The started client.
+ */
+export declare const initConsentClient: (options?: ConsentClientOptions, context?: CreateConsentClientContext) => ConsentClient;
+export type { Unsubscribe };

package/dist-types/deferred.d.ts

@@ -0,0 +1,13 @@
+/** A promise plus the functions that settle it. */
+export interface Deferred<Value> {
+    promise: Promise<Value>;
+    resolve: (value: Value) => void;
+    reject: (reason: unknown) => void;
+}
+/**
+ * Create a promise that something else settles later, such as a kernel
+ * event. `Promise.withResolvers` where the browser has it.
+ *
+ * @returns The deferred.
+ */
+export declare const createDeferred: <Value>() => Deferred<Value>;

package/dist-types/devtools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `@c15t/browser/devtools` — the c15t DevTools panel for the script-tag
+ * client, the way `@c15t/react/devtools` mounts it for a React provider.
+ *
+ * The panel inspects consents, scripts, policy and events, and its
+ * Location tab changes country, region, language and GPC and re-runs
+ * init, so a geo-keyed policy can be tried without spoofing headers.
+ *
+ * @example
+ * ```ts
+ * import { init } from '@c15t/browser';
+ * import { mountDevTools } from '@c15t/browser/devtools';
+ *
+ * const client = init({ backendURL: 'https://your-instance.c15t.dev' });
+ * if (import.meta.env.DEV) {
+ *   mountDevTools(client, { defaultOpen: true, defaultTab: 'location' });
+ * }
+ * ```
+ */
+import type { DevToolsInstance, DevToolsOptions } from '@c15t/dev-tools';
+import type { ConsentClient } from './types';
+/** Presentation options; the kernel and categories come from the client. */
+export type BrowserDevToolsOptions = Omit<DevToolsOptions, 'getConsentCategories' | 'kernel'>;
+/**
+ * Mount the DevTools panel against a client.
+ *
+ * @param client - The page's client.
+ * @param options - Panel placement and initial state.
+ * @returns The panel; call `destroy()` to remove it.
+ */
+export declare const mountDevTools: (client: ConsentClient, options?: BrowserDevToolsOptions) => DevToolsInstance;
+export type { DevToolsActions, DevToolsInstance, DevToolsPosition, DevToolsTab, } from '@c15t/dev-tools';

package/dist-types/entries/cdn-devtools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `dist/c15t.devtools.js` — the DevTools panel as a second script tag.
+ *
+ * ```html
+ * <script src=".../c15t.js" data-backend-url="..." defer></script>
+ * <script src=".../c15t.devtools.js" data-open data-tab="location" defer></script>
+ * ```
+ *
+ * Order does not matter: loaded first, it queues itself on `window.c15t`
+ * the way any pre-load call does and mounts once the client initialises.
+ * The panel lands on `window.c15t.devtools`.
+ */
+export {};

package/dist-types/entries/cdn-headless.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `dist/c15t.headless.js` — the runtime with no UI or CSS.
+ *
+ * Installs `window.c15t` and initialises from the script tag unless it
+ * carries `data-manual`. The page renders its own banner against the
+ * client's events and `data-c15t-action` buttons.
+ */
+export {};

package/dist-types/entries/cdn-iab.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-types/entries/cdn.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `dist/c15t.js` — the one-tag install.
+ *
+ * Installs `window.c15t`, then initialises from the script tag's `data-*`
+ * attributes and any queued `config` calls unless the tag carries
+ * `data-manual`.
+ */
+export {};

package/dist-types/gated-scripts.d.ts

@@ -0,0 +1,35 @@
+import type { ConsentSnapshot } from '@c15t/core';
+/** Attribute that names the category an inert `<script>` waits on. */
+export declare const CATEGORY_ATTRIBUTE = "data-c15t-category";
+/** Set once a gated script has been activated (or rejected as invalid). */
+export declare const ACTIVATED_ATTRIBUTE = "data-c15t-activated";
+/** A client's script queue, cancelled when that client is disposed. */
+interface GatedScriptActivator {
+    scan: () => number;
+    dispose: () => void;
+}
+/**
+ * Own activation ordering without retaining a client outside its lifecycle.
+ *
+ * @param getSnapshot - Read current consent before each activation.
+ * @param root - Where to look. Defaults to the document when scanning.
+ * @returns A scanner and its disposal function.
+ * @internal
+ */
+export declare const createGatedScriptActivator: (getSnapshot: () => ConsentSnapshot, root?: ParentNode) => GatedScriptActivator;
+/**
+ * Run inert `<script type="text/plain" data-c15t-category="…">` tags whose
+ * categories the snapshot grants. Non-async scripts run in document order,
+ * waiting for each external script to load or fail before continuing.
+ *
+ * Call again when consent changes so waiting scripts use the latest snapshot.
+ * Each script runs at most once; withdrawing consent after activation requires
+ * vendor cleanup or a page reload.
+ *
+ * @param snapshot - The kernel snapshot.
+ * @param root - Where to look. Defaults to the document.
+ * @returns How many scripts were activated immediately. Others may be waiting
+ * for an earlier external script.
+ */
+export declare const activateGatedScripts: (snapshot: ConsentSnapshot, root?: ParentNode) => number;
+export {};

package/dist-types/generated/iab-styles.d.ts

@@ -0,0 +1,144 @@
+export declare const stylesheet: string;
+export declare const classes: {
+    readonly banner: {
+        readonly root: "c15t-ui-root-wCtZ2";
+        readonly bannerVisible: "c15t-ui-bannerVisible-uqQdb";
+        readonly bannerHidden: "c15t-ui-bannerHidden-KVkXf";
+        readonly cardShell: "c15t-ui-cardShell-pmM71";
+        readonly card: "c15t-ui-card-lJZdN";
+        readonly header: "c15t-ui-header-WMRYy";
+        readonly title: "c15t-ui-title-iMdl2";
+        readonly description: "c15t-ui-description-_ZLiC";
+        readonly partnersLink: "c15t-ui-partnersLink-yKsgB";
+        readonly purposeList: "c15t-ui-purposeList-Qz2Eo";
+        readonly purposeMore: "c15t-ui-purposeMore-aANSf";
+        readonly legitimateInterestNotice: "c15t-ui-legitimateInterestNotice-QtcwV";
+        readonly privacyLink: "c15t-ui-privacyLink-RYh_l";
+        readonly footer: "c15t-ui-footer-danOO";
+        readonly overlay: "c15t-ui-overlay-OPamO";
+        readonly overlayVisible: "c15t-ui-overlayVisible-JAO1l";
+        readonly overlayHidden: "c15t-ui-overlayHidden-zfbJA";
+    };
+    readonly dialog: {
+        readonly root: "c15t-ui-root-pWvoN";
+        readonly dialogVisible: "c15t-ui-dialogVisible-ZcQux";
+        readonly dialogHidden: "c15t-ui-dialogHidden-QOLab";
+        readonly contentVisible: "c15t-ui-contentVisible-oIYEE";
+        readonly contentHidden: "c15t-ui-contentHidden-dppgu";
+        readonly overlay: "c15t-ui-overlay-LyBwJ";
+        readonly overlayVisible: "c15t-ui-overlayVisible-HyYf_";
+        readonly overlayHidden: "c15t-ui-overlayHidden-G8kpl";
+        readonly card: "c15t-ui-card-DTFr5";
+        readonly header: "c15t-ui-header-wVNlq";
+        readonly headerContent: "c15t-ui-headerContent-djclo";
+        readonly title: "c15t-ui-title-PNS3O";
+        readonly description: "c15t-ui-description-kGL5G";
+        readonly closeButton: "c15t-ui-closeButton-LDT86";
+        readonly body: "c15t-ui-body-IFzVC";
+        readonly tabsContainer: "c15t-ui-tabsContainer-CGMHA";
+        readonly tabsList: "c15t-ui-tabsList-w5OMX";
+        readonly tabButton: "c15t-ui-tabButton-TaxQK";
+        readonly tabIndicator: "c15t-ui-tabIndicator-ipeu4";
+        readonly content: "c15t-ui-content-tpKyG";
+        readonly purposeItem: "c15t-ui-purposeItem-ycHg8";
+        readonly purposeHeader: "c15t-ui-purposeHeader-dtjf3";
+        readonly purposeTrigger: "c15t-ui-purposeTrigger-RYEFG";
+        readonly purposeArrow: "c15t-ui-purposeArrow-O8n8H";
+        readonly purposeInfo: "c15t-ui-purposeInfo-wahTP";
+        readonly purposeName: "c15t-ui-purposeName-QJMF_";
+        readonly lockIcon: "c15t-ui-lockIcon-i8SD3";
+        readonly purposeMeta: "c15t-ui-purposeMeta-OC9IY";
+        readonly legitimateInterestBadge: "c15t-ui-legitimateInterestBadge-t0cqx";
+        readonly legitimateInterestIcon: "c15t-ui-legitimateInterestIcon-Pvt34";
+        readonly srOnly: "c15t-ui-srOnly-n1PBG";
+        readonly purposeContent: "c15t-ui-purposeContent-teoEc";
+        readonly purposeDescription: "c15t-ui-purposeDescription-eLaj6";
+        readonly examplesToggle: "c15t-ui-examplesToggle-UKJ4l";
+        readonly examplesList: "c15t-ui-examplesList-Jgu0V";
+        readonly vendorsToggle: "c15t-ui-vendorsToggle-iiROe";
+        readonly vendorSection: "c15t-ui-vendorSection-Xotxt";
+        readonly vendorSectionTitle: "c15t-ui-vendorSectionTitle-fDzFC";
+        readonly vendorSectionTitleLi: "c15t-ui-vendorSectionTitleLi-_EU2B";
+        readonly vendorRow: "c15t-ui-vendorRow-MdJwv";
+        readonly vendorRowLi: "c15t-ui-vendorRowLi-TR3to";
+        readonly vendorInfo: "c15t-ui-vendorInfo-cLXjo";
+        readonly vendorName: "c15t-ui-vendorName-U5tbA";
+        readonly customVendorIcon: "c15t-ui-customVendorIcon-xE8uf";
+        readonly vendorDetails: "c15t-ui-vendorDetails-nJLMH";
+        readonly vendorDetail: "c15t-ui-vendorDetail-qWyPR";
+        readonly vendorDetailLi: "c15t-ui-vendorDetailLi-HiywZ";
+        readonly stackItem: "c15t-ui-stackItem-Z6dCC";
+        readonly stackHeader: "c15t-ui-stackHeader-TkNdL";
+        readonly stackTrigger: "c15t-ui-stackTrigger-Kqeyy";
+        readonly stackInfo: "c15t-ui-stackInfo-JH0ue";
+        readonly stackName: "c15t-ui-stackName-yNHhd";
+        readonly stackMeta: "c15t-ui-stackMeta-Il_rX";
+        readonly stackControls: "c15t-ui-stackControls-kBZON";
+        readonly partialIndicator: "c15t-ui-partialIndicator-U9dt6";
+        readonly stackDescription: "c15t-ui-stackDescription-occgV";
+        readonly stackContent: "c15t-ui-stackContent-wu6FF";
+        readonly specialPurposesSection: "c15t-ui-specialPurposesSection-y9Pqu";
+        readonly specialPurposesHeader: "c15t-ui-specialPurposesHeader-Rq1Tg";
+        readonly specialPurposesTitle: "c15t-ui-specialPurposesTitle-tcftu";
+        readonly infoIcon: "c15t-ui-infoIcon-Egw87";
+        readonly tooltip: "c15t-ui-tooltip-XjaZq";
+        readonly tooltipVisible: "c15t-ui-tooltipVisible-saaoQ";
+        readonly vendorListHeader: "c15t-ui-vendorListHeader-Hfxxu";
+        readonly searchContainer: "c15t-ui-searchContainer-uyKJB";
+        readonly searchIcon: "c15t-ui-searchIcon-NhyW4";
+        readonly searchInput: "c15t-ui-searchInput-cLLuO";
+        readonly vendorCount: "c15t-ui-vendorCount-s4d6i";
+        readonly selectedVendorBanner: "c15t-ui-selectedVendorBanner-S6KCv";
+        readonly selectedVendorText: "c15t-ui-selectedVendorText-jjIQi";
+        readonly clearSelectionButton: "c15t-ui-clearSelectionButton-yz3Zx";
+        readonly clearIcon: "c15t-ui-clearIcon-sTZC2";
+        readonly vendorListItem: "c15t-ui-vendorListItem-NwBiX";
+        readonly vendorListItemHeader: "c15t-ui-vendorListItemHeader-fBe_O";
+        readonly vendorConsentControl: "c15t-ui-vendorConsentControl-VC70A";
+        readonly vendorConsentSwitch: "c15t-ui-vendorConsentSwitch-wEFf8";
+        readonly vendorListTrigger: "c15t-ui-vendorListTrigger-TG_0F";
+        readonly vendorListInfo: "c15t-ui-vendorListInfo-BSgBB";
+        readonly vendorListName: "c15t-ui-vendorListName-II_BV";
+        readonly vendorListMeta: "c15t-ui-vendorListMeta-wa6UC";
+        readonly vendorListMetaText: "c15t-ui-vendorListMetaText-MS_cF";
+        readonly vendorListLiBadge: "c15t-ui-vendorListLiBadge-_Uq0L";
+        readonly vendorListContent: "c15t-ui-vendorListContent-CtRTw";
+        readonly vendorLinks: "c15t-ui-vendorLinks-pxq9Z";
+        readonly tabPanel: "c15t-ui-tabPanel-PJKhk";
+        readonly vendorLink: "c15t-ui-vendorLink-htHQn";
+        readonly vendorLinkIcon: "c15t-ui-vendorLinkIcon-UjIy5";
+        readonly vendorBadges: "c15t-ui-vendorBadges-SED5E";
+        readonly vendorBadge: "c15t-ui-vendorBadge-Pu0Hs";
+        readonly vendorPurposesList: "c15t-ui-vendorPurposesList-CtEFC";
+        readonly vendorPurposesTitle: "c15t-ui-vendorPurposesTitle-2hGY4";
+        readonly vendorPurposesItems: "c15t-ui-vendorPurposesItems-VKo31";
+        readonly vendorPurposeItem: "c15t-ui-vendorPurposeItem-TmnWw";
+        readonly vendorPurposeItemLi: "c15t-ui-vendorPurposeItemLi-rO_6B";
+        readonly vendorRetention: "c15t-ui-vendorRetention-TTJ2U";
+        readonly footer: "c15t-ui-footer-YF32K";
+        readonly consentNotice: "c15t-ui-consentNotice-PEEG3";
+        readonly consentNoticeText: "c15t-ui-consentNoticeText-MhMCM";
+        readonly loadingContainer: "c15t-ui-loadingContainer-iW124";
+        readonly loadingSpinner: "c15t-ui-loadingSpinner-W8iiY";
+        readonly loadingText: "c15t-ui-loadingText-o2XqJ";
+        readonly emptyState: "c15t-ui-emptyState-nmTzy";
+        readonly emptyStateText: "c15t-ui-emptyStateText-HuJtF";
+        readonly vendorSectionHeading: "c15t-ui-vendorSectionHeading-s4i73";
+        readonly vendorSectionIcon: "c15t-ui-vendorSectionIcon-Cc99v";
+        readonly iabVendorSectionHeader: "c15t-ui-iabVendorSectionHeader-YsNA5";
+        readonly iabVendorNotice: "c15t-ui-iabVendorNotice-WnMMx";
+        readonly customVendorSectionHeader: "c15t-ui-customVendorSectionHeader-Sy8yM";
+        readonly customVendorNotice: "c15t-ui-customVendorNotice-NgBsE";
+        readonly customVendorItem: "c15t-ui-customVendorItem-QF5C7";
+        readonly customVendorPurposeSection: "c15t-ui-customVendorPurposeSection-zFEUM";
+        readonly vendorSectionTitleCustom: "c15t-ui-vendorSectionTitleCustom-JjHzO";
+        readonly objectButton: "c15t-ui-objectButton-S0x1H";
+        readonly objectButtonActive: "c15t-ui-objectButtonActive-AlNLv";
+        readonly liExplanation: "c15t-ui-liExplanation-_r6Zx";
+        readonly vendorLiSection: "c15t-ui-vendorLiSection-sqzvi";
+        readonly vendorLiSectionHeader: "c15t-ui-vendorLiSectionHeader-fsKUh";
+        readonly purposeLiSection: "c15t-ui-purposeLiSection-YbwuC";
+        readonly purposeLiSectionHeader: "c15t-ui-purposeLiSectionHeader-cSbP3";
+        readonly purposeLiInfo: "c15t-ui-purposeLiInfo-Rpryr";
+    };
+};

package/dist-types/generated/styles.d.ts

@@ -0,0 +1,137 @@
+export declare const stylesheet: string;
+export declare const classes: {
+    readonly accordion: {
+        readonly list: "c15t-ui-list-T3EU0";
+        readonly item: "c15t-ui-item-Jgm_X";
+        readonly triggerRow: "c15t-ui-triggerRow-xXdTH";
+        readonly trigger: "c15t-ui-trigger-KT5J_";
+        readonly content: "c15t-ui-content-qdPhy";
+        readonly arrow: "c15t-ui-arrow-JFKgd";
+        readonly header: "c15t-ui-header-ogZie";
+        readonly title: "c15t-ui-title-vmC1f";
+        readonly control: "c15t-ui-control-dy7nh";
+        readonly restriction: "c15t-ui-restriction-bXiI7";
+        readonly contentViewport: "c15t-ui-contentViewport-O2Kny";
+        readonly contentInner: "c15t-ui-contentInner-b3ykf";
+    };
+    readonly actions: {
+        readonly actionRoot: "c15t-ui-actionRoot-hYTak";
+        readonly actionGroup: "c15t-ui-actionGroup-GmX6v";
+    };
+    readonly banner: {
+        readonly root: "c15t-ui-root-p7SV0";
+        readonly bannerEnterActive: "c15t-ui-bannerEnterActive-IytGL";
+        readonly bannerLeaveActive: "c15t-ui-bannerLeaveActive-C7qrk";
+        readonly bannerEnterFrom: "c15t-ui-bannerEnterFrom-BJMc7";
+        readonly bannerLeaveTo: "c15t-ui-bannerLeaveTo-dXNcB";
+        readonly bannerEnterTo: "c15t-ui-bannerEnterTo-yatsy";
+        readonly bannerLeaveFrom: "c15t-ui-bannerLeaveFrom-RVGoD";
+        readonly bannerVisible: "c15t-ui-bannerVisible-AFth0";
+        readonly bannerHidden: "c15t-ui-bannerHidden-R0_3M";
+        readonly cardShell: "c15t-ui-cardShell-djyPy";
+        readonly card: "c15t-ui-card-lgjVq";
+        readonly footer: "c15t-ui-footer-JhJAe";
+        readonly rights: "c15t-ui-rights-wZg5K";
+        readonly rightLink: "c15t-ui-rightLink-IXsSJ";
+        readonly header: "c15t-ui-header-S6GiJ";
+        readonly title: "c15t-ui-title-vm8nL";
+        readonly description: "c15t-ui-description-s8Qhg";
+        readonly overlay: "c15t-ui-overlay-DoHh4";
+        readonly overlayEnterActive: "c15t-ui-overlayEnterActive-YGn_8";
+        readonly overlayLeaveActive: "c15t-ui-overlayLeaveActive-FvP5W";
+        readonly overlayEnterFrom: "c15t-ui-overlayEnterFrom-OtDqj";
+        readonly overlayLeaveTo: "c15t-ui-overlayLeaveTo-V7aI7";
+        readonly overlayEnterTo: "c15t-ui-overlayEnterTo-jcvNq";
+        readonly overlayLeaveFrom: "c15t-ui-overlayLeaveFrom-EYTMT";
+        readonly overlayVisible: "c15t-ui-overlayVisible-ywHQp";
+        readonly overlayHidden: "c15t-ui-overlayHidden-WgrJC";
+    };
+    readonly branding: {
+        readonly branding: "c15t-ui-branding-yf52E";
+        readonly brandingCopy: "c15t-ui-brandingCopy-ktA4u";
+        readonly brandingText: "c15t-ui-brandingText-ls0cn";
+        readonly brandingBy: "c15t-ui-brandingBy-CWN3T";
+        readonly brandingWordmarkLabel: "c15t-ui-brandingWordmarkLabel-FxCKX";
+        readonly brandingC15T: "c15t-ui-brandingC15T-GVCPl";
+        readonly brandingWordmark: "c15t-ui-brandingWordmark-yqSW2";
+        readonly brandingC15TMark: "c15t-ui-brandingC15TMark-VvBd_";
+        readonly brandingInth: "c15t-ui-brandingInth-bviD3";
+        readonly brandingTag: "c15t-ui-brandingTag-V3N0M";
+        readonly brandingContent: "c15t-ui-brandingContent-Z9PVI";
+        readonly brandingTagBanner: "c15t-ui-brandingTagBanner-zFtcX";
+        readonly brandingTagDialog: "c15t-ui-brandingTagDialog-Iv_a_";
+        readonly brandingFooter: "c15t-ui-brandingFooter-QIudR";
+    };
+    readonly button: {
+        readonly button: "c15t-ui-button-IiSDl";
+        readonly buttonIcon: "c15t-ui-buttonIcon-QgScm";
+    };
+    readonly dialog: {
+        readonly root: "c15t-ui-root-I07nx";
+        readonly overlay: "c15t-ui-overlay-c1WEk";
+        readonly "consent-dialog-fade-in": "c15t-ui-consent-dialog-fade-in-I04Yp";
+        readonly consentDialogFadeIn: "c15t-ui-consent-dialog-fade-in-I04Yp";
+        readonly "consent-dialog-fade-out": "c15t-ui-consent-dialog-fade-out-t5_x2";
+        readonly consentDialogFadeOut: "c15t-ui-consent-dialog-fade-out-t5_x2";
+        readonly container: "c15t-ui-container-KTZOT";
+        readonly enter: "c15t-ui-enter-vWVet";
+        readonly exit: "c15t-ui-exit-ioDiW";
+        readonly card: "c15t-ui-card-ve6qQ";
+        readonly "consent-dialog-slide-in-left": "c15t-ui-consent-dialog-slide-in-left-N9bgJ";
+        readonly consentDialogSlideInLeft: "c15t-ui-consent-dialog-slide-in-left-N9bgJ";
+        readonly "consent-dialog-slide-out-left": "c15t-ui-consent-dialog-slide-out-left-hkcUP";
+        readonly consentDialogSlideOutLeft: "c15t-ui-consent-dialog-slide-out-left-hkcUP";
+        readonly "consent-dialog-slide-in-right": "c15t-ui-consent-dialog-slide-in-right-L40wh";
+        readonly consentDialogSlideInRight: "c15t-ui-consent-dialog-slide-in-right-L40wh";
+        readonly "consent-dialog-slide-out-right": "c15t-ui-consent-dialog-slide-out-right-GjtEq";
+        readonly consentDialogSlideOutRight: "c15t-ui-consent-dialog-slide-out-right-GjtEq";
+        readonly dialogVisible: "c15t-ui-dialogVisible-dkX4M";
+        readonly dialogHidden: "c15t-ui-dialogHidden-uBU9W";
+        readonly contentVisible: "c15t-ui-contentVisible-KxAWb";
+        readonly contentHidden: "c15t-ui-contentHidden-LflgF";
+        readonly headerWrapper: "c15t-ui-headerWrapper-DQg3z";
+        readonly closeButton: "c15t-ui-closeButton-uPYIe";
+        readonly footer: "c15t-ui-footer-PeM4f";
+        readonly overlayVisible: "c15t-ui-overlayVisible-gG3jJ";
+        readonly overlayHidden: "c15t-ui-overlayHidden-eY362";
+        readonly header: "c15t-ui-header-VbAnL";
+        readonly title: "c15t-ui-title-ErzRZ";
+        readonly description: "c15t-ui-description-OQyBx";
+        readonly content: "c15t-ui-content-Y_5Ie";
+    };
+    readonly legalLinks: {
+        readonly legalLinks: "c15t-ui-legalLinks-h6W20";
+        readonly legalLink: "c15t-ui-legalLink-bBp6b";
+    };
+    readonly manager: {
+        readonly manager: "c15t-ui-manager-VznZW";
+        readonly footer: "c15t-ui-footer-fl3dz";
+    };
+    readonly switch: {
+        readonly root: "c15t-ui-root-LX1QP";
+        readonly track: "c15t-ui-track-TjViT";
+        readonly thumb: "c15t-ui-thumb-Uunnr";
+        readonly rootSmall: "c15t-ui-rootSmall-wI5cb";
+        readonly trackSmall: "c15t-ui-trackSmall-tAU5X";
+        readonly thumbSmall: "c15t-ui-thumbSmall-IrKfB";
+    };
+    readonly trigger: {
+        readonly trigger: "c15t-ui-trigger-Hjg5y";
+        readonly dragging: "c15t-ui-dragging-R4Cm2";
+        readonly sm: "c15t-ui-sm-sud0y";
+        readonly md: "c15t-ui-md-CZrWA";
+        readonly lg: "c15t-ui-lg-fGzix";
+        readonly icon: "c15t-ui-icon-dD5R6";
+        readonly text: "c15t-ui-text-Garil";
+        readonly bottomRight: "c15t-ui-bottomRight-RqjMF";
+        readonly bottomLeft: "c15t-ui-bottomLeft-J3DsX";
+        readonly topRight: "c15t-ui-topRight-Ln04J";
+        readonly topLeft: "c15t-ui-topLeft-tpeaf";
+        readonly snapping: "c15t-ui-snapping-YupfG";
+        readonly hidden: "c15t-ui-hidden-tV2GK";
+        readonly toolbar: "c15t-ui-toolbar-gCKkL";
+        readonly toolbarVertical: "c15t-ui-toolbarVertical-MQ8bT";
+        readonly toolbarItem: "c15t-ui-toolbarItem-OO8Dy";
+        readonly toolbarIcon: "c15t-ui-toolbarIcon-FpHKR";
+    };
+};

package/dist-types/global.d.ts

@@ -0,0 +1,112 @@
+import { custom, hosted } from '@c15t/core';
+import type { AllConsentNames, ConsentSnapshot, HasCondition, KernelUser, Unsubscribe } from '@c15t/core';
+import type { DevToolsInstance } from '@c15t/dev-tools';
+import type { CreateConsentClientContext } from './client';
+import { manifest } from './transports/manifest';
+import { offline } from './transports/offline';
+import type { ConsentClient, ConsentClientEventMap, ConsentClientOptions, ConsentUIHandle, ConsentUIOptions } from './types';
+/** The name the script-tag build installs itself under. */
+export declare const GLOBAL_NAME = "c15t";
+/** A call queued before the script loaded: `[method, ...args]`. */
+export type QueuedCall = [method: string, ...args: unknown[]];
+/**
+ * `window.c15t`, the one global the script-tag builds use.
+ *
+ * Before the tag loads it is a plain array of queued calls:
+ *
+ * ```html
+ * <script>
+ *   window.c15t = window.c15t || [];
+ *   c15t.push(['config', { consentCategories: ['measurement'] }]);
+ *   c15t.push(['on', 'consent', (snapshot) => console.log(snapshot)]);
+ * </script>
+ * ```
+ *
+ * The tag replaces it with this object and replays the queue in order.
+ * Before `init()` the read methods throw and `on()`/`ready()` wait; after
+ * it everything proxies to the page's client. `version`, `pkg` and `mode`
+ * keep the shape `@c15t/core` installs for devtools.
+ */
+export interface C15tGlobal {
+    /** Package version. */
+    readonly version: string;
+    /** Package name. */
+    readonly pkg: string;
+    /** Transport kind, once initialised. */
+    readonly mode: string | null;
+    /** The page's client, once initialised. */
+    readonly client: ConsentClient | null;
+    /**
+     * Add options before `init()`. Later calls win over earlier ones, and
+     * all of them win over the tag's `data-*` attributes. After `init()`
+     * it warns and does nothing.
+     *
+     * @param options - Client options to layer on.
+     */
+    config: (options: ConsentClientOptions) => void;
+    /**
+     * Create and start the page's client. A second call returns the
+     * existing one.
+     *
+     * @param options - Client options layered over the tag's attributes and
+     * every queued `config`.
+     * @returns The page's client.
+     */
+    init: (options?: ConsentClientOptions) => ConsentClient;
+    /**
+     * Run once the client exists, immediately if it already does. Safe to
+     * call before `init()`; `c15t.devtools.js` mounts through this.
+     *
+     * @param listener - Called with the client.
+     * @returns A function that cancels the call if it has not run yet.
+     */
+    onInit: (listener: (client: ConsentClient) => void) => Unsubscribe;
+    /** The DevTools panel, once `c15t.devtools.js` has mounted it. */
+    devtools: DevToolsInstance | null;
+    /** Resolves once the policy is resolved. Safe to call before `init()`. */
+    ready: () => Promise<ConsentSnapshot>;
+    /** Listen for a client event. Safe to call before `init()`. */
+    on: <EventName extends keyof ConsentClientEventMap>(event: EventName, listener: (payload: ConsentClientEventMap[EventName]) => void) => Unsubscribe;
+    getSnapshot: () => ConsentSnapshot;
+    subscribe: (listener: (snapshot: ConsentSnapshot) => void) => Unsubscribe;
+    has: (condition: HasCondition<AllConsentNames>) => boolean;
+    hasConsented: () => boolean;
+    acceptAll: ConsentClient['acceptAll'];
+    rejectAll: ConsentClient['rejectAll'];
+    save: ConsentClient['save'];
+    saveIAB: ConsentClient['saveIAB'];
+    dismissNotice: ConsentClient['dismissNotice'];
+    showBanner: () => void;
+    openDialog: () => void;
+    closeDialog: () => void;
+    setLanguage: (code: string) => void;
+    identify: (user: KernelUser) => Promise<void>;
+    mountUI: (options?: ConsentUIOptions) => ConsentUIHandle;
+    dispose: () => void;
+    /** Transport factories, for `init({ mode: c15t.hosted({ url }) })`. */
+    hosted: typeof hosted;
+    offline: typeof offline;
+    custom: typeof custom;
+    manifest: typeof manifest;
+}
+/**
+ * Put the API on `window.c15t`, replaying in order any calls a page queued
+ * on the array that was there before the script loaded.
+ *
+ * @param api - The API object.
+ */
+export declare const installGlobal: (api: C15tGlobal) => C15tGlobal;
+/**
+ * Build the global API object.
+ *
+ * @param context - Entry-point wiring (UI mounter, package name).
+ * @returns The API, not yet installed on `window`.
+ */
+export declare const createGlobal: (context: CreateConsentClientContext) => C15tGlobal;
+/**
+ * Initialise from the script tag unless the page opted out.
+ *
+ * @param api - The installed API.
+ * @returns The client, or `null` when the page asked to init itself.
+ */
+export declare const autoInit: (api: C15tGlobal) => ConsentClient | null;