@chatlychat/widget-element 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@chatlychat/widget-element` — the Chatly widget as a custom element, and the
+ * embed lifecycle every framework wrapper shares.
+ *
+ * **This entry has no side effects.** Importing it does not define a custom
+ * element and does not touch `document`. That is what lets
+ * `@chatlychat/widget-react` depend on this package for the lifecycle without
+ * registering a tag its consumers never asked for, and it is what makes the
+ * package importable from a server bundle.
+ *
+ * To get `<chatly-widget>`:
+ *
+ *     import '@chatlychat/widget-element/register';
+ *     // or, to choose the tag name:
+ *     import { defineChatlyWidget } from '@chatlychat/widget-element';
+ *     defineChatlyWidget('acme-chat');
+ */
+export { controls, startWidget, subscribe, DEFAULT_LOADER_URL, type ChatlyEmbedHandle, } from './embed.js';
+/**
+ * Test-only. Resets the module's mount state between tests and reports what
+ * it believes is mounted.
+ *
+ * Exported because `@chatlychat/widget-react`'s tests need it and a workspace
+ * package cannot reach past the `exports` map to a deep path. Named with the
+ * same `__testing` convention as `apps/realtime/src/gateway.ts` so it reads as
+ * what it is. Calling it in production does nothing useful: it forgets the
+ * widget without destroying it, which is the leak the refcount exists to
+ * prevent.
+ */
+export { __testing } from './embed.js';
+export { defineChatlyWidget, CHATLY_WIDGET_TAG, ELEMENT_EVENTS, type ChatlyElementEvent, type ChatlyWidgetElement, } from './element.js';
+export type { ChatlyBehavior, ChatlyCopy, ChatlyEmbedHandlers, ChatlyEmbedOptions, ChatlyEventName, ChatlyIdentity, ChatlyInitOptions, ChatlyMessageEvent, ChatlyQuickLink, ChatlyQuip, ChatlySession, ChatlyTheme, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AACpB;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * `@chatlychat/widget-element` — the Chatly widget as a custom element, and the
+ * embed lifecycle every framework wrapper shares.
+ *
+ * **This entry has no side effects.** Importing it does not define a custom
+ * element and does not touch `document`. That is what lets
+ * `@chatlychat/widget-react` depend on this package for the lifecycle without
+ * registering a tag its consumers never asked for, and it is what makes the
+ * package importable from a server bundle.
+ *
+ * To get `<chatly-widget>`:
+ *
+ *     import '@chatlychat/widget-element/register';
+ *     // or, to choose the tag name:
+ *     import { defineChatlyWidget } from '@chatlychat/widget-element';
+ *     defineChatlyWidget('acme-chat');
+ */
+export { controls, startWidget, subscribe, DEFAULT_LOADER_URL, } from './embed.js';
+/**
+ * Test-only. Resets the module's mount state between tests and reports what
+ * it believes is mounted.
+ *
+ * Exported because `@chatlychat/widget-react`'s tests need it and a workspace
+ * package cannot reach past the `exports` map to a deep path. Named with the
+ * same `__testing` convention as `apps/realtime/src/gateway.ts` so it reads as
+ * what it is. Calling it in production does nothing useful: it forgets the
+ * widget without destroying it, which is the leak the refcount exists to
+ * prevent.
+ */
+export { __testing } from './embed.js';
+export { defineChatlyWidget, CHATLY_WIDGET_TAG, ELEMENT_EVENTS, } from './element.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,kBAAkB,GAEnB,MAAM,YAAY,CAAC;AACpB;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GAGf,MAAM,cAAc,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":""}

package/dist/register.js

@@ -0,0 +1,12 @@
+/**
+ * The side-effecting entry: `import '@chatlychat/widget-element/register'`.
+ *
+ * Separate from `index.ts` on purpose. A package that defines a custom
+ * element as a side effect of being imported cannot be used for its types or
+ * its helpers without that happening, and it breaks any bundle evaluated on a
+ * server. Here the side effect is the whole point, and a consumer opts into it
+ * by importing this path.
+ */
+import { defineChatlyWidget } from './element.js';
+defineChatlyWidget();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,kBAAkB,EAAE,CAAC"}

package/dist/same-value.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Did the host page actually ask for something different?
+ *
+ * Every `<chatly-widget>` attribute change and every React re-render arrives
+ * here, and the answer decides whether the widget is re-initialised — which
+ * destroys and remounts it, closing an open panel. So "the same options
+ * spelled differently" has to compare equal.
+ *
+ * Lifted out of `embed.ts` when that file went over the repo's 650-line
+ * ceiling. Pure functions over plain values, which is why they were the right
+ * thing to move: nothing here touches the embed's mount state.
+ */
+import type { ChatlyInitOptions } from './types.js';
+/**
+ * Structural equality, with named exceptions.
+ *
+ * `JSON.stringify` was the obvious implementation and is wrong twice: key
+ * order differs between two literals with the same contents (so every render
+ * would look like a change), and `mountTo` can be an Element, which
+ * stringifies to `{}` — making two different containers compare equal and a
+ * moved mount point silently ignored.
+ */
+export declare function sameOptions(a: ChatlyInitOptions, b: ChatlyInitOptions, ignore?: readonly string[]): boolean;
+export declare function sameValue(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=same-value.d.ts.map

package/dist/same-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"same-value.d.ts","sourceRoot":"","sources":["../src/same-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,iBAAiB,EACpB,CAAC,EAAE,iBAAiB,EACpB,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,OAAO,CAaT;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAgCzD"}

package/dist/same-value.js

@@ -0,0 +1,60 @@
+/**
+ * Structural equality, with named exceptions.
+ *
+ * `JSON.stringify` was the obvious implementation and is wrong twice: key
+ * order differs between two literals with the same contents (so every render
+ * would look like a change), and `mountTo` can be an Element, which
+ * stringifies to `{}` — making two different containers compare equal and a
+ * moved mount point silently ignored.
+ */
+export function sameOptions(a, b, ignore = []) {
+    const keys = new Set([...Object.keys(a), ...Object.keys(b)].filter((k) => !ignore.includes(k)));
+    for (const key of keys) {
+        // Through `unknown`: an interface with named optional keys does not
+        // overlap an index signature, and TypeScript is right to say so — the
+        // read below is deliberately dynamic.
+        const left = a[key];
+        const right = b[key];
+        if (!sameValue(left, right)) {
+            return false;
+        }
+    }
+    return true;
+}
+export function sameValue(a, b) {
+    if (a === b) {
+        return true;
+    }
+    // An absent key and an explicit `undefined` are the same request. React
+    // props produce both for the same JSX depending on how they were spread.
+    if (a === undefined || b === undefined || a === null || b === null) {
+        return false;
+    }
+    if (typeof a !== 'object' || typeof b !== 'object') {
+        return false;
+    }
+    // A DOM node or a function is compared by identity only — recursing into an
+    // Element would walk the host page's entire tree.
+    if (isOpaque(a) || isOpaque(b)) {
+        return false;
+    }
+    if (Array.isArray(a) !== Array.isArray(b)) {
+        return false;
+    }
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((item, i) => sameValue(item, b[i]));
+    }
+    const left = a;
+    const right = b;
+    const keys = new Set([...Object.keys(left), ...Object.keys(right)]);
+    for (const key of keys) {
+        if (!sameValue(left[key], right[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+function isOpaque(value) {
+    return typeof Node !== 'undefined' && value instanceof Node;
+}
+//# sourceMappingURL=same-value.js.map

package/dist/same-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"same-value.js","sourceRoot":"","sources":["../src/same-value.ts"],"names":[],"mappings":"AAcA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,CAAoB,EACpB,CAAoB,EACpB,SAA4B,EAAE;IAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,oEAAoE;QACpE,sEAAsE;QACtE,sCAAsC;QACtC,MAAM,IAAI,GAAI,CAAwC,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAI,CAAwC,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAU,EAAE,CAAU;IAC9C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,wEAAwE;IACxE,yEAAyE;IACzE,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,4EAA4E;IAC5E,kDAAkD;IAClD,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,IAAI,GAAG,CAA4B,CAAC;IAC1C,MAAM,KAAK,GAAG,CAA4B,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,CAAC;AAC9D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,241 @@
+/**
+ * The widget's init options, as a dependency-free type.
+ *
+ * ── Why these are declared again here ───────────────────────────────────
+ *
+ * The authoritative declaration is `InitOptions` in `apps/widget/src/index.ts`.
+ * It cannot be imported: that file is a Preact app entry whose import graph
+ * pulls in `preact`, `@preact/signals` and a `?inline` CSS import, and this
+ * package ships to a customer's bundler with zero dependencies. The headless
+ * SDK makes the same call for the same reason (`packages/sdk-js/src/types.ts`
+ * — importing `@livechat/shared` drags zod in, measured at ~11KB gzipped).
+ *
+ * Two copies of a shape is a drift risk, so it is a CHECKED one:
+ * `scripts/check-widget-wrapper-parity.mjs` compares the key sets in this file
+ * against the widget's own interfaces and fails the build when either side
+ * gains a key the other does not have. Without that gate the failure is
+ * silent and one-directional — the widget adds `theme.somethingNew`, a React
+ * consumer passes it, and TypeScript rejects a value the widget would have
+ * honoured.
+ *
+ * Nothing here is validated at runtime, and that is deliberate (see
+ * `coerceConfig` in `embed.ts` for the one place a boundary exists).
+ */
+/** Identity the host page already knows. Mirrors the widget's `WidgetIdentity`. */
+export interface ChatlyIdentity {
+    /**
+     * Your own stable id for this person. Optional in the type, but it is the
+     * only field contacts are matched on — without it every visit creates a new
+     * contact.
+     */
+    externalId?: string;
+    email?: string;
+    name?: string;
+    /**
+     * `HMAC-SHA256(<channel IDV secret>, externalId)`, computed by YOUR SERVER.
+     * Never in the browser: the secret would be in your page source.
+     */
+    userHash?: string;
+    attributes?: Record<string, unknown>;
+}
+/** Colours, shape, type and launcher art. Mirrors the widget's `WidgetTheme`. */
+export interface ChatlyTheme {
+    icons?: Partial<Record<'mic' | 'stop' | 'attachment' | 'check' | 'star', string>>;
+    primaryColor?: string;
+    primaryContrast?: string;
+    background?: string;
+    backgroundSubtle?: string;
+    foreground?: string;
+    foregroundMuted?: string;
+    border?: string;
+    bubbleAgentBg?: string;
+    bubbleAgentFg?: string;
+    fontFamily?: string;
+    fontSize?: number | string;
+    borderRadius?: number | string;
+    launcherSize?: number;
+    panelWidth?: number;
+    panelHeight?: number;
+    position?: 'left' | 'right';
+    offsetX?: number;
+    offsetY?: number;
+    headerStyle?: 'gradient' | 'solid' | 'plain';
+    headerGradient?: [string, string];
+    hideLauncher?: boolean;
+    launcherIcon?: string;
+    launcherImage?: string;
+    launcherPing?: boolean;
+    launcherIdleAnimation?: 'none' | 'wiggle' | 'pulse' | 'bounce';
+    colorScheme?: 'light' | 'dark' | 'auto';
+    dangerColor?: string;
+    successColor?: string;
+    warningColor?: string;
+    hideBranding?: boolean;
+    logoUrl?: string;
+    agentAvatarUrl?: string;
+}
+/** Rotating micro-copy bound to a selector. Mirrors `WidgetQuip`. */
+export interface ChatlyQuip {
+    selector: string;
+    lines: string[];
+    intervalMs?: number;
+    oncePerSession?: boolean;
+}
+/** Behaviour toggles. Mirrors the widget's `WidgetBehavior`. */
+export interface ChatlyBehavior {
+    tabs?: Array<'home' | 'messages' | 'help'>;
+    defaultTab?: 'home' | 'messages' | 'help';
+    autoOpenAfterMs?: number;
+    hideOnUrls?: string[];
+    helpSearchOnly?: boolean;
+    starterPrompts?: string[];
+    home?: Array<'start' | 'recent' | 'quickLinks' | 'blocks' | 'helpSearch'>;
+    /**
+     * A `{ v, blocks }` envelope, the same shape a message carries. `unknown`
+     * rather than a block union: the widget validates it at the render boundary
+     * precisely so a block type a newer release added does not blank the home
+     * screen on an older bundle, and a narrow type here would refuse at compile
+     * time the forward compatibility the runtime was built to allow.
+     */
+    homeBlocks?: unknown;
+    draggable?: boolean;
+    quips?: ChatlyQuip[];
+    confettiClickStreak?: number;
+}
+/** A Home-tab button. Mirrors `WidgetQuickLink`. */
+export interface ChatlyQuickLink {
+    label: string;
+    href?: string;
+    startConversation?: string | {
+        initialMessage?: string;
+    };
+    description?: string;
+    icon?: string;
+}
+/** Every string in the panel. Mirrors `WidgetCopy`. */
+export interface ChatlyCopy {
+    greeting?: string;
+    greetingSubtitle?: string;
+    homeStartCta?: string;
+    homeStartCtaSubtitle?: string;
+    homeRecentTitle?: string;
+    homeQuickLinksTitle?: string;
+    homeHelpTitle?: string;
+    tabHome?: string;
+    tabMessages?: string;
+    tabHelp?: string;
+    messagesEmpty?: string;
+    messagesNewCta?: string;
+    helpSearchPlaceholder?: string;
+    helpEmpty?: string;
+    helpNoResults?: string;
+    helpStillNeedHelp?: string;
+    composerPlaceholder?: string;
+    composerSend?: string;
+    poweredBy?: string;
+    closeAria?: string;
+    backAria?: string;
+    unavailableMessage?: string;
+    unavailableRetry?: string;
+}
+/**
+ * Everything `Chatly.init()` accepts, minus `on`.
+ *
+ * The lifecycle callbacks are deliberately absent: a wrapper has to install
+ * ONE stable set of them at boot and fan out to whatever the host most
+ * recently passed, or every render with a fresh inline arrow function would
+ * look like a changed config and re-initialise the widget. See
+ * `ChatlyEmbedHandlers` and the `handlers` box in `embed.ts`.
+ */
+export interface ChatlyInitOptions {
+    /** Channel public ID. Required. */
+    publicId: string;
+    apiUrl?: string;
+    realtimeUrl?: string;
+    visitor?: ChatlyIdentity;
+    theme?: ChatlyTheme;
+    behavior?: ChatlyBehavior;
+    quickLinks?: ChatlyQuickLink[];
+    /**
+     * Mount inside an element of your own layout instead of floating.
+     *
+     * Both wrappers set this for you from their own container, so a host rarely
+     * passes it directly — in React it is `<ChatlyWidget inline />` and in the
+     * custom element it is the `inline` attribute. Passing a selector by hand
+     * still works and still carries the widget's refusal behaviour: a selector
+     * that matches nothing mounts NOTHING and says so.
+     */
+    mountTo?: string | Element;
+    cssOverrides?: string;
+    copy?: ChatlyCopy;
+    copyByLocale?: Record<string, ChatlyCopy>;
+}
+/**
+ * The widget's event names, as `Chatly.on()` spells them.
+ *
+ * `ready` is a state rather than a moment — the widget replays the last one
+ * to a late subscriber — and both wrappers rely on that, because a React
+ * effect or a `connectedCallback` can easily run after the session is up.
+ */
+export type ChatlyEventName = 'ready' | 'open' | 'close' | 'message' | 'conversation' | 'identified' | 'reset' | 'action' | 'error';
+/** What a `ready` or `identified` event carries. */
+export interface ChatlySession {
+    contactId: string | null;
+    workspaceId: string;
+}
+/** What a `message` event carries. */
+export interface ChatlyMessageEvent {
+    id: string;
+    body: string;
+    authorType: string;
+}
+/**
+ * Subscribers a wrapper forwards to.
+ *
+ * Every one is optional and every one is called with whatever the widget
+ * emitted — these are not re-typed payloads, they are the widget's own.
+ */
+export interface ChatlyEmbedHandlers {
+    onReady?: (session: ChatlySession) => void;
+    onOpen?: () => void;
+    onClose?: () => void;
+    onMessage?: (message: ChatlyMessageEvent) => void;
+    onConversation?: (detail: unknown) => void;
+    onIdentified?: (session: ChatlySession) => void;
+    onReset?: (detail: unknown) => void;
+    /** A visitor pressed a `host_event` action on a rich block. */
+    onAction?: (detail: unknown) => void;
+    /**
+     * The widget could not do something it was asked to do.
+     *
+     * Reported rather than thrown. The widget's own `chatly:error` event is the
+     * source, and it fires for a refused origin, a dead network and a 5xx —
+     * none of which a host page can do anything about by crashing.
+     */
+    onError?: (detail: unknown) => void;
+}
+/** Where `loader.js` is served from, plus the init options. */
+export interface ChatlyEmbedOptions extends ChatlyInitOptions {
+    /**
+     * The loader script URL.
+     *
+     * Defaults to Chatly Cloud's. A SELF-HOSTED deployment must set it: the
+     * default points a visitor's browser at our CDN, which for a self-hoster is
+     * both wrong and the kind of wrong that still renders a working chat bubble
+     * (talking to the wrong API) rather than failing loudly.
+     *
+     * `GET /v1/channels/:id` returns the right value for your deployment as
+     * `embed.loaderUrl`. Use that rather than typing a host.
+     */
+    loaderUrl?: string;
+    /**
+     * Set the widget's locale once it is up, via `Chatly.setLocale()`.
+     *
+     * Not an init option — the widget has none. The strings come from `copy`
+     * and `copyByLocale` in the embed, so `locale` picks between bundles YOU
+     * supplied; asking for a locale with no bundle warns rather than appearing
+     * to work. Changing it does NOT re-initialise the widget.
+     */
+    locale?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAElF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3B,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE/D,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAExC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC,CAAC;IAC1E;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,MAAM,GACN,OAAO,GACP,SAAS,GACT,cAAc,GACd,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AAEZ,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAClD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,25 @@
+/**
+ * The widget's init options, as a dependency-free type.
+ *
+ * ── Why these are declared again here ───────────────────────────────────
+ *
+ * The authoritative declaration is `InitOptions` in `apps/widget/src/index.ts`.
+ * It cannot be imported: that file is a Preact app entry whose import graph
+ * pulls in `preact`, `@preact/signals` and a `?inline` CSS import, and this
+ * package ships to a customer's bundler with zero dependencies. The headless
+ * SDK makes the same call for the same reason (`packages/sdk-js/src/types.ts`
+ * — importing `@livechat/shared` drags zod in, measured at ~11KB gzipped).
+ *
+ * Two copies of a shape is a drift risk, so it is a CHECKED one:
+ * `scripts/check-widget-wrapper-parity.mjs` compares the key sets in this file
+ * against the widget's own interfaces and fails the build when either side
+ * gains a key the other does not have. Without that gate the failure is
+ * silent and one-directional — the widget adds `theme.somethingNew`, a React
+ * consumer passes it, and TypeScript rejects a value the widget would have
+ * honoured.
+ *
+ * Nothing here is validated at runtime, and that is deliberate (see
+ * `coerceConfig` in `embed.ts` for the one place a boundary exists).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@chatlychat/widget-element",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The Chatly chat widget as a custom element (<chatly-widget>), plus the embed lifecycle framework wrappers share. Zero dependencies.",
+  "license": "MIT",
+  "homepage": "https://github.com/livechat/platform/tree/main/packages/widget-element",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/livechat/platform.git",
+    "directory": "packages/widget-element"
+  },
+  "bugs": "https://github.com/livechat/platform/issues",
+  "keywords": [
+    "chatly",
+    "livechat",
+    "chat",
+    "widget",
+    "custom-element",
+    "web-component",
+    "support"
+  ],
+  "author": "LiveChat Platform Engineering",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js",
+      "default": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.spec.*",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "pnpm build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src --max-warnings=0",
+    "test": "vitest run"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@livechat/config": "workspace:*",
+    "jsdom": "^30.0.1",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}