@lekoala/combobox 0.1.0

package/dist/types/helpers.d.ts

@@ -0,0 +1,251 @@
+/**
+ * Pure helpers shared by the Combobox engine.
+ *
+ * Free of DOM/engine state and unit-tested directly as ESM. The global build
+ * (dist/combobox.js) inlines them through its single side-effect entry,
+ * src/define.js; nothing in src/ ever touches window/globalThis.
+ *
+ * Separator contract:
+ * - separator values are full strings, not a character class (`",|;"` means
+ *   comma, pipe and semicolon are all independent separators);
+ * - the `|`-delimited form is the `<combo-box separators="…">` attribute
+ *   encoding, so a literal `|` cannot be expressed as an attribute separator;
+ * - matching prefers the longest separator at any position.
+ */
+export type ComboboxItem = Record<string, any> & {
+    value: string;
+    label: string;
+    disabled?: boolean;
+    selected?: boolean;
+    group?: string;
+    option?: HTMLOptionElement | null;
+    data?: Record<string, string | undefined>;
+    title?: string;
+};
+export type ItemFields = {
+    labelField?: string;
+    valueField?: string;
+};
+export type Token = {
+    text: string;
+    /**
+     * The separator that terminated the token
+     */
+    sep: string;
+};
+export type SplitResult = {
+    /**
+     * Completed tokens
+     */
+    done: Token[];
+    /**
+     * Trailing unterminated text that must stay in the input
+     */
+    rest: string;
+};
+/**
+ * Canonical combobox item. `value`/`label` are the serialized payload; the
+ * remaining keys mirror source metadata the engine reads back. Applications
+ * may hang their own payload on items (label/value fields are honored by the
+ * engine, a `data-*` mapping is not).
+ * @typedef {Record<string, any> & {
+ *   value: string,
+ *   label: string,
+ *   disabled?: boolean,
+ *   selected?: boolean,
+ *   group?: string,
+ *   option?: HTMLOptionElement | null,
+ *   data?: Record<string, string | undefined>,
+ *   title?: string,
+ * }} ComboboxItem
+ */
+/**
+ * Field mapping used to convert plain data objects into canonical items.
+ * @typedef {Object} ItemFields
+ * @property {string} [labelField]
+ * @property {string} [valueField]
+ */
+/**
+ * A completed separator-delimited token.
+ * @typedef {Object} Token
+ * @property {string} text
+ * @property {string} sep The separator that terminated the token
+ */
+/**
+ * Result of a tokenization pass.
+ * @typedef {Object} SplitResult
+ * @property {Token[]} done Completed tokens
+ * @property {string} rest Trailing unterminated text that must stay in the input
+ */
+/**
+ * @param {object} object
+ * @param {string} key
+ * @returns {boolean}
+ */
+export declare function hasOwn(object: object, key: string): boolean;
+/**
+ * Strip combining diacritics only (NFD + remove the U+0300–U+036F block).
+ * Case is preserved — use `normalize()` when case-insensitivity is also
+ * wanted. Everything in the engine that is "accent-insensitive" funnels
+ * through here, so there is exactly one definition of accent folding.
+ *
+ * @param {*} value
+ * @returns {string}
+ */
+export declare function stripDiacritics(value: any): string;
+/**
+ * @param {*} value
+ * @returns {string}
+ */
+export declare function normalize(value: any): string;
+/**
+ * Match a single `value` against `query` under a `match` strategy map
+ * ("includes" | "startswith" | "fuzzy" | "pattern").
+ *
+ * Contract: this helper decides **how a field matches** — it never receives
+ * more than one field value, so a match can never cross `searchFields`
+ * boundaries. The engine calls it as `values.some((value) => matchesField(value, query, mode))`.
+ *
+ * `pattern` is a string transformed into a `RegExp` with the `i` flag only
+ * (never a caller-supplied `RegExp`, so a stateful `g`/`y` matcher cannot
+ * leak between items). It first tests the raw value with the authored regex,
+ * then falls back to an accent-insensitive pass over `stripDiacritics()`
+ * text with a diacritics-folded spelling of the query — so `liège`, `Liège`,
+ * `LIEGE` and `liege` all match each other while `[A-Z]`-style regexes keep
+ * their original semantics (case is handled by `/i`, not by lowercasing).
+ * An invalid regex still yields `false` for every value.
+ *
+ * @param {*} value
+ * @param {*} query
+ * @param {*} mode
+ * @returns {boolean}
+ */
+export declare function matchesField(value: any, query: any, mode: any): boolean;
+/**
+ * Case- and accent-insensitive regex matching for a single value.
+ * See `matchesField` for the contract around the `i`-only flag and the
+ * additive accent-fold fallback; an invalid query returns `false`.
+ *
+ * @param {*} value
+ * @param {*} query
+ * @returns {boolean}
+ */
+export declare function patternMatch(value: any, query: any): boolean;
+/**
+ * Convert any input to a canonical `{ value, label }`.
+ *
+ * @param {*} raw
+ * @param {ItemFields | null} [fields]
+ * @returns {ComboboxItem | null}
+ */
+export declare function toItem(raw: any, fields?: ItemFields | null): ComboboxItem | null;
+/**
+ * Parse the pipe-delimited separator attribute into an array of full
+ * separator strings. `null`/empty values yield no separators.
+ *
+ * @param {string | string[] | null | undefined} raw
+ * @returns {string[]}
+ */
+export declare function parseSeparators(raw: string | string[] | null | undefined): string[];
+/**
+ * Split `input` by the longest matching separators.
+ * Returns `{ done: [{ text, sep }], rest }`: `done` holds complete tokens
+ * (each terminated by a separator); `rest` is the trailing unterminated
+ * text (the incomplete token that must stay in the input).
+ *
+ * @param {string | null | undefined} input
+ * @param {string | string[] | null | undefined} separators
+ * @returns {SplitResult}
+ */
+export declare function splitTokens(input: string | null | undefined, separators: string | string[] | null | undefined): SplitResult;
+/**
+ * Rank items by a score function with a stable tiebreak on the original
+ * relative order. `score(item, index) => number | false | null`:
+ * - `false` and `null` exclude the item (no confidence / explicit exclusion);
+ * - `0` is a valid score and keeps the item, ranked last for its tie group.
+ *
+ * The `index` argument is the position in the input list at scoring time,
+ * mirroring how the engine feeds filtered items to the user's scorer.
+ *
+ * @template T
+ * @param {T[]} items
+ * @param {(item: T, index: number) => number | false | null} score
+ * @returns {T[]}
+ */
+export declare function rankByScore<T>(items: T[], score: (item: T, index: number) => number | false | null): T[];
+/**
+ * Reconcile the remembered selection order against the currently selected
+ * values. Outcome: every selected value that appears in `order` first in the
+ * remembered sequence, then any selected value unknown to `order` appended in
+ * native `values` order. A remembered value that is no longer selected is
+ * never kept. `values` is treated as the source of truth for membership.
+ *
+ * @template T
+ * @param {T[]} values
+ * @param {T[]} order
+ * @returns {T[]}
+ */
+export declare function reconcileSelected<T>(values: T[], order: T[]): T[];
+/**
+ * Move `identity` within `list` to `index` (clamped to valid bounds). Returns
+ * `{ order, from, to }` when a real move happens (a fresh array, the input is
+ * never mutated), or `null` when the identity is unknown or already at the
+ * target position. `from`/`to` are the pre-move positions.
+ *
+ * Match is strict identity (SameValueZero), so the list may hold strings or
+ * option-element references alike — callers never need string coercion.
+ *
+ * @template T
+ * @param {T[]} list
+ * @param {T} identity
+ * @param {number} index
+ * @returns {{ order: T[], from: number, to: number } | null}
+ */
+export declare function moveValueInOrder<T>(list: T[], identity: T, index: number): {
+    order: T[];
+    from: number;
+    to: number;
+} | null;
+/**
+ * Split a comma-delimited attribute value into a trimmed, non-empty list.
+ * `"label, email, "` → `["label", "email"]`; empty input → `[]`.
+ *
+ * @param {string | null | undefined} raw
+ * @returns {string[]}
+ */
+export declare function parseList(raw: string | null | undefined): string[];
+/**
+ * Boolean `<combo-box>` attribute semantics: absent → `undefined` (so the
+ * caller can omit the option and keep the DEFAULTS value), present → `true`
+ * unless the authored value is exactly the string `"false"`.
+ *
+ * @param {Element} element
+ * @param {string} name
+ * @returns {boolean | undefined}
+ */
+export declare function booleanAttribute(element: Element, name: string): boolean | undefined;
+/**
+ * Parse a count-like `<combo-box>` attribute. `null` and non-integer values
+ * (e.g. `"banana"` or `"2.5"`) yield `undefined` so the caller can omit the
+ * option and let the DEFAULTS value apply instead of spreading `NaN`.
+ *
+ * @param {string | null | undefined} raw
+ * @returns {number | undefined}
+ */
+export declare function parseInteger(raw: string | null | undefined): number | undefined;
+/**
+ * Very light subsequence fuzzy match, used by `match: "fuzzy"`.
+ *
+ * Contract: both `str` and `lookup` must already be normalized (case/accent
+ * folding happens in the caller, in `normalize()`) — fuzzyMatch does no
+ * normalization of its own. A whitespace-only lookup matches everything; a
+ * plain substring still wins via the fast `includes` path; otherwise every
+ * non-space character of the lookup must appear in order. The scan advances by
+ * `char.length` (not `1`) so a surrogate-pair character is consumed whole.
+ *
+ * @param {string} str
+ * @param {*} lookup
+ * @returns {boolean}
+ */
+export declare function fuzzyMatch(str: string, lookup: any): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/types/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.js"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,24 @@
+export { ComboBoxElement, defineCombobox } from "./combo-box.js";
+export { Combobox, default } from "./combobox.js";
+export { booleanAttribute, fuzzyMatch, moveValueInOrder, normalize, parseInteger, parseList, parseSeparators, rankByScore, reconcileSelected, splitTokens, toItem, } from "./helpers.js";
+export type ComboboxOptions = import("./combobox.js").ComboboxOptions;
+export type ComboboxItem = import("./helpers.js").ComboboxItem;
+export type ComboboxSource = HTMLInputElement | HTMLSelectElement;
+export type LoadContext = import("./combobox.js").LoadContext;
+/**
+ * Public configuration for a Combobox instance.
+ * @typedef {import("./combobox.js").ComboboxOptions} ComboboxOptions
+ */
+/**
+ * Canonical combobox item (value/label payload plus optional metadata).
+ * @typedef {import("./helpers.js").ComboboxItem} ComboboxItem
+ */
+/**
+ * A selectable source for a combobox: a free-form input+datalist or a select.
+ * @typedef {HTMLInputElement | HTMLSelectElement} ComboboxSource
+ */
+/**
+ * Context passed to the async load callback.
+ * @typedef {import("./combobox.js").LoadContext} LoadContext
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,MAAM,GACP,MAAM,cAAc,CAAC;AAInB,YAAmD,eAAe,GAAxD,OAAO,eAAe,EAAE,eAAe,CAAiB;AAKlE,YAA+C,YAAY,GAAjD,OAAO,cAAc,EAAE,YAAY,CAAc;AAK3D,YAAgD,cAAc,GAApD,gBAAgB,GAAG,iBAAiB,CAAgB;AAK9D,YAA+C,WAAW,GAAhD,OAAO,eAAe,EAAE,WAAW,CAAa;AAjB7D;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG"}

package/dist/types/locales/de.d.ts

@@ -0,0 +1,7 @@
+/**
+ * German UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=de.d.ts.map

package/dist/types/locales/de.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../../src/locales/de.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/en.d.ts

@@ -0,0 +1,8 @@
+/**
+ * English UI messages — canonical catalog: keys and default values match the
+ * engine defaults, so `en` is the reference every other locale mirrors.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=en.d.ts.map

package/dist/types/locales/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/locales/en.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/es.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Spanish UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=es.d.ts.map

package/dist/types/locales/es.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../../src/locales/es.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/fr.d.ts

@@ -0,0 +1,7 @@
+/**
+ * French UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=fr.d.ts.map

package/dist/types/locales/fr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fr.d.ts","sourceRoot":"","sources":["../../../src/locales/fr.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/it.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Italian UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=it.d.ts.map

package/dist/types/locales/it.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"it.d.ts","sourceRoot":"","sources":["../../../src/locales/it.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/nl.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Dutch UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=nl.d.ts.map

package/dist/types/locales/nl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nl.d.ts","sourceRoot":"","sources":["../../../src/locales/nl.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/pt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Portuguese (European) UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=pt.d.ts.map

package/dist/types/locales/pt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pt.d.ts","sourceRoot":"","sources":["../../../src/locales/pt.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/ru.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Russian UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=ru.d.ts.map

package/dist/types/locales/ru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ru.d.ts","sourceRoot":"","sources":["../../../src/locales/ru.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/locales/zh-CN.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Simplified Chinese UI messages.
+ * @type {import("../messages.js").Messages}
+ */
+declare const messages: import("../messages.js").Messages;
+export default messages;
+//# sourceMappingURL=zh-CN.d.ts.map

package/dist/types/locales/zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../src/locales/zh-CN.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAFJ,OAAO,gBAAgB,EAAE,QAQlC,CAAC;eAIa,QAAQ"}

package/dist/types/messages.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Generated UI text, centralized for i18n. This module is DOM-free so the
+ * catalog can be imported and unit-tested without a browser; the engine's
+ * `Combobox.getDefaultMessages()` / `setDefaultMessages()` statics delegate to
+ * it, and the shipped `src/locales/*` modules apply their translations through
+ * `setDefaultMessages` on import.
+ */
+export type Messages = {
+    noResults?: string;
+    loading?: string;
+    loadError?: string;
+    create?: (query: string, context?: import("./combobox.js").ComboboxContext) => string;
+    position?: (label: string, position: number, total: number, context?: import("./combobox.js").ComboboxContext) => string;
+};
+/**
+ * Screen-reader / UI status messages. Defaults are merged so the label
+ * producers (`create`, `position`) are always functions; the plain status
+ * strings (`noResults`, `loading`, `loadError`) are literal text rendered by
+ * `setContent` (rich DOM rows use the `render.*` hooks instead).
+ * @typedef {Object} Messages
+ * @property {string} [noResults]
+ * @property {string} [loading]
+ * @property {string} [loadError]
+ * @property {(query: string, context?: import("./combobox.js").ComboboxContext) => string} [create]
+ * @property {(label: string, position: number, total: number, context?: import("./combobox.js").ComboboxContext) => string} [position]
+ */
+/** @type {Messages} */
+declare const DEFAULT_MESSAGES: Messages;
+/**
+ * Read the current default UI messages. Returns a shallow copy; mutating
+ * the result does not affect the engine.
+ * @returns {Messages}
+ */
+export declare function getDefaultMessages(): Messages;
+/**
+ * Merge application or locale-provided UI text into the default messages.
+ * Called by the shipped `locales/*` modules on import. Only comboboxes
+ * created *after* this call see the new text: instances resolve their
+ * messages as a snapshot at construction time. Per-instance `messages`
+ * options always take precedence over these defaults. Missing keys keep
+ * their current translation, and producer keys (`create`, `position`) stay
+ * functions.
+ * @param {Partial<Messages>} messages
+ * @returns {void}
+ */
+export declare function setDefaultMessages(messages: Partial<Messages>): void;
+export { DEFAULT_MESSAGES };
+//# sourceMappingURL=messages.d.ts.map

package/dist/types/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/messages.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOA,YAAkB,QAAQ,GAC1B;IAAoB,SAAS,AAA7B,CACA,EADW,MAAM,CACjB;IAAoB,OAAO,AAA3B,CACA,EADW,MAAM,CACjB;IAAoB,SAAS,AAA7B,CACA,EADW,MAAM,CACjB;IAA0F,MAAM,AAAhG,CACA,EADW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,eAAe,EAAE,eAAe,KAAK,MAAM,CACvF;IAA2H,QAAQ,AAAnI,CAAoI,EAAzH,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,eAAe,EAAE,eAAe,KAAK,MAAM,CAAY;CAAA,CAAA;AAVvI;;;;;;;;;;;GAWG;AAEH,uBAAuB;AACvB,QAAA,MAAM,gBAAgB,EADX,QAOV,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,IAFrB,QAAQ,CAIpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAHhC,OAAO,CAAC,QAAQ,CAGgB,GAF9B,IAAI,CAIhB;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@lekoala/combobox",
+  "version": "0.1.0",
+  "description": "Native-first <combo-box> combobox/filterable-select",
+  "type": "module",
+  "sideEffects": [
+    "./dist/combobox.js",
+    "./dist/combobox.min.js",
+    "./dist/combobox.css",
+    "./dist/combobox.min.css",
+    "./src/combobox.css",
+    "./src/define.js"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lekoala/combobox.git"
+  },
+  "homepage": "https://github.com/lekoala/combobox",
+  "bugs": "https://github.com/lekoala/combobox/issues",
+  "packageManager": "bun@1.4.0",
+  "customElements": "custom-elements.json",
+  "keywords": [
+    "combobox",
+    "select",
+    "filterable-select",
+    "datalist",
+    "custom-select",
+    "popover",
+    "web-component"
+  ],
+  "files": [
+    "dist",
+    "src",
+    "custom-elements.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./define": {
+      "types": "./dist/types/define.d.ts",
+      "import": "./src/define.js"
+    },
+    "./combobox.css": "./src/combobox.css",
+    "./locales/*": {
+      "types": "./dist/types/locales/*.d.ts",
+      "import": "./src/locales/*"
+    },
+    "./dist/combobox.js": "./dist/combobox.js",
+    "./dist/combobox.min.js": "./dist/combobox.min.js",
+    "./dist/combobox.css": "./dist/combobox.css",
+    "./dist/combobox.min.css": "./dist/combobox.min.css"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "bun run sync && node test/server.js",
+    "build:bundle": "bun scripts/build.js",
+    "build:types": "bun run types",
+    "build:manifest": "bun scripts/custom-elements.js",
+    "build": "bun run build:bundle && bun run build:types && bun run build:manifest",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "typecheck": "tsc -p jsconfig.json",
+    "types": "tsc -p tsconfig.types.json",
+    "test": "bun test test/unit",
+    "test:syntax": "node --check src/combobox.js && node --check src/combo-box.js && node --check src/helpers.js && node --check src/index.js && node --check src/define.js",
+    "test:types": "tsc -p test/types/tsconfig.json",
+    "test:browser": "playwright test test/browser --project chromium",
+    "test:browser:headed": "playwright test test/browser --project chromium --headed",
+    "test:browser:all": "playwright test test/browser",
+    "test:dist": "playwright test test/dist --project chromium",
+    "sync": "bun run build",
+    "check": "bun run test:syntax && bun run lint && bun run typecheck && bun run test",
+    "check:package": "bun scripts/check-package.js",
+    "check:generated": "bun scripts/check-generated.js",
+    "verify": "bun run check && bun run sync && bun run test:types && bun run check:generated && bun run check:package",
+    "check:all": "bun run verify && bun run test:browser:all && bun run test:dist",
+    "prepack": "bun run sync",
+    "prepublishOnly": "bun run verify"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.11",
+    "@playwright/test": "1.62.1",
+    "typescript": "7.0.2"
+  }
+}