@johnmorrisdotca/kumimoji 1.2.2 → 1.3.0

package/dist/daily.d.ts

@@ -8,7 +8,27 @@
  * hand, level, length) gets the same bag, in the same order. The race against
  * the clock is then theirs.
  */
-/** The day a moment falls on, in UTC, written `YYYY-MM-DD`. Throws a `RangeError` for an invalid `Date`. */
+/** The day a moment falls on, in UTC, written `YYYY-MM-DD`. Throws a `RangeError` for an invalid `Date`.
+ *
+ * @param at - The word offset, seat index or date specified by this signature.
+ * @returns The day a moment falls on, in UTC, written `YYYY-MM-DD`. Throws a `RangeError` for an invalid `Date`.
+ * @example
+ * ```ts
+ * import { kumimojiDay } from "@johnmorrisdotca/kumimoji";
+ *
+ * console.log(kumimojiDay(new Date("2026-10-12T12:00:00Z")));
+ * ```
+ */
 export declare function kumimojiDay(at: Date): string;
-/** Today's seed, the date as a number: 2026-10-01 is 20261001. The day is UTC, so it is one seed worldwide. */
+/** Today's seed, the date as a number: 2026-10-01 is 20261001. The day is UTC, so it is one seed worldwide.
+ *
+ * @param at - The word offset, seat index or date specified by this signature.
+ * @returns Today's seed, the date as a number: 2026-10-01 is 20261001. The day is UTC, so it is one seed worldwide.
+ * @example
+ * ```ts
+ * import { kumimojiDailySeed } from "@johnmorrisdotca/kumimoji";
+ *
+ * console.log(kumimojiDailySeed(new Date("2026-10-12T12:00:00Z")));
+ * ```
+ */
 export declare function kumimojiDailySeed(at: Date): number;

package/dist/daily.js

@@ -9,13 +9,33 @@
  * the clock is then theirs.
  */
 const pad = (value, width) => String(value).padStart(width, "0");
-/** The day a moment falls on, in UTC, written `YYYY-MM-DD`. Throws a `RangeError` for an invalid `Date`. */
+/** The day a moment falls on, in UTC, written `YYYY-MM-DD`. Throws a `RangeError` for an invalid `Date`.
+ *
+ * @param at - The word offset, seat index or date specified by this signature.
+ * @returns The day a moment falls on, in UTC, written `YYYY-MM-DD`. Throws a `RangeError` for an invalid `Date`.
+ * @example
+ * ```ts
+ * import { kumimojiDay } from "@johnmorrisdotca/kumimoji";
+ *
+ * console.log(kumimojiDay(new Date("2026-10-12T12:00:00Z")));
+ * ```
+ */
 export function kumimojiDay(at) {
     if (Number.isNaN(at.getTime()))
         throw new RangeError("kumimoji: an invalid Date has no day");
     return `${pad(at.getUTCFullYear(), 4)}-${pad(at.getUTCMonth() + 1, 2)}-${pad(at.getUTCDate(), 2)}`;
 }
-/** Today's seed, the date as a number: 2026-10-01 is 20261001. The day is UTC, so it is one seed worldwide. */
+/** Today's seed, the date as a number: 2026-10-01 is 20261001. The day is UTC, so it is one seed worldwide.
+ *
+ * @param at - The word offset, seat index or date specified by this signature.
+ * @returns Today's seed, the date as a number: 2026-10-01 is 20261001. The day is UTC, so it is one seed worldwide.
+ * @example
+ * ```ts
+ * import { kumimojiDailySeed } from "@johnmorrisdotca/kumimoji";
+ *
+ * console.log(kumimojiDailySeed(new Date("2026-10-12T12:00:00Z")));
+ * ```
+ */
 export function kumimojiDailySeed(at) {
     const [year, month, day] = kumimojiDay(at).split("-").map(Number);
     return year * 10000 + month * 100 + day;

package/dist/element-define.d.ts

@@ -1 +1 @@
-export {};
+export * from "./element.ts";

package/dist/element-define.js

@@ -1,13 +1,3 @@
-/**
- * Defines the `<kumimoji-table>` element on the page. Import it for its effect:
- *
- * ```html
- * <script type="module" src="https://cdn.jsdelivr.net/npm/@johnmorrisdotca/kumimoji@1/dist/element-define.js"></script>
- * <kumimoji-table language="english" hand="7"></kumimoji-table>
- * ```
- *
- * A tag already defined is left as it is, and on a server, where there is no page, nothing happens.
- */
-import { KumimojiTable } from "./element.js";
-if (typeof customElements !== "undefined" && customElements.get("kumimoji-table") === undefined)
-    customElements.define("kumimoji-table", KumimojiTable);
+import { defineTable } from "./element.js";
+defineTable();
+export * from "./element.js";

package/dist/element.d.ts

@@ -1,4 +1,4 @@
-import { type KumimojiTableHandle } from "./ui/mount.ts";
+import { type KumimojiTableHandle, type KumimojiTableOptions } from "./ui/mount.ts";
 import type { KumimojiSaved } from "./export.ts";
 declare const ElementBase: typeof HTMLElement;
 /**
@@ -12,8 +12,7 @@ declare const ElementBase: typeof HTMLElement;
  * <kumimoji-table language="japanese" level="easy" seed="daily"></kumimoji-table>
  * ```
  *
- * Attributes (each is read again when it changes; a change to any but `lang`
- * deals a new game):
+ * Attributes configure the starting game; display, language and control changes preserve play:
  *  - `language`: the tiles, `english` (default) or `japanese` kana.
  *  - `hand`: the opening hand, 3, 7 (default) or 11.
  *  - `level`: how many tiles are wild, `easy` (most), `medium` (default) or `hard` (none).
@@ -25,11 +24,41 @@ declare const ElementBase: typeof HTMLElement;
  * It fires `kumimoji-change` after every change to the game, with the game as it would
  * be saved as `event.detail.saved`, and `kumimoji-finish` when the last tile is laid and every run
  * is a word, with `event.detail` the deal, the play and the time it took. It has the methods
- * `newGame()` and `setGame()`. A table the rules do not offer (a hand of 5, say) draws nothing.
+ * `newGame()` and `setGame()`. Invalid input shows a status and a plain error event.
+ */
+/**
+ * Native table options, checked alongside builder coverage.
+ * @example
+ * ```ts
+ * import { KUMIMOJI_EMBED_OPTION_KEYS } from "@johnmorrisdotca/kumimoji/element";
+ * console.log(KUMIMOJI_EMBED_OPTION_KEYS.includes("saved"));
+ * ```
+ */
+export declare const KUMIMOJI_EMBED_OPTION_KEYS: string[];
+/**
+ * Full native host options, including saved state, private words and callbacks.
+ * @example
+ * ```ts
+ * import type { KumimojiElementOptions } from "@johnmorrisdotca/kumimoji/element";
+ * const options: KumimojiElementOptions = { keep: false, locale: "ja" };
+ * console.log(options.locale);
+ * ```
+ */
+export type KumimojiElementOptions = KumimojiTableOptions;
+/**
+ * A reflected crossword table with the native table handle and saved-state getter.
+ * @example
+ * ```ts
+ * import { KumimojiTable } from "@johnmorrisdotca/kumimoji/element";
+ * console.log(KumimojiTable.observedAttributes.includes("daily"));
+ * ```
  */
 export declare class KumimojiTable extends ElementBase {
     #private;
     static observedAttributes: string[];
+    /** Native host options. Callback/presentation changes preserve the current game. */
+    get options(): KumimojiElementOptions;
+    set options(value: KumimojiElementOptions);
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
@@ -41,5 +70,57 @@ export declare class KumimojiTable extends ElementBase {
     newGame(options?: Parameters<KumimojiTableHandle["newGame"]>[0]): Promise<void>;
     /** Put a game on the table: see `KumimojiTableHandle.setGame`. */
     setGame(saved: KumimojiSaved): Promise<void>;
+    /** The `language` attribute, reflected. */
+    get language(): string | null;
+    set language(value: string | number | boolean | null | undefined);
+    /** The `hand` attribute, reflected. */
+    get hand(): string | null;
+    set hand(value: string | number | boolean | null | undefined);
+    /** The `level` attribute, reflected. */
+    get level(): string | null;
+    set level(value: string | number | boolean | null | undefined);
+    /** The `length` attribute, reflected. */
+    get length(): string | null;
+    set length(value: string | number | boolean | null | undefined);
+    /** The `diagonals` attribute, reflected. */
+    get diagonals(): string | null;
+    set diagonals(value: string | number | boolean | null | undefined);
+    /** The `seed` attribute, reflected. */
+    get seed(): string | null;
+    set seed(value: string | number | boolean | null | undefined);
+    /** The `keep` attribute, reflected. */
+    get keep(): string | null;
+    set keep(value: string | number | boolean | null | undefined);
+    /** The `daily` attribute, reflected. */
+    get daily(): string | null;
+    set daily(value: string | number | boolean | null | undefined);
+    /** The `controls` attribute, reflected. */
+    get controls(): string | null;
+    set controls(value: string | number | boolean | null | undefined);
+    /** The `theme` attribute, reflected. */
+    get theme(): string | null;
+    set theme(value: string | number | boolean | null | undefined);
+    /** The `size` attribute, reflected. */
+    get size(): string | null;
+    set size(value: string | number | boolean | null | undefined);
+    /** The `width` attribute, reflected. */
+    get width(): string | null;
+    set width(value: string | number | boolean | null | undefined);
+    /** The `label` attribute, reflected. */
+    get label(): string | null;
+    set label(value: string | number | boolean | null | undefined);
 }
+/**
+ * Defines the table or a subclass under a custom tag. Server-safe and idempotent.
+ * @param tagName - The tag name; kumimoji-table by default.
+ * @param registry - The page registry, or undefined on a server.
+ * @returns Nothing; existing definitions are left alone.
+ * @example
+ * ```ts
+ * import { defineTable } from "@johnmorrisdotca/kumimoji/element";
+ * defineTable();
+ * console.log(typeof defineTable);
+ * ```
+ */
+export declare function defineTable(tagName?: string, registry?: CustomElementRegistry | undefined): void;
 export {};

package/dist/element.js

@@ -9,14 +9,16 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _KumimojiTable_instances, _KumimojiTable_table, _KumimojiTable_key, _KumimojiTable_queued, _KumimojiTable_seed, _KumimojiTable_refresh;
+var _KumimojiTable_instances, _KumimojiTable_table, _KumimojiTable_key, _KumimojiTable_queued, _KumimojiTable_seed, _KumimojiTable_options, _KumimojiTable_revision, _KumimojiTable_widthBefore, _KumimojiTable_widthOwned, _KumimojiTable_labelBefore, _KumimojiTable_write, _KumimojiTable_frame, _KumimojiTable_refresh;
+import { embedDay } from "./embed-day.js";
+import { KUMIMOJI_STYLE } from "./ui/style.js";
 import { kumimojiDailySeed } from "./daily.js";
 import { KUMIMOJI_HANDS } from "./tiles.constants.js";
 import { mountKumimoji } from "./ui/mount.js";
 const ElementBase = typeof HTMLElement === "undefined" ? class {
 } : HTMLElement;
 const oneOf = (value, allowed) => (allowed.includes(value) ? value : undefined);
-const isOn = (value) => value !== null && ["true", "on", "1", "yes"].includes(value.toLowerCase());
+const isOn = (value, fallback = false) => value === null ? fallback : !["false", "off", "no", "0"].includes(value.trim().toLowerCase());
 const HANDS = Object.values(KUMIMOJI_HANDS);
 /**
  * THE `<kumimoji-table>` ELEMENT: a game of Kumimoji alone in a tag, with no
@@ -29,8 +31,7 @@ const HANDS = Object.values(KUMIMOJI_HANDS);
  * <kumimoji-table language="japanese" level="easy" seed="daily"></kumimoji-table>
  * ```
  *
- * Attributes (each is read again when it changes; a change to any but `lang`
- * deals a new game):
+ * Attributes configure the starting game; display, language and control changes preserve play:
  *  - `language`: the tiles, `english` (default) or `japanese` kana.
  *  - `hand`: the opening hand, 3, 7 (default) or 11.
  *  - `level`: how many tiles are wild, `easy` (most), `medium` (default) or `hard` (none).
@@ -42,7 +43,24 @@ const HANDS = Object.values(KUMIMOJI_HANDS);
  * It fires `kumimoji-change` after every change to the game, with the game as it would
  * be saved as `event.detail.saved`, and `kumimoji-finish` when the last tile is laid and every run
  * is a word, with `event.detail` the deal, the play and the time it took. It has the methods
- * `newGame()` and `setGame()`. A table the rules do not offer (a hand of 5, say) draws nothing.
+ * `newGame()` and `setGame()`. Invalid input shows a status and a plain error event.
+ */
+/**
+ * Native table options, checked alongside builder coverage.
+ * @example
+ * ```ts
+ * import { KUMIMOJI_EMBED_OPTION_KEYS } from "@johnmorrisdotca/kumimoji/element";
+ * console.log(KUMIMOJI_EMBED_OPTION_KEYS.includes("saved"));
+ * ```
+ */
+export const KUMIMOJI_EMBED_OPTION_KEYS = Object.keys({ language: true, hand: true, level: true, gameLength: true, diagonals: true, seed: true, onFinish: true, onChange: true, locale: true, strings: true, theme: true, keep: true, controls: true, saved: true, onError: true });
+/**
+ * A reflected crossword table with the native table handle and saved-state getter.
+ * @example
+ * ```ts
+ * import { KumimojiTable } from "@johnmorrisdotca/kumimoji/element";
+ * console.log(KumimojiTable.observedAttributes.includes("daily"));
+ * ```
  */
 export class KumimojiTable extends ElementBase {
     constructor() {
@@ -52,11 +70,22 @@ export class KumimojiTable extends ElementBase {
         _KumimojiTable_key.set(this, "");
         _KumimojiTable_queued.set(this, false);
         _KumimojiTable_seed.set(this, null);
+        _KumimojiTable_options.set(this, {});
+        _KumimojiTable_revision.set(this, 0);
+        _KumimojiTable_widthBefore.set(this, null);
+        _KumimojiTable_widthOwned.set(this, false);
+        _KumimojiTable_labelBefore.set(this, null);
     }
+    /** Native host options. Callback/presentation changes preserve the current game. */
+    get options() { return __classPrivateFieldGet(this, _KumimojiTable_options, "f"); }
+    set options(value) { __classPrivateFieldSet(this, _KumimojiTable_options, value ?? {}, "f"); if (this.isConnected)
+        __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_refresh).call(this); }
     connectedCallback() {
         __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_refresh).call(this);
     }
     disconnectedCallback() {
+        var _a;
+        __classPrivateFieldSet(this, _KumimojiTable_revision, (_a = __classPrivateFieldGet(this, _KumimojiTable_revision, "f"), ++_a), "f");
         __classPrivateFieldGet(this, _KumimojiTable_table, "f")?.destroy();
         __classPrivateFieldSet(this, _KumimojiTable_table, null, "f");
         __classPrivateFieldSet(this, _KumimojiTable_key, "", "f");
@@ -67,7 +96,8 @@ export class KumimojiTable extends ElementBase {
         __classPrivateFieldSet(this, _KumimojiTable_queued, true, "f");
         queueMicrotask(() => {
             __classPrivateFieldSet(this, _KumimojiTable_queued, false, "f");
-            __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_refresh).call(this);
+            if (this.isConnected)
+                __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_refresh).call(this);
         });
     }
     /** The mounted table's handle (`mountKumimoji`), or null while the attributes name no table the rules offer. */
@@ -86,45 +116,146 @@ export class KumimojiTable extends ElementBase {
     setGame(saved) {
         return __classPrivateFieldGet(this, _KumimojiTable_table, "f")?.setGame(saved) ?? Promise.resolve();
     }
+    /** The `language` attribute, reflected. */
+    get language() { return this.getAttribute("language"); }
+    set language(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "language", value); }
+    /** The `hand` attribute, reflected. */
+    get hand() { return this.getAttribute("hand"); }
+    set hand(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "hand", value); }
+    /** The `level` attribute, reflected. */
+    get level() { return this.getAttribute("level"); }
+    set level(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "level", value); }
+    /** The `length` attribute, reflected. */
+    get length() { return this.getAttribute("length"); }
+    set length(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "length", value); }
+    /** The `diagonals` attribute, reflected. */
+    get diagonals() { return this.getAttribute("diagonals"); }
+    set diagonals(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "diagonals", value); }
+    /** The `seed` attribute, reflected. */
+    get seed() { return this.getAttribute("seed"); }
+    set seed(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "seed", value); }
+    /** The `keep` attribute, reflected. */
+    get keep() { return this.getAttribute("keep"); }
+    set keep(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "keep", value); }
+    /** The `daily` attribute, reflected. */
+    get daily() { return this.getAttribute("daily"); }
+    set daily(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "daily", value); }
+    /** The `controls` attribute, reflected. */
+    get controls() { return this.getAttribute("controls"); }
+    set controls(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "controls", value); }
+    /** The `theme` attribute, reflected. */
+    get theme() { return this.getAttribute("theme"); }
+    set theme(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "theme", value); }
+    /** The `size` attribute, reflected. */
+    get size() { return this.getAttribute("size"); }
+    set size(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "size", value); }
+    /** The `width` attribute, reflected. */
+    get width() { return this.getAttribute("width"); }
+    set width(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "width", value); }
+    /** The `label` attribute, reflected. */
+    get label() { return this.getAttribute("label"); }
+    set label(value) { __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_write).call(this, "label", value); }
 }
-_KumimojiTable_table = new WeakMap(), _KumimojiTable_key = new WeakMap(), _KumimojiTable_queued = new WeakMap(), _KumimojiTable_seed = new WeakMap(), _KumimojiTable_instances = new WeakSet(), _KumimojiTable_refresh = function _KumimojiTable_refresh() {
-    const language = oneOf(this.getAttribute("language"), ["english", "japanese"]);
-    const handAttribute = this.getAttribute("hand");
-    const hand = handAttribute === null ? undefined : Number(handAttribute);
-    const level = oneOf(this.getAttribute("level"), ["easy", "medium", "hard"]);
-    const gameLength = oneOf(this.getAttribute("length"), ["short", "medium", "full"]);
-    const diagonals = isOn(this.getAttribute("diagonals"));
-    const seedAttribute = this.getAttribute("seed");
-    const asked = Number(seedAttribute);
-    const seed = seedAttribute === "daily"
-        ? kumimojiDailySeed(new Date())
-        : seedAttribute !== null && Number.isInteger(asked) && asked >= 0 && asked <= 0xffffffff
-            ? asked
-            : (__classPrivateFieldSet(this, _KumimojiTable_seed, __classPrivateFieldGet(this, _KumimojiTable_seed, "f") ?? Math.floor(Math.random() * 2 ** 31), "f"));
-    const lang = this.getAttribute("lang");
-    const locale = lang === "en" || lang === "ja" ? lang : undefined;
-    const keep = !["false", "off", "0", "no"].includes((this.getAttribute("keep") ?? "").toLowerCase());
-    const key = JSON.stringify([language, hand, level, gameLength, diagonals, seed, keep]);
-    if (key === __classPrivateFieldGet(this, _KumimojiTable_key, "f") && __classPrivateFieldGet(this, _KumimojiTable_table, "f") !== null) {
-        __classPrivateFieldGet(this, _KumimojiTable_table, "f").setLocale(locale ?? (document.documentElement.lang.toLowerCase().startsWith("ja") ? "ja" : "en"));
-        return;
+_KumimojiTable_table = new WeakMap(), _KumimojiTable_key = new WeakMap(), _KumimojiTable_queued = new WeakMap(), _KumimojiTable_seed = new WeakMap(), _KumimojiTable_options = new WeakMap(), _KumimojiTable_revision = new WeakMap(), _KumimojiTable_widthBefore = new WeakMap(), _KumimojiTable_widthOwned = new WeakMap(), _KumimojiTable_labelBefore = new WeakMap(), _KumimojiTable_instances = new WeakSet(), _KumimojiTable_write = function _KumimojiTable_write(name, value) { if (value === null || value === undefined)
+    this.removeAttribute(name);
+else
+    this.setAttribute(name, String(value)); }, _KumimojiTable_frame = function _KumimojiTable_frame() {
+    this.style.display = "block";
+    this.style.maxWidth = "100%";
+    const width = Number(this.getAttribute("width")), size = this.getAttribute("size");
+    const pixels = this.hasAttribute("width") && width > 0 && Number.isFinite(width) ? Math.min(width, 2000) : size === "small" ? 320 : size === "medium" ? 480 : size === "large" ? 640 : null;
+    if (pixels !== null) {
+        if (!__classPrivateFieldGet(this, _KumimojiTable_widthOwned, "f"))
+            __classPrivateFieldSet(this, _KumimojiTable_widthBefore, this.style.width, "f");
+        __classPrivateFieldSet(this, _KumimojiTable_widthOwned, true, "f");
+        this.style.width = `${pixels}px`;
+    }
+    else if (__classPrivateFieldGet(this, _KumimojiTable_widthOwned, "f")) {
+        this.style.width = __classPrivateFieldGet(this, _KumimojiTable_widthBefore, "f") ?? "";
+        __classPrivateFieldSet(this, _KumimojiTable_widthOwned, false, "f");
+    }
+    const theme = this.getAttribute("theme");
+    this.style.colorScheme = theme === "light" || theme === "dark" ? theme : "light dark";
+    this.setAttribute("data-kumimoji-embed", "");
+    const root = this.getRootNode(), target = typeof ShadowRoot !== "undefined" && root instanceof ShadowRoot ? root : this.ownerDocument.head;
+    if (target.querySelector("style[data-kumimoji-embed-style]") === null) {
+        const style = this.ownerDocument.createElement("style");
+        style.setAttribute("data-kumimoji-embed-style", "");
+        const light = KUMIMOJI_STYLE.match(/\.km-root \{([^}]+)\}/)?.[1] ?? "";
+        const dark = KUMIMOJI_STYLE.match(/@media \(prefers-color-scheme: dark\) \{\s*\.km-root \{([^}]+)\}/)?.[1] ?? "";
+        style.textContent = `[data-kumimoji-embed][theme="light"] .km-root{${light}}[data-kumimoji-embed][theme="dark"] .km-root{${dark}}[data-kumimoji-embed]>.km-root{background:var(--km-panel);padding:12px;border-radius:12px}[data-kumimoji-embed] .km-controls[hidden]{display:none}`;
+        target.append(style);
+    }
+    if (this.hasAttribute("label")) {
+        __classPrivateFieldSet(this, _KumimojiTable_labelBefore, __classPrivateFieldGet(this, _KumimojiTable_labelBefore, "f") ?? { role: this.getAttribute("role"), label: this.getAttribute("aria-label") }, "f");
+        this.setAttribute("role", "group");
+        this.setAttribute("aria-label", this.getAttribute("label"));
+    }
+    else if (__classPrivateFieldGet(this, _KumimojiTable_labelBefore, "f") !== null) {
+        for (const [name, value] of [["role", __classPrivateFieldGet(this, _KumimojiTable_labelBefore, "f").role], ["aria-label", __classPrivateFieldGet(this, _KumimojiTable_labelBefore, "f").label]]) {
+            if (value === null)
+                this.removeAttribute(name);
+            else
+                this.setAttribute(name, value);
+        }
+        __classPrivateFieldSet(this, _KumimojiTable_labelBefore, null, "f");
+    }
+}, _KumimojiTable_refresh = function _KumimojiTable_refresh() {
+    var _a;
+    __classPrivateFieldGet(this, _KumimojiTable_instances, "m", _KumimojiTable_frame).call(this);
+    try {
+        const language = oneOf(this.getAttribute("language"), ["english", "japanese"]) ?? __classPrivateFieldGet(this, _KumimojiTable_options, "f").language;
+        const hand = this.hasAttribute("hand") ? Number(this.getAttribute("hand")) : __classPrivateFieldGet(this, _KumimojiTable_options, "f").hand;
+        const level = oneOf(this.getAttribute("level"), ["easy", "medium", "hard"]) ?? __classPrivateFieldGet(this, _KumimojiTable_options, "f").level;
+        const gameLength = oneOf(this.getAttribute("length"), ["short", "medium", "full"]) ?? __classPrivateFieldGet(this, _KumimojiTable_options, "f").gameLength;
+        const diagonals = isOn(this.getAttribute("diagonals"), __classPrivateFieldGet(this, _KumimojiTable_options, "f").diagonals ?? false);
+        const seedAttribute = this.getAttribute("seed"), asked = Number(seedAttribute);
+        const day = embedDay(this.hasAttribute("daily") ? this.getAttribute("daily") : seedAttribute === "daily" ? "today" : null);
+        const seed = day !== null ? kumimojiDailySeed(new Date(`${day}T00:00:00Z`)) : seedAttribute !== null && Number.isInteger(asked) && asked >= 0 && asked <= 0xffffffff ? asked : __classPrivateFieldGet(this, _KumimojiTable_options, "f").seed ?? (__classPrivateFieldSet(this, _KumimojiTable_seed, __classPrivateFieldGet(this, _KumimojiTable_seed, "f") ?? Math.floor(Math.random() * 2 ** 31), "f"));
+        const lang = this.getAttribute("lang"), locale = lang === "en" || lang === "ja" ? lang : __classPrivateFieldGet(this, _KumimojiTable_options, "f").locale ?? (this.ownerDocument.documentElement.lang.toLowerCase().startsWith("ja") ? "ja" : "en");
+        const keep = isOn(this.getAttribute("keep"), __classPrivateFieldGet(this, _KumimojiTable_options, "f").keep ?? true), controls = isOn(this.getAttribute("controls"), __classPrivateFieldGet(this, _KumimojiTable_options, "f").controls ?? true);
+        const key = JSON.stringify([language, hand, level, gameLength, diagonals, seed, day, __classPrivateFieldGet(this, _KumimojiTable_options, "f").saved]);
+        if (key === __classPrivateFieldGet(this, _KumimojiTable_key, "f") && __classPrivateFieldGet(this, _KumimojiTable_table, "f") !== null) {
+            __classPrivateFieldGet(this, _KumimojiTable_table, "f").set({ locale, strings: __classPrivateFieldGet(this, _KumimojiTable_options, "f").strings, theme: __classPrivateFieldGet(this, _KumimojiTable_options, "f").theme ?? {}, keep, controls });
+            return;
+        }
+        if (hand !== undefined && !HANDS.includes(hand))
+            throw new RangeError("Choose a hand of 3, 7 or 11 tiles.");
+        __classPrivateFieldGet(this, _KumimojiTable_table, "f")?.destroy();
+        __classPrivateFieldSet(this, _KumimojiTable_table, null, "f");
+        __classPrivateFieldSet(this, _KumimojiTable_key, "", "f");
+        this.replaceChildren();
+        const revision = __classPrivateFieldSet(this, _KumimojiTable_revision, (_a = __classPrivateFieldGet(this, _KumimojiTable_revision, "f"), ++_a), "f");
+        const table = mountKumimoji(this, { ...__classPrivateFieldGet(this, _KumimojiTable_options, "f"), language, hand, level, gameLength, diagonals, seed, locale, keep, controls, onChange: saved => { this.dispatchEvent(new CustomEvent("kumimoji-change", { detail: JSON.parse(JSON.stringify({ saved })), bubbles: true, composed: true })); __classPrivateFieldGet(this, _KumimojiTable_options, "f").onChange?.(saved); }, onFinish: result => { this.dispatchEvent(new CustomEvent("kumimoji-finish", { detail: JSON.parse(JSON.stringify(result)), bubbles: true, composed: true })); __classPrivateFieldGet(this, _KumimojiTable_options, "f").onFinish?.(result); }, onError: error => { this.dispatchEvent(new CustomEvent("kumimoji-error", { detail: { message: error.message }, bubbles: true, composed: true })); __classPrivateFieldGet(this, _KumimojiTable_options, "f").onError?.(error); } });
+        __classPrivateFieldSet(this, _KumimojiTable_table, table, "f");
+        __classPrivateFieldSet(this, _KumimojiTable_key, key, "f");
+        void table.ready.then(() => { if (this.isConnected && revision === __classPrivateFieldGet(this, _KumimojiTable_revision, "f") && table.saved() !== null)
+            this.dispatchEvent(new CustomEvent("kumimoji-load", { bubbles: true, composed: true, detail: { seed: table.saved().deal.seed, day } })); }).catch(() => { });
+    }
+    catch (error) {
+        __classPrivateFieldGet(this, _KumimojiTable_table, "f")?.destroy();
+        __classPrivateFieldSet(this, _KumimojiTable_table, null, "f");
+        __classPrivateFieldSet(this, _KumimojiTable_key, "", "f");
+        const message = error instanceof Error ? error.message : String(error), status = this.ownerDocument.createElement("p");
+        status.setAttribute("role", "status");
+        status.textContent = message;
+        this.replaceChildren(status);
+        this.dispatchEvent(new CustomEvent("kumimoji-error", { detail: { message }, bubbles: true, composed: true }));
     }
-    __classPrivateFieldGet(this, _KumimojiTable_table, "f")?.destroy();
-    __classPrivateFieldSet(this, _KumimojiTable_table, null, "f");
-    __classPrivateFieldSet(this, _KumimojiTable_key, key, "f");
-    if (hand !== undefined && !HANDS.includes(hand))
-        return;
-    __classPrivateFieldSet(this, _KumimojiTable_table, mountKumimoji(this, {
-        language,
-        hand,
-        level,
-        gameLength,
-        diagonals,
-        seed,
-        locale,
-        keep,
-        onChange: (saved) => this.dispatchEvent(new CustomEvent("kumimoji-change", { detail: { saved }, bubbles: true })),
-        onFinish: (result) => this.dispatchEvent(new CustomEvent("kumimoji-finish", { detail: result, bubbles: true })),
-    }), "f");
 };
-KumimojiTable.observedAttributes = ["language", "hand", "level", "length", "diagonals", "seed", "lang", "keep"];
+KumimojiTable.observedAttributes = ["language", "hand", "level", "length", "diagonals", "seed", "lang", "keep", "daily", "controls", "theme", "size", "width", "label"];
+/**
+ * Defines the table or a subclass under a custom tag. Server-safe and idempotent.
+ * @param tagName - The tag name; kumimoji-table by default.
+ * @param registry - The page registry, or undefined on a server.
+ * @returns Nothing; existing definitions are left alone.
+ * @example
+ * ```ts
+ * import { defineTable } from "@johnmorrisdotca/kumimoji/element";
+ * defineTable();
+ * console.log(typeof defineTable);
+ * ```
+ */
+export function defineTable(tagName = "kumimoji-table", registry = typeof customElements === "undefined" ? undefined : customElements) { if (registry !== undefined && registry.get(tagName) === undefined)
+    registry.define(tagName, tagName === "kumimoji-table" ? KumimojiTable : class extends KumimojiTable {
+    }); }

package/dist/embed-day.d.ts

@@ -0,0 +1,4 @@
+/** Shared UTC day parsing for the family's daily embeds. No storage, service or rollover timer. */
+export declare function embedDay(value: string | null | undefined, now?: Date): string | null;
+/** The same day and namespace give the same nonzero 32-bit seed on every machine. */
+export declare function dailySeed(day: string, namespace: string): number;

package/dist/embed-day.js

@@ -0,0 +1,23 @@
+/** Shared UTC day parsing for the family's daily embeds. No storage, service or rollover timer. */
+export function embedDay(value, now = new Date()) {
+    if (value === null || value === undefined || ["off", "false", "no", "0"].includes(value.trim().toLowerCase()))
+        return null;
+    const asked = value.trim().toLowerCase();
+    const day = ["", "today", "on", "true", "1"].includes(asked) ? Number.isNaN(now.getTime()) ? "" : now.toISOString().slice(0, 10) : value.trim();
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(day))
+        throw new RangeError("Use a real UTC date written YYYY-MM-DD.");
+    const time = Date.parse(`${day}T00:00:00Z`);
+    if (!Number.isFinite(time) || new Date(time).toISOString().slice(0, 10) !== day)
+        throw new RangeError("Use a real UTC date written YYYY-MM-DD.");
+    return day;
+}
+/** The same day and namespace give the same nonzero 32-bit seed on every machine. */
+export function dailySeed(day, namespace) {
+    const parsed = embedDay(day);
+    if (parsed === null)
+        throw new RangeError("A daily seed needs a UTC date.");
+    let hash = 2166136261;
+    for (const letter of `${parsed}/${namespace}`)
+        hash = Math.imul(hash ^ letter.charCodeAt(0), 16777619) >>> 0;
+    return hash || 1;
+}