@wcstack/contacts 1.16.0

package/README.ja.md

@@ -0,0 +1,91 @@
+# @wcstack/contacts
+
+`@wcstack/contacts` は wcstack エコシステム向けのヘッドレスな Contact Picker コンポーネントです。
+
+視覚的な UI ウィジェットではありません。`navigator.contacts.select(properties, options)` を宣言的コマンド+観測可能stateに変える**非同期プリミティブノード**で、Web Share APIに対する`@wcstack/share`と同じ形をしています。
+
+`@wcstack/state` と組み合わせると、`<wcs-contacts>` はパス契約で直接バインドできます:
+
+- **入力サーフェス**: 無し — `select(properties, options)`の引数は呼び出しごと
+- **出力 state サーフェス**: `value`、`loading`、`error`、`cancelled`
+
+## なぜ存在するか — Android Chrome限定、unsupportedが常態
+
+Contact Picker APIは**Android Chromeでのみ**動作します。デスクトップブラウザ（およびiOS Safari）は`navigator.contacts`を一切持ちません。このノードは補助的なショートカットとして設計し、常に手入力の代替手段を用意してください。
+
+> **2つの位置引数、プロトコル変更不要。** `select(properties, options)`はバッチ3で初めて2引数を取るcommandです。command-tokenの引数素通しは引数の個数を特別扱いしないため、無改造でそのまま動作します（`docs/contact-picker-tag-design.md` §2参照）。
+
+> **`multiple: false`（既定）でも戻り値は配列。** 単一選択でも1要素の配列になります——素のオブジェクトを期待せず`value.0`のようにバインドしてください。
+
+## インストール
+
+```bash
+npm install @wcstack/contacts
+```
+
+## クイックスタート
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/contacts/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      picked: null,
+      pickContact() {
+        this.$command.select.emit(["name", "tel"], { multiple: false });
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-contacts data-wcs="command.select: $command.select; value: picked"></wcs-contacts>
+
+<button data-wcs="onclick: pickContact">連絡先を選択</button>
+<p data-wcs="textContent: picked.0.name.0"></p>
+```
+
+## 観測可能プロパティ（出力）
+
+| プロパティ  | イベント                        | 説明 |
+| ----------- | -------------------------------- | ---- |
+| `value`     | `wcs-contacts:complete`           | 選択された連絡先の配列（`multiple: false`でも常に配列）、成功前は`null`。 |
+| `loading`   | `wcs-contacts:loading-changed`    | ピッカーダイアログが開いている間`true`。 |
+| `error`     | `wcs-contacts:error`              | 真のプラットフォーム失敗（`select()`が投げた`DOMException`/`Error`）、または unsupported 経路ではプレーンオブジェクト`{ message: "Contact Picker API is not supported in this browser." }`、無ければ`null`。 |
+| `cancelled` | `wcs-contacts:cancelled-changed`  | ユーザーがピッカーを閉じたら`true`（`error`とは分離）。 |
+
+## コマンド
+
+| コマンド | 非同期 | 説明 |
+| -------- | ------ | ---- |
+| `select` | はい   | `select(properties, options?)` — `properties`は`"name"`/`"email"`/`"tel"`/`"address"`/`"icon"`の配列、`options.multiple`既定`false`。never-throw: ユーザーキャンセルは`cancelled`、それ以外の失敗は`error`へ。`abort`コマンドは無し（Contact Picker APIはAbortSignalを受け付けない）。 |
+
+## 属性 / 入力
+
+**無し。**
+
+## 注意・制限
+
+- **Android Chrome限定。** unsupportedを例外ケースでなく既定として扱ってください。
+- **`unsupported` 専用フラグは持たない。** `navigator.contacts.select` が関数でない状態で `select()` を呼ぶと、即座に `error` がプレーンオブジェクト `{ message: "Contact Picker API is not supported in this browser." }` になり `null` で解決します — 非同期処理を開始しないため `_gen` は消費されません。この形は実失敗（`error` に `DOMException`/`Error` が入る）とは異なるため、unsupported 経路で `error instanceof Error` や `error.name` を前提にしないでください。
+- **`getProperties()`はv1スコープ外**（対応フィールドの非同期事前確認、`docs/contact-picker-tag-design.md` §4参照）。
+- `@wcstack/share`/`@wcstack/eyedropper`とアーキタイプを共有: 単一`_gen`世代ガード、never-throw、AbortController無し。
+
+## ヘッドレス利用（`ContactsCore`）
+
+```typescript
+import { ContactsCore } from "@wcstack/contacts";
+
+const core = new ContactsCore();
+core.addEventListener("wcs-contacts:complete", (e) => {
+  console.log((e as CustomEvent).detail.value); // ContactInfo[]
+});
+
+await core.select(["name", "tel"], { multiple: true });
+core.dispose();
+```
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,92 @@
+# @wcstack/contacts
+
+`@wcstack/contacts` is a headless Contact Picker component for the wcstack ecosystem.
+
+It is not a visual UI widget.
+It is an **async primitive node** that turns `navigator.contacts.select(properties, options)` into declarative command + observable state, the same shape `@wcstack/share` establishes for the Web Share API.
+
+With `@wcstack/state`, `<wcs-contacts>` can be bound directly through path contracts:
+
+- **input surface**: none — `select(properties, options)`'s arguments are per-call
+- **output state surface**: `value`, `loading`, `error`, `cancelled`
+
+## Why this exists — Android Chrome only, unsupported is the common case
+
+The Contact Picker API works **only on Android Chrome**. Desktop browsers (and iOS Safari) entirely lack `navigator.contacts`. Design any UI around this being a supplementary shortcut, not the primary input method — always keep a manual-entry fallback.
+
+> **Two positional arguments, no protocol change needed.** `select(properties, options)` is the first batch-3 member to take two arguments instead of one. The command-token argument pass-through does not special-case argument count — it works unmodified (see `docs/contact-picker-tag-design.md` §2).
+
+> **`multiple: false` (the default) still resolves to an array.** Even a single selection is a one-element array — bind `value.0` (or iterate) rather than expecting a bare object.
+
+## Install
+
+```bash
+npm install @wcstack/contacts
+```
+
+## Quick Start
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/contacts/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      picked: null,
+      pickContact() {
+        this.$command.select.emit(["name", "tel"], { multiple: false });
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-contacts data-wcs="command.select: $command.select; value: picked"></wcs-contacts>
+
+<button data-wcs="onclick: pickContact">Pick a contact</button>
+<p data-wcs="textContent: picked.0.name.0"></p>
+```
+
+## Observable Properties (outputs)
+
+| Property    | Event                        | Description |
+| ----------- | ----------------------------- | ------------ |
+| `value`     | `wcs-contacts:complete`        | The array of picked contacts (always an array, even with `multiple: false`), or `null` before any successful selection. |
+| `loading`   | `wcs-contacts:loading-changed` | `true` while the picker dialog is open. |
+| `error`     | `wcs-contacts:error`           | A true platform failure (a `DOMException`/`Error` from `select()`), or the plain object `{ message: "Contact Picker API is not supported in this browser." }` on the unsupported path, or `null`. |
+| `cancelled` | `wcs-contacts:cancelled-changed` | `true` when the user dismissed the picker (kept separate from `error`). |
+
+## Commands
+
+| Command | Async | Description |
+| ------- | ----- | ------------ |
+| `select` | yes | `select(properties, options?)` — `properties` is an array of `"name"`/`"email"`/`"tel"`/`"address"`/`"icon"`; `options.multiple` defaults to `false`. Never-throw: a user-cancelled picker surfaces via `cancelled`, any other failure via `error`. No `abort` command — the Contact Picker API accepts no `AbortSignal`. |
+
+## Attributes / Inputs
+
+**None.**
+
+## Notes & limitations
+
+- **Android Chrome only.** Treat `unsupported` as the default, not an edge case.
+- **`unsupported` has no dedicated flag.** Calling `select()` when `navigator.contacts.select` is not a function immediately sets `error` to the plain object `{ message: "Contact Picker API is not supported in this browser." }` and resolves with `null` — no `_gen` is consumed, since no asynchronous work is started. This shape differs from a real failure, where `error` holds a `DOMException`/`Error`; do not assume `error instanceof Error` or `error.name` on the unsupported path.
+- **`getProperties()` is out of scope for v1** (an async pre-check for supported fields) — see `docs/contact-picker-tag-design.md` §4.
+- Shares its architecture with `@wcstack/share`/`@wcstack/eyedropper`: single `_gen` generation guard, never-throw, no `AbortController`.
+
+## Headless usage (`ContactsCore`)
+
+```typescript
+import { ContactsCore } from "@wcstack/contacts";
+
+const core = new ContactsCore();
+core.addEventListener("wcs-contacts:complete", (e) => {
+  console.log((e as CustomEvent).detail.value); // ContactInfo[]
+});
+
+await core.select(["name", "tel"], { multiple: true });
+core.dispose();
+```
+
+## License
+
+MIT

package/dist/auto.js

@@ -0,0 +1,3 @@
+import { bootstrapContacts } from "./index.esm.js";
+
+bootstrapContacts();

package/dist/auto.min.js

@@ -0,0 +1 @@
+import{bootstrapContacts}from"./index.esm.min.js";bootstrapContacts();

package/dist/index.d.ts

@@ -0,0 +1,172 @@
+interface IWcBindableProperty {
+    readonly name: string;
+    readonly event: string;
+    readonly getter?: (event: Event) => any;
+}
+interface IWcBindableInput {
+    readonly name: string;
+    readonly attribute?: string;
+}
+interface IWcBindableCommand {
+    readonly name: string;
+    readonly async?: boolean;
+}
+interface IWcBindable {
+    readonly protocol: "wc-bindable";
+    readonly version: 1;
+    readonly properties: readonly IWcBindableProperty[];
+    readonly inputs?: readonly IWcBindableInput[];
+    readonly commands?: readonly IWcBindableCommand[];
+}
+
+interface ITagNames {
+    readonly contacts: string;
+}
+interface IWritableTagNames {
+    contacts?: string;
+}
+interface IConfig {
+    readonly tagNames: ITagNames;
+}
+interface IWritableConfig {
+    tagNames?: IWritableTagNames;
+}
+
+/** Field names selectable via the Contact Picker API's `properties` argument. */
+type ContactProperty = "name" | "email" | "tel" | "address" | "icon";
+/** Options for `select(properties, options)` — `multiple` defaults to `false`. */
+interface ContactsSelectOptions {
+    multiple?: boolean;
+}
+/**
+ * A postal address entry returned for the `"address"` contact property, mirroring
+ * the Contact Picker API's `ContactAddress` shape (MDN). Every field is optional:
+ * the platform populates only what it has, and field coverage varies by browser /
+ * OS. An index signature is kept so a future platform field does not force callers
+ * into a type assertion — consistent with the design doc's "pass the platform
+ * return value straight through to `value`" principle (docs/contact-picker-tag-design.md §3).
+ */
+interface ContactAddress {
+    addressLine?: string[];
+    city?: string;
+    country?: string;
+    dependentLocality?: string;
+    organization?: string;
+    phone?: string;
+    postalCode?: string;
+    recipient?: string;
+    region?: string;
+    sortingCode?: string;
+    [key: string]: unknown;
+}
+/**
+ * A single contact returned by `navigator.contacts.select()`. Every field is an
+ * array (a contact can have multiple emails, phone numbers, etc.) and only the
+ * fields requested via `properties` are populated.
+ */
+interface ContactInfo {
+    name?: string[];
+    email?: string[];
+    tel?: string[];
+    address?: ContactAddress[];
+    icon?: Blob[];
+}
+/**
+ * Value types for ContactsCore (headless) — the observable state properties.
+ * Use with `bind()` from a wc-bindable binding core for compile-time type checking.
+ *
+ * @example
+ * ```typescript
+ * const core = new ContactsCore();
+ * bind(core, (name: keyof WcsContactsCoreValues, value) => { ... });
+ * ```
+ */
+interface WcsContactsCoreValues {
+    value: ContactInfo[] | null;
+    loading: boolean;
+    error: any;
+    cancelled: boolean;
+}
+/**
+ * Value types for the Shell (`<wcs-contacts>`) — identical observable surface
+ * to the Core. The Shell adds no inputs: `select(properties, options)`'s
+ * arguments are per-call, not declarative attributes.
+ */
+type WcsContactsValues = WcsContactsCoreValues;
+
+declare function bootstrapContacts(userConfig?: IWritableConfig): void;
+
+declare function getConfig(): IConfig;
+
+/**
+ * Headless Contact Picker primitive. A thin, framework-agnostic wrapper around
+ * `navigator.contacts.select(properties, options)` exposed through the
+ * wc-bindable protocol.
+ *
+ * This is the same simplified derivative of `FetchCore._doFetch` that
+ * `@wcstack/share`'s `ShareCore` establishes (docs/contact-picker-tag-design.md
+ * §1): single `_gen` generation guard, same-value-guarded private setters,
+ * never-throw try/catch, no `AbortController`/`abort()` — the Contact Picker
+ * API accepts no `AbortSignal` and, like the Web Share dialog, the picker is a
+ * single system-modal surface (at most one open at a time).
+ *
+ * The one structural difference from `ShareCore`: `select()` takes **two**
+ * positional arguments (`properties`, `options`) rather than one — the first
+ * batch-3 member to do so. The command-token argument pass-through
+ * (spec-proposal-command-token-arguments.md) does not special-case argument
+ * count, so this requires no protocol change.
+ */
+declare class ContactsCore extends EventTarget {
+    static wcBindable: IWcBindable;
+    private _target;
+    private _value;
+    private _loading;
+    private _error;
+    private _cancelled;
+    private _gen;
+    private _ready;
+    constructor(target?: EventTarget);
+    get ready(): Promise<void>;
+    get value(): ContactInfo[] | null;
+    get loading(): boolean;
+    get error(): any;
+    get cancelled(): boolean;
+    observe(): Promise<void>;
+    dispose(): void;
+    private _setLoading;
+    private _setValue;
+    private _setError;
+    private _setCancelled;
+    private _api;
+    select(properties: ContactProperty[], options?: ContactsSelectOptions): Promise<ContactInfo[] | null>;
+}
+
+/**
+ * `<wcs-contacts>` — declarative Contact Picker API primitive.
+ *
+ * A thin command-only Shell (mirrors `<wcs-share>`): no attributes at all.
+ * `select(properties, options)`'s arguments are per-call, not a declarative
+ * setting to park on the element ahead of time.
+ *
+ * **Android Chrome only.** Desktop browsers entirely lack `navigator.contacts`
+ * — treat `unsupported` as the default state, not an edge case, in any
+ * example or consuming UI.
+ */
+declare class WcsContacts extends HTMLElement {
+    static hasConnectedCallbackPromise: boolean;
+    static wcBindable: IWcBindable;
+    private _core;
+    private _connectedCallbackPromise;
+    constructor();
+    get value(): ContactInfo[] | null;
+    get loading(): boolean;
+    get error(): any;
+    get cancelled(): boolean;
+    get connectedCallbackPromise(): Promise<void>;
+    select(properties: ContactProperty[], options?: ContactsSelectOptions): Promise<ContactInfo[] | null>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}
+
+export { ContactsCore, WcsContacts, bootstrapContacts, getConfig };
+export type { ContactAddress, ContactInfo, ContactProperty, ContactsSelectOptions, IWritableConfig, IWritableTagNames, WcsContactsCoreValues, WcsContactsValues };

package/dist/index.esm.js

@@ -0,0 +1,290 @@
+const _config = {
+    tagNames: {
+        contacts: "wcs-contacts",
+    },
+};
+function deepFreeze(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    Object.freeze(obj);
+    for (const key of Object.keys(obj)) {
+        deepFreeze(obj[key]);
+    }
+    return obj;
+}
+function deepClone(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    const clone = {};
+    for (const key of Object.keys(obj)) {
+        clone[key] = deepClone(obj[key]);
+    }
+    return clone;
+}
+let frozenConfig = null;
+// Note: this is the live, mutable internal config. It is not part of the public
+// package exports (see exports.ts) — only `getConfig()` (frozen snapshot) is
+// surfaced; `setConfig()` is applied internally via `bootstrapContacts()` and is
+// not re-exported from the package root — but a deep path import (`.../src/config.js`)
+// can still reach and mutate it. Accepted as-is for cross-package consistency: every
+// @wcstack package follows this same shape. Use `getConfig()` for a frozen, safe read.
+const config = _config;
+function getConfig() {
+    if (!frozenConfig) {
+        frozenConfig = deepFreeze(deepClone(_config));
+    }
+    return frozenConfig;
+}
+function setConfig(partialConfig) {
+    if (partialConfig.tagNames) {
+        Object.assign(_config.tagNames, partialConfig.tagNames);
+    }
+    frozenConfig = null;
+}
+
+/**
+ * Headless Contact Picker primitive. A thin, framework-agnostic wrapper around
+ * `navigator.contacts.select(properties, options)` exposed through the
+ * wc-bindable protocol.
+ *
+ * This is the same simplified derivative of `FetchCore._doFetch` that
+ * `@wcstack/share`'s `ShareCore` establishes (docs/contact-picker-tag-design.md
+ * §1): single `_gen` generation guard, same-value-guarded private setters,
+ * never-throw try/catch, no `AbortController`/`abort()` — the Contact Picker
+ * API accepts no `AbortSignal` and, like the Web Share dialog, the picker is a
+ * single system-modal surface (at most one open at a time).
+ *
+ * The one structural difference from `ShareCore`: `select()` takes **two**
+ * positional arguments (`properties`, `options`) rather than one — the first
+ * batch-3 member to do so. The command-token argument pass-through
+ * (spec-proposal-command-token-arguments.md) does not special-case argument
+ * count, so this requires no protocol change.
+ */
+class ContactsCore extends EventTarget {
+    static wcBindable = {
+        protocol: "wc-bindable",
+        version: 1,
+        properties: [
+            { name: "value", event: "wcs-contacts:complete", getter: (e) => e.detail.value },
+            { name: "loading", event: "wcs-contacts:loading-changed" },
+            { name: "error", event: "wcs-contacts:error" },
+            { name: "cancelled", event: "wcs-contacts:cancelled-changed" },
+        ],
+        commands: [
+            { name: "select", async: true },
+        ],
+    };
+    _target;
+    _value = null;
+    _loading = false;
+    _error = null;
+    _cancelled = false;
+    // Generation guard (§3.4 of the guidelines): bumped ONLY by dispose(). A
+    // select() that settles after dispose() has a stale `gen` and MUST NOT
+    // write state to a torn-down element. Unlike FetchCore/EyedropperCore,
+    // select() itself does NOT bump `_gen` on each call: the archetype
+    // (docs/web-share-tag-design.md §2, adopted verbatim by
+    // docs/contact-picker-tag-design.md §1) deliberately drops the "a new call
+    // supersedes the previous one" plumbing those cores need, because the
+    // contact picker is a single system-modal surface (a second concurrent
+    // select() rejects with InvalidStateError on its own). Bumping `_gen` per
+    // call would instead let a fast-failing second call incorrectly invalidate
+    // a still-pending first call's eventual success. Also not bumped on the
+    // unsupported early-return — no asynchronous work is started, so there is
+    // no generation to protect.
+    _gen = 0;
+    // SSR (§3.8): no asynchronous probe to await, so readiness is immediate.
+    _ready = Promise.resolve();
+    constructor(target) {
+        super();
+        this._target = target ?? this;
+    }
+    get ready() {
+        return this._ready;
+    }
+    get value() {
+        return this._value;
+    }
+    get loading() {
+        return this._loading;
+    }
+    get error() {
+        return this._error;
+    }
+    get cancelled() {
+        return this._cancelled;
+    }
+    // Lifecycle (§3.5). Select is command-driven with no subscription to
+    // establish, so observe() is an idempotent no-op that resolves once ready;
+    // dispose() only invalidates any in-flight select() (there is nothing to
+    // abort or unsubscribe).
+    observe() {
+        return this._ready;
+    }
+    dispose() {
+        this._gen++;
+    }
+    _setLoading(loading) {
+        if (this._loading === loading)
+            return;
+        this._loading = loading;
+        this._target.dispatchEvent(new CustomEvent("wcs-contacts:loading-changed", {
+            detail: loading,
+            bubbles: true,
+        }));
+    }
+    _setValue(value) {
+        if (this._value === value)
+            return;
+        this._value = value;
+        this._target.dispatchEvent(new CustomEvent("wcs-contacts:complete", {
+            detail: { value },
+            bubbles: true,
+        }));
+    }
+    _setError(error) {
+        if (this._error === error)
+            return;
+        this._error = error;
+        this._target.dispatchEvent(new CustomEvent("wcs-contacts:error", {
+            detail: error,
+            bubbles: true,
+        }));
+    }
+    _setCancelled(cancelled) {
+        if (this._cancelled === cancelled)
+            return;
+        this._cancelled = cancelled;
+        this._target.dispatchEvent(new CustomEvent("wcs-contacts:cancelled-changed", {
+            detail: cancelled,
+            bubbles: true,
+        }));
+    }
+    // API resolution is call-time, never cached (§3.7): lets tests install/remove
+    // navigator.contacts freely and lets an unsupported environment (the common
+    // case — desktop browsers entirely lack this API) be detected correctly on
+    // every call.
+    _api() {
+        const nav = globalThis.navigator;
+        return typeof nav?.contacts?.select === "function" ? nav.contacts.select.bind(nav.contacts) : undefined;
+    }
+    async select(properties, options) {
+        // never-throw + unsupported: resolve API at call time and bail out
+        // immediately if absent. No _gen bump — no asynchronous work is started.
+        const selectFn = this._api();
+        if (!selectFn) {
+            this._setError({ message: "Contact Picker API is not supported in this browser." });
+            return null;
+        }
+        // Captured, not bumped (see the `_gen` field docs above): select() does
+        // not supersede a prior in-flight call, only dispose() invalidates.
+        const gen = this._gen;
+        this._setLoading(true);
+        // Reset the previous outcome before starting a new select so a stale
+        // cancelled/error does not linger into this call's result.
+        this._setError(null);
+        this._setCancelled(false);
+        try {
+            const contacts = await selectFn(properties, options);
+            // Stale completion (dispose() ran while the picker was open).
+            if (gen !== this._gen) {
+                return null;
+            }
+            // `multiple` does not change the result shape — even a single
+            // selection resolves to a one-element array (docs/contact-picker-tag-design.md §3).
+            this._setValue(contacts);
+            this._setLoading(false);
+            return contacts;
+        }
+        catch (e) {
+            // Stale completion (dispose() ran while the picker was open).
+            if (gen !== this._gen) {
+                return null;
+            }
+            if (e?.name === "AbortError") {
+                // The user dismissed the contact picker — a routine cancellation, not
+                // a platform failure. Kept out of `error`.
+                this._setCancelled(true);
+            }
+            else {
+                this._setError(e);
+            }
+            this._setLoading(false);
+            return null;
+        }
+    }
+}
+
+/**
+ * `<wcs-contacts>` — declarative Contact Picker API primitive.
+ *
+ * A thin command-only Shell (mirrors `<wcs-share>`): no attributes at all.
+ * `select(properties, options)`'s arguments are per-call, not a declarative
+ * setting to park on the element ahead of time.
+ *
+ * **Android Chrome only.** Desktop browsers entirely lack `navigator.contacts`
+ * — treat `unsupported` as the default state, not an edge case, in any
+ * example or consuming UI.
+ */
+class WcsContacts extends HTMLElement {
+    // SSR (§4.4): observe() completes synchronously, but the Shell still exposes
+    // connectedCallbackPromise so the state binder can await it uniformly across
+    // all IO nodes before snapshotting.
+    static hasConnectedCallbackPromise = true;
+    static wcBindable = {
+        ...ContactsCore.wcBindable,
+        inputs: [],
+        // Core の commands をそのまま継承（単一情報源）。
+        commands: ContactsCore.wcBindable.commands,
+    };
+    _core;
+    _connectedCallbackPromise = Promise.resolve();
+    constructor() {
+        super();
+        this._core = new ContactsCore(this);
+    }
+    // --- Core delegated getters ---
+    get value() {
+        return this._core.value;
+    }
+    get loading() {
+        return this._core.loading;
+    }
+    get error() {
+        return this._core.error;
+    }
+    get cancelled() {
+        return this._core.cancelled;
+    }
+    get connectedCallbackPromise() {
+        return this._connectedCallbackPromise;
+    }
+    // --- Commands ---
+    select(properties, options) {
+        return this._core.select(properties, options);
+    }
+    // --- Lifecycle ---
+    connectedCallback() {
+        this.style.display = "none";
+        this._connectedCallbackPromise = this._core.observe();
+    }
+    disconnectedCallback() {
+        this._core.dispose();
+    }
+}
+
+function registerComponents() {
+    if (!customElements.get(config.tagNames.contacts)) {
+        customElements.define(config.tagNames.contacts, WcsContacts);
+    }
+}
+
+function bootstrapContacts(userConfig) {
+    if (userConfig) {
+        setConfig(userConfig);
+    }
+    registerComponents();
+}
+
+export { ContactsCore, WcsContacts, bootstrapContacts, getConfig };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/core/ContactsCore.ts","../src/components/Contacts.ts","../src/registerComponents.ts","../src/bootstrapContacts.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    contacts: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    contacts: \"wcs-contacts\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\n// Note: this is the live, mutable internal config. It is not part of the public\n// package exports (see exports.ts) — only `getConfig()` (frozen snapshot) is\n// surfaced; `setConfig()` is applied internally via `bootstrapContacts()` and is\n// not re-exported from the package root — but a deep path import (`.../src/config.js`)\n// can still reach and mutate it. Accepted as-is for cross-package consistency: every\n// @wcstack package follows this same shape. Use `getConfig()` for a frozen, safe read.\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { ContactInfo, ContactProperty, ContactsSelectOptions, IWcBindable } from \"../types.js\";\n\n/**\n * Headless Contact Picker primitive. A thin, framework-agnostic wrapper around\n * `navigator.contacts.select(properties, options)` exposed through the\n * wc-bindable protocol.\n *\n * This is the same simplified derivative of `FetchCore._doFetch` that\n * `@wcstack/share`'s `ShareCore` establishes (docs/contact-picker-tag-design.md\n * §1): single `_gen` generation guard, same-value-guarded private setters,\n * never-throw try/catch, no `AbortController`/`abort()` — the Contact Picker\n * API accepts no `AbortSignal` and, like the Web Share dialog, the picker is a\n * single system-modal surface (at most one open at a time).\n *\n * The one structural difference from `ShareCore`: `select()` takes **two**\n * positional arguments (`properties`, `options`) rather than one — the first\n * batch-3 member to do so. The command-token argument pass-through\n * (spec-proposal-command-token-arguments.md) does not special-case argument\n * count, so this requires no protocol change.\n */\nexport class ContactsCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"value\", event: \"wcs-contacts:complete\", getter: (e: Event) => (e as CustomEvent).detail.value },\n      { name: \"loading\", event: \"wcs-contacts:loading-changed\" },\n      { name: \"error\", event: \"wcs-contacts:error\" },\n      { name: \"cancelled\", event: \"wcs-contacts:cancelled-changed\" },\n    ],\n    commands: [\n      { name: \"select\", async: true },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _value: ContactInfo[] | null = null;\n  private _loading: boolean = false;\n  private _error: any = null;\n  private _cancelled: boolean = false;\n  // Generation guard (§3.4 of the guidelines): bumped ONLY by dispose(). A\n  // select() that settles after dispose() has a stale `gen` and MUST NOT\n  // write state to a torn-down element. Unlike FetchCore/EyedropperCore,\n  // select() itself does NOT bump `_gen` on each call: the archetype\n  // (docs/web-share-tag-design.md §2, adopted verbatim by\n  // docs/contact-picker-tag-design.md §1) deliberately drops the \"a new call\n  // supersedes the previous one\" plumbing those cores need, because the\n  // contact picker is a single system-modal surface (a second concurrent\n  // select() rejects with InvalidStateError on its own). Bumping `_gen` per\n  // call would instead let a fast-failing second call incorrectly invalidate\n  // a still-pending first call's eventual success. Also not bumped on the\n  // unsupported early-return — no asynchronous work is started, so there is\n  // no generation to protect.\n  private _gen = 0;\n  // SSR (§3.8): no asynchronous probe to await, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  get value(): ContactInfo[] | null {\n    return this._value;\n  }\n\n  get loading(): boolean {\n    return this._loading;\n  }\n\n  get error(): any {\n    return this._error;\n  }\n\n  get cancelled(): boolean {\n    return this._cancelled;\n  }\n\n  // Lifecycle (§3.5). Select is command-driven with no subscription to\n  // establish, so observe() is an idempotent no-op that resolves once ready;\n  // dispose() only invalidates any in-flight select() (there is nothing to\n  // abort or unsubscribe).\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._gen++;\n  }\n\n  private _setLoading(loading: boolean): void {\n    if (this._loading === loading) return;\n    this._loading = loading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:loading-changed\", {\n      detail: loading,\n      bubbles: true,\n    }));\n  }\n\n  private _setValue(value: ContactInfo[] | null): void {\n    if (this._value === value) return;\n    this._value = value;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:complete\", {\n      detail: { value },\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: any): void {\n    if (this._error === error) return;\n    this._error = error;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  private _setCancelled(cancelled: boolean): void {\n    if (this._cancelled === cancelled) return;\n    this._cancelled = cancelled;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:cancelled-changed\", {\n      detail: cancelled,\n      bubbles: true,\n    }));\n  }\n\n  // API resolution is call-time, never cached (§3.7): lets tests install/remove\n  // navigator.contacts freely and lets an unsupported environment (the common\n  // case — desktop browsers entirely lack this API) be detected correctly on\n  // every call.\n  private _api(): ((properties: ContactProperty[], options?: ContactsSelectOptions) => Promise<ContactInfo[]>) | undefined {\n    const nav = (globalThis as any).navigator;\n    return typeof nav?.contacts?.select === \"function\" ? nav.contacts.select.bind(nav.contacts) : undefined;\n  }\n\n  async select(properties: ContactProperty[], options?: ContactsSelectOptions): Promise<ContactInfo[] | null> {\n    // never-throw + unsupported: resolve API at call time and bail out\n    // immediately if absent. No _gen bump — no asynchronous work is started.\n    const selectFn = this._api();\n    if (!selectFn) {\n      this._setError({ message: \"Contact Picker API is not supported in this browser.\" });\n      return null;\n    }\n\n    // Captured, not bumped (see the `_gen` field docs above): select() does\n    // not supersede a prior in-flight call, only dispose() invalidates.\n    const gen = this._gen;\n\n    this._setLoading(true);\n    // Reset the previous outcome before starting a new select so a stale\n    // cancelled/error does not linger into this call's result.\n    this._setError(null);\n    this._setCancelled(false);\n\n    try {\n      const contacts = await selectFn(properties, options);\n\n      // Stale completion (dispose() ran while the picker was open).\n      if (gen !== this._gen) {\n        return null;\n      }\n\n      // `multiple` does not change the result shape — even a single\n      // selection resolves to a one-element array (docs/contact-picker-tag-design.md §3).\n      this._setValue(contacts);\n      this._setLoading(false);\n      return contacts;\n    } catch (e: any) {\n      // Stale completion (dispose() ran while the picker was open).\n      if (gen !== this._gen) {\n        return null;\n      }\n      if (e?.name === \"AbortError\") {\n        // The user dismissed the contact picker — a routine cancellation, not\n        // a platform failure. Kept out of `error`.\n        this._setCancelled(true);\n      } else {\n        this._setError(e);\n      }\n      this._setLoading(false);\n      return null;\n    }\n  }\n}\n","import { ContactInfo, ContactProperty, ContactsSelectOptions, IWcBindable } from \"../types.js\";\nimport { ContactsCore } from \"../core/ContactsCore.js\";\n\n/**\n * `<wcs-contacts>` — declarative Contact Picker API primitive.\n *\n * A thin command-only Shell (mirrors `<wcs-share>`): no attributes at all.\n * `select(properties, options)`'s arguments are per-call, not a declarative\n * setting to park on the element ahead of time.\n *\n * **Android Chrome only.** Desktop browsers entirely lack `navigator.contacts`\n * — treat `unsupported` as the default state, not an edge case, in any\n * example or consuming UI.\n */\nexport class WcsContacts extends HTMLElement {\n  // SSR (§4.4): observe() completes synchronously, but the Shell still exposes\n  // connectedCallbackPromise so the state binder can await it uniformly across\n  // all IO nodes before snapshotting.\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...ContactsCore.wcBindable,\n    inputs: [],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: ContactsCore.wcBindable.commands,\n  };\n\n  private _core: ContactsCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new ContactsCore(this);\n  }\n\n  // --- Core delegated getters ---\n\n  get value(): ContactInfo[] | null {\n    return this._core.value;\n  }\n\n  get loading(): boolean {\n    return this._core.loading;\n  }\n\n  get error(): any {\n    return this._core.error;\n  }\n\n  get cancelled(): boolean {\n    return this._core.cancelled;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Commands ---\n\n  select(properties: ContactProperty[], options?: ContactsSelectOptions): Promise<ContactInfo[] | null> {\n    return this._core.select(properties, options);\n  }\n\n  // --- Lifecycle ---\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    this._connectedCallbackPromise = this._core.observe();\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { WcsContacts } from \"./components/Contacts.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.contacts)) {\n    customElements.define(config.tagNames.contacts, WcsContacts);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapContacts(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n"],"names":[],"mappings":"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"}

package/dist/index.esm.min.js

@@ -0,0 +1,2 @@
+const e={tagNames:{contacts:"wcs-contacts"}};function t(e){if(null===e||"object"!=typeof e)return e;Object.freeze(e);for(const s of Object.keys(e))t(e[s]);return e}function s(e){if(null===e||"object"!=typeof e)return e;const t={};for(const n of Object.keys(e))t[n]=s(e[n]);return t}let n=null;const c=e;function r(){return n||(n=t(s(e))),n}class a extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"value",event:"wcs-contacts:complete",getter:e=>e.detail.value},{name:"loading",event:"wcs-contacts:loading-changed"},{name:"error",event:"wcs-contacts:error"},{name:"cancelled",event:"wcs-contacts:cancelled-changed"}],commands:[{name:"select",async:!0}]};_target;_value=null;_loading=!1;_error=null;_cancelled=!1;_gen=0;_ready=Promise.resolve();constructor(e){super(),this._target=e??this}get ready(){return this._ready}get value(){return this._value}get loading(){return this._loading}get error(){return this._error}get cancelled(){return this._cancelled}observe(){return this._ready}dispose(){this._gen++}_setLoading(e){this._loading!==e&&(this._loading=e,this._target.dispatchEvent(new CustomEvent("wcs-contacts:loading-changed",{detail:e,bubbles:!0})))}_setValue(e){this._value!==e&&(this._value=e,this._target.dispatchEvent(new CustomEvent("wcs-contacts:complete",{detail:{value:e},bubbles:!0})))}_setError(e){this._error!==e&&(this._error=e,this._target.dispatchEvent(new CustomEvent("wcs-contacts:error",{detail:e,bubbles:!0})))}_setCancelled(e){this._cancelled!==e&&(this._cancelled=e,this._target.dispatchEvent(new CustomEvent("wcs-contacts:cancelled-changed",{detail:e,bubbles:!0})))}_api(){const e=globalThis.navigator;return"function"==typeof e?.contacts?.select?e.contacts.select.bind(e.contacts):void 0}async select(e,t){const s=this._api();if(!s)return this._setError({message:"Contact Picker API is not supported in this browser."}),null;const n=this._gen;this._setLoading(!0),this._setError(null),this._setCancelled(!1);try{const c=await s(e,t);return n!==this._gen?null:(this._setValue(c),this._setLoading(!1),c)}catch(e){return n!==this._gen||("AbortError"===e?.name?this._setCancelled(!0):this._setError(e),this._setLoading(!1)),null}}}class o extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...a.wcBindable,inputs:[],commands:a.wcBindable.commands};_core;_connectedCallbackPromise=Promise.resolve();constructor(){super(),this._core=new a(this)}get value(){return this._core.value}get loading(){return this._core.loading}get error(){return this._core.error}get cancelled(){return this._core.cancelled}get connectedCallbackPromise(){return this._connectedCallbackPromise}select(e,t){return this._core.select(e,t)}connectedCallback(){this.style.display="none",this._connectedCallbackPromise=this._core.observe()}disconnectedCallback(){this._core.dispose()}}function l(t){var s;t&&((s=t).tagNames&&Object.assign(e.tagNames,s.tagNames),n=null),customElements.get(c.tagNames.contacts)||customElements.define(c.tagNames.contacts,o)}export{a as ContactsCore,o as WcsContacts,l as bootstrapContacts,r as getConfig};
+//# sourceMappingURL=index.esm.min.js.map

package/dist/index.esm.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.min.js","sources":["../src/config.ts","../src/core/ContactsCore.ts","../src/components/Contacts.ts","../src/bootstrapContacts.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    contacts: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    contacts: \"wcs-contacts\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\n// Note: this is the live, mutable internal config. It is not part of the public\n// package exports (see exports.ts) — only `getConfig()` (frozen snapshot) is\n// surfaced; `setConfig()` is applied internally via `bootstrapContacts()` and is\n// not re-exported from the package root — but a deep path import (`.../src/config.js`)\n// can still reach and mutate it. Accepted as-is for cross-package consistency: every\n// @wcstack package follows this same shape. Use `getConfig()` for a frozen, safe read.\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { ContactInfo, ContactProperty, ContactsSelectOptions, IWcBindable } from \"../types.js\";\n\n/**\n * Headless Contact Picker primitive. A thin, framework-agnostic wrapper around\n * `navigator.contacts.select(properties, options)` exposed through the\n * wc-bindable protocol.\n *\n * This is the same simplified derivative of `FetchCore._doFetch` that\n * `@wcstack/share`'s `ShareCore` establishes (docs/contact-picker-tag-design.md\n * §1): single `_gen` generation guard, same-value-guarded private setters,\n * never-throw try/catch, no `AbortController`/`abort()` — the Contact Picker\n * API accepts no `AbortSignal` and, like the Web Share dialog, the picker is a\n * single system-modal surface (at most one open at a time).\n *\n * The one structural difference from `ShareCore`: `select()` takes **two**\n * positional arguments (`properties`, `options`) rather than one — the first\n * batch-3 member to do so. The command-token argument pass-through\n * (spec-proposal-command-token-arguments.md) does not special-case argument\n * count, so this requires no protocol change.\n */\nexport class ContactsCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"value\", event: \"wcs-contacts:complete\", getter: (e: Event) => (e as CustomEvent).detail.value },\n      { name: \"loading\", event: \"wcs-contacts:loading-changed\" },\n      { name: \"error\", event: \"wcs-contacts:error\" },\n      { name: \"cancelled\", event: \"wcs-contacts:cancelled-changed\" },\n    ],\n    commands: [\n      { name: \"select\", async: true },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _value: ContactInfo[] | null = null;\n  private _loading: boolean = false;\n  private _error: any = null;\n  private _cancelled: boolean = false;\n  // Generation guard (§3.4 of the guidelines): bumped ONLY by dispose(). A\n  // select() that settles after dispose() has a stale `gen` and MUST NOT\n  // write state to a torn-down element. Unlike FetchCore/EyedropperCore,\n  // select() itself does NOT bump `_gen` on each call: the archetype\n  // (docs/web-share-tag-design.md §2, adopted verbatim by\n  // docs/contact-picker-tag-design.md §1) deliberately drops the \"a new call\n  // supersedes the previous one\" plumbing those cores need, because the\n  // contact picker is a single system-modal surface (a second concurrent\n  // select() rejects with InvalidStateError on its own). Bumping `_gen` per\n  // call would instead let a fast-failing second call incorrectly invalidate\n  // a still-pending first call's eventual success. Also not bumped on the\n  // unsupported early-return — no asynchronous work is started, so there is\n  // no generation to protect.\n  private _gen = 0;\n  // SSR (§3.8): no asynchronous probe to await, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  get value(): ContactInfo[] | null {\n    return this._value;\n  }\n\n  get loading(): boolean {\n    return this._loading;\n  }\n\n  get error(): any {\n    return this._error;\n  }\n\n  get cancelled(): boolean {\n    return this._cancelled;\n  }\n\n  // Lifecycle (§3.5). Select is command-driven with no subscription to\n  // establish, so observe() is an idempotent no-op that resolves once ready;\n  // dispose() only invalidates any in-flight select() (there is nothing to\n  // abort or unsubscribe).\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._gen++;\n  }\n\n  private _setLoading(loading: boolean): void {\n    if (this._loading === loading) return;\n    this._loading = loading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:loading-changed\", {\n      detail: loading,\n      bubbles: true,\n    }));\n  }\n\n  private _setValue(value: ContactInfo[] | null): void {\n    if (this._value === value) return;\n    this._value = value;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:complete\", {\n      detail: { value },\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: any): void {\n    if (this._error === error) return;\n    this._error = error;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  private _setCancelled(cancelled: boolean): void {\n    if (this._cancelled === cancelled) return;\n    this._cancelled = cancelled;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-contacts:cancelled-changed\", {\n      detail: cancelled,\n      bubbles: true,\n    }));\n  }\n\n  // API resolution is call-time, never cached (§3.7): lets tests install/remove\n  // navigator.contacts freely and lets an unsupported environment (the common\n  // case — desktop browsers entirely lack this API) be detected correctly on\n  // every call.\n  private _api(): ((properties: ContactProperty[], options?: ContactsSelectOptions) => Promise<ContactInfo[]>) | undefined {\n    const nav = (globalThis as any).navigator;\n    return typeof nav?.contacts?.select === \"function\" ? nav.contacts.select.bind(nav.contacts) : undefined;\n  }\n\n  async select(properties: ContactProperty[], options?: ContactsSelectOptions): Promise<ContactInfo[] | null> {\n    // never-throw + unsupported: resolve API at call time and bail out\n    // immediately if absent. No _gen bump — no asynchronous work is started.\n    const selectFn = this._api();\n    if (!selectFn) {\n      this._setError({ message: \"Contact Picker API is not supported in this browser.\" });\n      return null;\n    }\n\n    // Captured, not bumped (see the `_gen` field docs above): select() does\n    // not supersede a prior in-flight call, only dispose() invalidates.\n    const gen = this._gen;\n\n    this._setLoading(true);\n    // Reset the previous outcome before starting a new select so a stale\n    // cancelled/error does not linger into this call's result.\n    this._setError(null);\n    this._setCancelled(false);\n\n    try {\n      const contacts = await selectFn(properties, options);\n\n      // Stale completion (dispose() ran while the picker was open).\n      if (gen !== this._gen) {\n        return null;\n      }\n\n      // `multiple` does not change the result shape — even a single\n      // selection resolves to a one-element array (docs/contact-picker-tag-design.md §3).\n      this._setValue(contacts);\n      this._setLoading(false);\n      return contacts;\n    } catch (e: any) {\n      // Stale completion (dispose() ran while the picker was open).\n      if (gen !== this._gen) {\n        return null;\n      }\n      if (e?.name === \"AbortError\") {\n        // The user dismissed the contact picker — a routine cancellation, not\n        // a platform failure. Kept out of `error`.\n        this._setCancelled(true);\n      } else {\n        this._setError(e);\n      }\n      this._setLoading(false);\n      return null;\n    }\n  }\n}\n","import { ContactInfo, ContactProperty, ContactsSelectOptions, IWcBindable } from \"../types.js\";\nimport { ContactsCore } from \"../core/ContactsCore.js\";\n\n/**\n * `<wcs-contacts>` — declarative Contact Picker API primitive.\n *\n * A thin command-only Shell (mirrors `<wcs-share>`): no attributes at all.\n * `select(properties, options)`'s arguments are per-call, not a declarative\n * setting to park on the element ahead of time.\n *\n * **Android Chrome only.** Desktop browsers entirely lack `navigator.contacts`\n * — treat `unsupported` as the default state, not an edge case, in any\n * example or consuming UI.\n */\nexport class WcsContacts extends HTMLElement {\n  // SSR (§4.4): observe() completes synchronously, but the Shell still exposes\n  // connectedCallbackPromise so the state binder can await it uniformly across\n  // all IO nodes before snapshotting.\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...ContactsCore.wcBindable,\n    inputs: [],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: ContactsCore.wcBindable.commands,\n  };\n\n  private _core: ContactsCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new ContactsCore(this);\n  }\n\n  // --- Core delegated getters ---\n\n  get value(): ContactInfo[] | null {\n    return this._core.value;\n  }\n\n  get loading(): boolean {\n    return this._core.loading;\n  }\n\n  get error(): any {\n    return this._core.error;\n  }\n\n  get cancelled(): boolean {\n    return this._core.cancelled;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Commands ---\n\n  select(properties: ContactProperty[], options?: ContactsSelectOptions): Promise<ContactInfo[] | null> {\n    return this._core.select(properties, options);\n  }\n\n  // --- Lifecycle ---\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    this._connectedCallbackPromise = this._core.observe();\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapContacts(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { WcsContacts } from \"./components/Contacts.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.contacts)) {\n    customElements.define(config.tagNames.contacts, WcsContacts);\n  }\n}\n"],"names":["_config","tagNames","contacts","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","ContactsCore","EventTarget","static","protocol","version","properties","name","event","getter","e","detail","value","commands","async","_target","_value","_loading","_error","_cancelled","_gen","_ready","Promise","resolve","constructor","target","super","this","ready","loading","error","cancelled","observe","dispose","_setLoading","dispatchEvent","CustomEvent","bubbles","_setValue","_setError","_setCancelled","_api","nav","globalThis","navigator","select","bind","undefined","options","selectFn","message","gen","WcsContacts","HTMLElement","wcBindable","inputs","_core","_connectedCallbackPromise","connectedCallbackPromise","connectedCallback","style","display","disconnectedCallback","bootstrapContacts","userConfig","partialConfig","assign","customElements","get","define"],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@wcstack/contacts",
+  "version": "1.16.0",
+  "description": "Declarative Contact Picker component for Web Components. Framework-agnostic navigator.contacts.select() wrapper via wc-bindable-protocol.",
+  "type": "module",
+  "main": "./dist/index.esm.js",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js"
+    },
+    "./auto": "./dist/auto.min.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist .tsc-out",
+    "build": "rimraf dist .tsc-out && tsc && rollup -c",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "prepublishOnly": "npm run build && npm run test:coverage"
+  },
+  "keywords": [
+    "web-components",
+    "contact-picker",
+    "contacts",
+    "custom-elements",
+    "wc-bindable",
+    "declarative",
+    "zero-dependencies",
+    "framework-agnostic"
+  ],
+  "author": "mogera551",
+  "homepage": "https://wcstack.github.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wcstack/wcstack.git",
+    "directory": "packages/contacts"
+  },
+  "bugs": {
+    "url": "https://github.com/wcstack/wcstack/issues"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@vitest/coverage-v8": "^4.0.15",
+    "@vitest/ui": "^4.0.15",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "happy-dom": "^20.0.11",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.22.4",
+    "rollup-plugin-dts": "^6.1.1",
+    "rollup-plugin-copy": "^3.5.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0",
+    "vitest": "^4.0.15"
+  }
+}