{ "schemaVersion": "1.0.0", "readme": "", "modules": [ { "kind": "javascript-module", "path": "lit/components/alert/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmAlert", "members": [ { "kind": "field", "name": "severity", "type": { "text": "AlertSeverity" }, "default": "\"info\"", "attribute": "severity" }, { "kind": "field", "name": "heading", "type": { "text": "string" }, "default": "\"\"", "attribute": "heading" }, { "kind": "field", "name": "dismissible", "type": { "text": "boolean" }, "default": "false", "attribute": "dismissible" }, { "kind": "field", "name": "static", "type": { "text": "boolean" }, "default": "false", "attribute": "static" }, { "kind": "field", "name": "prominent", "type": { "text": "boolean" }, "default": "false", "attribute": "prominent" }, { "kind": "field", "name": "variant", "type": { "text": "AlertVariant" }, "default": "\"inline\"", "attribute": "variant" }, { "kind": "field", "name": "_hasBodyText", "type": { "text": "boolean" }, "privacy": "private", "default": "true" }, { "kind": "field", "name": "_hasAction", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_onDefaultSlot", "privacy": "private" }, { "kind": "field", "name": "_onActionSlot", "privacy": "private" }, { "kind": "field", "name": "_onActionClick", "privacy": "private" }, { "kind": "field", "name": "_onDismiss", "privacy": "private" } ], "events": [ { "description": "Fired when the alert's action is activated.", "name": "alert-action" }, { "description": "Fired when the alert is dismissed.", "name": "alert-dismiss" } ], "attributes": [ { "name": "severity", "type": { "text": "AlertSeverity" }, "default": "\"info\"", "fieldName": "severity" }, { "name": "heading", "type": { "text": "string" }, "default": "\"\"", "fieldName": "heading" }, { "name": "dismissible", "type": { "text": "boolean" }, "default": "false", "fieldName": "dismissible" }, { "name": "static", "type": { "text": "boolean" }, "default": "false", "fieldName": "static" }, { "name": "prominent", "type": { "text": "boolean" }, "default": "false", "fieldName": "prominent" }, { "name": "variant", "type": { "text": "AlertVariant" }, "default": "\"inline\"", "fieldName": "variant" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-alert", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmAlert", "declaration": { "name": "XmAlert", "module": "lit/components/alert/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-alert", "declaration": { "name": "XmAlert", "module": "lit/components/alert/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/app-bar/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmAppBar", "members": [ { "kind": "field", "name": "size", "type": { "text": "AppBarSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "sticky", "type": { "text": "boolean" }, "default": "false", "attribute": "sticky", "reflects": true }, { "kind": "field", "name": "_mo", "type": { "text": "MutationObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_slotEmpty", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "name", "type": { "text": "string | null" } } ] }, { "kind": "field", "name": "_onSlot", "privacy": "private" }, { "kind": "field", "name": "_onNavSlot", "privacy": "private" } ], "attributes": [ { "name": "size", "type": { "text": "AppBarSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "sticky", "type": { "text": "boolean" }, "default": "false", "fieldName": "sticky" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-app-bar", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmAppBar", "declaration": { "name": "XmAppBar", "module": "lit/components/app-bar/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-app-bar", "declaration": { "name": "XmAppBar", "module": "lit/components/app-bar/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/artifact/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmArtifact", "members": [ { "kind": "field", "name": "title", "type": { "text": "string" }, "default": "\"\"", "attribute": "title" }, { "kind": "field", "name": "sub", "type": { "text": "string[] | null" }, "default": "null" }, { "kind": "field", "name": "subCsv", "type": { "text": "string" }, "default": "\"\"", "attribute": "sub-csv" }, { "kind": "field", "name": "view", "type": { "text": "ArtifactView" }, "default": "\"preview\"", "attribute": "view", "reflects": true }, { "kind": "field", "name": "showRefresh", "type": { "text": "boolean" }, "default": "false", "attribute": "show-refresh" }, { "kind": "field", "name": "showClose", "type": { "text": "boolean" }, "default": "false", "attribute": "show-close" }, { "kind": "field", "name": "_bodies", "type": { "text": "ArtifactBodies" }, "privacy": "private", "default": "{ preview: [], code: [] }" }, { "kind": "field", "name": "_uid", "privacy": "private", "default": "`artifact-${++artifactInstance}`" }, { "kind": "method", "name": "setBodies", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "preview", "type": { "text": "ChildNode[]" } }, { "name": "code", "type": { "text": "ChildNode[]" } } ], "description": "Imperatively set the preview/code body nodes from a host. Replaces any\nauthored or previously-set bodies. Used by to hand the\npanel its slot content; the chat shell can't author them as direct\nchildren of the lit-rendered tag without the snapshot\ntiming race that this method sidesteps." }, { "kind": "field", "name": "_setView", "privacy": "private" }, { "kind": "field", "name": "_onTabKeydown", "privacy": "private" }, { "kind": "field", "name": "_onRefresh", "privacy": "private" }, { "kind": "field", "name": "_onClose", "privacy": "private" }, { "kind": "method", "name": "_subItems", "privacy": "private", "return": { "type": { "text": "string[]" } } } ], "events": [ { "description": "Fired when the element requests to close.", "name": "close" }, { "description": "Fired when a refresh is requested.", "name": "refresh" }, { "description": "Fired when the active view changes.", "name": "view-change" } ], "attributes": [ { "name": "title", "type": { "text": "string" }, "default": "\"\"", "fieldName": "title" }, { "name": "sub-csv", "type": { "text": "string" }, "default": "\"\"", "fieldName": "subCsv" }, { "name": "view", "type": { "text": "ArtifactView" }, "default": "\"preview\"", "fieldName": "view" }, { "name": "show-refresh", "type": { "text": "boolean" }, "default": "false", "fieldName": "showRefresh" }, { "name": "show-close", "type": { "text": "boolean" }, "default": "false", "fieldName": "showClose" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-artifact", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmArtifact", "declaration": { "name": "XmArtifact", "module": "lit/components/artifact/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-artifact", "declaration": { "name": "XmArtifact", "module": "lit/components/artifact/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/autocomplete/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmAutocomplete", "members": [ { "kind": "field", "name": "options", "type": { "text": "SelectOption[]" }, "default": "[]", "description": "Shared option model — `{ label, value, disabled? }` (AD-8a)." }, { "kind": "field", "name": "placeholder", "type": { "text": "string" }, "default": "\"Search…\"", "description": "Native placeholder shown when the query is empty.", "attribute": "placeholder" }, { "kind": "field", "name": "_open", "type": { "text": "boolean" }, "privacy": "protected", "default": "false" }, { "kind": "field", "name": "_query", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"" }, { "kind": "field", "name": "_activeIndex", "type": { "text": "number" }, "privacy": "protected", "default": "-1" }, { "kind": "field", "name": "_selectedValue", "type": { "text": "string | number | null" }, "privacy": "protected", "default": "null" }, { "kind": "field", "name": "_input", "type": { "text": "HTMLInputElement | null" }, "privacy": "protected" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "protected" }, { "kind": "method", "name": "_resolveSeed", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "selectedValue", "type": { "text": "string | number | null" }, "description": "Typed primitive read for consumers; the inherited string `value` stays in\nsync for xm-form / ElementInternals.", "readonly": true }, { "kind": "field", "name": "_filtered", "type": { "text": "SelectOption[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_enabledIndexes", "type": { "text": "number[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_onDocPointerDown", "privacy": "private" }, { "kind": "method", "name": "_openList", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_closeList", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "focusInput", "default": "true" } ] }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" }, { "kind": "field", "name": "_onInput", "privacy": "private" }, { "kind": "method", "name": "_commitSelection", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "opt", "type": { "text": "SelectOption" } } ] }, { "kind": "method", "name": "_selectActive", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "method", "name": "_nextEnabled", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "from", "type": { "text": "number" } }, { "name": "dir", "type": { "text": "1 | -1" } } ] }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_renderOption", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "opt", "type": { "text": "SelectOption" } }, { "name": "index", "type": { "text": "number" } }, { "name": "baseId", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_highlight", "privacy": "private", "return": { "type": { "text": "TemplateResult | string" } }, "parameters": [ { "name": "label", "type": { "text": "string" } } ], "description": "Wrap the matched substring in a highlight mark. The mark carries BOTH a\ncoral ink AND an underline so the cue survives grayscale (NFR-15 — color\nis never the sole carrier)." }, { "kind": "method", "name": "_renderEmpty", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "baseId", "type": { "text": "string" } } ] }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "placeholder", "type": { "text": "string" }, "default": "\"Search…\"", "description": "Native placeholder shown when the query is empty.", "fieldName": "placeholder" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-autocomplete", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmAutocomplete", "declaration": { "name": "XmAutocomplete", "module": "lit/components/autocomplete/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-autocomplete", "declaration": { "name": "XmAutocomplete", "module": "lit/components/autocomplete/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/avatar/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmAvatar", "members": [ { "kind": "field", "name": "title", "type": { "text": "string" }, "default": "\"\"", "attribute": "title" }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "attribute": "name" }, { "kind": "field", "name": "initials", "type": { "text": "string" }, "default": "\"\"", "attribute": "initials" }, { "kind": "field", "name": "src", "type": { "text": "string" }, "default": "\"\"", "attribute": "src" }, { "kind": "field", "name": "size", "type": { "text": "AvatarSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "_initials", "type": { "text": "string" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_label", "type": { "text": "string" }, "privacy": "private", "readonly": true } ], "attributes": [ { "name": "title", "type": { "text": "string" }, "default": "\"\"", "fieldName": "title" }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "fieldName": "name" }, { "name": "initials", "type": { "text": "string" }, "default": "\"\"", "fieldName": "initials" }, { "name": "src", "type": { "text": "string" }, "default": "\"\"", "fieldName": "src" }, { "name": "size", "type": { "text": "AvatarSize" }, "default": "\"md\"", "fieldName": "size" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-avatar", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmAvatar", "declaration": { "name": "XmAvatar", "module": "lit/components/avatar/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-avatar", "declaration": { "name": "XmAvatar", "module": "lit/components/avatar/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/avatar-group/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmAvatarGroup", "members": [ { "kind": "field", "name": "max", "type": { "text": "number" }, "default": "4", "attribute": "max" }, { "kind": "field", "name": "size", "type": { "text": "AvatarSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "_overflow", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "method", "name": "_avatars", "privacy": "private", "return": { "type": { "text": "HTMLElement[]" } } }, { "kind": "method", "name": "_applyChildren", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onSlot", "privacy": "private" } ], "attributes": [ { "name": "max", "type": { "text": "number" }, "default": "4", "fieldName": "max" }, { "name": "size", "type": { "text": "AvatarSize" }, "default": "\"md\"", "fieldName": "size" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-avatar-group", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmAvatarGroup", "declaration": { "name": "XmAvatarGroup", "module": "lit/components/avatar-group/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-avatar-group", "declaration": { "name": "XmAvatarGroup", "module": "lit/components/avatar-group/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/badge/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmBadge", "members": [ { "kind": "field", "name": "count", "type": { "text": "number | null" }, "default": "null", "attribute": "count" }, { "kind": "field", "name": "dot", "type": { "text": "boolean" }, "default": "false", "attribute": "dot" }, { "kind": "field", "name": "max", "type": { "text": "number" }, "default": "99", "attribute": "max" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "_hasCount", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_display", "type": { "text": "string" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_ariaLabel", "type": { "text": "string" }, "privacy": "private", "readonly": true } ], "attributes": [ { "name": "count", "type": { "text": "number | null" }, "default": "null", "fieldName": "count" }, { "name": "dot", "type": { "text": "boolean" }, "default": "false", "fieldName": "dot" }, { "name": "max", "type": { "text": "number" }, "default": "99", "fieldName": "max" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-badge", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmBadge", "declaration": { "name": "XmBadge", "module": "lit/components/badge/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-badge", "declaration": { "name": "XmBadge", "module": "lit/components/badge/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/brand-mark/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmBrandGlyph", "members": [], "superclass": { "name": "LightElement", "module": "lit/components/brand-mark/index.ts" }, "tagName": "xm-brand-glyph", "customElement": true }, { "kind": "class", "description": "", "name": "XmBrandMark", "members": [ { "kind": "field", "name": "size", "type": { "text": "BrandSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "showGlyph", "type": { "text": "boolean" }, "default": "true", "attribute": "show-glyph" }, { "kind": "field", "name": "showWordmark", "type": { "text": "boolean" }, "default": "true", "attribute": "show-wordmark" }, { "kind": "field", "name": "showTagline", "type": { "text": "boolean" }, "default": "false", "attribute": "show-tagline" }, { "kind": "field", "name": "tagline", "type": { "text": "string" }, "default": "\"Smart-routing AI chat. The mark is an X-mesh — four nodes routing to a single hub through the letterform itself.\"", "attribute": "tagline" } ], "attributes": [ { "name": "size", "type": { "text": "BrandSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "show-glyph", "type": { "text": "boolean" }, "default": "true", "fieldName": "showGlyph" }, { "name": "show-wordmark", "type": { "text": "boolean" }, "default": "true", "fieldName": "showWordmark" }, { "name": "show-tagline", "type": { "text": "boolean" }, "default": "false", "fieldName": "showTagline" }, { "name": "tagline", "type": { "text": "string" }, "default": "DEFAULT_TAGLINE", "fieldName": "tagline" } ], "superclass": { "name": "LightElement", "module": "lit/components/brand-mark/index.ts" }, "tagName": "xm-brand-mark", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmBrandGlyph", "declaration": { "name": "XmBrandGlyph", "module": "lit/components/brand-mark/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-brand-glyph", "declaration": { "name": "XmBrandGlyph", "module": "lit/components/brand-mark/index.ts" } }, { "kind": "js", "name": "XmBrandMark", "declaration": { "name": "XmBrandMark", "module": "lit/components/brand-mark/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-brand-mark", "declaration": { "name": "XmBrandMark", "module": "lit/components/brand-mark/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/breadcrumbs/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmBreadcrumbs", "members": [ { "kind": "field", "name": "items", "type": { "text": "BreadcrumbItem[]" }, "default": "[]" }, { "kind": "field", "name": "separator", "type": { "text": "BreadcrumbSeparator" }, "default": "\"chevron\"", "attribute": "separator" }, { "kind": "method", "name": "_separatorGlyph", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } } ], "attributes": [ { "name": "separator", "type": { "text": "BreadcrumbSeparator" }, "default": "\"chevron\"", "fieldName": "separator" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-breadcrumbs", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmBreadcrumbs", "declaration": { "name": "XmBreadcrumbs", "module": "lit/components/breadcrumbs/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-breadcrumbs", "declaration": { "name": "XmBreadcrumbs", "module": "lit/components/breadcrumbs/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/bubble/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmBubbleGroup", "members": [ { "kind": "field", "name": "variant", "type": { "text": "BubbleVariant" }, "default": "\"bot\"", "attribute": "variant" }, { "kind": "field", "name": "_authoredChildren", "type": { "text": "ChildNode[]" }, "privacy": "private", "default": "[]" } ], "events": [ { "description": "Fired when an artifact download is requested.", "name": "artifact-download" }, { "description": "Fired when an artifact is opened.", "name": "artifact-open" } ], "attributes": [ { "name": "variant", "type": { "text": "BubbleVariant" }, "default": "\"bot\"", "fieldName": "variant" } ], "superclass": { "name": "LightElement", "module": "lit/components/bubble/index.ts" }, "tagName": "xm-bubble-group", "customElement": true }, { "kind": "class", "description": "", "name": "XmBubble", "members": [ { "kind": "field", "name": "variant", "type": { "text": "BubbleVariant" }, "default": "\"bot\"", "attribute": "variant" }, { "kind": "field", "name": "attachments", "type": { "text": "BubbleAttachment[]" }, "default": "[]" }, { "kind": "field", "name": "artifact", "type": { "text": "BubbleArtifact | null" }, "default": "null" }, { "kind": "field", "name": "download", "type": { "text": "boolean" }, "default": "false", "attribute": "download" }, { "kind": "field", "name": "text", "type": { "text": "string" }, "default": "\"\"", "attribute": "text" }, { "kind": "field", "name": "bodyHtml", "type": { "text": "string" }, "default": "\"\"", "attribute": "body-html" }, { "kind": "field", "name": "_authored", "type": { "text": "ChildNode[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_onArtifactOpen", "privacy": "private" }, { "kind": "field", "name": "_onArtifactDownload", "privacy": "private" }, { "kind": "method", "name": "_attachmentTemplate", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "a", "type": { "text": "BubbleAttachment" } } ] }, { "kind": "method", "name": "_artifactTemplate", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } } ], "attributes": [ { "name": "variant", "type": { "text": "BubbleVariant" }, "default": "\"bot\"", "fieldName": "variant" }, { "name": "download", "type": { "text": "boolean" }, "default": "false", "fieldName": "download" }, { "name": "text", "type": { "text": "string" }, "default": "\"\"", "fieldName": "text" }, { "name": "body-html", "type": { "text": "string" }, "default": "\"\"", "fieldName": "bodyHtml" } ], "superclass": { "name": "LightElement", "module": "lit/components/bubble/index.ts" }, "tagName": "xm-bubble", "customElement": true }, { "kind": "class", "description": "", "name": "XmBubbleActions", "members": [ { "kind": "field", "name": "ts", "type": { "text": "string" }, "default": "\"\"", "attribute": "ts" }, { "kind": "field", "name": "ariaLabel", "type": { "text": "string" }, "default": "\"Message actions\"", "attribute": "aria-label" }, { "kind": "field", "name": "_authored", "type": { "text": "ChildNode[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_copyResetTimer", "type": { "text": "number | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_stragglerObserver", "type": { "text": "MutationObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_isRenderedShell", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "node", "type": { "text": "Node" } } ] }, { "kind": "method", "name": "_harvestAuthored", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "nodes", "type": { "text": "ChildNode[]" } } ] }, { "kind": "field", "name": "_onDelegatedClick", "privacy": "private" }, { "kind": "method", "name": "_showCopiedFeedback", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "btn", "type": { "text": "HTMLElement" } } ] } ], "attributes": [ { "name": "ts", "type": { "text": "string" }, "default": "\"\"", "fieldName": "ts" }, { "name": "aria-label", "type": { "text": "string" }, "default": "\"Message actions\"", "fieldName": "ariaLabel" } ], "superclass": { "name": "LightElement", "module": "lit/components/bubble/index.ts" }, "tagName": "xm-bubble-actions", "customElement": true }, { "kind": "class", "description": "", "name": "XmArtifactChip", "members": [ { "kind": "field", "name": "artifact", "type": { "text": "BubbleArtifact | null" }, "default": "null" }, { "kind": "field", "name": "download", "type": { "text": "boolean" }, "default": "false", "attribute": "download" }, { "kind": "field", "name": "_open", "privacy": "private" }, { "kind": "field", "name": "_download", "privacy": "private" } ], "attributes": [ { "name": "download", "type": { "text": "boolean" }, "default": "false", "fieldName": "download" } ], "superclass": { "name": "LightElement", "module": "lit/components/bubble/index.ts" }, "tagName": "xm-artifact-chip", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmBubbleGroup", "declaration": { "name": "XmBubbleGroup", "module": "lit/components/bubble/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-bubble-group", "declaration": { "name": "XmBubbleGroup", "module": "lit/components/bubble/index.ts" } }, { "kind": "js", "name": "XmBubble", "declaration": { "name": "XmBubble", "module": "lit/components/bubble/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-bubble", "declaration": { "name": "XmBubble", "module": "lit/components/bubble/index.ts" } }, { "kind": "js", "name": "XmBubbleActions", "declaration": { "name": "XmBubbleActions", "module": "lit/components/bubble/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-bubble-actions", "declaration": { "name": "XmBubbleActions", "module": "lit/components/bubble/index.ts" } }, { "kind": "js", "name": "XmArtifactChip", "declaration": { "name": "XmArtifactChip", "module": "lit/components/bubble/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-artifact-chip", "declaration": { "name": "XmArtifactChip", "module": "lit/components/bubble/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/button/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmButton", "members": [ { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }" }, { "kind": "field", "name": "variant", "type": { "text": "ButtonVariant" }, "default": "\"primary\"", "attribute": "variant" }, { "kind": "field", "name": "size", "type": { "text": "ButtonSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "iconOnly", "type": { "text": "boolean" }, "default": "false", "attribute": "icon-only" }, { "kind": "field", "name": "fullWidth", "type": { "text": "boolean" }, "default": "false", "attribute": "full-width" }, { "kind": "field", "name": "selected", "type": { "text": "boolean" }, "default": "false", "description": "Persistent active/selected state — used by toggle/tab buttons. Reuses\nthe same .is-active visual the design canvases trigger via forceState.", "attribute": "selected" }, { "kind": "field", "name": "type", "type": { "text": "ButtonType" }, "default": "\"button\"", "attribute": "type" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled" }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading" }, { "kind": "field", "name": "forceState", "type": { "text": "ForceState" }, "default": "null", "attribute": "force-state" }, { "kind": "field", "name": "_mo", "type": { "text": "MutationObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_slotEmpty", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "name", "type": { "text": "string | null" } } ] }, { "kind": "field", "name": "_onSlot", "privacy": "private" } ], "attributes": [ { "name": "variant", "type": { "text": "ButtonVariant" }, "default": "\"primary\"", "fieldName": "variant" }, { "name": "size", "type": { "text": "ButtonSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "icon-only", "type": { "text": "boolean" }, "default": "false", "fieldName": "iconOnly" }, { "name": "full-width", "type": { "text": "boolean" }, "default": "false", "fieldName": "fullWidth" }, { "name": "selected", "type": { "text": "boolean" }, "default": "false", "description": "Persistent active/selected state — used by toggle/tab buttons. Reuses\nthe same .is-active visual the design canvases trigger via forceState.", "fieldName": "selected" }, { "name": "type", "type": { "text": "ButtonType" }, "default": "\"button\"", "fieldName": "type" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading" }, { "name": "force-state", "type": { "text": "ForceState" }, "default": "null", "fieldName": "forceState" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-button", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmButton", "declaration": { "name": "XmButton", "module": "lit/components/button/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-button", "declaration": { "name": "XmButton", "module": "lit/components/button/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/card/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmCard", "members": [ { "kind": "field", "name": "elevation", "type": { "text": "CardElevation" }, "default": "2", "attribute": "elevation" }, { "kind": "field", "name": "size", "type": { "text": "CardSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "_mo", "type": { "text": "MutationObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_slotEmpty", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "name", "type": { "text": "string | null" } } ] }, { "kind": "field", "name": "_onSlot", "privacy": "private" } ], "attributes": [ { "name": "elevation", "type": { "text": "CardElevation" }, "default": "2", "fieldName": "elevation" }, { "name": "size", "type": { "text": "CardSize" }, "default": "\"md\"", "fieldName": "size" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-card", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmCard", "declaration": { "name": "XmCard", "module": "lit/components/card/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-card", "declaration": { "name": "XmCard", "module": "lit/components/card/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/chat/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmChatShell", "members": [ { "kind": "field", "name": "conversations", "type": { "text": "ConversationGroup[]" }, "default": "[]" }, { "kind": "field", "name": "thread", "type": { "text": "ThreadMessage[]" }, "default": "[]" }, { "kind": "field", "name": "processing", "type": { "text": "boolean" }, "default": "false", "attribute": "processing" }, { "kind": "field", "name": "thinkingLabel", "type": { "text": "string" }, "default": "\"\"", "attribute": "thinking-label" }, { "kind": "field", "name": "topTitle", "type": { "text": "string" }, "default": "\"New Conversation\"", "attribute": "top-title" }, { "kind": "field", "name": "fullViewport", "type": { "text": "boolean" }, "default": "false", "description": "Pin the shell to the viewport (height: 100vh). Default is height: 100%\nso the shell sizes to its container — embedded hosts get correct\nsizing for free. Full-bleed previews opt in via the `full-viewport`\nattribute.", "attribute": "full-viewport" }, { "kind": "field", "name": "_collapsed", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_activeId", "type": { "text": "string | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_openArtifact", "type": { "text": "BubbleArtifact | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_hasEmpty", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_searchValue", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_copiedIdx", "type": { "text": "number | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_copiedTimer", "type": { "text": "number | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_artifactBodyNodes", "type": { "text": "ChildNode[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_artifactCodeNodes", "type": { "text": "ChildNode[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_emptyNodes", "type": { "text": "ChildNode[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_toggleCollapsed", "privacy": "private" }, { "kind": "field", "name": "_selectConv", "privacy": "private" }, { "kind": "field", "name": "_onSearchInput", "privacy": "private" }, { "kind": "field", "name": "_onSearchClear", "privacy": "private" }, { "kind": "field", "name": "_onArtifactOpen", "privacy": "private" }, { "kind": "field", "name": "_onArtifactClose", "privacy": "private" }, { "kind": "field", "name": "_onComposerSend", "privacy": "private" }, { "kind": "field", "name": "_onComposerCancel", "privacy": "private" }, { "kind": "field", "name": "_onCopyMessage", "privacy": "private" }, { "kind": "method", "name": "_renderSidebar", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderCollapsedList", "privacy": "private", "return": { "type": { "text": "TemplateResult[]" } }, "parameters": [ { "name": "groups", "type": { "text": "ConversationGroup[]" } } ] }, { "kind": "method", "name": "_renderExpandedList", "privacy": "private", "return": { "type": { "text": "TemplateResult[]" } }, "parameters": [ { "name": "groups", "type": { "text": "ConversationGroup[]" } } ] }, { "kind": "method", "name": "_renderTopBar", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderBubbleRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "m", "type": { "text": "ThreadMessage" } }, { "name": "idx", "type": { "text": "number" } } ] } ], "events": [ { "description": "Fired when the artifact panel is closed.", "name": "artifact-close" }, { "description": "Fired when an artifact is opened.", "name": "artifact-open" }, { "description": "Fired when the action is cancelled.", "name": "cancel" }, { "description": "Fired when the user sends the composed content.", "name": "send" } ], "attributes": [ { "name": "processing", "type": { "text": "boolean" }, "default": "false", "fieldName": "processing" }, { "name": "thinking-label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "thinkingLabel" }, { "name": "top-title", "type": { "text": "string" }, "default": "\"New Conversation\"", "fieldName": "topTitle" }, { "name": "full-viewport", "type": { "text": "boolean" }, "default": "false", "description": "Pin the shell to the viewport (height: 100vh). Default is height: 100%\nso the shell sizes to its container — embedded hosts get correct\nsizing for free. Full-bleed previews opt in via the `full-viewport`\nattribute.", "fieldName": "fullViewport" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-chat-shell", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmChatShell", "declaration": { "name": "XmChatShell", "module": "lit/components/chat/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-chat-shell", "declaration": { "name": "XmChatShell", "module": "lit/components/chat/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/checkbox/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmCheckbox", "members": [ { "kind": "field", "name": "indeterminate", "type": { "text": "boolean" }, "default": "false", "description": "Indeterminate (mixed) state — shows the dash mark on the coral fill and\nreports aria-checked=\"mixed\". Cleared on the first user toggle.", "attribute": "indeterminate", "reflects": true }, { "kind": "field", "name": "_hasLabel", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_onLabelSlotChange", "privacy": "private" }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "A checkbox submits checked-state (\"on\"/null), not text — declare it a\ntoggle so the form value is correct from first paint, before any user\ninteraction (the base seeds `_checked` from the `checked` attribute and\n`isToggle` routes it through the checkbox form-value branch).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_handleToggle", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "indeterminate", "type": { "text": "boolean" }, "default": "false", "description": "Indeterminate (mixed) state — shows the dash mark on the coral fill and\nreports aria-checked=\"mixed\". Cleared on the first user toggle.", "fieldName": "indeterminate" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-checkbox", "customElement": true, "events": [ { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ] } ], "exports": [ { "kind": "js", "name": "XmCheckbox", "declaration": { "name": "XmCheckbox", "module": "lit/components/checkbox/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-checkbox", "declaration": { "name": "XmCheckbox", "module": "lit/components/checkbox/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/chip/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmChip", "members": [ { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "attribute": "value" }, { "kind": "field", "name": "size", "type": { "text": "ChipSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "selected", "type": { "text": "boolean" }, "default": "false", "attribute": "selected", "reflects": true }, { "kind": "field", "name": "removable", "type": { "text": "boolean" }, "default": "false", "attribute": "removable" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true }, { "kind": "field", "name": "category", "type": { "text": "ChipCategory" }, "default": "\"\"", "attribute": "category" }, { "kind": "field", "name": "count", "type": { "text": "number | null" }, "default": "null", "description": "Trailing figure carried by the chip (a facet count). A real field rather\nthan text baked into the label, so it keeps the tabular/mono typescale,\nsurvives `removable`, and stays out of the remove control's accessible\nname. `null` renders nothing.", "attribute": "count" }, { "kind": "field", "name": "_mo", "type": { "text": "MutationObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_labelText", "type": { "text": "string" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_hasIconLeft", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_onSlot", "privacy": "private" }, { "kind": "method", "name": "_activate", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onHostClick", "privacy": "private" }, { "kind": "field", "name": "_onHostKeydown", "privacy": "private" }, { "kind": "field", "name": "_onRemove", "privacy": "private" } ], "events": [ { "description": "Fired when the chip is activated.", "name": "xm-chip-activate" }, { "description": "Fired when the chip's remove affordance is activated.", "name": "xm-chip-remove" } ], "attributes": [ { "name": "value", "type": { "text": "string" }, "default": "\"\"", "fieldName": "value" }, { "name": "size", "type": { "text": "ChipSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "selected", "type": { "text": "boolean" }, "default": "false", "fieldName": "selected" }, { "name": "removable", "type": { "text": "boolean" }, "default": "false", "fieldName": "removable" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "category", "type": { "text": "ChipCategory" }, "default": "\"\"", "fieldName": "category" }, { "name": "count", "type": { "text": "number | null" }, "default": "null", "description": "Trailing figure carried by the chip (a facet count). A real field rather\nthan text baked into the label, so it keeps the tabular/mono typescale,\nsurvives `removable`, and stays out of the remove control's accessible\nname. `null` renders nothing.", "fieldName": "count" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-chip", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmChip", "declaration": { "name": "XmChip", "module": "lit/components/chip/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-chip", "declaration": { "name": "XmChip", "module": "lit/components/chip/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/chip-group/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmChipGroup", "members": [ { "kind": "field", "name": "multiple", "type": { "text": "boolean" }, "default": "false", "attribute": "multiple" }, { "kind": "field", "name": "value", "type": { "text": "Primitive | Primitive[] | null" }, "default": "null" }, { "kind": "field", "name": "max", "type": { "text": "number" }, "default": "0", "description": "Show at most this many chips; the rest fold behind an overflow pill\n(0 = show everything). Same word, same behaviour as ``.\nA selected chip is never folded — an active filter stays visible even past\nthe cap — so the visible count can exceed `max`. Chips the consumer hid\nthemselves are left alone.", "attribute": "max" }, { "kind": "field", "name": "overflowLabel", "type": { "text": "string" }, "default": "\"+{n} more\"", "description": "Copy for the collapsed overflow pill. `{n}` interpolates the hidden count.", "attribute": "overflow-label" }, { "kind": "field", "name": "_overflowOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_foldCount", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_folded", "privacy": "private", "default": "new Set()" }, { "kind": "method", "name": "_chips", "privacy": "private", "return": { "type": { "text": "ChipEl[]" } } }, { "kind": "method", "name": "_enabledChips", "privacy": "private", "return": { "type": { "text": "ChipEl[]" } } }, { "kind": "method", "name": "_foldable", "privacy": "private", "return": { "type": { "text": "ChipEl[]" } } }, { "kind": "method", "name": "_partition", "privacy": "private", "return": { "type": { "text": "{ keep: ChipEl[]; fold: ChipEl[] }" } }, "parameters": [ { "name": "folding", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_applyOverflow", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_toggleOverflow", "privacy": "private" }, { "kind": "method", "name": "_syncValueFromChips", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onChipActivate", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "method", "name": "_updateRovingTabindex", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "focused", "optional": true, "type": { "text": "ChipEl" } } ] }, { "kind": "method", "name": "_renderOverflow", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "field", "name": "_onSlot", "privacy": "private" } ], "events": [ { "description": "Fired on commit with the new value in `detail`.", "name": "change" }, { "description": "Fired when the overflow pill folds or unfolds the tail of the set (`detail.open`, `detail.hidden`).", "name": "xm-chip-group-overflow-toggle" } ], "attributes": [ { "name": "multiple", "type": { "text": "boolean" }, "default": "false", "fieldName": "multiple" }, { "name": "max", "type": { "text": "number" }, "default": "0", "description": "Show at most this many chips; the rest fold behind an overflow pill\n(0 = show everything). Same word, same behaviour as ``.\nA selected chip is never folded — an active filter stays visible even past\nthe cap — so the visible count can exceed `max`. Chips the consumer hid\nthemselves are left alone.", "fieldName": "max" }, { "name": "overflow-label", "type": { "text": "string" }, "default": "\"+{n} more\"", "description": "Copy for the collapsed overflow pill. `{n}` interpolates the hidden count.", "fieldName": "overflowLabel" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-chip-group", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmChipGroup", "declaration": { "name": "XmChipGroup", "module": "lit/components/chip-group/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-chip-group", "declaration": { "name": "XmChipGroup", "module": "lit/components/chip-group/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/code/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmCode", "members": [ { "kind": "field", "name": "block", "type": { "text": "boolean" }, "default": "false", "attribute": "block" } ], "attributes": [ { "name": "block", "type": { "text": "boolean" }, "default": "false", "fieldName": "block" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-code", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmCode", "declaration": { "name": "XmCode", "module": "lit/components/code/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-code", "declaration": { "name": "XmCode", "module": "lit/components/code/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/composer/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmComposer", "members": [ { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "attribute": "initial-value" }, { "kind": "field", "name": "initialFocus", "type": { "text": "boolean" }, "default": "true", "attribute": "initial-focus" }, { "kind": "field", "name": "processing", "type": { "text": "boolean" }, "default": "false", "attribute": "processing" }, { "kind": "field", "name": "thinkingLabel", "type": { "text": "string" }, "default": "\"\"", "attribute": "thinking-label" }, { "kind": "field", "name": "maxChars", "type": { "text": "number" }, "default": "5000", "attribute": "max-chars" }, { "kind": "field", "name": "counterAt", "type": { "text": "number" }, "default": "0.8", "attribute": "counter-at" }, { "kind": "field", "name": "placeholder", "type": { "text": "string" }, "default": "\"Describe what you want to create…\"", "attribute": "placeholder" }, { "kind": "field", "name": "showAttachments", "type": { "text": "boolean" }, "default": "false", "attribute": "show-attachments" }, { "kind": "field", "name": "value", "type": { "text": "string | null" }, "default": "null" }, { "kind": "field", "name": "attachments", "type": { "text": "ComposerAttachment[] | null" }, "default": "null" }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_atts", "type": { "text": "ComposerAttachment[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_warning", "type": { "text": "ComposerWarning | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_trayOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_dragging", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_dragDepth", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_warnTimer", "type": { "text": "ReturnType | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_didInitialFocus", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_lastValueProp", "type": { "text": "string | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_lastAttsProp", "type": { "text": "ComposerAttachment[] | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_flashWarning", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "msg", "type": { "text": "string | null" } } ] }, { "kind": "method", "name": "_addFiles", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "fileList", "type": { "text": "FileList | File[]" } } ] }, { "kind": "method", "name": "_removeAtt", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "id", "type": { "text": "number" } } ] }, { "kind": "field", "name": "_clearAtts", "privacy": "private" }, { "kind": "field", "name": "_send", "privacy": "private" }, { "kind": "field", "name": "_cancel", "privacy": "private" }, { "kind": "field", "name": "_onInput", "privacy": "private" }, { "kind": "field", "name": "_onKeyDown", "privacy": "private" }, { "kind": "field", "name": "_onPaste", "privacy": "private" }, { "kind": "field", "name": "_onDragEnter", "privacy": "private" }, { "kind": "field", "name": "_onDragOver", "privacy": "private" }, { "kind": "field", "name": "_onDragLeave", "privacy": "private" }, { "kind": "field", "name": "_onDrop", "privacy": "private" }, { "kind": "field", "name": "_onBoxClick", "privacy": "private" }, { "kind": "field", "name": "_onPickFile", "privacy": "private" }, { "kind": "field", "name": "_onFileInput", "privacy": "private" }, { "kind": "method", "name": "_renderAttCard", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "att", "type": { "text": "ComposerAttachment" } } ] }, { "kind": "method", "name": "_renderAttRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "att", "type": { "text": "ComposerAttachment" } } ] }, { "kind": "method", "name": "_renderAttachments", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "method", "name": "_renderHint", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } } ], "events": [ { "name": "value-change", "type": { "text": "CustomEvent" }, "description": "Fired when the value changes (`detail.value`)." }, { "name": "attachments-change", "type": { "text": "CustomEvent" }, "description": "Fired when the attachment set changes." }, { "description": "Fired when the action is cancelled.", "name": "cancel" }, { "description": "Fired when the user sends the composed content.", "name": "send" } ], "attributes": [ { "name": "initial-value", "type": { "text": "string" }, "default": "\"\"", "fieldName": "initialValue" }, { "name": "initial-focus", "type": { "text": "boolean" }, "default": "true", "fieldName": "initialFocus" }, { "name": "processing", "type": { "text": "boolean" }, "default": "false", "fieldName": "processing" }, { "name": "thinking-label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "thinkingLabel" }, { "name": "max-chars", "type": { "text": "number" }, "default": "5000", "fieldName": "maxChars" }, { "name": "counter-at", "type": { "text": "number" }, "default": "0.8", "fieldName": "counterAt" }, { "name": "placeholder", "type": { "text": "string" }, "default": "\"Describe what you want to create…\"", "fieldName": "placeholder" }, { "name": "show-attachments", "type": { "text": "boolean" }, "default": "false", "fieldName": "showAttachments" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-composer", "customElement": true }, { "kind": "variable", "name": "id" }, { "kind": "variable", "name": "ext" } ], "exports": [ { "kind": "js", "name": "XmComposer", "declaration": { "name": "XmComposer", "module": "lit/components/composer/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-composer", "declaration": { "name": "XmComposer", "module": "lit/components/composer/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/data-grid/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmDataGrid", "members": [ { "kind": "field", "name": "columns", "type": { "text": "DataGridColumn[]" }, "default": "[]" }, { "kind": "field", "name": "rows", "type": { "text": "TableRow[]" }, "default": "[]" }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true }, { "kind": "field", "name": "pageSize", "type": { "text": "number" }, "default": "100", "attribute": "page-size" }, { "kind": "field", "name": "maxHeight", "type": { "text": "string" }, "default": "\"420px\"", "attribute": "max-height" }, { "kind": "field", "name": "totalsLabel", "type": { "text": "string" }, "default": "\"\"", "attribute": "totals-label" }, { "kind": "field", "name": "totals", "type": { "text": "boolean" }, "default": "false", "attribute": "totals" }, { "kind": "field", "name": "fitColumns", "type": { "text": "boolean" }, "default": "false", "description": "Grow the columns to fill the frame when the declared widths leave room to\nspare. Full page turns this on for as long as it is open, so the grid uses\nthe screen it took; set it to keep the same behaviour in the card.", "attribute": "fit-columns" }, { "kind": "field", "name": "fill", "type": { "text": "boolean" }, "default": "false", "description": "Stretch the frame to the host's full height instead of collapsing to the\nrows. A grid embedded in a flex column needs this to own its own scroll;\nfull page turns it on regardless, for as long as it is open.", "attribute": "fill", "reflects": true }, { "kind": "field", "name": "server", "type": { "text": "boolean" }, "default": "false", "description": "Server/controlled mode (ADR 0042): the consumer owns search, sort and\npaging. The grid stops filtering and reordering `rows`, hands them to the\ntable verbatim, and reports search and sort as intents only. Use it when\nthe rows are a page of a larger set, or a shape a local pass would\ndamage — a flattened hierarchy loses its children to either.", "attribute": "server", "reflects": true }, { "kind": "field", "name": "totalItems", "type": { "text": "number" }, "default": "0", "description": "Result count behind `rows` in server mode: the empty state, the search\ncount and the table's paging are all derived from it, never `rows.length`.", "attribute": "total-items" }, { "kind": "field", "name": "rowClick", "type": { "text": "boolean" }, "default": "false", "description": "Make rows clickable — the table's `xm-data-table-row-click` is composed,\nso it surfaces on this element.", "attribute": "row-click" }, { "kind": "field", "name": "rowKey", "type": { "text": "string" }, "default": "\"\"", "description": "Column key whose value is a row's stable identity, handed to the table.", "attribute": "row-key" }, { "kind": "field", "name": "rowHeader", "type": { "text": "| ((row: TableRow, index: number) => DataTableRowHeader | null)\n | null" }, "default": "null", "description": "Marks a row as a group header that keeps its own cells, handed straight to\nthe table — the group a consumer already owns, wearing the system's band." }, { "kind": "field", "name": "groupable", "type": { "text": "string[]" }, "default": "[]", "description": "Column keys the \"group rows\" menu offers. Empty hides the grouping pane." }, { "kind": "field", "name": "groupBy", "type": { "text": "string" }, "default": "\"\"", "description": "Column key rows start grouped by, and what the default view restores to.\nThe user can change it from the setup panel or a column's own menu.", "attribute": "group-by" }, { "kind": "field", "name": "sort", "type": { "text": "DataTableSortChangeDetail | null" }, "default": "null", "description": "Column the rows start sorted by, and what the default view restores to.\nThe grid owns sort the way it owns every other column capability: the\ntable is driven from here, so a saved view is a snapshot of grid state." }, { "kind": "field", "name": "groupSummary", "type": { "text": "| ((rows: TableRow[], key: string) => DataTableGroupSummary)\n | null" }, "default": "null", "description": "Aggregate line for a group's header row, handed straight to the table." }, { "kind": "field", "name": "emptyHeading", "type": { "text": "string" }, "default": "\"No data\"", "attribute": "empty-heading" }, { "kind": "field", "name": "emptyText", "type": { "text": "string" }, "default": "\"\"", "attribute": "empty-text" }, { "kind": "field", "name": "searchPlaceholder", "type": { "text": "string" }, "default": "\"Search all data\"", "attribute": "search-placeholder" }, { "kind": "field", "name": "toolbar", "type": { "text": "boolean" }, "default": "true", "description": "Drop the whole toolbar. Each cluster below can also be dropped on its own —\nthe toolbar belongs to the grid, so what it carries is per instance.", "attribute": "toolbar", "reflects": true }, { "kind": "field", "name": "noSearch", "type": { "text": "boolean" }, "default": "false", "attribute": "no-search" }, { "kind": "field", "name": "noViews", "type": { "text": "boolean" }, "default": "false", "attribute": "no-views" }, { "kind": "field", "name": "noGrouping", "type": { "text": "boolean" }, "default": "false", "attribute": "no-grouping" }, { "kind": "field", "name": "noColumns", "type": { "text": "boolean" }, "default": "false", "attribute": "no-columns" }, { "kind": "field", "name": "noDensity", "type": { "text": "boolean" }, "default": "false", "attribute": "no-density" }, { "kind": "field", "name": "noFullPage", "type": { "text": "boolean" }, "default": "false", "attribute": "no-full-page" }, { "kind": "field", "name": "_query", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_density", "type": { "text": "DataTableDensity" }, "privacy": "private", "default": "\"comfortable\"" }, { "kind": "field", "name": "_groupBy", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_sortKey", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_sortDirection", "type": { "text": "SortDirection" }, "privacy": "private", "default": "\"asc\"" }, { "kind": "field", "name": "_widths", "type": { "text": "Record" }, "privacy": "private", "default": "{}" }, { "kind": "field", "name": "_pinned", "type": { "text": "string[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_hidden", "type": { "text": "string[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_wrapped", "type": { "text": "string[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_collapsed", "type": { "text": "string[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_full", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_setupOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_setupPane", "type": { "text": "SetupPane" }, "privacy": "private", "default": "\"root\"" }, { "kind": "field", "name": "_columnMenu", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_views", "type": { "text": "DataGridView[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_viewId", "privacy": "private", "default": "\"default\"", "type": { "text": "string" } }, { "kind": "field", "name": "_viewDraft", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_hasEmpty", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_scrollLocked", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_columnMenuAnchor", "type": { "text": "HTMLElement | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_defaultLayout", "type": { "text": "DataGridLayout | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_layoutSeededFrom", "type": { "text": "DataGridColumn[] | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_layoutFromColumns", "privacy": "private", "return": { "type": { "text": "DataGridLayout" } } }, { "kind": "method", "name": "_currentLayout", "privacy": "private", "return": { "type": { "text": "DataGridLayout" } } }, { "kind": "method", "name": "_applyLayout", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "layout", "type": { "text": "DataGridLayout" } } ] }, { "kind": "method", "name": "_signature", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "layout", "type": { "text": "DataGridLayout" } } ] }, { "kind": "field", "name": "_allViews", "type": { "text": "DataGridView[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_activeView", "type": { "text": "DataGridView" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_emitLayout", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_visibleColumns", "type": { "text": "DataGridColumn[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_matches", "type": { "text": "TableRow[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_table", "type": { "text": "XmDataTable | null" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_renderToolbar", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "matches", "type": { "text": "TableRow[]" } } ] }, { "kind": "method", "name": "_renderSearch", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "matches", "type": { "text": "TableRow[]" } } ] }, { "kind": "method", "name": "_renderSetup", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "field", "name": "_setupPanes", "type": { "text": "SetupPane[]" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_renderSetupPane", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "panes", "type": { "text": "SetupPane[]" } } ] }, { "kind": "method", "name": "_renderSetupRoot", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "panes", "type": { "text": "SetupPane[]" } } ] }, { "kind": "method", "name": "_renderViewsPane", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderGroupPane", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderDensityPane", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderColumnsPane", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "field", "name": "_renderColumnMenuTrigger", "privacy": "private" }, { "kind": "method", "name": "_renderColumnMenu", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderColumnPanel", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "col", "type": { "text": "DataGridColumn" } } ] }, { "kind": "method", "name": "_toggleColumnMenu", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "e", "type": { "text": "MouseEvent" } } ] }, { "kind": "field", "name": "_onDocPointer", "privacy": "private" }, { "kind": "method", "name": "_menuRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "opts", "type": { "text": "{\n icon: string;\n label: string;\n hint?: string;\n on?: boolean;\n disabled?: boolean;\n trailing?: string;\n onPick: () => void;\n onDelete?: (() => void) | undefined;\n }" } } ] }, { "kind": "method", "name": "_renderDensity", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderFullPage", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderEmptyRegion", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "noMatches", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_renderNoMatches", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "field", "name": "_onSearch", "privacy": "private" }, { "kind": "field", "name": "_matchCount", "type": { "text": "number" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_clearSearch", "privacy": "private" }, { "kind": "field", "name": "_onSortChange", "privacy": "private" }, { "kind": "field", "name": "_onResize", "privacy": "private" }, { "kind": "field", "name": "_onGroupToggle", "privacy": "private" }, { "kind": "method", "name": "_setSort", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "direction", "type": { "text": "SortDirection" } } ] }, { "kind": "method", "name": "_setPinned", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "pinned", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_setHidden", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "hidden", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_setWrapped", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "wrapped", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_setGroupBy", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_setDensity", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "density", "type": { "text": "DataTableDensity" } } ] }, { "kind": "method", "name": "_selectView", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "view", "type": { "text": "DataGridView" } } ] }, { "kind": "field", "name": "_saveView", "privacy": "private" }, { "kind": "method", "name": "_deleteView", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "view", "type": { "text": "DataGridView" } } ] }, { "kind": "field", "name": "_onSetupClose", "privacy": "private" }, { "kind": "method", "name": "_closeSetup", "privacy": "private", "return": { "type": { "text": "void" } } } ], "events": [ { "name": "xm-data-grid-layout-change", "type": { "text": "CustomEvent" }, "description": "Fired when density, grouping, sort or any column state changes (`detail.layout`)." }, { "name": "xm-data-grid-view-change", "type": { "text": "CustomEvent" }, "description": "Fired when the active view changes or its layout drifts (`detail.view`, `detail.dirty`)." }, { "description": "Fired when the search query changes (`detail.query`, `detail.matches`).", "name": "xm-data-grid-search" } ], "attributes": [ { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading" }, { "name": "page-size", "type": { "text": "number" }, "default": "100", "fieldName": "pageSize" }, { "name": "max-height", "type": { "text": "string" }, "default": "\"420px\"", "fieldName": "maxHeight" }, { "name": "totals-label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "totalsLabel" }, { "name": "totals", "type": { "text": "boolean" }, "default": "false", "fieldName": "totals" }, { "name": "fit-columns", "type": { "text": "boolean" }, "default": "false", "description": "Grow the columns to fill the frame when the declared widths leave room to\nspare. Full page turns this on for as long as it is open, so the grid uses\nthe screen it took; set it to keep the same behaviour in the card.", "fieldName": "fitColumns" }, { "name": "fill", "type": { "text": "boolean" }, "default": "false", "description": "Stretch the frame to the host's full height instead of collapsing to the\nrows. A grid embedded in a flex column needs this to own its own scroll;\nfull page turns it on regardless, for as long as it is open.", "fieldName": "fill" }, { "name": "server", "type": { "text": "boolean" }, "default": "false", "description": "Server/controlled mode (ADR 0042): the consumer owns search, sort and\npaging. The grid stops filtering and reordering `rows`, hands them to the\ntable verbatim, and reports search and sort as intents only. Use it when\nthe rows are a page of a larger set, or a shape a local pass would\ndamage — a flattened hierarchy loses its children to either.", "fieldName": "server" }, { "name": "total-items", "type": { "text": "number" }, "default": "0", "description": "Result count behind `rows` in server mode: the empty state, the search\ncount and the table's paging are all derived from it, never `rows.length`.", "fieldName": "totalItems" }, { "name": "row-click", "type": { "text": "boolean" }, "default": "false", "description": "Make rows clickable — the table's `xm-data-table-row-click` is composed,\nso it surfaces on this element.", "fieldName": "rowClick" }, { "name": "row-key", "type": { "text": "string" }, "default": "\"\"", "description": "Column key whose value is a row's stable identity, handed to the table.", "fieldName": "rowKey" }, { "name": "group-by", "type": { "text": "string" }, "default": "\"\"", "description": "Column key rows start grouped by, and what the default view restores to.\nThe user can change it from the setup panel or a column's own menu.", "fieldName": "groupBy" }, { "name": "empty-heading", "type": { "text": "string" }, "default": "\"No data\"", "fieldName": "emptyHeading" }, { "name": "empty-text", "type": { "text": "string" }, "default": "\"\"", "fieldName": "emptyText" }, { "name": "search-placeholder", "type": { "text": "string" }, "default": "\"Search all data\"", "fieldName": "searchPlaceholder" }, { "name": "toolbar", "type": { "text": "boolean" }, "default": "true", "description": "Drop the whole toolbar. Each cluster below can also be dropped on its own —\nthe toolbar belongs to the grid, so what it carries is per instance.", "fieldName": "toolbar" }, { "name": "no-search", "type": { "text": "boolean" }, "default": "false", "fieldName": "noSearch" }, { "name": "no-views", "type": { "text": "boolean" }, "default": "false", "fieldName": "noViews" }, { "name": "no-grouping", "type": { "text": "boolean" }, "default": "false", "fieldName": "noGrouping" }, { "name": "no-columns", "type": { "text": "boolean" }, "default": "false", "fieldName": "noColumns" }, { "name": "no-density", "type": { "text": "boolean" }, "default": "false", "fieldName": "noDensity" }, { "name": "no-full-page", "type": { "text": "boolean" }, "default": "false", "fieldName": "noFullPage" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-data-grid", "customElement": true } ], "exports": [ { "kind": "js", "name": "TableRow", "declaration": { "name": "TableRow", "module": "lit/components/data-grid/index.ts" } }, { "kind": "js", "name": "XmDataGrid", "declaration": { "name": "XmDataGrid", "module": "lit/components/data-grid/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-data-grid", "declaration": { "name": "XmDataGrid", "module": "lit/components/data-grid/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/data-table/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmDataTable", "members": [ { "kind": "field", "name": "columns", "type": { "text": "DataTableColumn[]" }, "default": "[]" }, { "kind": "field", "name": "rows", "type": { "text": "TableRow[]" }, "default": "[]" }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true }, { "kind": "field", "name": "pageSize", "default": "10", "attribute": "page-size", "type": { "text": "number" } }, { "kind": "field", "name": "emptyHeading", "type": { "text": "string" }, "default": "\"No data\"", "attribute": "empty-heading" }, { "kind": "field", "name": "emptyText", "type": { "text": "string" }, "default": "\"\"", "attribute": "empty-text" }, { "kind": "field", "name": "server", "type": { "text": "boolean" }, "default": "false", "description": "Server/controlled mode (AD-14): the consumer owns sort + paging. The table\nrenders `rows` verbatim, never sorts/slices a copy, derives the page count\nfrom `total-items` (not `rows.length`), and emits intents only.", "attribute": "server", "reflects": true }, { "kind": "field", "name": "totalItems", "type": { "text": "number" }, "default": "0", "description": "Total item count for server-mode paging (pages = ceil(total-items/page-size)).", "attribute": "total-items" }, { "kind": "field", "name": "sort", "type": { "text": "DataTableSortChangeDetail | null" }, "default": "null", "description": "Controlled sort indicator for server mode (`{ key, direction }`); reflected,\nnever reordered locally." }, { "kind": "field", "name": "rowClick", "type": { "text": "boolean" }, "default": "false", "description": "Make rows clickable — emits xm-data-table-row-click (AD-15).", "attribute": "row-click" }, { "kind": "field", "name": "stickyHeader", "type": { "text": "boolean" }, "default": "false", "description": "Pin the header rows while the table body scrolls inside the frame. Pair\nwith `max-height` (or a host height) so the frame actually scrolls.", "attribute": "sticky-header", "reflects": true }, { "kind": "field", "name": "maxHeight", "type": { "text": "string" }, "default": "\"\"", "description": "Scroll-viewport cap for `sticky-header` — any CSS length (\"360px\", \"50vh\").", "attribute": "max-height" }, { "kind": "field", "name": "fill", "type": { "text": "boolean" }, "default": "false", "description": "Stretch the frame to fill the host's full height instead of collapsing to\ncontent height. Pair with `sticky-header` and a definite-height host so the\ntable reaches the bottom edge and the scrollbar pins there even when the\nrows don't fill the viewport.", "attribute": "fill", "reflects": true }, { "kind": "field", "name": "flush", "type": { "text": "boolean" }, "default": "false", "description": "Drop the frame's hairline border + corner radius for edge-to-edge\nembedding (the frame becomes flush with its container).", "attribute": "flush", "reflects": true }, { "kind": "field", "name": "expandable", "type": { "text": "boolean" }, "default": "false", "description": "Enable per-row expansion (ADR 0019): adds a leading expander column whose\nchevron button toggles an in-place detail row under its data row.", "attribute": "expandable", "reflects": true }, { "kind": "field", "name": "expandMode", "type": { "text": "DataTableExpandMode" }, "default": "\"single\"", "description": "`single` (default) keeps at most one row open; `multiple` allows any number.", "attribute": "expand-mode" }, { "kind": "field", "name": "rowKey", "type": { "text": "string" }, "default": "\"\"", "description": "Column key whose value is a row's stable expansion identity. Without it,\nidentity falls back to the row's position, which drifts across sort order\nand server-mode page swaps — set it whenever rows have an id.", "attribute": "row-key" }, { "kind": "field", "name": "renderDetail", "type": { "text": "| ((row: TableRow, index: number) => unknown)\n | null" }, "default": "null", "description": "Lazy per-row detail content — called only while the row is open, with the\nrow and its index in the rendered page. May return a Lit template, a DOM\nnode, or a string (rendered as text)." }, { "kind": "field", "name": "expandedKeys", "type": { "text": "string[] | null" }, "default": "null", "description": "Controlled expansion (AD-14): when non-null the consumer owns the open\nset — toggles emit intents only. `null` (default) is uncontrolled." }, { "kind": "field", "name": "density", "type": { "text": "DataTableDensity" }, "default": "\"comfortable\"", "description": "Row rhythm. `compact` tightens the vertical cell padding one step so a\nlong list fits on one screen; the type scale and hairlines are unchanged.", "attribute": "density", "reflects": true }, { "kind": "field", "name": "groupBy", "type": { "text": "string" }, "default": "\"\"", "description": "Column key whose value groups consecutive rows under a foldable header\nrow (ADR 0030). Grouping runs over the rendered page, after sort.", "attribute": "group-by" }, { "kind": "field", "name": "groupSummary", "type": { "text": "| ((rows: TableRow[], key: string) => DataTableGroupSummary)\n | null" }, "default": "null", "description": "Aggregate line for a group's header row, called with that group's rows." }, { "kind": "field", "name": "renderGroupRow", "type": { "text": "| ((group: DataTableGroup) => unknown)\n | null" }, "default": "null", "description": "Escape hatch owning the group header's body (mirrors `renderCell`). When\nset it supersedes the summary chrome; the fold control stays table-owned." }, { "kind": "field", "name": "collapsedGroups", "type": { "text": "string[] | null" }, "default": "null", "description": "Controlled folding (AD-14): when non-null the consumer owns the collapsed\nset — toggles emit intents only. `null` (default) is uncontrolled." }, { "kind": "field", "name": "rowHeader", "type": { "text": "| ((row: TableRow, index: number) => DataTableRowHeader | null)\n | null" }, "default": "null", "description": "Marks a row as a group header that keeps its own cells (ADR 0041). Use it\nwhen the header of a group is itself a record — `group-by` cannot express\nthat, because it renders per-column aggregates over the children. The row\ntakes the group row's surface; returning `open` also puts the table's fold\nchip in the first laid-out cell, and folding stays the consumer's state:\nthe chip emits an intent, never a local change." }, { "kind": "field", "name": "rowActions", "type": { "text": "| ((row: TableRow, index: number) => unknown)\n | null" }, "default": "null", "description": "Trailing per-row action rail — a copy button, a download, a row menu.\nRevealed on row hover and on `:focus-within`, so it stays keyboard-reachable\nin source order. Row-click never fires from it (AD-15)." }, { "kind": "field", "name": "actionsAlways", "type": { "text": "boolean" }, "default": "false", "description": "Keep the action rail visible at rest instead of revealing it on hover.", "attribute": "actions-always" }, { "kind": "field", "name": "columnLayout", "type": { "text": "boolean" }, "default": "false", "description": "Fixed-width column layout (ADR 0034): each column renders at a declared\npixel width via `` + `table-layout: fixed`. This is what makes\nsticky offsets computable, so it also gates pinning and resizing. Off by\ndefault — without it the table auto-sizes exactly as before.", "attribute": "column-layout", "reflects": true }, { "kind": "field", "name": "resizableColumns", "type": { "text": "boolean" }, "default": "false", "description": "Drag a header's trailing edge to resize; double-click resets to the\ncolumn's declared `width`. Requires `column-layout`.", "attribute": "resizable-columns" }, { "kind": "field", "name": "fitColumns", "type": { "text": "boolean" }, "default": "false", "description": "Grow the columns to fill the scroll frame whenever the declared widths add\nup to less than the space available. Surplus is shared across the unpinned\ncolumns in proportion to their declared width; an overflowing table is\nuntouched and still scrolls. Requires `column-layout`.", "attribute": "fit-columns", "reflects": true }, { "kind": "field", "name": "totals", "type": { "text": "boolean" }, "default": "false", "description": "Render the aggregate `` row built from each column's `total`. Under\n`sticky-header` it pins to the bottom of the scroll frame.", "attribute": "totals", "reflects": true }, { "kind": "field", "name": "totalsLabel", "type": { "text": "string" }, "default": "\"\"", "description": "Copy for the totals row's first cell (e.g. \"18 tools\").", "attribute": "totals-label" }, { "kind": "field", "name": "overlayScroll", "type": { "text": "boolean" }, "default": "false", "description": "Replace the frame's native scrollbars with overlay rails, so nothing\nreserves a band inside the frame. Wheel and trackpad are untouched.", "attribute": "overlay-scroll", "reflects": true }, { "kind": "field", "name": "columnWidths", "type": { "text": "Record | null" }, "default": "null", "description": "Controlled column widths (AD-14). `null` (default) is uncontrolled." }, { "kind": "field", "name": "pinnedColumns", "type": { "text": "string[] | null" }, "default": "null", "description": "Controlled pinned set (AD-14). `null` (default) is uncontrolled." }, { "kind": "field", "name": "hiddenColumns", "type": { "text": "string[] | null" }, "default": "null", "description": "Controlled hidden set (AD-14). `null` (default) is uncontrolled." }, { "kind": "field", "name": "wrappedColumns", "type": { "text": "string[] | null" }, "default": "null", "description": "Controlled wrapped set (AD-14). `null` (default) is uncontrolled." }, { "kind": "field", "name": "renderHeaderAction", "type": { "text": "| ((column: DataTableColumn, index: number) => unknown)\n | null" }, "default": "null", "description": "Trailing control inside a header cell — the column's own options menu.\nMirrors `renderCell` / `rowActions`: the consumer owns the button and\nwhatever it opens; sorting and resizing stay table-owned." }, { "kind": "field", "name": "_sortKey", "type": { "text": "string | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_sortDirection", "type": { "text": "SortDirection" }, "privacy": "private", "default": "\"asc\"" }, { "kind": "field", "name": "_currentPage", "type": { "text": "number" }, "privacy": "private", "default": "1" }, { "kind": "field", "name": "_openKeys", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "_collapsedKeys", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "_widths", "type": { "text": "Record" }, "privacy": "private", "default": "{}" }, { "kind": "field", "name": "_pinned", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "_hidden", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "_wrapped", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "_frameWidth", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_railX", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_railXFrac", "type": { "text": "number" }, "privacy": "private", "default": "1" }, { "kind": "field", "name": "_railY", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_railYFrac", "type": { "text": "number" }, "privacy": "private", "default": "1" }, { "kind": "field", "name": "_fitted", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_columnDefaultsFrom", "type": { "text": "DataTableColumn[] | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_frameObserver", "type": { "text": "ResizeObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_engine", "type": { "text": "RowEngine | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_engineColumns", "type": { "text": "DataTableColumn[] | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_engineColumnDefs", "type": { "text": "ColumnDef[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_coreRowModel", "privacy": "private", "readonly": true }, { "kind": "field", "name": "_sortedRowModel", "privacy": "private", "readonly": true }, { "kind": "field", "name": "_paginationRowModel", "privacy": "private", "readonly": true }, { "kind": "method", "name": "_seedColumnState", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_syncEngine", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_rowModel", "privacy": "private", "return": { "type": { "text": "RowModel | null" } } }, { "kind": "method", "name": "_layout", "privacy": "private", "return": { "type": { "text": "ColumnLayout[]" } } }, { "kind": "method", "name": "_fitEnabled", "privacy": "private", "return": { "type": { "text": "boolean" } } }, { "kind": "method", "name": "_fitToFrame", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "ordered", "type": { "text": "{ col: DataTableColumn; pinned: boolean; width: number }[]" } } ] }, { "kind": "method", "name": "_canResize", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } } ] }, { "kind": "method", "name": "_cellStyle", "privacy": "private", "return": { "type": { "text": "string | typeof nothing" } }, "parameters": [ { "name": "entry", "type": { "text": "ColumnLayout" } } ] }, { "kind": "method", "name": "_headerCellStyle", "privacy": "private", "return": { "type": { "text": "string | typeof nothing" } }, "parameters": [ { "name": "entry", "type": { "text": "ColumnLayout" } } ] }, { "kind": "method", "name": "_cellClasses", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "entry", "type": { "text": "ColumnLayout" } }, { "name": "base", "type": { "text": "string[]" } } ] }, { "kind": "method", "name": "_onFrameResize", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_renderTable", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_tableStyle", "privacy": "private", "return": { "type": { "text": "string | typeof nothing" } }, "parameters": [ { "name": "layout", "type": { "text": "ColumnLayout[]" } } ] }, { "kind": "method", "name": "_renderSizingRow", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "layout", "type": { "text": "ColumnLayout[]" } } ] }, { "kind": "method", "name": "_renderColGroup", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "layout", "type": { "text": "ColumnLayout[]" } } ] }, { "kind": "method", "name": "_groupRuns", "privacy": "private", "return": { "type": { "text": "GroupRun[] | null" } } }, { "kind": "method", "name": "_groupStartIndexes", "privacy": "private", "return": { "type": { "text": "Set" } } }, { "kind": "method", "name": "_renderGroupRow", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "method", "name": "_renderHeaderCell", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "entry", "type": { "text": "ColumnLayout" } }, { "name": "groupStart", "default": "false" } ] }, { "kind": "method", "name": "_renderHeaderBadges", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "entry", "type": { "text": "ColumnLayout" } } ] }, { "kind": "method", "name": "_renderDataRows", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "layout", "type": { "text": "ColumnLayout[]" } } ] }, { "kind": "method", "name": "_renderDataRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "layout", "type": { "text": "ColumnLayout[]" } } ] }, { "kind": "method", "name": "_renderCell", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "entry", "type": { "text": "ColumnLayout" } }, { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "header", "default": "null", "type": { "text": "DataTableRowHeader | null" } } ] }, { "kind": "method", "name": "_renderRowFold", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "header", "type": { "text": "DataTableRowHeader | null" } } ] }, { "kind": "method", "name": "_renderTotalsRow", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "layout", "type": { "text": "ColumnLayout[]" } } ] }, { "kind": "method", "name": "_aggregateValue", "privacy": "private", "return": { "type": { "text": "number | null" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } }, { "name": "rows", "type": { "text": "TableRow[]" } } ] }, { "kind": "method", "name": "_aggregate", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } }, { "name": "rows", "type": { "text": "TableRow[]" } } ] }, { "kind": "method", "name": "_barShareOfValue", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } }, { "name": "value", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_renderBar", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "share", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_renderActionsCell", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_renderGroupHeaderRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "group", "type": { "text": "DataTableGroup" } } ] }, { "kind": "method", "name": "_renderGroupAggregateRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "group", "type": { "text": "DataTableGroup" } } ] }, { "kind": "method", "name": "_renderExpanderCell", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "key", "type": { "text": "string" } }, { "name": "open", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_renderDetailRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "key", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_renderSkeletonRows", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderEmptyPanel", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_emptyPanelStyle", "privacy": "private", "return": { "type": { "text": "string | typeof nothing" } } }, { "kind": "method", "name": "_renderFooter", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "method", "name": "_renderRails", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "field", "name": "_scroller", "type": { "text": "HTMLElement | null" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_onFrameScroll", "privacy": "private" }, { "kind": "method", "name": "_syncRails", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onRailXDown", "privacy": "private" }, { "kind": "field", "name": "_onRailYDown", "privacy": "private" }, { "kind": "method", "name": "_dragRail", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "PointerEvent" } }, { "name": "axis", "type": { "text": "\"x\" | \"y\"" } } ] }, { "kind": "method", "name": "pinColumn", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "pinned", "type": { "text": "boolean" } } ], "description": "Pin a column to the left edge, or release it. A `locked` column ignores this." }, { "kind": "method", "name": "setColumnHidden", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "hidden", "type": { "text": "boolean" } } ], "description": "Take a column out of the view, or put it back. A `locked` column ignores this." }, { "kind": "method", "name": "setColumnWrapped", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "wrapped", "type": { "text": "boolean" } } ], "description": "Wrap a column's copy to three lines, or return it to one line + ellipsis.\nOnly a `wrappable` column responds." }, { "kind": "method", "name": "setColumnWidth", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "width", "type": { "text": "number" } } ], "description": "Set a column's width in px, clamped to its own floor and the shared cap." }, { "kind": "method", "name": "resetColumnWidth", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } } ], "description": "Return a column to its declared `width`." }, { "kind": "method", "name": "setSort", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string | null" } }, { "name": "direction", "default": "\"asc\"", "type": { "text": "SortDirection" } } ], "description": "Set (or clear, with `null`) the sort from outside the header row — a column\noptions menu, or restoring a saved layout. Applies locally in client mode\nand emits either way, exactly like a header click; `sort` stays the\nserver-mode controlled property and is untouched here. A cleared sort\nemits with an empty `key`." }, { "kind": "method", "name": "_emit", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "type", "type": { "text": "string" } }, { "name": "detail", "type": { "text": "T" } } ] }, { "kind": "method", "name": "_onResizeStart", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "PointerEvent" } }, { "name": "entry", "type": { "text": "ColumnLayout" } } ] }, { "kind": "method", "name": "_isEmpty", "privacy": "private", "return": { "type": { "text": "boolean" } } }, { "kind": "method", "name": "_rowKeyOf", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_resolveKeyInPage", "privacy": "private", "return": { "type": { "text": "{ row: TableRow; index: number } | null" } }, "parameters": [ { "name": "key", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_colSpan", "privacy": "private", "return": { "type": { "text": "number" } } }, { "kind": "method", "name": "_rowGroups", "privacy": "private", "return": { "type": { "text": "{ group: DataTableGroup; entries: { row: TableRow; index: number }[] }[]" } }, "parameters": [ { "name": "slice", "type": { "text": "TableRow[]" } } ] }, { "kind": "method", "name": "_showBar", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } } ] }, { "kind": "method", "name": "_clampShare", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "share", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_barShare", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } }, { "name": "row", "type": { "text": "TableRow" } } ] }, { "kind": "method", "name": "_barValue", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } }, { "name": "row", "type": { "text": "TableRow" } } ] }, { "kind": "method", "name": "_barScale", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } } ] }, { "kind": "method", "name": "_isNumericCol", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } } ] }, { "kind": "method", "name": "_effectivePageSize", "privacy": "private", "return": { "type": { "text": "number" } } }, { "kind": "method", "name": "_pageCount", "privacy": "private", "return": { "type": { "text": "number" } } }, { "kind": "method", "name": "_pagedRows", "privacy": "private", "return": { "type": { "text": "TableRow[]" } } }, { "kind": "method", "name": "_toggleSort", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "col", "type": { "text": "DataTableColumn" } } ] }, { "kind": "method", "name": "_fromInteractiveDescendant", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "e", "type": { "text": "Event" } } ] }, { "kind": "method", "name": "_onRowClick", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "MouseEvent" } }, { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_onRowKey", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } }, { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_emitRowClick", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_toggleExpand", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "key", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_emitRowToggle", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "key", "type": { "text": "string" } }, { "name": "open", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_onExpanderKey", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } }, { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "key", "type": { "text": "string" } }, { "name": "open", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_onDetailKey", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } }, { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "key", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_collapseRow", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "row", "type": { "text": "TableRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "key", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_focusExpander", "privacy": "private", "return": { "type": { "text": "Promise" } }, "parameters": [ { "name": "index", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_toggleGroup", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "group", "type": { "text": "DataTableGroup" } } ] }, { "kind": "method", "name": "_onHeaderKey", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } }, { "name": "col", "type": { "text": "DataTableColumn" } } ] }, { "kind": "field", "name": "_onPageChange", "privacy": "private" } ], "events": [ { "name": "xm-data-table-page-change", "type": { "text": "CustomEvent" }, "description": "Fired when the page changes (`detail.page`)." }, { "name": "xm-data-table-row-header-toggle", "type": { "text": "CustomEvent" }, "description": "Fired when a `row-header` row's fold chip is pressed (`detail.row`, `detail.index`, `detail.open`)." }, { "name": "type", "type": { "text": "CustomEvent" } }, { "name": "xm-data-table-sort-change", "type": { "text": "CustomEvent" }, "description": "Fired when the sort changes (`detail.key`, `detail.direction`)." }, { "name": "xm-data-table-row-click", "type": { "text": "CustomEvent" }, "description": "Fired when a clickable row is activated (`detail.row`, `detail.index`)." }, { "type": { "text": "CustomEvent" } }, { "name": "xm-data-table-group-toggle", "type": { "text": "CustomEvent" }, "description": "Fired when a `group-by` header row folds or unfolds (`detail.key`, `detail.open`, `detail.rows`)." }, { "description": "Fired when a row's detail region opens (`detail.row`, `detail.index`, `detail.key`, `detail.open`).", "name": "xm-data-table-row-expand" }, { "description": "Fired when a row's detail region closes (`detail.row`, `detail.index`, `detail.key`, `detail.open`).", "name": "xm-data-table-row-collapse" }, { "description": "Fired when a column's width changes (`detail.key`, `detail.width`).", "name": "xm-data-table-column-resize" }, { "description": "Fired when a column is pinned or released (`detail.key`, `detail.pinned`).", "name": "xm-data-table-column-pin" }, { "description": "Fired when a column is hidden or restored (`detail.key`, `detail.visible`).", "name": "xm-data-table-column-visibility" }, { "description": "Fired when a column's text wrapping is toggled (`detail.key`, `detail.wrapped`).", "name": "xm-data-table-column-wrap" } ], "attributes": [ { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading" }, { "name": "page-size", "default": "DEFAULT_PAGE_SIZE", "fieldName": "pageSize" }, { "name": "empty-heading", "type": { "text": "string" }, "default": "\"No data\"", "fieldName": "emptyHeading" }, { "name": "empty-text", "type": { "text": "string" }, "default": "\"\"", "fieldName": "emptyText" }, { "name": "server", "type": { "text": "boolean" }, "default": "false", "description": "Server/controlled mode (AD-14): the consumer owns sort + paging. The table\nrenders `rows` verbatim, never sorts/slices a copy, derives the page count\nfrom `total-items` (not `rows.length`), and emits intents only.", "fieldName": "server" }, { "name": "total-items", "type": { "text": "number" }, "default": "0", "description": "Total item count for server-mode paging (pages = ceil(total-items/page-size)).", "fieldName": "totalItems" }, { "name": "row-click", "type": { "text": "boolean" }, "default": "false", "description": "Make rows clickable — emits xm-data-table-row-click (AD-15).", "fieldName": "rowClick" }, { "name": "sticky-header", "type": { "text": "boolean" }, "default": "false", "description": "Pin the header rows while the table body scrolls inside the frame. Pair\nwith `max-height` (or a host height) so the frame actually scrolls.", "fieldName": "stickyHeader" }, { "name": "max-height", "type": { "text": "string" }, "default": "\"\"", "description": "Scroll-viewport cap for `sticky-header` — any CSS length (\"360px\", \"50vh\").", "fieldName": "maxHeight" }, { "name": "fill", "type": { "text": "boolean" }, "default": "false", "description": "Stretch the frame to fill the host's full height instead of collapsing to\ncontent height. Pair with `sticky-header` and a definite-height host so the\ntable reaches the bottom edge and the scrollbar pins there even when the\nrows don't fill the viewport.", "fieldName": "fill" }, { "name": "flush", "type": { "text": "boolean" }, "default": "false", "description": "Drop the frame's hairline border + corner radius for edge-to-edge\nembedding (the frame becomes flush with its container).", "fieldName": "flush" }, { "name": "expandable", "type": { "text": "boolean" }, "default": "false", "description": "Enable per-row expansion (ADR 0019): adds a leading expander column whose\nchevron button toggles an in-place detail row under its data row.", "fieldName": "expandable" }, { "name": "expand-mode", "type": { "text": "DataTableExpandMode" }, "default": "\"single\"", "description": "`single` (default) keeps at most one row open; `multiple` allows any number.", "fieldName": "expandMode" }, { "name": "row-key", "type": { "text": "string" }, "default": "\"\"", "description": "Column key whose value is a row's stable expansion identity. Without it,\nidentity falls back to the row's position, which drifts across sort order\nand server-mode page swaps — set it whenever rows have an id.", "fieldName": "rowKey" }, { "name": "density", "type": { "text": "DataTableDensity" }, "default": "\"comfortable\"", "description": "Row rhythm. `compact` tightens the vertical cell padding one step so a\nlong list fits on one screen; the type scale and hairlines are unchanged.", "fieldName": "density" }, { "name": "group-by", "type": { "text": "string" }, "default": "\"\"", "description": "Column key whose value groups consecutive rows under a foldable header\nrow (ADR 0030). Grouping runs over the rendered page, after sort.", "fieldName": "groupBy" }, { "name": "actions-always", "type": { "text": "boolean" }, "default": "false", "description": "Keep the action rail visible at rest instead of revealing it on hover.", "fieldName": "actionsAlways" }, { "name": "column-layout", "type": { "text": "boolean" }, "default": "false", "description": "Fixed-width column layout (ADR 0034): each column renders at a declared\npixel width via `` + `table-layout: fixed`. This is what makes\nsticky offsets computable, so it also gates pinning and resizing. Off by\ndefault — without it the table auto-sizes exactly as before.", "fieldName": "columnLayout" }, { "name": "resizable-columns", "type": { "text": "boolean" }, "default": "false", "description": "Drag a header's trailing edge to resize; double-click resets to the\ncolumn's declared `width`. Requires `column-layout`.", "fieldName": "resizableColumns" }, { "name": "fit-columns", "type": { "text": "boolean" }, "default": "false", "description": "Grow the columns to fill the scroll frame whenever the declared widths add\nup to less than the space available. Surplus is shared across the unpinned\ncolumns in proportion to their declared width; an overflowing table is\nuntouched and still scrolls. Requires `column-layout`.", "fieldName": "fitColumns" }, { "name": "totals", "type": { "text": "boolean" }, "default": "false", "description": "Render the aggregate `` row built from each column's `total`. Under\n`sticky-header` it pins to the bottom of the scroll frame.", "fieldName": "totals" }, { "name": "totals-label", "type": { "text": "string" }, "default": "\"\"", "description": "Copy for the totals row's first cell (e.g. \"18 tools\").", "fieldName": "totalsLabel" }, { "name": "overlay-scroll", "type": { "text": "boolean" }, "default": "false", "description": "Replace the frame's native scrollbars with overlay rails, so nothing\nreserves a band inside the frame. Wheel and trackpad are untouched.", "fieldName": "overlayScroll" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-data-table", "customElement": true } ], "exports": [ { "kind": "js", "name": "TableRow", "declaration": { "name": "TableRow", "module": "lit/components/data-table/index.ts" } }, { "kind": "js", "name": "XmDataTable", "declaration": { "name": "XmDataTable", "module": "lit/components/data-table/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-data-table", "declaration": { "name": "XmDataTable", "module": "lit/components/data-table/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/date-range/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmDateRange", "members": [ { "kind": "field", "name": "from", "type": { "text": "string | null" }, "default": "null", "attribute": "from" }, { "kind": "field", "name": "to", "type": { "text": "string | null" }, "default": "null", "attribute": "to" }, { "kind": "field", "name": "placeholder", "type": { "text": "string" }, "default": "\"Date range\"", "attribute": "placeholder" }, { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "_id", "privacy": "private", "default": "`xm-date-range-${++drSeq}`" }, { "kind": "field", "name": "_draftFrom", "type": { "text": "Date | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_draftTo", "type": { "text": "Date | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_view", "type": { "text": "Date" }, "privacy": "private" }, { "kind": "field", "name": "_focusDay", "type": { "text": "Date" }, "privacy": "private" }, { "kind": "field", "name": "_liveMsg", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_activePreset", "type": { "text": "PresetId | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "private" }, { "kind": "field", "name": "_trigger", "type": { "text": "HTMLButtonElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_panel", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_closing", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_onDocPointer", "privacy": "private" }, { "kind": "method", "name": "_initDraft", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_toggle", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_close", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "restoreFocus", "type": { "text": "boolean" } } ] }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" }, { "kind": "method", "name": "_focusRovingDay", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_applyPreset", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "id", "type": { "text": "PresetId" } } ] }, { "kind": "method", "name": "_pickDay", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "day", "type": { "text": "Date" } } ] }, { "kind": "field", "name": "_invalid", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_apply", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_clear", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_emit", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "from", "type": { "text": "Date | null" } }, { "name": "to", "type": { "text": "Date | null" } } ] }, { "kind": "method", "name": "_shiftMonth", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "delta", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_onGridKey", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } } ] }, { "kind": "method", "name": "_panelFocusables", "privacy": "private", "return": { "type": { "text": "HTMLElement[]" } } }, { "kind": "method", "name": "_onPanelKey", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } } ] }, { "kind": "method", "name": "_daysInMonth", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "view", "type": { "text": "Date" } } ] }, { "kind": "method", "name": "_renderTriggerValue", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderPanel", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "labelId", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_renderRail", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderCalendar", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderWeeks", "privacy": "private", "return": { "type": { "text": "TemplateResult[]" } } }, { "kind": "method", "name": "_renderDay", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "day", "type": { "text": "Date" } }, { "name": "viewMonth", "type": { "text": "number" } }, { "name": "today", "type": { "text": "Date" } } ] }, { "kind": "method", "name": "_renderFooter", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "labelId", "type": { "text": "string" } } ] } ], "events": [ { "name": "xm-date-range-change", "type": { "text": "CustomEvent" }, "description": "Fired when the selected date range changes." } ], "attributes": [ { "name": "from", "type": { "text": "string | null" }, "default": "null", "fieldName": "from" }, { "name": "to", "type": { "text": "string | null" }, "default": "null", "fieldName": "to" }, { "name": "placeholder", "type": { "text": "string" }, "default": "\"Date range\"", "fieldName": "placeholder" }, { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-date-range", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmDateRange", "declaration": { "name": "XmDateRange", "module": "lit/components/date-range/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-date-range", "declaration": { "name": "XmDateRange", "module": "lit/components/date-range/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/dialog/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmDialog", "members": [ { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "noScrimClose", "type": { "text": "boolean" }, "default": "false", "attribute": "no-scrim-close" }, { "kind": "field", "name": "static", "type": { "text": "boolean" }, "default": "false", "attribute": "static" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "_hasHeader", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_hasAction", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "private" }, { "kind": "field", "name": "_headerId", "privacy": "private", "readonly": true, "default": "`xm-dialog-${++dialogSeq}-header`" }, { "kind": "field", "name": "_wasOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" }, { "kind": "field", "name": "_onCloseButton", "privacy": "private" }, { "kind": "field", "name": "_onHeaderSlot", "privacy": "private" }, { "kind": "field", "name": "_onActionSlot", "privacy": "private" } ], "events": [ { "description": "Fired when the element requests to close.", "name": "close" } ], "attributes": [ { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "no-scrim-close", "type": { "text": "boolean" }, "default": "false", "fieldName": "noScrimClose" }, { "name": "static", "type": { "text": "boolean" }, "default": "false", "fieldName": "static" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-dialog", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmDialog", "declaration": { "name": "XmDialog", "module": "lit/components/dialog/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-dialog", "declaration": { "name": "XmDialog", "module": "lit/components/dialog/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/divider/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmDivider", "members": [ { "kind": "field", "name": "orientation", "type": { "text": "DividerOrientation" }, "default": "\"horizontal\"", "attribute": "orientation", "reflects": true } ], "attributes": [ { "name": "orientation", "type": { "text": "DividerOrientation" }, "default": "\"horizontal\"", "fieldName": "orientation" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-divider", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmDivider", "declaration": { "name": "XmDivider", "module": "lit/components/divider/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-divider", "declaration": { "name": "XmDivider", "module": "lit/components/divider/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/empty-state/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmEmptyState", "members": [ { "kind": "field", "name": "heading", "type": { "text": "string" }, "default": "\"\"", "attribute": "heading" }, { "kind": "field", "name": "icon", "type": { "text": "string" }, "default": "\"\"", "description": "A primitives icon element name (e.g. \"xm-search-icon\"). Used only when no\nslot=\"icon\" content is supplied.", "attribute": "icon" }, { "kind": "field", "name": "_hasIconSlot", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_hasText", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_hasAction", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "method", "name": "_iconEl", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "field", "name": "_onIconSlot", "privacy": "private" }, { "kind": "field", "name": "_onDefaultSlot", "privacy": "private" }, { "kind": "field", "name": "_onActionSlot", "privacy": "private" } ], "attributes": [ { "name": "heading", "type": { "text": "string" }, "default": "\"\"", "fieldName": "heading" }, { "name": "icon", "type": { "text": "string" }, "default": "\"\"", "description": "A primitives icon element name (e.g. \"xm-search-icon\"). Used only when no\nslot=\"icon\" content is supplied.", "fieldName": "icon" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-empty-state", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmEmptyState", "declaration": { "name": "XmEmptyState", "module": "lit/components/empty-state/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-empty-state", "declaration": { "name": "XmEmptyState", "module": "lit/components/empty-state/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/expansion-panel/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmExpansionPanel", "members": [ { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "heading", "type": { "text": "string" }, "default": "\"\"", "attribute": "heading" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true }, { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "attribute": "value" }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "attribute": "name" }, { "kind": "field", "name": "_uid", "privacy": "private", "default": "`expansion-panel-${++panelInstance}`" }, { "kind": "field", "name": "_onSiblingOpen", "privacy": "private" }, { "kind": "method", "name": "_toggle", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onHeaderClick", "privacy": "private" } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail`." }, { "description": "Coordination event (on document) so sibling panels close in single-open mode.", "name": "xm-expansion-panel-open" } ], "attributes": [ { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "heading", "type": { "text": "string" }, "default": "\"\"", "fieldName": "heading" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "fieldName": "value" }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "fieldName": "name" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-expansion-panel", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmExpansionPanel", "declaration": { "name": "XmExpansionPanel", "module": "lit/components/expansion-panel/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-expansion-panel", "declaration": { "name": "XmExpansionPanel", "module": "lit/components/expansion-panel/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/field/index.ts", "declarations": [ { "kind": "class", "description": "Abstract chrome + lifecycle base for every xmesh form field.\n\nSubclasses register with `@customElement(\"xm-\")`; XmField itself is\nnever registered (it is not a usable element on its own).", "name": "XmField", "members": [ { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true" }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper" }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error" }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "attribute": "name", "reflects": true }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "attribute": "value" }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked" }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field." }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`." }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`." }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a)." }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq" }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`" }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`" }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false" }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state." }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a)." }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field." }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail." }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change." }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a)." }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7)." } ], "events": [ { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field)." }, { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail` (inherited by every field)." } ], "attributes": [ { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper" }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error" }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly" }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading" }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "fieldName": "name" }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "fieldName": "initialValue" }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked" } ], "superclass": { "name": "LitElement", "package": "lit" }, "customElement": true } ], "exports": [ { "kind": "js", "name": "XmField", "declaration": { "name": "XmField", "module": "lit/components/field/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/file-input/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmFileInput", "members": [ { "kind": "field", "name": "accept", "type": { "text": "string" }, "default": "\"\"", "description": "Native accept filter (e.g. \".yml,.json,image/*\").", "attribute": "accept" }, { "kind": "field", "name": "multiple", "type": { "text": "boolean" }, "default": "false", "description": "Allow selecting more than one file.", "attribute": "multiple" }, { "kind": "field", "name": "_files", "type": { "text": "File[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "_dragActive", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_native", "type": { "text": "HTMLInputElement | null" }, "privacy": "private" }, { "kind": "field", "name": "files", "type": { "text": "File[]" }, "description": "Public read contract (AD-6a) — the selected files.", "readonly": true }, { "kind": "method", "name": "_setFiles", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "files", "type": { "text": "File[]" } } ] }, { "kind": "method", "name": "_openPicker", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onNativeChange", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "field", "name": "_onDragOver", "privacy": "private" }, { "kind": "field", "name": "_onDragLeave", "privacy": "private" }, { "kind": "method", "name": "_accepts", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "file", "type": { "text": "File" } } ], "description": "Does a dropped file satisfy the `accept` list? Mirrors the native picker so\ndrag-drop and click-to-pick enforce the same filter." }, { "kind": "field", "name": "_onDrop", "privacy": "private" }, { "kind": "method", "name": "_removeFile", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "index", "type": { "text": "number" } } ] }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "accept", "type": { "text": "string" }, "default": "\"\"", "description": "Native accept filter (e.g. \".yml,.json,image/*\").", "fieldName": "accept" }, { "name": "multiple", "type": { "text": "boolean" }, "default": "false", "description": "Allow selecting more than one file.", "fieldName": "multiple" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native .", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write ``.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-file-input", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmFileInput", "declaration": { "name": "XmFileInput", "module": "lit/components/file-input/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-file-input", "declaration": { "name": "XmFileInput", "module": "lit/components/file-input/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/form/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmForm", "members": [ { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true }, { "kind": "field", "name": "_ownReadonly", "privacy": "private", "readonly": true, "default": "new WeakMap()", "description": "Each touched child's OWN readonly, snapshotted before the form ever sets it,\nso OR-propagation never clears a child's intrinsic readonly." }, { "kind": "field", "name": "_fields", "type": { "text": "FieldLike[]" }, "privacy": "private", "description": "The slotted, form-associated children — discovered via the light DOM, never\nby querying any child's shadow root (AD-12).", "readonly": true }, { "kind": "method", "name": "_readValue", "privacy": "private", "return": { "type": { "text": "unknown" } }, "parameters": [ { "name": "field", "type": { "text": "FieldLike" } } ], "description": "Read one child's current value by its kind (toggle / file / value field)." }, { "kind": "method", "name": "_isToggle", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "field", "type": { "text": "FieldLike" } } ] }, { "kind": "method", "name": "_isInvalid", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "field", "type": { "text": "FieldLike" } } ], "description": "A child is invalid if it carries error copy OR is required-but-empty." }, { "kind": "method", "name": "validate", "return": { "type": { "text": "FormResult" } }, "description": "Public read contract: pull each child's live value at read time (children\nare uncontrolled — the form does not drive their renders, AD-6)." }, { "kind": "method", "name": "submit", "return": { "type": { "text": "FormResult" } }, "description": "Imperative submit — same path the submit button / Enter take." }, { "kind": "field", "name": "_onChildSubmit", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "method", "name": "_propagate", "privacy": "private", "return": { "type": { "text": "void" } } } ], "events": [ { "name": "submit", "type": { "text": "CustomEvent" }, "description": "Fired when the form is submitted with its values in `detail`." } ], "attributes": [ { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-form", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmForm", "declaration": { "name": "XmForm", "module": "lit/components/form/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-form", "declaration": { "name": "XmForm", "module": "lit/components/form/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/grid/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmGrid", "members": [ { "kind": "field", "name": "columns", "type": { "text": "number" }, "default": "12", "attribute": "columns", "reflects": true }, { "kind": "field", "name": "gap", "type": { "text": "GridGap" }, "default": "\"md\"", "attribute": "gap", "reflects": true } ], "attributes": [ { "name": "columns", "type": { "text": "number" }, "default": "12", "fieldName": "columns" }, { "name": "gap", "type": { "text": "GridGap" }, "default": "\"md\"", "fieldName": "gap" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-grid", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmGrid", "declaration": { "name": "XmGrid", "module": "lit/components/grid/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-grid", "declaration": { "name": "XmGrid", "module": "lit/components/grid/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/icon/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmIcon", "members": [ { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Material Symbol name to render, e.g. \"close\" or \"search\".", "attribute": "name" }, { "kind": "field", "name": "size", "type": { "text": "number" }, "default": "16", "description": "Rendered edge length in px (square).", "attribute": "size" }, { "kind": "field", "name": "title", "type": { "text": "string" }, "default": "\"\"", "description": "Accessible label — sets role=\"img\" + ; omit for decorative icons.", "attribute": "title" } ], "attributes": [ { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Material Symbol name to render, e.g. \"close\" or \"search\".", "fieldName": "name" }, { "name": "size", "type": { "text": "number" }, "default": "16", "description": "Rendered edge length in px (square).", "fieldName": "size" }, { "name": "title", "type": { "text": "string" }, "default": "\"\"", "description": "Accessible label — sets role=\"img\" + <title>; omit for decorative icons.", "fieldName": "title" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-icon", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmIcon", "declaration": { "name": "XmIcon", "module": "lit/components/icon/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-icon", "declaration": { "name": "XmIcon", "module": "lit/components/icon/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/kbd/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmKbd", "members": [], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-kbd", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmKbd", "declaration": { "name": "XmKbd", "module": "lit/components/kbd/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-kbd", "declaration": { "name": "XmKbd", "module": "lit/components/kbd/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/list/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmList", "members": [ { "kind": "field", "name": "interactive", "type": { "text": "boolean" }, "default": "false", "attribute": "interactive" }, { "kind": "field", "name": "selectable", "type": { "text": "boolean" }, "default": "false", "attribute": "selectable" }, { "kind": "field", "name": "value", "type": { "text": "Primitive | null" }, "default": "null" }, { "kind": "field", "name": "_isInteractive", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_items", "privacy": "private", "return": { "type": { "text": "ListItemEl[]" } } }, { "kind": "method", "name": "_enabledItems", "privacy": "private", "return": { "type": { "text": "ListItemEl[]" } } }, { "kind": "method", "name": "_applyItems", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_updateRovingTabindex", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "focused", "optional": true, "type": { "text": "ListItemEl" } } ] }, { "kind": "method", "name": "_select", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "item", "type": { "text": "ListItemEl" } } ] }, { "kind": "method", "name": "_itemFromEvent", "privacy": "private", "return": { "type": { "text": "ListItemEl | null" } }, "parameters": [ { "name": "target", "type": { "text": "EventTarget | null" } } ] }, { "kind": "field", "name": "_onClick", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "field", "name": "_onSlot", "privacy": "private" } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail`." } ], "attributes": [ { "name": "interactive", "type": { "text": "boolean" }, "default": "false", "fieldName": "interactive" }, { "name": "selectable", "type": { "text": "boolean" }, "default": "false", "fieldName": "selectable" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-list", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmList", "declaration": { "name": "XmList", "module": "lit/components/list/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-list", "declaration": { "name": "XmList", "module": "lit/components/list/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/list-item/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmListItem", "members": [ { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "attribute": "value" }, { "kind": "field", "name": "selected", "type": { "text": "boolean" }, "default": "false", "attribute": "selected", "reflects": true }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true }, { "kind": "field", "name": "secondary", "type": { "text": "string" }, "default": "\"\"", "attribute": "secondary" }, { "kind": "field", "name": "_mo", "type": { "text": "MutationObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_hasSlot", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "name", "type": { "text": "string" } } ] }, { "kind": "field", "name": "_onSlot", "privacy": "private" } ], "attributes": [ { "name": "value", "type": { "text": "string" }, "default": "\"\"", "fieldName": "value" }, { "name": "selected", "type": { "text": "boolean" }, "default": "false", "fieldName": "selected" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "secondary", "type": { "text": "string" }, "default": "\"\"", "fieldName": "secondary" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-list-item", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmListItem", "declaration": { "name": "XmListItem", "module": "lit/components/list-item/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-list-item", "declaration": { "name": "XmListItem", "module": "lit/components/list-item/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/menu/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmMenu", "members": [ { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"bottom-start\"", "attribute": "placement" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "_activeIndex", "type": { "text": "number" }, "privacy": "private", "default": "-1" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "private" }, { "kind": "field", "name": "_triggerWrap", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_list", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_listId", "privacy": "private", "readonly": true, "default": "`xm-menu-${++menuSeq}`" }, { "kind": "field", "name": "_items", "type": { "text": "XmMenuItem[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_enabledIndexes", "type": { "text": "number[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_onTriggerClick", "privacy": "private" }, { "kind": "field", "name": "_onTriggerKeydown", "privacy": "private" }, { "kind": "method", "name": "_openMenu", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "landOn", "optional": true, "type": { "text": "number" } } ] }, { "kind": "method", "name": "_close", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "reason", "type": { "text": "string" } } ] }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" }, { "kind": "field", "name": "_onListKeydown", "privacy": "private" }, { "kind": "method", "name": "_nextEnabled", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "from", "type": { "text": "number" } }, { "name": "dir", "type": { "text": "1 | -1" } } ] }, { "kind": "field", "name": "_onItemsSlot", "privacy": "private" }, { "kind": "field", "name": "_onItemActivate", "privacy": "private" }, { "kind": "field", "name": "_onItemHover", "privacy": "private" }, { "kind": "method", "name": "_activateIndex", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "index", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_syncItems", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_triggerEl", "type": { "text": "HTMLElement | null" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_wireTriggerAria", "privacy": "private" } ], "events": [ { "name": "close", "type": { "text": "CustomEvent" }, "description": "Fired when the element requests to close." }, { "name": "xm-menu-select", "type": { "text": "CustomEvent" }, "description": "Fired when a menu option is selected." }, { "description": "Fired when a menu item is activated.", "name": "xm-menu-item-activate" }, { "description": "Fired when a menu item is hovered.", "name": "xm-menu-item-hover" } ], "attributes": [ { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"bottom-start\"", "fieldName": "placement" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-menu", "customElement": true }, { "kind": "class", "description": "", "name": "XmMenuItem", "members": [ { "kind": "field", "name": "value", "type": { "text": "string | number" }, "default": "\"\"", "attribute": "value" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true }, { "kind": "field", "name": "active", "type": { "text": "boolean" }, "default": "false", "attribute": "active", "reflects": true }, { "kind": "field", "name": "_hasIcon", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_onIconSlot", "privacy": "private" }, { "kind": "field", "name": "_onClick", "privacy": "private" }, { "kind": "field", "name": "_onMouseMove", "privacy": "private" } ], "attributes": [ { "name": "value", "type": { "text": "string | number" }, "default": "\"\"", "fieldName": "value" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "active", "type": { "text": "boolean" }, "default": "false", "fieldName": "active" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-menu-item", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmMenu", "declaration": { "name": "XmMenu", "module": "lit/components/menu/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-menu", "declaration": { "name": "XmMenu", "module": "lit/components/menu/index.ts" } }, { "kind": "js", "name": "XmMenuItem", "declaration": { "name": "XmMenuItem", "module": "lit/components/menu/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-menu-item", "declaration": { "name": "XmMenuItem", "module": "lit/components/menu/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/multi-select/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmMultiSelect", "members": [ { "kind": "field", "name": "options", "type": { "text": "MultiSelectOption[]" }, "default": "[]", "description": "The option model — `{ label, value, disabled? }` shared with xm-select / radio-group." }, { "kind": "field", "name": "placeholder", "type": { "text": "string" }, "default": "\"Select…\"", "description": "Shown on the trigger when nothing is selected.", "attribute": "placeholder" }, { "kind": "field", "name": "max", "type": { "text": "number" }, "default": "0", "description": "Selection cap (0 = uncapped). At the cap, unselected options disable; selected stay removable.", "attribute": "max" }, { "kind": "field", "name": "searchable", "type": { "text": "boolean" }, "default": "true", "description": "Render the in-panel search filter.", "attribute": "searchable" }, { "kind": "field", "name": "inline", "type": { "text": "boolean" }, "default": "false", "description": "Dock the panel in place of the combobox trigger — an always-open filter\nrail (ADR 0031). Search, bulk actions, recents, sections, virtualization\nand the selection contract are unchanged; only the trigger and the\noverlay drop away, and the listbox becomes the focus target.", "attribute": "inline", "reflects": true }, { "kind": "field", "name": "recent", "type": { "text": "(string | number)[]" }, "default": "[]", "description": "Option values pinned under a \"Recent\" header above the full list; suppressed while a search query is active." }, { "kind": "field", "name": "bulkActions", "type": { "text": "boolean" }, "default": "false", "description": "Render the \"Select all\" / \"Clear\" bulk-action row. \"Select all\" operates on the search-filtered set and respects `max`.", "attribute": "bulk-actions" }, { "kind": "field", "name": "server", "type": { "text": "boolean" }, "default": "false", "description": "Server mode (ADR 0023): the backend owns filtering — client-side label matching is off, the search emits `xm-multi-select-search`, and scrolling near the end emits `xm-multi-select-load-more`.", "attribute": "server", "reflects": true }, { "kind": "field", "name": "optionsLoading", "type": { "text": "boolean" }, "default": "false", "description": "Signal a consumer fetch in flight (server-mode search, or any options refresh): rows already present dim to ghost ink, skeleton rows fade in under them, and \"No matches\" is suppressed. Distinct from the inherited field-level `loading`, which disables the whole control.", "attribute": "options-loading", "reflects": true }, { "kind": "field", "name": "searchDebounce", "type": { "text": "number" }, "default": "250", "description": "Debounce for `xm-multi-select-search` in milliseconds.", "attribute": "search-debounce" }, { "kind": "field", "name": "totalItems", "type": { "text": "number" }, "default": "0", "description": "Server mode: total backend match count for the current query. Drives the \"Showing N of M matches\" note and load-more paging (0 = unknown/complete).", "attribute": "total-items" }, { "kind": "field", "name": "renderOption", "type": { "text": "| ((option: MultiSelectOption, ctx: MultiSelectOptionContext) => unknown)\n | undefined | undefined" }, "description": "Escape hatch for custom option-row content (mirrors data-table's `renderCell`, ADR 0008/0024):\ngiven the option and its render state, returns the row body after the presentational\ncheckbox. The `li`, checkbox, a11y wiring, and toggle stay component-owned. With a\nvirtualized list (>200 rows) the returned content must keep a uniform single-row height." }, { "kind": "field", "name": "_open", "type": { "text": "boolean" }, "privacy": "protected", "default": "false" }, { "kind": "field", "name": "_activeIndex", "type": { "text": "number" }, "privacy": "protected", "default": "-1" }, { "kind": "field", "name": "_selected", "privacy": "protected", "default": "new Set<string | number>()" }, { "kind": "field", "name": "_query", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"" }, { "kind": "field", "name": "_capNote", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"" }, { "kind": "field", "name": "_scrollTop", "type": { "text": "number" }, "privacy": "protected", "default": "0" }, { "kind": "field", "name": "_viewH", "type": { "text": "number" }, "privacy": "protected", "default": "280" }, { "kind": "field", "name": "_stride", "privacy": "protected", "default": "30", "type": { "text": "number" } }, { "kind": "field", "name": "_chipFit", "privacy": "protected" }, { "kind": "field", "name": "_control", "type": { "text": "HTMLElement | null" }, "privacy": "protected" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "protected" }, { "kind": "field", "name": "_search", "type": { "text": "HTMLElement | null" }, "privacy": "protected" }, { "kind": "field", "name": "_typeahead", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_typeaheadTimer", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_searchTimer", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_loadMoreKey", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_labelByValue", "privacy": "private", "default": "new Map<string | number, string>()" }, { "kind": "field", "name": "_chipResizeObserver", "type": { "text": "ResizeObserver | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_chipMeasureTarget", "type": { "text": "Element | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_rowsCache", "type": { "text": "OptionRow[] | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_rowsCacheOptions", "type": { "text": "MultiSelectOption[] | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_rowsCacheRecent", "type": { "text": "(string | number)[] | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_rowsCacheQuery", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_rowsCacheServer", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_settleRects", "type": { "text": "Map<string, DOMRect> | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_focusTarget", "privacy": "private", "return": { "type": { "text": "HTMLElement | null" } } }, { "kind": "field", "name": "_reducedMotion", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_settleTracks", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "changed", "type": { "text": "PropertyValues<this>" } } ] }, { "kind": "method", "name": "_captureSettleRects", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_motionMs", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "token", "type": { "text": "string" } }, { "name": "fallback", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_playSettle", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "prev", "type": { "text": "Map<string, DOMRect>" } } ] }, { "kind": "method", "name": "_measureListbox", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_scrollVirtualActiveIntoView", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "selectedValues", "type": { "text": "(string | number)[]" }, "description": "Read: the selected primitives in option order (values missing from\n`options` persist after, in selection order). Write (controlled, ADR\n0026): replaces the selection wholesale, syncs the form value, and\nre-renders — without emitting `change` (no controlled echo) — so a\nconsumer can drive the selection from its own state instead of\nkey-remounting." }, { "kind": "method", "name": "_seedFromValue", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_absorbOptionLabels", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_labelFor", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "value", "type": { "text": "string | number" } } ] }, { "kind": "method", "name": "_syncChipMeasurement", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_measureChips", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_q", "type": { "text": "string" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_matches", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "opt", "type": { "text": "MultiSelectOption" } } ] }, { "kind": "field", "name": "_atCap", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_optDisabled", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "opt", "type": { "text": "MultiSelectOption" } } ] }, { "kind": "field", "name": "_rows", "type": { "text": "OptionRow[]" }, "privacy": "protected", "readonly": true }, { "kind": "field", "name": "_navigable", "type": { "text": "number[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_matchCount", "type": { "text": "number" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_nextNavigable", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "from", "type": { "text": "number" } }, { "name": "dir", "type": { "text": "1 | -1" } } ] }, { "kind": "method", "name": "_toggleValue", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string | number" } } ] }, { "kind": "method", "name": "_toggleIndex", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "i", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_selectAllVisible", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_clearSelection", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_syncForm", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_emitChange", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onDocPointerDown", "privacy": "private" }, { "kind": "method", "name": "_openList", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_closeList", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "focusControl", "default": "true" } ] }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" }, { "kind": "field", "name": "_onControlClick", "privacy": "private" }, { "kind": "field", "name": "_onChipRemove", "privacy": "private" }, { "kind": "field", "name": "_onControlKeydown", "privacy": "private" }, { "kind": "method", "name": "_onListKeydown", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } } ] }, { "kind": "field", "name": "_onSearchKeydown", "privacy": "private" }, { "kind": "field", "name": "_onSearchInput", "privacy": "private" }, { "kind": "method", "name": "_emitSearch", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onListScroll", "privacy": "private" }, { "kind": "method", "name": "_maybeLoadMore", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "el", "type": { "text": "HTMLElement" } } ] }, { "kind": "method", "name": "_typeAhead", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "char", "type": { "text": "string" } } ] }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_renderInline", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderTriggerChip", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "value", "type": { "text": "string | number" } }, { "name": "removable", "type": { "text": "boolean" } }, { "name": "measuring", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_renderPanel", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "baseId", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_renderMainRows", "privacy": "private", "return": { "type": { "text": "unknown" } }, "parameters": [ { "name": "rows", "type": { "text": "OptionRow[]" } }, { "name": "pinnedCount", "type": { "text": "number" } }, { "name": "baseId", "type": { "text": "string" } } ] }, { "kind": "method", "name": "_renderSkeletonRows", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "existingCount", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_renderNote", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "method", "name": "_renderRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "row", "type": { "text": "OptionRow" } }, { "name": "index", "type": { "text": "number" } }, { "name": "baseId", "type": { "text": "string" } } ] }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on every toggle; `detail.value` is the full selection as an Array<primitive>.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "xm-multi-select-search", "type": { "text": "CustomEvent" }, "description": "Server mode: debounced search intent (`detail.query`); also fired on open with the current query. The consumer fetches and sets `.options` with the matching set." }, { "name": "xm-multi-select-load-more", "type": { "text": "CustomEvent" }, "description": "Server mode: fired once per page when the listbox scrolls near its end and `options.length < totalItems` (`detail = { query, offset }`). The consumer appends the next page to `.options`." }, { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "placeholder", "type": { "text": "string" }, "default": "\"Select…\"", "description": "Shown on the trigger when nothing is selected.", "fieldName": "placeholder" }, { "name": "max", "type": { "text": "number" }, "default": "0", "description": "Selection cap (0 = uncapped). At the cap, unselected options disable; selected stay removable.", "fieldName": "max" }, { "name": "searchable", "type": { "text": "boolean" }, "default": "true", "description": "Render the in-panel search filter.", "fieldName": "searchable" }, { "name": "inline", "type": { "text": "boolean" }, "default": "false", "description": "Dock the panel in place of the combobox trigger — an always-open filter\nrail (ADR 0031). Search, bulk actions, recents, sections, virtualization\nand the selection contract are unchanged; only the trigger and the\noverlay drop away, and the listbox becomes the focus target.", "fieldName": "inline" }, { "name": "bulk-actions", "type": { "text": "boolean" }, "default": "false", "description": "Render the \"Select all\" / \"Clear\" bulk-action row. \"Select all\" operates on the search-filtered set and respects `max`.", "fieldName": "bulkActions" }, { "name": "server", "type": { "text": "boolean" }, "default": "false", "description": "Server mode (ADR 0023): the backend owns filtering — client-side label matching is off, the search emits `xm-multi-select-search`, and scrolling near the end emits `xm-multi-select-load-more`.", "fieldName": "server" }, { "name": "options-loading", "type": { "text": "boolean" }, "default": "false", "description": "Signal a consumer fetch in flight (server-mode search, or any options refresh): rows already present dim to ghost ink, skeleton rows fade in under them, and \"No matches\" is suppressed. Distinct from the inherited field-level `loading`, which disables the whole control.", "fieldName": "optionsLoading" }, { "name": "search-debounce", "type": { "text": "number" }, "default": "250", "description": "Debounce for `xm-multi-select-search` in milliseconds.", "fieldName": "searchDebounce" }, { "name": "total-items", "type": { "text": "number" }, "default": "0", "description": "Server mode: total backend match count for the current query. Drives the \"Showing N of M matches\" note and load-more paging (0 = unknown/complete).", "fieldName": "totalItems" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-multi-select", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmMultiSelect", "declaration": { "name": "XmMultiSelect", "module": "lit/components/multi-select/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-multi-select", "declaration": { "name": "XmMultiSelect", "module": "lit/components/multi-select/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/navigation-drawer/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmNavigationDrawer", "members": [ { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }" }, { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "collapsed", "type": { "text": "boolean" }, "default": "false", "attribute": "collapsed", "reflects": true }, { "kind": "field", "name": "modal", "type": { "text": "boolean" }, "default": "false", "attribute": "modal", "reflects": true }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"Navigation\"", "attribute": "label" }, { "kind": "field", "name": "_dialog", "type": { "text": "HTMLDialogElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_restoreFocusTo", "type": { "text": "HTMLElement | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_wasOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "method", "name": "_activateModal", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_deactivateModal", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "dispatch", "default": "true" } ] }, { "kind": "field", "name": "_onDialogCancel", "privacy": "private" }, { "kind": "field", "name": "_onDialogClose", "privacy": "private" }, { "kind": "field", "name": "_onDialogClick", "privacy": "private" }, { "kind": "method", "name": "_emitClose", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_restoreFocus", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_deepActiveElement", "privacy": "private", "return": { "type": { "text": "HTMLElement | null" } } } ], "events": [ { "name": "close", "type": { "text": "CustomEvent" }, "description": "Fired when the element requests to close." } ], "attributes": [ { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "collapsed", "type": { "text": "boolean" }, "default": "false", "fieldName": "collapsed" }, { "name": "modal", "type": { "text": "boolean" }, "default": "false", "fieldName": "modal" }, { "name": "label", "type": { "text": "string" }, "default": "\"Navigation\"", "fieldName": "label" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-navigation-drawer", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmNavigationDrawer", "declaration": { "name": "XmNavigationDrawer", "module": "lit/components/navigation-drawer/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-navigation-drawer", "declaration": { "name": "XmNavigationDrawer", "module": "lit/components/navigation-drawer/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/overlay/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmOverlay", "members": [ { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }" }, { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "mode", "type": { "text": "OverlayMode" }, "default": "\"modal\"", "attribute": "mode", "reflects": true }, { "kind": "field", "name": "tier", "type": { "text": "OverlayTier" }, "default": "\"dialog\"", "attribute": "tier", "reflects": true }, { "kind": "field", "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"bottom-start\"", "attribute": "placement", "reflects": true }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "matchAnchorWidth", "type": { "text": "boolean" }, "default": "false", "description": "Non-modal dropdowns: size the surface's border box to exactly the anchor's\nwidth, so a width-matching listbox aligns border-to-border with its trigger\n(ADR 0025). The consumer stops sizing the panel content to the anchor.", "attribute": "match-anchor-width", "reflects": true }, { "kind": "field", "name": "arrow", "type": { "text": "boolean" }, "default": "false", "description": "Non-modal overlays: weld a small pointer to the surface edge facing the\nanchor. It tracks the anchor's centre — when the surface is clamped at a\nviewport edge the pointer slides along that edge and keeps pointing at the\ntrigger (ADR 0033). Opt-in, so menus and dialogs are unaffected.", "attribute": "arrow", "reflects": true }, { "kind": "field", "name": "anchor", "type": { "text": "HTMLElement | null" }, "default": "null", "description": "Trigger element to anchor a non-modal overlay against (CSS anchor()).\nA property, not an attribute — it is an element reference, possibly from\nanother shadow root. Reactive, so re-anchoring an ALREADY-OPEN overlay\nre-pins it (a delegated tooltip moving between targets, ADR 0033)." }, { "kind": "field", "name": "opener", "type": { "text": "HTMLElement | null" }, "default": "null", "description": "Element focus is restored to on close. Defaults to `anchor`, else the\ndocument's deepest activeElement at open time." }, { "kind": "field", "name": "_dialog", "type": { "text": "HTMLDialogElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_popover", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_id", "privacy": "private", "readonly": true, "default": "`xm-overlay-${++overlaySeq}`" }, { "kind": "field", "name": "_anchorName", "privacy": "private", "readonly": true, "default": "`--xm-overlay-anchor-${overlaySeq}`" }, { "kind": "field", "name": "_restoreFocusTo", "type": { "text": "HTMLElement | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_scrollLocked", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_wasOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_activationSeq", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "method", "name": "show", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "hide", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "reason", "default": "\"api\"", "type": { "text": "OverlayCloseReason" } } ] }, { "kind": "method", "name": "toggle", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_activate", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_deactivate", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "reason", "type": { "text": "OverlayCloseReason" } } ] }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "field", "name": "_onDialogCancel", "privacy": "private" }, { "kind": "field", "name": "_onDialogClose", "privacy": "private" }, { "kind": "field", "name": "_onDialogClick", "privacy": "private" }, { "kind": "method", "name": "_applyAnchor", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_sameTreeScope", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "anchor", "type": { "text": "HTMLElement" } } ] }, { "kind": "field", "name": "_reposition", "privacy": "private" }, { "kind": "method", "name": "_pinToAnchor", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_flipSide", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "side", "type": { "text": "string" } }, { "name": "a", "type": { "text": "DOMRect" } }, { "name": "w", "type": { "text": "number" } }, { "name": "h", "type": { "text": "number" } }, { "name": "gap", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_lockScroll", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_unlockScroll", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_restoreFocus", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_deepActiveElement", "privacy": "private", "return": { "type": { "text": "HTMLElement | null" } } }, { "kind": "method", "name": "_ownsOpener", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "other", "type": { "text": "XmOverlay" } } ] }, { "kind": "method", "name": "_tierZVar", "privacy": "private", "return": { "type": { "text": "string" } } } ], "events": [ { "name": "xm-overlay-open", "type": { "text": "CustomEvent" }, "description": "Fired when the overlay opens." }, { "name": "xm-overlay-close", "type": { "text": "CustomEvent" }, "description": "Fired when the overlay closes." } ], "attributes": [ { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "mode", "type": { "text": "OverlayMode" }, "default": "\"modal\"", "fieldName": "mode" }, { "name": "tier", "type": { "text": "OverlayTier" }, "default": "\"dialog\"", "fieldName": "tier" }, { "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"bottom-start\"", "fieldName": "placement" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" }, { "name": "match-anchor-width", "type": { "text": "boolean" }, "default": "false", "description": "Non-modal dropdowns: size the surface's border box to exactly the anchor's\nwidth, so a width-matching listbox aligns border-to-border with its trigger\n(ADR 0025). The consumer stops sizing the panel content to the anchor.", "fieldName": "matchAnchorWidth" }, { "name": "arrow", "type": { "text": "boolean" }, "default": "false", "description": "Non-modal overlays: weld a small pointer to the surface edge facing the\nanchor. It tracks the anchor's centre — when the surface is clamped at a\nviewport edge the pointer slides along that edge and keeps pointing at the\ntrigger (ADR 0033). Opt-in, so menus and dialogs are unaffected.", "fieldName": "arrow" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-overlay", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmOverlay", "declaration": { "name": "XmOverlay", "module": "lit/components/overlay/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-overlay", "declaration": { "name": "XmOverlay", "module": "lit/components/overlay/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/pagination/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmPagination", "members": [ { "kind": "field", "name": "page", "type": { "text": "number" }, "default": "1", "attribute": "page" }, { "kind": "field", "name": "total", "type": { "text": "number" }, "default": "1", "attribute": "total" }, { "kind": "field", "name": "siblings", "type": { "text": "number" }, "default": "1", "attribute": "siblings" }, { "kind": "field", "name": "size", "type": { "text": "PaginationSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "offset", "type": { "text": "number" }, "default": "0", "description": "Offset/limit mode (AD-18): set `limit` + `total-items` (+ `offset`) instead\nof `page` + `total`. The page-based API stays available and unchanged; in\nthis mode the control ALSO emits xm-pagination-offset-change.", "attribute": "offset" }, { "kind": "field", "name": "limit", "type": { "text": "number" }, "default": "0", "attribute": "limit" }, { "kind": "field", "name": "totalItems", "type": { "text": "number" }, "default": "0", "attribute": "total-items" }, { "kind": "method", "name": "_isOffsetMode", "privacy": "private", "return": { "type": { "text": "boolean" } } }, { "kind": "method", "name": "_clamp", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "value", "type": { "text": "number" } }, { "name": "total", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_goto", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "target", "type": { "text": "number" } }, { "name": "total", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_pageWindow", "privacy": "private", "return": { "type": { "text": "PageToken[]" } }, "parameters": [ { "name": "page", "type": { "text": "number" } }, { "name": "total", "type": { "text": "number" } } ] } ], "events": [ { "name": "xm-pagination-page-change", "type": { "text": "CustomEvent" }, "description": "Fired when the page changes (`detail.page`)." }, { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail`." }, { "name": "xm-pagination-offset-change", "type": { "text": "CustomEvent" }, "description": "Fired in offset/limit mode (`detail.offset`, `detail.limit`)." } ], "attributes": [ { "name": "page", "type": { "text": "number" }, "default": "1", "fieldName": "page" }, { "name": "total", "type": { "text": "number" }, "default": "1", "fieldName": "total" }, { "name": "siblings", "type": { "text": "number" }, "default": "1", "fieldName": "siblings" }, { "name": "size", "type": { "text": "PaginationSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "offset", "type": { "text": "number" }, "default": "0", "description": "Offset/limit mode (AD-18): set `limit` + `total-items` (+ `offset`) instead\nof `page` + `total`. The page-based API stays available and unchanged; in\nthis mode the control ALSO emits xm-pagination-offset-change.", "fieldName": "offset" }, { "name": "limit", "type": { "text": "number" }, "default": "0", "fieldName": "limit" }, { "name": "total-items", "type": { "text": "number" }, "default": "0", "fieldName": "totalItems" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-pagination", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmPagination", "declaration": { "name": "XmPagination", "module": "lit/components/pagination/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-pagination", "declaration": { "name": "XmPagination", "module": "lit/components/pagination/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/popover/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmPopover", "members": [ { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"bottom-start\"", "attribute": "placement" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "private" }, { "kind": "field", "name": "_panel", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_triggerWrap", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_panelId", "privacy": "private", "readonly": true, "default": "`xm-popover-${++popoverSeq}`" }, { "kind": "field", "name": "_closeReason", "type": { "text": "string" }, "privacy": "private", "default": "\"api\"" }, { "kind": "field", "name": "_wasOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_onTriggerClick", "privacy": "private" }, { "kind": "field", "name": "_onDocPointer", "privacy": "private" }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" }, { "kind": "method", "name": "_requestClose", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "reason", "type": { "text": "string" } } ] }, { "kind": "field", "name": "_triggerEl", "type": { "text": "HTMLElement | null" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_wireTriggerAria", "privacy": "private" } ], "events": [ { "name": "xm-popover-open", "type": { "text": "CustomEvent" }, "description": "Fired when the popover opens." }, { "name": "xm-popover-close", "type": { "text": "CustomEvent" }, "description": "Fired when the popover closes." } ], "attributes": [ { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"bottom-start\"", "fieldName": "placement" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-popover", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmPopover", "declaration": { "name": "XmPopover", "module": "lit/components/popover/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-popover", "declaration": { "name": "XmPopover", "module": "lit/components/popover/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/progress/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmProgress", "members": [ { "kind": "field", "name": "variant", "type": { "text": "ProgressVariant" }, "default": "\"linear\"", "attribute": "variant" }, { "kind": "field", "name": "value", "default": "NaN", "attribute": "value" }, { "kind": "field", "name": "indeterminate", "type": { "text": "boolean" }, "default": "false", "attribute": "indeterminate" }, { "kind": "field", "name": "size", "type": { "text": "ProgressSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "showLabel", "type": { "text": "boolean" }, "default": "false", "attribute": "show-label" }, { "kind": "field", "name": "segments", "type": { "text": "ProgressSegment[]" }, "default": "[]", "description": "Turn the rail into a part-to-whole split: one track, n parts sized by\nshare of their sum. Not progress toward a goal, so the segmented rail is\na labelled list rather than a `progressbar`; `value` is ignored." }, { "kind": "field", "name": "_isDeterminate", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_clamped", "type": { "text": "number" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_renderSegmented", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "sz", "type": { "text": "ProgressSize" } } ] }, { "kind": "method", "name": "_renderLinear", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "det", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_renderCircular", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "det", "type": { "text": "boolean" } }, { "name": "sz", "type": { "text": "ProgressSize" } } ] }, { "kind": "method", "name": "_renderRingIndicator", "privacy": "private", "return": { "type": { "text": "SVGTemplateResult" } }, "parameters": [ { "name": "det", "type": { "text": "boolean" } }, { "name": "r", "type": { "text": "number" } }, { "name": "circumference", "type": { "text": "number" } }, { "name": "stroke", "type": { "text": "number" } } ] } ], "attributes": [ { "name": "variant", "type": { "text": "ProgressVariant" }, "default": "\"linear\"", "fieldName": "variant" }, { "name": "value", "default": "NaN", "fieldName": "value" }, { "name": "indeterminate", "type": { "text": "boolean" }, "default": "false", "fieldName": "indeterminate" }, { "name": "size", "type": { "text": "ProgressSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" }, { "name": "show-label", "type": { "text": "boolean" }, "default": "false", "fieldName": "showLabel" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-progress", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmProgress", "declaration": { "name": "XmProgress", "module": "lit/components/progress/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-progress", "declaration": { "name": "XmProgress", "module": "lit/components/progress/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/radio-group/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmRadio", "members": [ { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "The primitive value this radio contributes to the group when selected.", "attribute": "value" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "description": "Own disabled — OR'd with the group's disabled by the group.", "attribute": "disabled", "reflects": true }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "Driven by the group; never set directly by authors.", "attribute": "checked", "reflects": true }, { "kind": "field", "name": "groupDisabled", "type": { "text": "boolean" }, "default": "false", "description": "Effective disabled the group computes (group OR own).", "attribute": "group-disabled", "reflects": true }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "readonly": true } ], "events": [ { "description": "Fired on commit with the new value in `detail`.", "name": "change" } ], "attributes": [ { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "The primitive value this radio contributes to the group when selected.", "fieldName": "value" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "description": "Own disabled — OR'd with the group's disabled by the group.", "fieldName": "disabled" }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "Driven by the group; never set directly by authors.", "fieldName": "checked" }, { "name": "group-disabled", "type": { "text": "boolean" }, "default": "false", "description": "Effective disabled the group computes (group OR own).", "fieldName": "groupDisabled" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-radio", "customElement": true }, { "kind": "class", "description": "", "name": "XmRadioGroup", "members": [ { "kind": "field", "name": "_radios", "type": { "text": "XmRadio[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_enabledRadios", "type": { "text": "XmRadio[]" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_syncRadios", "privacy": "private", "return": { "type": { "text": "void" } }, "description": "Reflect the group's selected value + disabled onto each child, and set the\nroving tabindex (selected, else first enabled, is the only tab stop)." }, { "kind": "method", "name": "_select", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "radio", "type": { "text": "XmRadio" } }, { "name": "focus", "default": "true" } ] }, { "kind": "field", "name": "_onClick", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-radio-group", "customElement": true, "attributes": [ { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ] } ], "exports": [ { "kind": "js", "name": "XmRadio", "declaration": { "name": "XmRadio", "module": "lit/components/radio-group/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-radio", "declaration": { "name": "XmRadio", "module": "lit/components/radio-group/index.ts" } }, { "kind": "js", "name": "XmRadioGroup", "declaration": { "name": "XmRadioGroup", "module": "lit/components/radio-group/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-radio-group", "declaration": { "name": "XmRadioGroup", "module": "lit/components/radio-group/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/select/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmSelect", "members": [ { "kind": "field", "name": "options", "type": { "text": "SelectOption[]" }, "default": "[]", "description": "The option model — `{ label, value, disabled? }` shared across\nselect / autocomplete / radio-group so one host handler is safe." }, { "kind": "field", "name": "placeholder", "type": { "text": "string" }, "default": "\"Select…\"", "description": "Shown on the closed control when nothing is selected.", "attribute": "placeholder" }, { "kind": "field", "name": "_open", "type": { "text": "boolean" }, "privacy": "protected", "default": "false" }, { "kind": "field", "name": "_activeIndex", "type": { "text": "number" }, "privacy": "protected", "default": "-1" }, { "kind": "field", "name": "_selectedValue", "type": { "text": "string | number | null" }, "privacy": "protected", "default": "null", "description": "The selected option's PRIMITIVE value (string | number), or null." }, { "kind": "field", "name": "_control", "type": { "text": "HTMLElement | null" }, "privacy": "protected" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "protected" }, { "kind": "field", "name": "_typeahead", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_typeaheadTimer", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "selectedValue", "type": { "text": "string | number | null" }, "description": "Live read for the closed control + xm-form. The inherited string `value`\nstays in sync; this returns the typed primitive for consumers that want it.", "readonly": true }, { "kind": "field", "name": "_enabledIndexes", "type": { "text": "number[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_selectedLabel", "type": { "text": "string" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_onDocPointerDown", "privacy": "private" }, { "kind": "method", "name": "_openList", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_closeList", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "focusControl", "default": "true" } ] }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" }, { "kind": "method", "name": "_commitSelection", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string | number" } }, { "name": "emit", "default": "true" } ] }, { "kind": "method", "name": "_selectActive", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_selectOption", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "index", "type": { "text": "number" } } ] }, { "kind": "field", "name": "_onControlKeydown", "privacy": "private" }, { "kind": "method", "name": "_onListKeydown", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "KeyboardEvent" } } ] }, { "kind": "method", "name": "_nextEnabled", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "from", "type": { "text": "number" } }, { "name": "dir", "type": { "text": "1 | -1" } } ] }, { "kind": "method", "name": "_typeAhead", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "char", "type": { "text": "string" } } ] }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_renderOption", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "opt", "type": { "text": "SelectOption" } }, { "name": "index", "type": { "text": "number" } }, { "name": "baseId", "type": { "text": "string" } } ] }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "placeholder", "type": { "text": "string" }, "default": "\"Select…\"", "description": "Shown on the closed control when nothing is selected.", "fieldName": "placeholder" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-select", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmSelect", "declaration": { "name": "XmSelect", "module": "lit/components/select/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-select", "declaration": { "name": "XmSelect", "module": "lit/components/select/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/side-sheet/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmSideSheet", "members": [ { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }" }, { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "modal", "type": { "text": "boolean" }, "default": "false", "attribute": "modal", "reflects": true }, { "kind": "field", "name": "side", "type": { "text": "SideSheetSide" }, "default": "\"end\"", "attribute": "side", "reflects": true }, { "kind": "field", "name": "noScrimClose", "type": { "text": "boolean" }, "default": "false", "attribute": "no-scrim-close" }, { "kind": "field", "name": "static", "type": { "text": "boolean" }, "default": "false", "attribute": "static" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label" }, { "kind": "field", "name": "_hasHeader", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_hasAction", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_dialog", "type": { "text": "HTMLDialogElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_headerId", "privacy": "private", "readonly": true, "default": "`xm-side-sheet-${++sideSheetSeq}-header`" }, { "kind": "field", "name": "_restoreFocusTo", "type": { "text": "HTMLElement | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_wasOpen", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_pendingReason", "type": { "text": "SideSheetCloseDetail[\"reason\"] | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_activateModal", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_deactivateModal", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "dispatch", "default": "true" } ] }, { "kind": "field", "name": "_onDialogCancel", "privacy": "private" }, { "kind": "field", "name": "_onDialogClose", "privacy": "private" }, { "kind": "field", "name": "_onDialogClick", "privacy": "private" }, { "kind": "field", "name": "_onCloseButton", "privacy": "private" }, { "kind": "method", "name": "_emitClose", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_restoreFocus", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_deepActiveElement", "privacy": "private", "return": { "type": { "text": "HTMLElement | null" } } }, { "kind": "field", "name": "_onHeaderSlot", "privacy": "private" }, { "kind": "field", "name": "_onActionSlot", "privacy": "private" } ], "events": [ { "name": "close", "type": { "text": "CustomEvent" }, "description": "Fired when the sheet requests to close; detail carries the reason (esc, backdrop, api)." } ], "attributes": [ { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "modal", "type": { "text": "boolean" }, "default": "false", "fieldName": "modal" }, { "name": "side", "type": { "text": "SideSheetSide" }, "default": "\"end\"", "fieldName": "side" }, { "name": "no-scrim-close", "type": { "text": "boolean" }, "default": "false", "fieldName": "noScrimClose" }, { "name": "static", "type": { "text": "boolean" }, "default": "false", "fieldName": "static" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-side-sheet", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmSideSheet", "declaration": { "name": "XmSideSheet", "module": "lit/components/side-sheet/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-side-sheet", "declaration": { "name": "XmSideSheet", "module": "lit/components/side-sheet/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/sidebar-item/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmSidebarItem", "members": [ { "kind": "field", "name": "title", "type": { "text": "string" }, "default": "\"\"", "attribute": "title" }, { "kind": "field", "name": "layout", "type": { "text": "SidebarLayout" }, "default": "\"row\"", "attribute": "layout" }, { "kind": "field", "name": "active", "type": { "text": "boolean" }, "default": "false", "attribute": "active" }, { "kind": "field", "name": "hover", "type": { "text": "boolean" }, "default": "false", "attribute": "hover" }, { "kind": "field", "name": "showDot", "type": { "text": "boolean" }, "default": "false", "attribute": "show-dot" }, { "kind": "field", "name": "collapsed", "type": { "text": "boolean" }, "default": "false", "attribute": "collapsed" }, { "kind": "field", "name": "badge", "type": { "text": "string" }, "default": "\"\"", "description": "Trailing count on a `row`-layout item (unread, open tickets). On the\ncollapsed rail there is no room for a figure, so the stripe takes the\naccent instead — the signal survives the collapse, the number does not.", "attribute": "badge" }, { "kind": "method", "name": "_renderBadge", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } } } ], "attributes": [ { "name": "title", "type": { "text": "string" }, "default": "\"\"", "fieldName": "title" }, { "name": "layout", "type": { "text": "SidebarLayout" }, "default": "\"row\"", "fieldName": "layout" }, { "name": "active", "type": { "text": "boolean" }, "default": "false", "fieldName": "active" }, { "name": "hover", "type": { "text": "boolean" }, "default": "false", "fieldName": "hover" }, { "name": "show-dot", "type": { "text": "boolean" }, "default": "false", "fieldName": "showDot" }, { "name": "collapsed", "type": { "text": "boolean" }, "default": "false", "fieldName": "collapsed" }, { "name": "badge", "type": { "text": "string" }, "default": "\"\"", "description": "Trailing count on a `row`-layout item (unread, open tickets). On the\ncollapsed rail there is no room for a figure, so the stripe takes the\naccent instead — the signal survives the collapse, the number does not.", "fieldName": "badge" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-sidebar-item", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmSidebarItem", "declaration": { "name": "XmSidebarItem", "module": "lit/components/sidebar-item/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-sidebar-item", "declaration": { "name": "XmSidebarItem", "module": "lit/components/sidebar-item/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/skeleton/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmSkeleton", "members": [ { "kind": "field", "name": "variant", "type": { "text": "SkeletonVariant" }, "default": "\"line\"", "attribute": "variant" }, { "kind": "field", "name": "width", "type": { "text": "string" }, "default": "\"\"", "attribute": "width" }, { "kind": "field", "name": "height", "type": { "text": "string" }, "default": "\"\"", "attribute": "height" }, { "kind": "field", "name": "lines", "type": { "text": "number" }, "default": "1", "attribute": "lines" }, { "kind": "field", "name": "radius", "type": { "text": "string" }, "default": "\"\"", "attribute": "radius" }, { "kind": "method", "name": "_renderShape", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderLines", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_shapeStyle", "privacy": "private", "return": { "type": { "text": "string" } } } ], "attributes": [ { "name": "variant", "type": { "text": "SkeletonVariant" }, "default": "\"line\"", "fieldName": "variant" }, { "name": "width", "type": { "text": "string" }, "default": "\"\"", "fieldName": "width" }, { "name": "height", "type": { "text": "string" }, "default": "\"\"", "fieldName": "height" }, { "name": "lines", "type": { "text": "number" }, "default": "1", "fieldName": "lines" }, { "name": "radius", "type": { "text": "string" }, "default": "\"\"", "fieldName": "radius" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-skeleton", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmSkeleton", "declaration": { "name": "XmSkeleton", "module": "lit/components/skeleton/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-skeleton", "declaration": { "name": "XmSkeleton", "module": "lit/components/skeleton/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/slider/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmSlider", "members": [ { "kind": "field", "name": "min", "type": { "text": "number" }, "default": "0", "attribute": "min" }, { "kind": "field", "name": "max", "type": { "text": "number" }, "default": "100", "attribute": "max" }, { "kind": "field", "name": "step", "type": { "text": "number" }, "default": "1", "attribute": "step" }, { "kind": "field", "name": "showValue", "type": { "text": "boolean" }, "default": "false", "description": "Show the current numeric value as a label beside the track.", "attribute": "show-value" }, { "kind": "field", "name": "unit", "type": { "text": "string" }, "default": "\"\"", "description": "Optional unit appended to the displayed value (e.g. \"%\", \"px\").", "attribute": "unit" }, { "kind": "field", "name": "_track", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_dragging", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "valueAsNumber", "type": { "text": "number" }, "description": "Typed live read; the inherited string `value` stays in sync.", "readonly": true }, { "kind": "field", "name": "_num", "type": { "text": "number" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_fraction", "type": { "text": "number" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_clampSnap", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "v", "type": { "text": "number" } } ] }, { "kind": "method", "name": "_setValue", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "v", "type": { "text": "number" } }, { "name": "emitInput", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "_commit", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_valueFromClientX", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "clientX", "type": { "text": "number" } } ] }, { "kind": "field", "name": "_onPointerDown", "privacy": "private" }, { "kind": "field", "name": "_onPointerMove", "privacy": "private" }, { "kind": "field", "name": "_onPointerUp", "privacy": "private" }, { "kind": "method", "name": "_focusThumb", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "field", "name": "_onBlur", "privacy": "private" }, { "kind": "field", "name": "_valueText", "type": { "text": "string" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "events": [ { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "min", "type": { "text": "number" }, "default": "0", "fieldName": "min" }, { "name": "max", "type": { "text": "number" }, "default": "100", "fieldName": "max" }, { "name": "step", "type": { "text": "number" }, "default": "1", "fieldName": "step" }, { "name": "show-value", "type": { "text": "boolean" }, "default": "false", "description": "Show the current numeric value as a label beside the track.", "fieldName": "showValue" }, { "name": "unit", "type": { "text": "string" }, "default": "\"\"", "description": "Optional unit appended to the displayed value (e.g. \"%\", \"px\").", "fieldName": "unit" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-slider", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmSlider", "declaration": { "name": "XmSlider", "module": "lit/components/slider/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-slider", "declaration": { "name": "XmSlider", "module": "lit/components/slider/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/snackbar/index.ts", "declarations": [ { "kind": "variable", "name": "SNACK_PRESETS", "type": { "text": "Record<SnackKind, SnackPreset>" }, "default": "{ auth: { kind: \"auth\", code: \"401\", title: \"Access denied\", message: \"Your API key was rejected. Open settings to update or replace the key.\", primaryLabel: \"Open settings\", secondaryLabel: \"Dismiss\", }, server: { kind: \"server\", code: \"503\", title: \"Server error\", message: \"The model service is temporarily unavailable. Your message wasn't sent.\", primaryLabel: \"Retry\", secondaryLabel: \"Dismiss\", }, generic: { kind: \"generic\", code: \"ERR\", title: \"Something went wrong\", message: \"We couldn't reach the backend. Check your connection and try again.\", primaryLabel: \"Retry\", secondaryLabel: \"Dismiss\", }, }" }, { "kind": "class", "description": "", "name": "XmSnackbar", "members": [ { "kind": "field", "name": "kind", "type": { "text": "SnackKind" }, "default": "\"generic\"", "attribute": "kind" }, { "kind": "field", "name": "code", "type": { "text": "string" }, "default": "\"\"", "attribute": "code" }, { "kind": "field", "name": "title", "type": { "text": "string" }, "default": "\"\"", "attribute": "title" }, { "kind": "field", "name": "message", "type": { "text": "string" }, "default": "\"\"", "attribute": "message" }, { "kind": "field", "name": "primaryLabel", "type": { "text": "string" }, "default": "\"\"", "attribute": "primary-label" }, { "kind": "field", "name": "secondaryLabel", "type": { "text": "string" }, "default": "\"Dismiss\"", "attribute": "secondary-label" }, { "kind": "field", "name": "showDismiss", "type": { "text": "boolean" }, "default": "false", "attribute": "show-dismiss" }, { "kind": "field", "name": "static", "type": { "text": "boolean" }, "default": "false", "attribute": "static" }, { "kind": "field", "name": "_onPrimary", "privacy": "private" }, { "kind": "field", "name": "_onDismiss", "privacy": "private" } ], "events": [ { "description": "Fired when the snackbar is dismissed.", "name": "snackbar-dismiss" }, { "description": "Fired when the snackbar's primary action is activated.", "name": "snackbar-primary" } ], "attributes": [ { "name": "kind", "type": { "text": "SnackKind" }, "default": "\"generic\"", "fieldName": "kind" }, { "name": "code", "type": { "text": "string" }, "default": "\"\"", "fieldName": "code" }, { "name": "title", "type": { "text": "string" }, "default": "\"\"", "fieldName": "title" }, { "name": "message", "type": { "text": "string" }, "default": "\"\"", "fieldName": "message" }, { "name": "primary-label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "primaryLabel" }, { "name": "secondary-label", "type": { "text": "string" }, "default": "\"Dismiss\"", "fieldName": "secondaryLabel" }, { "name": "show-dismiss", "type": { "text": "boolean" }, "default": "false", "fieldName": "showDismiss" }, { "name": "static", "type": { "text": "boolean" }, "default": "false", "fieldName": "static" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-snackbar", "customElement": true } ], "exports": [ { "kind": "js", "name": "SNACK_PRESETS", "declaration": { "name": "SNACK_PRESETS", "module": "lit/components/snackbar/index.ts" } }, { "kind": "js", "name": "XmSnackbar", "declaration": { "name": "XmSnackbar", "module": "lit/components/snackbar/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-snackbar", "declaration": { "name": "XmSnackbar", "module": "lit/components/snackbar/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/stack/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmStack", "members": [ { "kind": "field", "name": "direction", "type": { "text": "StackDirection" }, "default": "\"vertical\"", "attribute": "direction", "reflects": true }, { "kind": "field", "name": "gap", "type": { "text": "StackGap" }, "default": "\"md\"", "attribute": "gap", "reflects": true }, { "kind": "field", "name": "align", "type": { "text": "StackAlign" }, "default": "\"stretch\"", "attribute": "align", "reflects": true }, { "kind": "field", "name": "justify", "type": { "text": "StackJustify" }, "default": "\"start\"", "attribute": "justify", "reflects": true }, { "kind": "field", "name": "wrap", "type": { "text": "boolean" }, "default": "false", "attribute": "wrap", "reflects": true } ], "attributes": [ { "name": "direction", "type": { "text": "StackDirection" }, "default": "\"vertical\"", "fieldName": "direction" }, { "name": "gap", "type": { "text": "StackGap" }, "default": "\"md\"", "fieldName": "gap" }, { "name": "align", "type": { "text": "StackAlign" }, "default": "\"stretch\"", "fieldName": "align" }, { "name": "justify", "type": { "text": "StackJustify" }, "default": "\"start\"", "fieldName": "justify" }, { "name": "wrap", "type": { "text": "boolean" }, "default": "false", "fieldName": "wrap" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-stack", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmStack", "declaration": { "name": "XmStack", "module": "lit/components/stack/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-stack", "declaration": { "name": "XmStack", "module": "lit/components/stack/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/stat/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmStat", "members": [ { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "description": "Caption above the figure, in the mono label typescale. Sentence case.", "attribute": "label" }, { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "The figure itself, pre-formatted by the caller (grouping, units, currency).", "attribute": "value" }, { "kind": "field", "name": "delta", "type": { "text": "string" }, "default": "\"\"", "description": "Change beside the figure, sign included (`\"+18%\"`, `\"-4\"`). Rendered in the\ncoral accent whatever the direction — direction is carried by the sign and\nthe note, never by a red/green hue (POLICIES rule 3a).", "attribute": "delta" }, { "kind": "field", "name": "deltaNote", "type": { "text": "string" }, "default": "\"\"", "description": "What the delta is measured against (`\"vs 7-day avg\"`).", "attribute": "delta-note" }, { "kind": "field", "name": "size", "type": { "text": "StatSize" }, "default": "\"md\"", "description": "`hero` for the one figure a screen is about, `md` (default) for the strip\nbeside it, `sm` for a figure inside dense chrome.", "attribute": "size", "reflects": true } ], "attributes": [ { "name": "label", "type": { "text": "string" }, "default": "\"\"", "description": "Caption above the figure, in the mono label typescale. Sentence case.", "fieldName": "label" }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "The figure itself, pre-formatted by the caller (grouping, units, currency).", "fieldName": "value" }, { "name": "delta", "type": { "text": "string" }, "default": "\"\"", "description": "Change beside the figure, sign included (`\"+18%\"`, `\"-4\"`). Rendered in the\ncoral accent whatever the direction — direction is carried by the sign and\nthe note, never by a red/green hue (POLICIES rule 3a).", "fieldName": "delta" }, { "name": "delta-note", "type": { "text": "string" }, "default": "\"\"", "description": "What the delta is measured against (`\"vs 7-day avg\"`).", "fieldName": "deltaNote" }, { "name": "size", "type": { "text": "StatSize" }, "default": "\"md\"", "description": "`hero` for the one figure a screen is about, `md` (default) for the strip\nbeside it, `sm` for a figure inside dense chrome.", "fieldName": "size" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-stat", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmStat", "declaration": { "name": "XmStat", "module": "lit/components/stat/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-stat", "declaration": { "name": "XmStat", "module": "lit/components/stat/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/switch/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmSwitch", "members": [ { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "A switch submits checked-state (\"on\"/null), not text — declare it a toggle\nso the form value is correct from first paint, before any user interaction\n(the base seeds `_checked` from the `checked` attribute and `isToggle`\nroutes it through the toggle form-value branch).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggleSwitch", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-switch", "customElement": true, "attributes": [ { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "events": [ { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ] } ], "exports": [ { "kind": "js", "name": "XmSwitch", "declaration": { "name": "XmSwitch", "module": "lit/components/switch/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-switch", "declaration": { "name": "XmSwitch", "module": "lit/components/switch/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/table/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmTable", "members": [ { "kind": "field", "name": "columns", "type": { "text": "TableColumn[]" }, "default": "[]" }, { "kind": "field", "name": "rows", "type": { "text": "TableRow[]" }, "default": "[]" }, { "kind": "field", "name": "caption", "type": { "text": "string" }, "default": "\"\"", "attribute": "caption" }, { "kind": "method", "name": "_isNumericCol", "privacy": "private", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "col", "type": { "text": "TableColumn" } } ] }, { "kind": "method", "name": "_renderData", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } } ], "attributes": [ { "name": "caption", "type": { "text": "string" }, "default": "\"\"", "fieldName": "caption" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-table", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmTable", "declaration": { "name": "XmTable", "module": "lit/components/table/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-table", "declaration": { "name": "XmTable", "module": "lit/components/table/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/tabs/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmTab", "members": [ { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "attribute": "value" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true } ], "events": [ { "description": "Fired on commit with the new value in `detail`.", "name": "change" } ], "attributes": [ { "name": "value", "type": { "text": "string" }, "default": "\"\"", "fieldName": "value" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-tab", "customElement": true }, { "kind": "class", "description": "", "name": "XmTabPanel", "members": [ { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "attribute": "value" } ], "attributes": [ { "name": "value", "type": { "text": "string" }, "default": "\"\"", "fieldName": "value" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-tab-panel", "customElement": true }, { "kind": "class", "description": "", "name": "XmTabs", "members": [ { "kind": "field", "name": "value", "type": { "text": "string" }, "default": "\"\"", "attribute": "value" }, { "kind": "field", "name": "size", "type": { "text": "TabsSize" }, "default": "\"md\"", "attribute": "size" }, { "kind": "field", "name": "inset", "type": { "text": "boolean" }, "default": "false", "attribute": "inset", "reflects": true }, { "kind": "field", "name": "_list", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_indicator", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_id", "privacy": "private", "readonly": true, "default": "`xm-tabs-${++tabsSeq}`" }, { "kind": "field", "name": "_activeValue", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_onResize", "privacy": "private" }, { "kind": "field", "name": "_tabs", "type": { "text": "XmTab[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_panels", "type": { "text": "XmTabPanel[]" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "_enabledTabs", "privacy": "private", "return": { "type": { "text": "XmTab[]" } } }, { "kind": "field", "name": "_sync", "privacy": "private" }, { "kind": "method", "name": "_positionIndicator", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_activate", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } }, { "name": "focus", "default": "true" } ] }, { "kind": "field", "name": "_onClick", "privacy": "private" }, { "kind": "field", "name": "_onKeydown", "privacy": "private" } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" } } ], "attributes": [ { "name": "value", "type": { "text": "string" }, "default": "\"\"", "fieldName": "value" }, { "name": "size", "type": { "text": "TabsSize" }, "default": "\"md\"", "fieldName": "size" }, { "name": "inset", "type": { "text": "boolean" }, "default": "false", "fieldName": "inset" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-tabs", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmTab", "declaration": { "name": "XmTab", "module": "lit/components/tabs/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-tab", "declaration": { "name": "XmTab", "module": "lit/components/tabs/index.ts" } }, { "kind": "js", "name": "XmTabPanel", "declaration": { "name": "XmTabPanel", "module": "lit/components/tabs/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-tab-panel", "declaration": { "name": "XmTabPanel", "module": "lit/components/tabs/index.ts" } }, { "kind": "js", "name": "XmTabs", "declaration": { "name": "XmTabs", "module": "lit/components/tabs/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-tabs", "declaration": { "name": "XmTabs", "module": "lit/components/tabs/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/text-field/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmTextField", "members": [ { "kind": "field", "name": "type", "type": { "text": "TextFieldType" }, "default": "\"text\"", "description": "Native input type — single-line text variants only.", "attribute": "type" }, { "kind": "field", "name": "placeholder", "type": { "text": "string" }, "default": "\"\"", "description": "Native placeholder — shown when the live value is empty.", "attribute": "placeholder" }, { "kind": "field", "name": "clearable", "type": { "text": "boolean" }, "default": "false", "description": "Show a trailing clear button when the field has a value (implied for type=\"search\").", "attribute": "clearable" }, { "kind": "field", "name": "_onInput", "privacy": "private" }, { "kind": "field", "name": "_onChange", "privacy": "private" }, { "kind": "field", "name": "_showClear", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_leadSlotted", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_trailSlotted", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_onRailSlotChange", "privacy": "private" }, { "kind": "field", "name": "_onClear", "privacy": "private" }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "type", "type": { "text": "TextFieldType" }, "default": "\"text\"", "description": "Native input type — single-line text variants only.", "fieldName": "type" }, { "name": "placeholder", "type": { "text": "string" }, "default": "\"\"", "description": "Native placeholder — shown when the live value is empty.", "fieldName": "placeholder" }, { "name": "clearable", "type": { "text": "boolean" }, "default": "false", "description": "Show a trailing clear button when the field has a value (implied for type=\"search\").", "fieldName": "clearable" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-text-field", "customElement": true, "events": [ { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ] } ], "exports": [ { "kind": "js", "name": "XmTextField", "declaration": { "name": "XmTextField", "module": "lit/components/text-field/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-text-field", "declaration": { "name": "XmTextField", "module": "lit/components/text-field/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/textarea/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmTextarea", "members": [ { "kind": "field", "name": "rows", "type": { "text": "number" }, "default": "3", "description": "Initial visible height in text rows.", "attribute": "rows" }, { "kind": "field", "name": "placeholder", "type": { "text": "string" }, "default": "\"\"", "description": "Native placeholder — shown when the live value is empty.", "attribute": "placeholder" }, { "kind": "field", "name": "autoGrow", "type": { "text": "boolean" }, "default": "false", "description": "Grow the textarea height with content up to `maxRows` (no scroll jitter).", "attribute": "auto-grow" }, { "kind": "field", "name": "maxRows", "type": { "text": "number" }, "default": "8", "description": "Cap for auto-grow, in rows. Beyond it the textarea scrolls.", "attribute": "max-rows" }, { "kind": "field", "name": "_textarea", "type": { "text": "HTMLTextAreaElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_onInput", "privacy": "private" }, { "kind": "field", "name": "_onChange", "privacy": "private" }, { "kind": "method", "name": "_resize", "privacy": "private", "return": { "type": { "text": "void" } }, "description": "Reset then snap to scrollHeight, clamped to maxRows. Reading scrollHeight\nafter a height reset is the only reliable shrink-and-grow measurement;\nit's a single synchronous layout read per input, not an animation." }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "Subclasses override to render their concrete control directly into shadow\nDOM. The default projects whatever the author slots as `slot=\"control\"`,\nso a subclass can also author the control as a light-DOM child. Either\npath keeps the chrome on the base (AD-7).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "formAssociated", "type": { "text": "boolean" }, "static": true, "default": "true", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "shadowRootOptions", "type": { "text": "ShadowRootInit" }, "static": true, "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "\"\"", "attribute": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "helper", "type": { "text": "string" }, "default": "\"\"", "attribute": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "attribute": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "attribute": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "attribute": "name", "reflects": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialValue", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "attribute": "value", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "initialChecked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "attribute": "checked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_value", "type": { "text": "string" }, "privacy": "protected", "default": "\"\"", "description": "Live value state — seeded from `initialValue`, then owned by the field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_checked", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "Live checked state (toggle subclasses) — seeded from `initialChecked`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_toggle", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "description": "True once a toggle subclass has declared itself, so the form value is\nsubmitted as checked-state rather than text. Set eagerly by overriding\n`isToggle`, or lazily on the first `emitToggle`.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_formDisabled", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "description": "OR-propagated disabled flag a future xm-form sets — never re-enables a\nself-disabled field (AD-6a / AD-9a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "internals", "type": { "text": "ElementInternals" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_seq", "type": { "text": "number" }, "privacy": "private", "readonly": true, "default": "++fieldIdSeq", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_controlId", "privacy": "private", "readonly": true, "default": "`xm-field-control-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_describedById", "privacy": "private", "readonly": true, "default": "`xm-field-desc-${this._seq}`", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_valueSeeded", "type": { "text": "boolean" }, "privacy": "private", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "_dirty", "type": { "text": "boolean" }, "privacy": "protected", "default": "false", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isToggle", "type": { "text": "boolean" }, "privacy": "protected", "description": "Whether this field submits checked-state (toggle) rather than text. Toggle\nsubclasses (checkbox / radio / switch) override this to return `true` so\ntheir form value is correct from first paint — before any interaction —\nand is never inferred from `initialChecked` (a declaratively-checked text\nfield must NOT be treated as a toggle, and an untouched unchecked toggle\nmust submit `null`, not `\"\"`).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "effectiveDisabled", "type": { "text": "boolean" }, "privacy": "protected", "description": "Effective disabled = own disabled OR a future xm-form down-propagation.\nOR semantics: neither source can re-enable what the other disabled.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "nonInteractive", "type": { "text": "boolean" }, "privacy": "protected", "description": "Non-interactive whenever disabled (either source), readonly, or loading.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "isError", "type": { "text": "boolean" }, "privacy": "protected", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "hasMessage", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when the message row has helper or error copy to describe.", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "value", "type": { "text": "string" }, "description": "Programmatic reset support — setting `value` after first paint updates live state.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "checked", "type": { "text": "boolean" }, "description": "Public read contract for toggle subclasses (AD-6a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "setFormDisabled", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "disabled", "type": { "text": "boolean" } } ], "description": "Down-propagation hook: xm-form (Story 2.10) sets this; it OR's with the\nfield's own disabled and can never re-enable a self-disabled field.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Per-keystroke / per-drag live update. Updates live state, syncs the form\nvalue, and emits a composed, bubbling `input` with a typed primitive detail.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitChange", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "string" } } ], "description": "Commit. Same payload shape as input; fire on blur / Enter / native change.", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "emitToggle", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "checked", "type": { "text": "boolean" } } ], "description": "Toggle commit — marks the field a toggle and emits `detail.checked` (AD-8a).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "method", "name": "_syncFormValue", "privacy": "private", "return": { "type": { "text": "void" } }, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "kind": "field", "name": "controlAria", "type": { "text": "FieldControlAria" }, "privacy": "protected", "description": "The ARIA hooks the chrome wires. Subclasses set `id`, `aria-describedby`,\n`aria-invalid`, and `aria-required` on their control element from these so\nthe rendered label associates with the control and the error string is\nannounced (NFR-13 / UX-DR7).", "readonly": true, "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "attributes": [ { "name": "rows", "type": { "text": "number" }, "default": "3", "description": "Initial visible height in text rows.", "fieldName": "rows" }, { "name": "placeholder", "type": { "text": "string" }, "default": "\"\"", "description": "Native placeholder — shown when the live value is empty.", "fieldName": "placeholder" }, { "name": "auto-grow", "type": { "text": "boolean" }, "default": "false", "description": "Grow the textarea height with content up to `maxRows` (no scroll jitter).", "fieldName": "autoGrow" }, { "name": "max-rows", "type": { "text": "number" }, "default": "8", "description": "Cap for auto-grow, in rows. Beyond it the textarea scrolls.", "fieldName": "maxRows" }, { "name": "label", "type": { "text": "string" }, "default": "\"\"", "fieldName": "label", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "helper", "type": { "text": "string" }, "default": "\"\"", "fieldName": "helper", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "error", "type": { "text": "string" }, "default": "\"\"", "description": "Severity copy. Non-empty ⇒ the field is in error (icon + copy, never color).", "fieldName": "error", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "size", "type": { "text": "FieldSize" }, "default": "\"md\"", "fieldName": "size", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "fieldName": "loading", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "name", "type": { "text": "string" }, "default": "\"\"", "description": "Form-control name — mirrors native <input name>.", "fieldName": "name", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "value", "type": { "text": "string" }, "default": "\"\"", "description": "INITIAL value (uncontrolled-first, AD-6): the `value` attribute seeds the\nlive state once, then never overrides user input. Mapped from attribute\n`value` so authors write `<xm-text-field value=\"…\">`.", "fieldName": "initialValue", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "checked", "type": { "text": "boolean" }, "default": "false", "description": "INITIAL checked for toggle subclasses; mapped from attribute `checked`.", "fieldName": "initialChecked", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ], "superclass": { "name": "XmField", "module": "/lit/components/field/index.js" }, "tagName": "xm-textarea", "customElement": true, "events": [ { "name": "input", "type": { "text": "CustomEvent" }, "description": "Fired on each edit with the current value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } }, { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired on commit with the new value in `detail` (inherited by every field).", "inheritedFrom": { "name": "XmField", "module": "lit/components/field/index.ts" } } ] } ], "exports": [ { "kind": "js", "name": "XmTextarea", "declaration": { "name": "XmTextarea", "module": "lit/components/textarea/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-textarea", "declaration": { "name": "XmTextarea", "module": "lit/components/textarea/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/tooltip/index.ts", "declarations": [ { "kind": "class", "description": "", "name": "XmTooltip", "members": [ { "kind": "field", "name": "text", "type": { "text": "string" }, "default": "\"\"", "attribute": "text" }, { "kind": "field", "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"top\"", "attribute": "placement" }, { "kind": "field", "name": "openDelay", "type": { "text": "number" }, "default": "150", "attribute": "open-delay" }, { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false", "attribute": "open", "reflects": true }, { "kind": "field", "name": "delegate", "type": { "text": "boolean" }, "default": "false", "description": "Label every `[data-tip]` descendant of the slotted subtree from one\ninstance, instead of labelling a single `slot=\"trigger\"` control.", "attribute": "delegate", "reflects": true }, { "kind": "field", "name": "_visible", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "_delegateText", "type": { "text": "string" }, "privacy": "private", "default": "\"\"" }, { "kind": "field", "name": "_overlay", "type": { "text": "XmOverlay | null" }, "privacy": "private" }, { "kind": "field", "name": "_triggerWrap", "type": { "text": "HTMLElement | null" }, "privacy": "private" }, { "kind": "field", "name": "_labelId", "privacy": "private", "readonly": true, "default": "`xm-tooltip-${++tooltipSeq}`" }, { "kind": "field", "name": "_showTimer", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_hideTimer", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "field", "name": "_delegateTarget", "type": { "text": "HTMLElement | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "_describedEl", "type": { "text": "HTMLElement | null" }, "privacy": "private", "default": "null" }, { "kind": "method", "name": "_renderTrigger", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderDelegateArea", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_labelContent", "privacy": "private", "return": { "type": { "text": "unknown" } } }, { "kind": "field", "name": "_wireDescribedBy", "privacy": "private" }, { "kind": "field", "name": "_triggerEl", "type": { "text": "HTMLElement | null" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "_onEnter", "privacy": "private" }, { "kind": "field", "name": "_onLeave", "privacy": "private" }, { "kind": "field", "name": "_onFocusIn", "privacy": "private" }, { "kind": "field", "name": "_onFocusOut", "privacy": "private" }, { "kind": "method", "name": "_arm", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_disarm", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onDelegateOver", "privacy": "private" }, { "kind": "field", "name": "_onDelegateOut", "privacy": "private" }, { "kind": "method", "name": "_show", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_describe", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "el", "type": { "text": "HTMLElement" } } ] }, { "kind": "method", "name": "_releaseDescribed", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "_hide", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "_onOverlayClose", "privacy": "private" } ], "attributes": [ { "name": "text", "type": { "text": "string" }, "default": "\"\"", "fieldName": "text" }, { "name": "placement", "type": { "text": "OverlayPlacement" }, "default": "\"top\"", "fieldName": "placement" }, { "name": "open-delay", "type": { "text": "number" }, "default": "150", "fieldName": "openDelay" }, { "name": "open", "type": { "text": "boolean" }, "default": "false", "fieldName": "open" }, { "name": "delegate", "type": { "text": "boolean" }, "default": "false", "description": "Label every `[data-tip]` descendant of the slotted subtree from one\ninstance, instead of labelling a single `slot=\"trigger\"` control.", "fieldName": "delegate" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-tooltip", "customElement": true } ], "exports": [ { "kind": "js", "name": "XmTooltip", "declaration": { "name": "XmTooltip", "module": "lit/components/tooltip/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-tooltip", "declaration": { "name": "XmTooltip", "module": "lit/components/tooltip/index.ts" } } ] }, { "kind": "javascript-module", "path": "lit/components/validation/index.ts", "declarations": [ { "kind": "variable", "name": "VALIDATION_TITLE", "type": { "text": "Record<ValidationCode, string>" }, "default": "{ size: \"File too large\", ext: \"Wrong file type\", parse: \"Couldn't parse file\", shape: \"Unexpected structure\", empty: \"Empty file\", read: \"Read error\", }" }, { "kind": "variable", "name": "VALIDATION_PRESETS", "type": { "text": "Record<ValidationCode, ValidationPreset>" }, "default": "{ shape: { code: \"shape\", fileName: \"domains.yml\", path: \"/agents\", rule: \"required\", message: 'Definitions file is missing required field \"agents\".', file: { ext: \"yml\", name: \"domains.yml\", summary: \"8.4 KB · 4 agents, 12 tools\" }, }, parse: { code: \"parse\", fileName: \"domains.yml\", path: \"12:5\", rule: \"yaml\", message: \"Couldn't parse file. Unexpected token at line 12, column 5 — check indentation and quoting.\", }, size: { code: \"size\", fileName: \"huge-export.json\", rule: \"max-size\", message: \"File is 412 KB. Maximum allowed size is 200 KB.\", file: { ext: \"json\", name: \"huge-export.json\", summary: \"412 KB · over the 200 KB limit\" }, }, ext: { code: \"ext\", fileName: \"config.txt\", rule: \"ext\", message: \"Only .yml, .yaml, and .json files are accepted.\", file: { ext: \"yml\", name: \"config.txt\", summary: \"1.2 KB · unsupported extension\" }, }, empty: { code: \"empty\", fileName: \"empty.json\", rule: \"non-empty\", message: \"File is empty. Upload a valid YAML or JSON definitions file.\", file: { ext: \"json\", name: \"empty.json\", summary: \"0 B · no content\" }, }, read: { code: \"read\", fileName: \"domains.json\", rule: \"io\", message: \"Couldn't read the file from disk. Try selecting it again or check permissions.\", file: { ext: \"json\", name: \"domains.json\", summary: \"permission denied\" }, }, }" }, { "kind": "class", "description": "", "name": "XmFileValidationBlock", "members": [ { "kind": "field", "name": "state", "type": { "text": "ValidationState" }, "default": "\"idle\"", "attribute": "state" }, { "kind": "field", "name": "file", "type": { "text": "ValidationFile | null" }, "default": "null" }, { "kind": "field", "name": "error", "type": { "text": "ValidationError | null" }, "default": "null" }, { "kind": "field", "name": "hint", "type": { "text": "string" }, "default": "\"\"", "attribute": "hint" }, { "kind": "field", "name": "fileCsv", "type": { "text": "string" }, "default": "\"\"", "attribute": "file-csv" }, { "kind": "field", "name": "errorJson", "type": { "text": "string" }, "default": "\"\"", "attribute": "error-json" }, { "kind": "field", "name": "_copyState", "type": { "text": "CopyState" }, "privacy": "private", "default": "\"idle\"" }, { "kind": "method", "name": "_emit", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "type": { "text": "Record<string, unknown>" } } ] }, { "kind": "method", "name": "_renderDropRow", "privacy": "private", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "method", "name": "_renderFileRow", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "invalid", "type": { "text": "boolean" } } ] }, { "kind": "field", "name": "_onCopyPath", "privacy": "private" }, { "kind": "field", "name": "_onDismiss", "privacy": "private" }, { "kind": "method", "name": "_renderErrorRow", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "showMeta", "type": { "text": "boolean" } } ] } ], "events": [ { "name": "name", "type": { "text": "CustomEvent" } }, { "description": "Fired when the user requests to pick a file.", "name": "file-pick" }, { "description": "Fired when a file is dropped (`detail.file`).", "name": "file-drop" }, { "description": "Fired when the file path is copied (`detail.path`).", "name": "copy-path" }, { "description": "Fired when the validation error is dismissed.", "name": "error-dismiss" } ], "attributes": [ { "name": "state", "type": { "text": "ValidationState" }, "default": "\"idle\"", "fieldName": "state" }, { "name": "hint", "type": { "text": "string" }, "default": "\"\"", "fieldName": "hint" }, { "name": "file-csv", "type": { "text": "string" }, "default": "\"\"", "fieldName": "fileCsv" }, { "name": "error-json", "type": { "text": "string" }, "default": "\"\"", "fieldName": "errorJson" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "xm-file-validation-block", "customElement": true } ], "exports": [ { "kind": "js", "name": "VALIDATION_TITLE", "declaration": { "name": "VALIDATION_TITLE", "module": "lit/components/validation/index.ts" } }, { "kind": "js", "name": "VALIDATION_PRESETS", "declaration": { "name": "VALIDATION_PRESETS", "module": "lit/components/validation/index.ts" } }, { "kind": "js", "name": "XmFileValidationBlock", "declaration": { "name": "XmFileValidationBlock", "module": "lit/components/validation/index.ts" } }, { "kind": "custom-element-definition", "name": "xm-file-validation-block", "declaration": { "name": "XmFileValidationBlock", "module": "lit/components/validation/index.ts" } } ] } ] }