{ "schemaVersion": "1.0.0", "readme": "", "modules": [ { "kind": "javascript-module", "path": "src/components/baht-form.ts", "declarations": [ { "kind": "class", "description": " — dumb controlled form renderer (spec 01).\nJSON in (form + value + registry) -> UI out; emits `baht-change` / `baht-validity`.\nNo buttons, no cross-field logic — that's or the host.", "name": "BahtForm", "members": [ { "kind": "field", "name": "form", "type": { "text": "FormDefinition" } }, { "kind": "field", "name": "value", "type": { "text": "Record" }, "default": "{}" }, { "kind": "field", "name": "registry", "type": { "text": "Registry" }, "default": "{}" }, { "kind": "field", "name": "showOptional", "type": { "text": "boolean" }, "default": "false", "description": "Label every non-required field \"(optional)\" (localized) instead of relying on asterisks alone.", "attribute": "show-optional" }, { "kind": "field", "name": "options", "type": { "text": "BahtFormOptions" }, "default": "{}" }, { "kind": "field", "name": "fieldStates", "type": { "text": "Record" }, "default": "{}", "description": "L2 (workflow) derived per-field UI state, keyed by field key. Optional." }, { "kind": "field", "name": "view", "type": { "text": "string | undefined | undefined" }, "description": "Name of a view from `form.views`. Display-only: when set, only that view's\nfields are rendered and validated (the user can only fix what they see),\nbut getData() still returns the FULL form — the server always validates\nthe complete schema, views never change the submit payload.", "attribute": "view" }, { "kind": "field", "name": "flags", "type": { "text": "FeatureFlags" }, "default": "{}", "description": "Feature-flag values (spec 01 §12) — fields whose `flag` is off behave as\nif they were never in the schema: no render, no validation, no payload." }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "description": "Force every field readonly — a display-only render of this form's own layout/widths.", "attribute": "readonly" }, { "kind": "field", "name": "edits", "type": { "text": "Record" }, "privacy": "private", "default": "{}", "description": "Edits the user made since the host last set `value` (controlled overlay)." }, { "kind": "field", "name": "errors", "type": { "text": "ValidationError[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "scriptStates", "type": { "text": "Record" }, "privacy": "private", "default": "{}", "description": "Per-field overrides set by scripts — layered over `fieldStates` (script wins)." }, { "kind": "field", "name": "fieldMessages", "type": { "text": "Record" }, "privacy": "private", "default": "{}", "description": "showFieldMsg() messages, one per field." }, { "kind": "field", "name": "formMessages", "type": { "text": "ScriptMessage[]" }, "privacy": "private", "default": "[]", "description": "addErrorMessage()/addInfoMessage() — reset at the start of every submit pass." }, { "kind": "field", "name": "referenceLabels", "privacy": "private", "default": "new Map()", "description": "Read-only view: labels of reference ids, keyed `lookup\\u0000id` (resolved async)." }, { "kind": "field", "name": "referenceResolving", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "warnedLookups", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "scriptContext", "type": { "text": "ScriptContext | null" }, "privacy": "private", "default": "null", "description": "The `g` handed to scripts; rebuilt when `form` changes." }, { "kind": "field", "name": "scriptContextForm", "type": { "text": "FormDefinition | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "scriptDepth", "type": { "text": "number" }, "privacy": "private", "default": "0", "description": "Depth of the current setValue -> change-script cascade." }, { "kind": "field", "name": "loadedForm", "type": { "text": "FormDefinition | null" }, "privacy": "private", "default": "null", "description": "The `form` identity `load` scripts last ran for." }, { "kind": "field", "name": "dynamicOptions", "privacy": "private", "default": "new Map()", "description": "Resolved dynamic options + the dep snapshot / fetch epoch they belong to." }, { "kind": "field", "name": "optionsSnapshots", "privacy": "private", "default": "new Map()" }, { "kind": "field", "name": "optionsEpoch", "privacy": "private", "default": "new Map()" }, { "kind": "field", "name": "warnedViews", "privacy": "private", "default": "new Set()", "description": "Unknown `view` values already warned about — avoid re-warning on every render." }, { "kind": "field", "name": "flagCache", "type": { "text": "{ form?: FormDefinition; flags?: FeatureFlags; out?: FormDefinition }" }, "privacy": "private", "default": "{}", "description": "applyFlags result, memoized on (form, flags) identity." }, { "kind": "field", "name": "assignedForm", "type": { "text": "FormDefinition | undefined" }, "privacy": "private", "description": "`form` as the host may actually have left it: a framework can connect the element\nbefore it binds the property, so internally it is optional until then.", "readonly": true }, { "kind": "field", "name": "effectiveForm", "type": { "text": "FormDefinition | undefined" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "syncDynamicOptions", "privacy": "private", "return": { "type": { "text": "void" } }, "description": "Refetch `options_from` options whose dep snapshot changed. Sync fetchers\nland immediately; async ones re-render on resolve (stale responses are\ndropped by epoch)." }, { "kind": "method", "name": "clearDependents", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "changedKey", "type": { "text": "string" } } ], "description": "A user edit invalidates every field whose options_deps include the edited\nkey — their values reset to defaults, cascading down chains\n(province -> district -> subdistrict)." }, { "kind": "field", "name": "sortedFields", "type": { "text": "FieldDescriptor[]" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "lastVisible", "type": { "text": "Record" }, "privacy": "private", "default": "{}", "description": "Visibility as of the last completed render, by key. A field that was\nhidden there and is visible now gets `baht-field--revealed` for one\nrender so the stylesheet can fade it in; fields visible from the first\nrender never animate (a form should not shimmer on mount)." }, { "kind": "field", "name": "nextVisible", "type": { "text": "Record" }, "privacy": "private", "default": "{}" }, { "kind": "method", "name": "revealClass", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "visible", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "stateFor", "privacy": "private", "return": { "type": { "text": "DerivedFieldState" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } } ] }, { "kind": "method", "name": "rowStatesFor", "privacy": "private", "return": { "type": { "text": "Record" } }, "parameters": [ { "name": "key", "type": { "text": "string" } } ], "description": "The row sub-field states of one repeater: `fieldStates` keys starting `key[`." }, { "kind": "method", "name": "valueFor", "privacy": "private", "return": { "type": { "text": "unknown" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } } ] }, { "kind": "method", "name": "flushTyped", "privacy": "private", "return": { "type": { "text": "void" } }, "description": "Debounced keystrokes still in a control land in `edits` before anyone reads them." }, { "kind": "method", "name": "getData", "return": { "type": { "text": "Record" } } }, { "kind": "method", "name": "setValue", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "patch", "type": { "text": "Record" } } ], "description": "Merge values programmatically. Runs each key's `change` scripts (like\nServiceNow's g_form.setValue) but emits no `baht-change` — the host\nalready knows, and a store adapter would otherwise loop." }, { "kind": "method", "name": "runValidators", "privacy": "private", "return": { "type": { "text": "ValidationError[]" } }, "description": "Declarative + registry validators over the visible fields (no scripts)." }, { "kind": "method", "name": "validate", "return": { "type": { "text": "{ valid: boolean; errors: ValidationError[] }" } }, "description": "Full validation pass: validators, then `submit` scripts (spec 01 §14). A\nscript returning `false` blocks; its `addErrorMessage()` calls become\n`{ key: '$' }` errors so hosts see why." }, { "kind": "method", "name": "reset", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "g", "privacy": "private", "return": { "type": { "text": "ScriptContext" } }, "parameters": [ { "name": "form", "type": { "text": "FormDefinition" } } ], "description": "The `g` (g_form) for the current form — built lazily over this component's state." }, { "kind": "method", "name": "applyScriptValue", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "value", "type": { "text": "unknown" } } ], "description": "A script wrote a value: same path as a user edit (emit + cascade), minus the formatter." }, { "kind": "method", "name": "runChangeScripts", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "oldValue", "type": { "text": "unknown" } }, { "name": "newValue", "type": { "text": "unknown" } }, { "name": "isLoading", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "runLoadScripts", "privacy": "private", "return": { "type": { "text": "void" } }, "description": "Form load (ServiceNow order): every field's `change` scripts with\nisLoading=true, then the `load` scripts. Once per `form` identity — a\nworkflow reuses this element across steps, so each step loads." }, { "kind": "method", "name": "onFieldInput", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } }, { "name": "e", "type": { "text": "Event" } } ] }, { "kind": "method", "name": "validateOneField", "privacy": "private", "return": { "type": { "text": "ValidationError[]" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } } ], "description": "Validate a single field against current form data (siblings included)." }, { "kind": "method", "name": "onFieldBlur", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } } ], "description": "`validateOn: 'blur'` — validate just the field the user left, same as\nhow errors are shown elsewhere (merged into `this.errors`, painted by\n`renderField`/`.baht-error`). No-op for 'change'/'submit' modes." }, { "kind": "method", "name": "renderField", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } } ] }, { "kind": "method", "name": "lookupFor", "privacy": "private", "return": { "type": { "text": "FieldReferenceLookup | null" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } } ], "description": "`registry.references[field.reference]`, with `search` bound to the form's current data." }, { "kind": "method", "name": "referenceText", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } }, { "name": "id", "type": { "text": "string" } } ], "description": "Read-only view of a reference: its resolved label once known, the raw id until then." }, { "kind": "method", "name": "uploaderFor", "privacy": "private", "return": { "type": { "text": "NonNullable[string] | undefined" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } } ] }, { "kind": "method", "name": "renderFieldMsg", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "msg", "type": { "text": "{ type: string; message: string }" } } ] }, { "kind": "method", "name": "onControlInput", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "key", "type": { "text": "string" } }, { "name": "e", "type": { "text": "Event" } } ], "description": "Resolve the descriptor at event time — it may have changed since the control\nwas first rendered (the same node is reused across renders, see render())." }, { "kind": "method", "name": "renderReadonlyFiles", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "items", "type": { "text": "{ name: string; url: string | null }[]" } } ], "description": "Uploaded files in read-only mode: each a download link when it has a safe url." }, { "kind": "method", "name": "renderReadonlyBody", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } }, { "name": "shown", "type": { "text": "DisplayValue" } } ], "description": "The value part of a read-only field, by how `displayValue` says it reads." }, { "kind": "method", "name": "renderReadonlyField", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "field", "type": { "text": "FieldDescriptor" } }, { "name": "width", "type": { "text": "string" } }, { "name": "visible", "type": { "text": "boolean" } } ] }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "events": [ { "name": "baht-validity", "type": { "text": "CustomEvent" } }, { "name": "baht-change", "type": { "text": "CustomEvent" } }, { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "show-optional", "type": { "text": "boolean" }, "default": "false", "description": "Label every non-required field \"(optional)\" (localized) instead of relying on asterisks alone.", "fieldName": "showOptional" }, { "name": "view", "type": { "text": "string | undefined | undefined" }, "description": "Name of a view from `form.views`. Display-only: when set, only that view's\nfields are rendered and validated (the user can only fix what they see),\nbut getData() still returns the FULL form — the server always validates\nthe complete schema, views never change the submit payload.", "fieldName": "view" }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "description": "Force every field readonly — a display-only render of this form's own layout/widths.", "fieldName": "readonly" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "tagName": "baht-form", "customElement": true }, { "kind": "variable", "name": "errors", "type": { "text": "ValidationError[]" }, "default": "[]" } ], "exports": [ { "kind": "js", "name": "BahtForm", "declaration": { "name": "BahtForm", "module": "src/components/baht-form.ts" } }, { "kind": "custom-element-definition", "name": "baht-form", "declaration": { "name": "BahtForm", "module": "src/components/baht-form.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/baht-workflow.ts", "declarations": [ { "kind": "class", "description": " — the optional brain (spec 03). Wraps the current form in an\ninternal , evaluates rules on every change, walks the visible forms\nin linear `order`, and owns the single Next/Submit button.\nForms with kind 'approval' render a decision step instead (spec 03 §4):\na summary of earlier answers plus Approve/Reject (+ optional comment); the\ndecision lands in data as `.decision` so rules can branch on it.\nThe runtime navigates; the host acts (on baht-next / baht-submit / baht-approve /\nbaht-reject / baht-complete).", "name": "BahtWorkflow", "members": [ { "kind": "field", "name": "workflow", "type": { "text": "WorkflowDefinition" } }, { "kind": "field", "name": "value", "type": { "text": "NestedData" }, "default": "{}" }, { "kind": "field", "name": "registry", "type": { "text": "Registry" }, "default": "{}" }, { "kind": "field", "name": "validateGate", "type": { "text": "boolean" }, "default": "true", "attribute": "validate-gate" }, { "kind": "field", "name": "nextLabel", "type": { "text": "string | undefined" }, "description": "Label attributes beat the i18n catalog; unset = t('next')/t('submit')/t('back').", "attribute": "next-label" }, { "kind": "field", "name": "submitLabel", "type": { "text": "string | undefined" }, "attribute": "submit-label" }, { "kind": "field", "name": "backLabel", "type": { "text": "string | undefined" }, "attribute": "back-label" }, { "kind": "field", "name": "showBack", "type": { "text": "boolean" }, "default": "true", "attribute": "show-back" }, { "kind": "field", "name": "direction", "type": { "text": "'forward' | 'back' | null" }, "privacy": "private", "default": "null", "description": "Which way the last navigation went. Stamped on the step wrapper as\n`baht-workflow-step--forward|--back` so the stylesheet can slide the new\nstep in from the matching side; null on first render (nothing to replay)." }, { "kind": "field", "name": "flags", "type": { "text": "FeatureFlags" }, "default": "{}", "description": "Feature-flag values (spec 01 §12): flag-off steps/fields/rules vanish." }, { "kind": "field", "name": "showSteps", "type": { "text": "boolean" }, "default": "false", "description": "Render a progress indicator above the current form.", "attribute": "show-steps" }, { "kind": "field", "name": "stepsVariant", "type": { "text": "'default' | 'sidebar'" }, "default": "'default'", "description": "'default' horizontal markers, or 'sidebar' vertical nav list — forwarded to .", "attribute": "steps-variant" }, { "kind": "field", "name": "data", "type": { "text": "NestedData" }, "privacy": "private", "default": "{}" }, { "kind": "field", "name": "derived", "type": { "text": "Derived | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "current", "type": { "text": "string | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "approvalError", "type": { "text": "string | null" }, "privacy": "private", "default": "null" }, { "kind": "field", "name": "history", "type": { "text": "string[]" }, "privacy": "private", "default": "[]" }, { "kind": "field", "name": "currentFormName", "type": { "text": "string | null" }, "readonly": true }, { "kind": "field", "name": "flagCache", "type": { "text": "{\n workflow?: WorkflowDefinition;\n flags?: FeatureFlags;\n out?: WorkflowDefinition;\n }" }, "privacy": "private", "default": "{}", "description": "applyFlags result, memoized on (workflow, flags) identity." }, { "kind": "field", "name": "assignedWorkflow", "type": { "text": "WorkflowDefinition | undefined" }, "privacy": "private", "description": "`workflow` as the host may actually have left it: a framework can connect the\nelement before it binds the property, so internally it is optional until then.", "readonly": true }, { "kind": "field", "name": "effectiveWorkflow", "type": { "text": "WorkflowDefinition | undefined" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "reevaluate", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "visibleForms", "type": { "text": "WorkflowForm[]" }, "privacy": "private", "description": "Forms in ascending order whose derived visibility is true.", "readonly": true }, { "kind": "field", "name": "currentForm", "type": { "text": "WorkflowForm | null" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "navTarget", "type": { "text": "string" }, "privacy": "private", "description": "Where next() would go from here: a form_name or 'end' (spec 03 §6).", "readonly": true }, { "kind": "field", "name": "isLast", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "fieldStatesFor", "privacy": "private", "return": { "type": { "text": "Record" } }, "parameters": [ { "name": "form_name", "type": { "text": "string" } } ] }, { "kind": "field", "name": "formEl", "type": { "text": "BahtForm | null" }, "privacy": "private", "readonly": true }, { "kind": "method", "name": "getData", "return": { "type": { "text": "NestedData" } } }, { "kind": "method", "name": "setValue", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "form_name", "type": { "text": "string" } }, { "name": "patch", "type": { "text": "Record" } } ], "description": "Host/store write into one form's data — same path a user edit takes\n(rules reevaluate, `baht-data-change` fires) but WITHOUT the step reset\nthat re-feeding the `value` prop causes." }, { "kind": "method", "name": "next", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "advance", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "extraDetail", "default": "{}", "type": { "text": "Record" } } ], "description": "Advance past the current form: submit+complete at 'end', else step to navTarget." }, { "kind": "method", "name": "approve", "return": { "type": { "text": "void" } }, "description": "Approve the current approval step (same as pressing its Approve button)." }, { "kind": "method", "name": "reject", "return": { "type": { "text": "void" } }, "description": "Reject the current approval step (same as pressing its Reject button)." }, { "kind": "method", "name": "decide", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "decision", "type": { "text": "ApprovalDecision" } } ] }, { "kind": "method", "name": "gotoForm", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "form_name", "type": { "text": "string" } } ], "description": "Jump back to a visible form, truncating the history to that point." }, { "kind": "method", "name": "back", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "gotoStart", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "onFormChange", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "e", "type": { "text": "Event" } } ] }, { "kind": "method", "name": "onCommentInput", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "form_name", "type": { "text": "string" } }, { "name": "value", "type": { "text": "string" } } ] }, { "kind": "method", "name": "summary_forms", "privacy": "private", "return": { "type": { "text": "WorkflowForm[]" } }, "parameters": [ { "name": "approval", "type": { "text": "WorkflowForm" } } ], "description": "Forms the approval step summarizes: configured list, else every earlier plain form." }, { "kind": "method", "name": "renderApproval", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "form", "type": { "text": "WorkflowForm" } } ] }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "validate-gate", "type": { "text": "boolean" }, "default": "true", "fieldName": "validateGate" }, { "name": "next-label", "type": { "text": "string | undefined" }, "description": "Label attributes beat the i18n catalog; unset = t('next')/t('submit')/t('back').", "fieldName": "nextLabel" }, { "name": "submit-label", "type": { "text": "string | undefined" }, "fieldName": "submitLabel" }, { "name": "back-label", "type": { "text": "string | undefined" }, "fieldName": "backLabel" }, { "name": "show-back", "type": { "text": "boolean" }, "default": "true", "fieldName": "showBack" }, { "name": "show-steps", "type": { "text": "boolean" }, "default": "false", "description": "Render a progress indicator above the current form.", "fieldName": "showSteps" }, { "name": "steps-variant", "type": { "text": "'default' | 'sidebar'" }, "default": "'default'", "description": "'default' horizontal markers, or 'sidebar' vertical nav list — forwarded to .", "fieldName": "stepsVariant" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "tagName": "baht-workflow", "customElement": true, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] }, { "kind": "variable", "name": "comment" } ], "exports": [ { "kind": "js", "name": "BahtWorkflow", "declaration": { "name": "BahtWorkflow", "module": "src/components/baht-workflow.ts" } }, { "kind": "custom-element-definition", "name": "baht-workflow", "declaration": { "name": "BahtWorkflow", "module": "src/components/baht-workflow.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/base.ts", "declarations": [ { "kind": "function", "name": "arr", "return": { "type": { "text": "T[]" } }, "parameters": [ { "name": "value", "type": { "text": "T[] | null | undefined" } } ], "description": "Runtime guards for rich props. The TS type says `T[]` / `Record`, but hosts assign\nfrom JSON (`el.markers = json.markers`) and JS hosts pass `undefined` freely, so\nevery read goes through here instead of a `?? []` that the type-aware lint would\n(rightly, for TS callers) flag as unnecessary." }, { "kind": "function", "name": "obj", "return": { "type": { "text": "T | Record" } }, "parameters": [ { "name": "value", "type": { "text": "T | null | undefined" } } ] }, { "kind": "function", "name": "stringOf", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "value", "type": { "text": "unknown" } } ] }, { "kind": "function", "name": "hasDom", "return": { "type": { "text": "boolean" } }, "description": "True when a real DOM is present. Lit's own `isServer` is hard-coded to `true` in its\nnode build, which jsdom/happy-dom test runners also load, so guards that need \"is there\na document to touch\" feature-detect instead: the" }, { "kind": "variable", "name": "boolOff", "type": { "text": "object" }, "default": "{ fromAttribute: (value: string | null): boolean => value !== 'false', // null (absent) = default toAttribute: (value: boolean): string | null => (value ? '' : 'false'), }", "description": "Attribute converter for booleans that DEFAULT TO TRUE. Lit's own `type: Boolean` reads\n`show-close=\"false\"` as true (presence is all it checks), so a default-true switch could\nnever be turned off from HTML. With this: absent = default, bare = true, `=\"false\"` = false." }, { "kind": "variable", "name": "SSR_STASH", "type": { "text": "unique symbol" }, "description": "While a parent hydrates, the hydrate module parks each nested `baht-*` child's server\nmarkup under this key so the parent's hydration walk does not see the child's part\nmarkers. `hasSsrMarkup` treats a parked stash as \"still server-rendered\"." }, { "kind": "function", "name": "hasSsrMarkup", "return": { "type": { "text": "boolean" } }, "parameters": [ { "name": "host", "type": { "text": "Element" } } ], "description": "True while the element's light DOM still holds un-hydrated server-rendered Lit markup." }, { "kind": "class", "description": "Light-DOM Lit base: consumer CSS reaches every internal node (spec 01 §6).", "name": "BahtElement", "members": [ { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids)." }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary." } ], "events": [ { "name": "name", "type": { "text": "CustomEvent" } } ], "attributes": [ { "name": "defer-hydration" } ], "superclass": { "name": "LitElement", "package": "lit" }, "customElement": true }, { "kind": "function", "name": "adoptLightChildren", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "host", "type": { "text": "HTMLElement" } }, { "name": "slot", "type": { "text": "HTMLElement" } } ], "description": "Light DOM has no . Call from firstUpdated() to move author-supplied\nchildren into `slot` — everything that isn't the rendered `root` or a Lit\ncomment marker. (During HTML parsing children can land after\nconnectedCallback fires, so sweeping at first render is the reliable point.)" } ], "exports": [ { "kind": "js", "name": "arr", "declaration": { "name": "arr", "module": "src/components/base.ts" } }, { "kind": "js", "name": "obj", "declaration": { "name": "obj", "module": "src/components/base.ts" } }, { "kind": "js", "name": "stringOf", "declaration": { "name": "stringOf", "module": "src/components/base.ts" } }, { "kind": "js", "name": "hasDom", "declaration": { "name": "hasDom", "module": "src/components/base.ts" } }, { "kind": "js", "name": "boolOff", "declaration": { "name": "boolOff", "module": "src/components/base.ts" } }, { "kind": "js", "name": "SSR_STASH", "declaration": { "name": "SSR_STASH", "module": "src/components/base.ts" } }, { "kind": "js", "name": "hasSsrMarkup", "declaration": { "name": "hasSsrMarkup", "module": "src/components/base.ts" } }, { "kind": "js", "name": "BahtElement", "declaration": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "js", "name": "adoptLightChildren", "declaration": { "name": "adoptLightChildren", "module": "src/components/base.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/define.ts", "declarations": [ { "kind": "function", "name": "customElement", "parameters": [ { "name": "tag", "type": { "text": "string" } } ], "description": "Lit's `@customElement`, tolerating a tag being defined already. Module\nfederation or a duplicated dependency can load two copies of bank20baht-ui\ninto one page; the second copy keeps the first definition and warns\ninstead of throwing from `customElements.define`." } ], "exports": [ { "kind": "js", "name": "customElement", "declaration": { "name": "customElement", "module": "src/components/define.ts" } }, { "kind": "custom-element-definition", "name": "tag", "declaration": { "name": "cls", "module": "src/components/define.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/field-base.ts", "declarations": [ { "kind": "class", "description": "Shared shape of every field primitive: descriptor + value in, `baht-input` out.\nDumb and controlled — never mutates its own `value` prop; the host re-feeds it.\n\n`controlId` carries the base class `uid`: the same field key renders once per repeater\nrow (and can repeat across forms on one page), so key-only ids collide — worst for\nradios, whose shared native `name` merges groups.", "name": "BahtFieldBase", "members": [ { "kind": "field", "name": "defaultDebounce", "type": { "text": "number" }, "static": true, "default": "150", "description": "Default trailing debounce (ms) for TYPED edits — text, email, password,\ntextarea, number. Every keystroke otherwise re-runs the host's rules,\nvalidation and dependent-option fetches. Per element: the `debounce`\nproperty/attribute; `` sets it for a whole\nform. 0 = emit on every keystroke. Selects, checkboxes, radios, toggles,\ndates and files are never debounced — a pick is one event." }, { "kind": "field", "name": "field", "type": { "text": "FieldDescriptor" } }, { "kind": "field", "name": "value", "type": { "text": "unknown" }, "default": "null" }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled" }, { "kind": "field", "name": "readonly", "type": { "text": "boolean" }, "default": "false", "attribute": "readonly" }, { "kind": "field", "name": "required", "type": { "text": "boolean" }, "default": "false", "attribute": "required" }, { "kind": "field", "name": "showOptional", "type": { "text": "boolean" }, "default": "false", "description": "Append the localized \"(optional)\" marker to the label when not required (set by ).", "attribute": "show-optional" }, { "kind": "field", "name": "error", "type": { "text": "string | null" }, "default": "null" }, { "kind": "field", "name": "debounce", "type": { "text": "number | undefined" }, "description": "Debounce for typed edits (ms); unset = BahtFieldBase.defaultDebounce.", "attribute": "debounce" }, { "kind": "field", "name": "typed", "type": { "text": "{ value: unknown; emitted: boolean } | null" }, "privacy": "private", "default": "null", "description": "The keystrokes not yet (or just) handed to the host. The control keeps\nrendering `typed.value` until the host's `value` moves, so a re-render\nmid-typing (a sibling field changing) can't snap the text back." }, { "kind": "field", "name": "typedTimer", "type": { "text": "ReturnType | undefined" }, "privacy": "private" }, { "kind": "field", "name": "onFocusOut", "privacy": "private", "readonly": true }, { "kind": "field", "name": "effectiveDebounce", "type": { "text": "number" }, "privacy": "protected", "readonly": true }, { "kind": "method", "name": "emitTyped", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "unknown" } } ], "description": "A typed edit: emitted after `debounce` ms of quiet (or at once when 0)." }, { "kind": "method", "name": "flushTyped", "return": { "type": { "text": "void" } }, "description": "Hand a pending typed edit to the host now (blur, disconnect, host reads). Idempotent." }, { "kind": "field", "name": "shownValue", "type": { "text": "unknown" }, "privacy": "protected", "description": "What a typed control shows: pending keystrokes win over a stale host value.", "readonly": true }, { "kind": "field", "name": "shownText", "type": { "text": "string" }, "privacy": "protected", "description": "`shownValue` as control text: `''` for null/undefined, `String()` otherwise.", "readonly": true }, { "kind": "field", "name": "assignedField", "type": { "text": "FieldDescriptor | undefined" }, "privacy": "protected", "description": "`field` as the host may actually have left it: a framework can connect the element\nbefore it binds the descriptor, so internally it is optional until then.", "readonly": true }, { "kind": "method", "name": "emitInput", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "value", "type": { "text": "unknown" } } ], "description": "Emit the user's edit upward (composed so it crosses any boundary)." }, { "kind": "method", "name": "renderControl", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } } }, { "kind": "field", "name": "hasFieldIcon", "type": { "text": "boolean" }, "privacy": "protected", "description": "True when `field.icon` names a real icon — gates both the icon markup\nand the control's icon-padding class, so a typo/removed name never\nleaves the control indented for a glyph that isn't there.", "readonly": true }, { "kind": "method", "name": "renderFieldIcon", "privacy": "protected", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "description": "Leading icon for text/currency/textarea/dropdown controls (spec: field.icon)." }, { "kind": "method", "name": "renderLabel", "privacy": "protected", "return": { "type": { "text": "TemplateResult | typeof nothing" } } }, { "kind": "method", "name": "renderLabelMark", "privacy": "protected", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "description": "Required asterisk, or the \"(optional)\" marker when the form asks for it." }, { "kind": "field", "name": "controlId", "type": { "text": "string" }, "privacy": "protected", "readonly": true }, { "kind": "field", "name": "labelId", "type": { "text": "string" }, "privacy": "protected", "readonly": true }, { "kind": "field", "name": "errorId", "type": { "text": "string" }, "privacy": "protected", "readonly": true }, { "kind": "field", "name": "helpId", "type": { "text": "string" }, "privacy": "protected", "readonly": true }, { "kind": "field", "name": "describedBy", "type": { "text": "string | typeof nothing" }, "privacy": "protected", "description": "id list for the control's aria-describedby: error first, then help.", "readonly": true }, { "kind": "field", "name": "invalidAttr", "type": { "text": "string | typeof nothing" }, "privacy": "protected", "description": "'true' while the field is in error, else absent (styles hook on [aria-invalid]).", "readonly": true }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "fieldName": "disabled" }, { "name": "readonly", "type": { "text": "boolean" }, "default": "false", "fieldName": "readonly" }, { "name": "required", "type": { "text": "boolean" }, "default": "false", "fieldName": "required" }, { "name": "show-optional", "type": { "text": "boolean" }, "default": "false", "description": "Append the localized \"(optional)\" marker to the label when not required (set by ).", "fieldName": "showOptional" }, { "name": "debounce", "type": { "text": "number | undefined" }, "description": "Debounce for typed edits (ms); unset = BahtFieldBase.defaultDebounce.", "fieldName": "debounce" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] } ], "exports": [ { "kind": "js", "name": "BahtFieldBase", "declaration": { "name": "BahtFieldBase", "module": "src/components/field-base.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/layers.ts", "declarations": [ { "kind": "function", "name": "pushLayer", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "el", "type": { "text": "HTMLElement" } } ] }, { "kind": "function", "name": "dropLayer", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "el", "type": { "text": "HTMLElement" } } ] }, { "kind": "function", "name": "topLayer", "return": { "type": { "text": "HTMLElement | null" } }, "description": "The topmost open layer, or `null` when none is open." } ], "exports": [ { "kind": "js", "name": "pushLayer", "declaration": { "name": "pushLayer", "module": "src/components/layers.ts" } }, { "kind": "js", "name": "dropLayer", "declaration": { "name": "dropLayer", "module": "src/components/layers.ts" } }, { "kind": "js", "name": "topLayer", "declaration": { "name": "topLayer", "module": "src/components/layers.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/menu-controller.ts", "declarations": [ { "kind": "class", "description": "The ARIA menu behind `` and ``: open state, outside click,\nAPG menu-button keyboard (↓/↑/Enter/Space open on the first/last item; ↑ ↓ wrap and skip\ndisabled; Home/End; Escape closes back to the trigger and is marked handled so a surrounding\n`` stays open; Tab closes), item rendering with shortcut hints, and page-wide\nitem shortcuts (same scoping as ``).", "name": "MenuController", "members": [ { "kind": "field", "name": "open", "type": { "text": "boolean" }, "default": "false" }, { "kind": "field", "name": "mac", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "unbinders", "type": { "text": "(() => void)[]" }, "privacy": "private", "default": "[]" }, { "kind": "method", "name": "hostConnected", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "hostDisconnected", "return": { "type": { "text": "void" } } }, { "kind": "method", "name": "rebind", "return": { "type": { "text": "void" } }, "description": "Re-register item shortcuts — call when `items` changes." }, { "kind": "method", "name": "unbindAll", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "onDocMousedown", "privacy": "private", "readonly": true }, { "kind": "method", "name": "setOpen", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "open", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "pick", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "item", "type": { "text": "MenuItem" } } ] }, { "kind": "method", "name": "enabledButtons", "privacy": "private", "return": { "type": { "text": "HTMLButtonElement[]" } } }, { "kind": "method", "name": "openAndFocus", "privacy": "private", "return": { "type": { "text": "Promise" } }, "parameters": [ { "name": "which", "type": { "text": "'first' | 'last'" } } ] }, { "kind": "field", "name": "onTriggerClick", "readonly": true, "description": "Trigger click: keyboard activation (detail 0) lands on the first item, per the APG." }, { "kind": "field", "name": "onTriggerKeydown", "readonly": true }, { "kind": "field", "name": "onMenuKeydown", "privacy": "private", "readonly": true }, { "kind": "method", "name": "renderItem", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "item", "type": { "text": "MenuItem" } } ] } ] } ], "exports": [ { "kind": "js", "name": "MenuController", "declaration": { "name": "MenuController", "module": "src/components/menu-controller.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/motion.ts", "declarations": [ { "kind": "function", "name": "afterExit", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "el", "type": { "text": "Element" } }, { "name": "done", "type": { "text": "() => void" } } ], "description": "Call `done` once the CSS animations currently running on `el` (or inside\nit) have finished — or right away when none play: `prefers-reduced-motion`\n(the stylesheet sets `animation: none`), a host without the tokens\nstylesheet, or a DOM without the Web Animations API (happy-dom). Add the\n`--leaving` class BEFORE calling this so the exit keyframes are the ones\nbeing waited on." } ], "exports": [ { "kind": "js", "name": "afterExit", "declaration": { "name": "afterExit", "module": "src/components/motion.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/shortcuts.ts", "declarations": [ { "kind": "function", "name": "isMacPlatform", "return": { "type": { "text": "boolean" } }, "description": "Apple platform (⌘ = `mod`, ⌃⌥⇧⌘ glyphs). Client-only; `false` without a DOM." }, { "kind": "function", "name": "bindShortcut", "return": { "type": { "text": "() => void" } }, "parameters": [ { "name": "host", "type": { "text": "HTMLElement" } }, { "name": "spec", "type": { "text": "string" } }, { "name": "run", "type": { "text": "() => void" } }, { "name": "enabled", "default": "() => true", "type": { "text": "() => boolean" } } ], "description": "Bind `spec` for `host`; returns the unbind function. An unparseable spec binds nothing.\nCall from `connectedCallback`/`updated` and unbind on disconnect." } ], "exports": [ { "kind": "js", "name": "isMacPlatform", "declaration": { "name": "isMacPlatform", "module": "src/components/shortcuts.ts" } }, { "kind": "js", "name": "bindShortcut", "declaration": { "name": "bindShortcut", "module": "src/components/shortcuts.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/primitives/baht-accordion.ts", "declarations": [ { "kind": "class", "description": "Accordion. `items` drive the panels; `multiple` allows several open at once.\nEmits `baht-toggle { index, open }`.\n\n el.items = [\n { title: 'What is a workflow?', content: 'Workflows run when something happens…' },\n { title: 'Pricing', content: '฿20 / month.', open: true },\n ];", "name": "BahtAccordion", "members": [ { "kind": "field", "name": "items", "type": { "text": "AccordionItem[]" }, "default": "[]" }, { "kind": "field", "name": "multiple", "type": { "text": "boolean" }, "default": "false", "attribute": "multiple" }, { "kind": "field", "name": "openSet", "privacy": "private", "default": "new Set()" }, { "kind": "field", "name": "itemsFingerprint", "type": { "text": "string" }, "privacy": "private", "default": "''", "description": "Fingerprint of the panel content and open flags — identity-independent, so an equal\nre-fed array doesn't look like a \"new\" set of items." }, { "kind": "method", "name": "fingerprint", "privacy": "private", "static": true, "return": { "type": { "text": "string" } }, "parameters": [ { "name": "items", "type": { "text": "AccordionItem[]" } } ] }, { "kind": "method", "name": "toggle", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "index", "type": { "text": "number" } } ] }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "multiple", "type": { "text": "boolean" }, "default": "false", "fieldName": "multiple" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "tagName": "baht-accordion", "customElement": true, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] } ], "exports": [ { "kind": "js", "name": "BahtAccordion", "declaration": { "name": "BahtAccordion", "module": "src/components/primitives/baht-accordion.ts" } }, { "kind": "custom-element-definition", "name": "baht-accordion", "declaration": { "name": "BahtAccordion", "module": "src/components/primitives/baht-accordion.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/primitives/baht-alert.ts", "declarations": [ { "kind": "class", "description": "Inline alert / callout.\n\n ", "name": "BahtAlert", "members": [ { "kind": "field", "name": "tone", "type": { "text": "'info' | 'success' | 'warning' | 'danger'" }, "default": "'info'", "attribute": "tone" }, { "kind": "field", "name": "heading", "type": { "text": "string" }, "default": "''", "attribute": "heading" }, { "kind": "field", "name": "message", "type": { "text": "string" }, "default": "''", "attribute": "message" }, { "kind": "field", "name": "dismissible", "type": { "text": "boolean" }, "default": "false", "attribute": "dismissible" }, { "kind": "field", "name": "dismissed", "type": { "text": "boolean" }, "privacy": "private", "default": "false" }, { "kind": "field", "name": "generation", "type": { "text": "number" }, "privacy": "private", "default": "0" }, { "kind": "method", "name": "dismiss", "privacy": "private", "return": { "type": { "text": "void" } } }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "tone", "type": { "text": "'info' | 'success' | 'warning' | 'danger'" }, "default": "'info'", "fieldName": "tone" }, { "name": "heading", "type": { "text": "string" }, "default": "''", "fieldName": "heading" }, { "name": "message", "type": { "text": "string" }, "default": "''", "fieldName": "message" }, { "name": "dismissible", "type": { "text": "boolean" }, "default": "false", "fieldName": "dismissible" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "tagName": "baht-alert", "customElement": true, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] } ], "exports": [ { "kind": "js", "name": "BahtAlert", "declaration": { "name": "BahtAlert", "module": "src/components/primitives/baht-alert.ts" } }, { "kind": "custom-element-definition", "name": "baht-alert", "declaration": { "name": "BahtAlert", "module": "src/components/primitives/baht-alert.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/primitives/baht-avatar.ts", "declarations": [ { "kind": "class", "description": "Small circular identity chip — initials derived from `label`, or an\nexplicit `initials` override.\n\n \n ", "name": "BahtAvatar", "members": [ { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "''", "description": "Full name; initials are derived from it when `initials` isn't set.", "attribute": "label" }, { "kind": "field", "name": "initials", "type": { "text": "string" }, "default": "''", "description": "Explicit override — first 1-2 characters are shown as-is.", "attribute": "initials" }, { "kind": "field", "name": "size", "type": { "text": "AvatarSize" }, "default": "'md'", "attribute": "size" }, { "kind": "field", "name": "shown", "type": { "text": "string" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "label", "type": { "text": "string" }, "default": "''", "description": "Full name; initials are derived from it when `initials` isn't set.", "fieldName": "label" }, { "name": "initials", "type": { "text": "string" }, "default": "''", "description": "Explicit override — first 1-2 characters are shown as-is.", "fieldName": "initials" }, { "name": "size", "type": { "text": "AvatarSize" }, "default": "'md'", "fieldName": "size" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "tagName": "baht-avatar", "customElement": true, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] } ], "exports": [ { "kind": "js", "name": "BahtAvatar", "declaration": { "name": "BahtAvatar", "module": "src/components/primitives/baht-avatar.ts" } }, { "kind": "custom-element-definition", "name": "baht-avatar", "declaration": { "name": "BahtAvatar", "module": "src/components/primitives/baht-avatar.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/primitives/baht-badge.ts", "declarations": [ { "kind": "class", "description": "Status pill / tag / counter (20baht badges).\nStatus tones (neutral/success/danger/warning/info) show a colored dot;\ntag tones (outline/solid/gold/inverse/mono) don't.\n\n \n ", "name": "BahtBadge", "members": [ { "kind": "field", "name": "tone", "type": { "text": "BadgeTone" }, "default": "'neutral'", "attribute": "tone" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "''", "attribute": "label" }, { "kind": "field", "name": "dot", "type": { "text": "boolean | null" }, "default": "null", "description": "Force the dot on/off; defaults to on for status tones." }, { "kind": "field", "name": "showDot", "type": { "text": "boolean" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "tone", "type": { "text": "BadgeTone" }, "default": "'neutral'", "fieldName": "tone" }, { "name": "label", "type": { "text": "string" }, "default": "''", "fieldName": "label" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "tagName": "baht-badge", "customElement": true, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] } ], "exports": [ { "kind": "js", "name": "BahtBadge", "declaration": { "name": "BahtBadge", "module": "src/components/primitives/baht-badge.ts" } }, { "kind": "custom-element-definition", "name": "baht-badge", "declaration": { "name": "BahtBadge", "module": "src/components/primitives/baht-badge.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/primitives/baht-bar-chart.ts", "declarations": [ { "kind": "class", "description": "", "name": "BahtBarChart", "members": [ { "kind": "field", "name": "groups", "type": { "text": "ChartGroup[]" }, "default": "[]", "description": "Original API: `{ label, count }[]`, one bar each." }, { "kind": "field", "name": "series", "type": { "text": "ChartSeries[]" }, "default": "[]", "description": "Series API: one entry per series, one value per category." }, { "kind": "field", "name": "categories", "type": { "text": "string[]" }, "default": "[]", "description": "Category names, one per value index." }, { "kind": "field", "name": "orientation", "type": { "text": "'horizontal' | 'vertical'" }, "default": "'horizontal'", "description": "Bars across (default) or columns up.", "attribute": "orientation" }, { "kind": "field", "name": "stacked", "type": { "text": "boolean" }, "default": "false", "description": "Stack the series inside one band instead of grouping them side by side.", "attribute": "stacked" }, { "kind": "field", "name": "compare", "type": { "text": "number[]" }, "default": "[]", "description": "Previous-period values, drawn as a muted bar under each current bar." }, { "kind": "field", "name": "compareLabel", "type": { "text": "string" }, "default": "'Previous period'", "description": "Names the muted `compare` bar in the key and the table twin.", "attribute": "compare-label" }, { "kind": "field", "name": "markers", "type": { "text": "ChartMarker[]" }, "default": "[]", "description": "Budget / target lines drawn over the bars." }, { "kind": "field", "name": "labelValues", "type": { "text": "'ends' | 'none'" }, "default": "'ends'", "description": "`ends` prints the value at the bar tip; `none` leaves it to the tooltip.", "attribute": "label-values" }, { "kind": "field", "name": "emphasis", "type": { "text": "number | null" }, "default": "null", "description": "Index of the series (2+ series) or category (one series) to highlight.", "attribute": "emphasis" }, { "kind": "field", "name": "color", "type": { "text": "string" }, "default": "''", "description": "Single color for every bar; per-series palette otherwise.", "attribute": "color" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "''", "description": "Accessible summary used by the vertical (graphics-only) rendering.", "attribute": "label" }, { "kind": "field", "name": "band", "type": { "text": "number" }, "privacy": "private", "default": "0", "description": "Measured px per category for the vertical rendering; `0` until the host has\nbeen measured, where the CSS flex fallback (`flex: 1 1 0; min-width: 0`)\nalready keeps the columns inside the host. Measuring lets the element also\nthin the x labels and shrink the bars below the 24px cap, so 31 days fit a\n400px card instead of spilling out of it." }, { "kind": "field", "name": "resizeObserver", "type": { "text": "ResizeObserver | undefined" }, "privacy": "private" }, { "kind": "method", "name": "measure", "privacy": "private", "return": { "type": { "text": "void" } }, "description": "Host width → px per category. Never runs on the server (`hasDom` guard)." }, { "kind": "field", "name": "columnCount", "type": { "text": "number" }, "privacy": "private", "readonly": true }, { "kind": "field", "name": "model", "type": { "text": "{ series: ChartSeries[]; categories: string[]; legacy: boolean }" }, "privacy": "private", "description": "The series actually drawn — `groups` is normalised into one series.", "readonly": true }, { "kind": "method", "name": "colorFor", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "seriesIndex", "type": { "text": "number" } }, { "name": "categoryIndex", "type": { "text": "number" } }, { "name": "multi", "type": { "text": "boolean" } } ] }, { "kind": "method", "name": "domainMax", "privacy": "private", "return": { "type": { "text": "number" } }, "parameters": [ { "name": "series", "type": { "text": "ChartSeries[]" } }, { "name": "stacked", "type": { "text": "boolean" } }, { "name": "legacy", "type": { "text": "boolean" } } ], "description": "Largest value a bar can reach: the raw max for `groups`, a clean tick otherwise." }, { "kind": "method", "name": "tableTwin", "privacy": "private", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "series", "type": { "text": "ChartSeries[]" } }, { "name": "categories", "type": { "text": "string[]" } }, { "name": "n", "type": { "text": "number" } } ] }, { "kind": "method", "name": "markersFor", "privacy": "private", "return": { "type": { "text": "ChartMarker[]" } }, "parameters": [ { "name": "category", "type": { "text": "string" } } ], "description": "Markers with no `category` span the chart; the rest ride their own row." }, { "kind": "field", "name": "chartMarkers", "type": { "text": "ChartMarker[]" }, "privacy": "private", "description": "Markers that apply to every row / column.", "readonly": true }, { "kind": "method", "name": "categoryMarkers", "privacy": "private", "return": { "type": { "text": "ChartMarker[]" } }, "parameters": [ { "name": "category", "type": { "text": "string" } } ], "description": "Markers pinned to one category — they ride that row / column, not the chart." }, { "kind": "method", "name": "markerText", "privacy": "private", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "m", "type": { "text": "ChartMarker" } } ], "description": "What a marker reads as: its own label, else its formatted value." }, { "kind": "method", "name": "markerOverlay", "privacy": "private", "return": { "type": { "text": "TemplateResult[]" } }, "parameters": [ { "name": "max", "type": { "text": "number" } }, { "name": "category", "type": { "text": "string" } } ], "description": "Marker lines, positioned along the value axis. The label is drawn separately\n(`markerLabels`) as real text — a `title` attribute alone never reaches AT." }, { "kind": "method", "name": "place", "privacy": "private", "return": { "type": { "text": "{ m: ChartMarker; pct: number }[]" } }, "parameters": [ { "name": "markers", "type": { "text": "ChartMarker[]" } }, { "name": "max", "type": { "text": "number" } } ], "description": "Marker labels, sorted along the axis and thinned so neighbours never collide:\na dropped label keeps its line, and its value still reads in the table twin.\nThinning is scoped to the list it is given — chart-wide markers compete with\neach other, a row's own markers only with that row's." }, { "kind": "method", "name": "placedMarkers", "privacy": "private", "return": { "type": { "text": "{ m: ChartMarker; pct: number }[]" } }, "parameters": [ { "name": "max", "type": { "text": "number" } } ], "description": "Chart-wide marker labels — the strip above the rows / the end of the line." }, { "kind": "method", "name": "rowMarkerLabels", "privacy": "private", "return": { "type": { "text": "TemplateResult[]" } }, "parameters": [ { "name": "category", "type": { "text": "string" } }, { "name": "max", "type": { "text": "number" } } ], "description": "A row's own marker labels, drawn beside their line inside that row." }, { "kind": "method", "name": "legendEntries", "privacy": "private", "return": { "type": { "text": "{ label: string; color: string }[]" } }, "parameters": [ { "name": "series", "type": { "text": "ChartSeries[]" } } ], "description": "Legend rows: one per series, plus the muted `compare` key when it is set." }, { "kind": "method", "name": "renderHorizontal", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "data", "type": { "text": "{\n series: ChartSeries[];\n categories: string[];\n legacy: boolean;\n }" } } ] }, { "kind": "method", "name": "renderVertical", "privacy": "private", "return": { "type": { "text": "TemplateResult" } }, "parameters": [ { "name": "data", "type": { "text": "{\n series: ChartSeries[];\n categories: string[];\n legacy: boolean;\n }" } } ] }, { "kind": "field", "name": "emptyMessage", "type": { "text": "string" }, "default": "'No data to chart'", "description": "Shown instead of the marks when there is nothing to plot.", "attribute": "empty-message", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "field", "name": "loading", "type": { "text": "boolean" }, "default": "false", "description": "Hold the previous render at reduced opacity while new data loads.", "attribute": "loading", "reflects": true, "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "field", "name": "showTable", "type": { "text": "boolean" }, "default": "true", "description": "Render the \"View as table\" twin under the chart.", "attribute": "show-table", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "field", "name": "format", "type": { "text": "ChartFormat" }, "default": "'number'", "description": "How values are rendered in labels, ticks, tooltips and the table twin.", "attribute": "format", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "field", "name": "currency", "type": { "text": "string" }, "default": "'THB'", "description": "ISO currency code for `format=\"currency\"` (THB renders `฿`).", "attribute": "currency", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "field", "name": "tipEl", "type": { "text": "HTMLElement | undefined" }, "privacy": "private", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "field", "name": "held", "type": { "text": "unknown" }, "privacy": "private", "default": "null", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "fmt", "privacy": "protected", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "value", "type": { "text": "number" } } ], "description": "Value → display text using this chart's `format` / `currency`.", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "hold", "privacy": "protected", "return": { "type": { "text": "T" } }, "parameters": [ { "name": "next", "type": { "text": "T" } } ], "description": "The snapshot to draw. While `loading` is set the previous one is returned,\nso a refetch dims the chart instead of emptying it.", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "rootClass", "privacy": "protected", "return": { "type": { "text": "string" } }, "parameters": [ { "name": "extra", "type": { "text": "string" } } ], "description": "Root class list: `baht-chart` plus the loading modifier.", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "renderTooltip", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "The single floating tooltip node; rendered by the template, never appended.", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "showTip", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "event", "type": { "text": "Event" } }, { "name": "text", "type": { "text": "string" } } ], "description": "Show `text` near the pointer (or, on keyboard focus, near the mark).\nContent is assigned with `textContent`: category and series names are\nuntrusted data (interaction.md).", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "hideTip", "privacy": "protected", "return": { "type": { "text": "void" } }, "description": "Hide the tooltip (pointerleave / blur).", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "renderEmpty", "privacy": "protected", "return": { "type": { "text": "TemplateResult" } }, "description": "The empty placeholder, or `nothing` when there is data.", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "method", "name": "renderLegend", "privacy": "protected", "return": { "type": { "text": "TemplateResult | typeof nothing" } }, "parameters": [ { "name": "entries", "type": { "text": "{ label: string; color: string; value?: string; share?: string }[]" } }, { "name": "kind", "default": "'rect'", "type": { "text": "'rect' | 'line'" } } ], "description": "Legend rows — only ever rendered for 2+ series (marks-and-anatomy.md).", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "orientation", "type": { "text": "'horizontal' | 'vertical'" }, "default": "'horizontal'", "description": "Bars across (default) or columns up.", "fieldName": "orientation" }, { "name": "stacked", "type": { "text": "boolean" }, "default": "false", "description": "Stack the series inside one band instead of grouping them side by side.", "fieldName": "stacked" }, { "name": "compare-label", "type": { "text": "string" }, "default": "'Previous period'", "description": "Names the muted `compare` bar in the key and the table twin.", "fieldName": "compareLabel" }, { "name": "label-values", "type": { "text": "'ends' | 'none'" }, "default": "'ends'", "description": "`ends` prints the value at the bar tip; `none` leaves it to the tooltip.", "fieldName": "labelValues" }, { "name": "emphasis", "type": { "text": "number | null" }, "default": "null", "description": "Index of the series (2+ series) or category (one series) to highlight.", "fieldName": "emphasis" }, { "name": "color", "type": { "text": "string" }, "default": "''", "description": "Single color for every bar; per-series palette otherwise.", "fieldName": "color" }, { "name": "label", "type": { "text": "string" }, "default": "''", "description": "Accessible summary used by the vertical (graphics-only) rendering.", "fieldName": "label" }, { "name": "empty-message", "type": { "text": "string" }, "default": "'No data to chart'", "description": "Shown instead of the marks when there is nothing to plot.", "fieldName": "emptyMessage", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "name": "loading", "type": { "text": "boolean" }, "default": "false", "description": "Hold the previous render at reduced opacity while new data loads.", "fieldName": "loading", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "name": "show-table", "type": { "text": "boolean" }, "default": "true", "description": "Render the \"View as table\" twin under the chart.", "fieldName": "showTable", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "name": "format", "type": { "text": "ChartFormat" }, "default": "'number'", "description": "How values are rendered in labels, ticks, tooltips and the table twin.", "fieldName": "format", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "name": "currency", "type": { "text": "string" }, "default": "'THB'", "description": "ISO currency code for `format=\"currency\"` (THB renders `฿`).", "fieldName": "currency", "inheritedFrom": { "name": "BahtChartBase", "module": "src/components/primitives/charts.ts" } }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtChartBase", "module": "/src/components/primitives/charts.js" }, "tagName": "baht-bar-chart", "customElement": true, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] } ], "exports": [ { "kind": "js", "name": "BahtBarChart", "declaration": { "name": "BahtBarChart", "module": "src/components/primitives/baht-bar-chart.ts" } }, { "kind": "custom-element-definition", "name": "baht-bar-chart", "declaration": { "name": "BahtBarChart", "module": "src/components/primitives/baht-bar-chart.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/primitives/baht-breadcrumbs.ts", "declarations": [ { "kind": "class", "description": "Breadcrumb trail. Last item renders as the current page (no link). Items\nwithout `href` emit `baht-navigate { item, index }` for router-driven apps.\n\n el.items = [\n { label: 'Workflows', href: '/workflows' },\n { label: 'Signup', href: '/workflows/signup' },\n { label: 'Run #812' },\n ];", "name": "BahtBreadcrumbs", "members": [ { "kind": "field", "name": "items", "type": { "text": "Crumb[]" }, "default": "[]" }, { "kind": "field", "name": "separator", "type": { "text": "string" }, "default": "'›'", "attribute": "separator" }, { "kind": "method", "name": "navigate", "privacy": "private", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "item", "type": { "text": "Crumb" } }, { "name": "index", "type": { "text": "number" } } ] }, { "kind": "field", "name": "uid", "type": { "text": "number" }, "privacy": "protected", "default": "0", "description": "Per-instance sequence for unique DOM ids (`for`/`id`/`aria-*` pairs). Stays `0` for the\nserver render and for the client's hydrating render so both produce identical markup.\nThe number is allocated at the first update — not in `connectedCallback`, which the\nHTML parser can fire before the server-rendered children exist: plain client-side\nmounts get it just before their first render (single render, as before), hydrated\nones right after hydration (one extra render that rewrites the ids).", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } }, { "kind": "method", "name": "emit", "privacy": "protected", "return": { "type": { "text": "void" } }, "parameters": [ { "name": "name", "type": { "text": "string" } }, { "name": "detail", "optional": true, "type": { "text": "unknown" } } ], "description": "Dispatch a bubbling, composed CustomEvent — crosses any light/shadow DOM boundary.", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "attributes": [ { "name": "separator", "type": { "text": "string" }, "default": "'›'", "fieldName": "separator" }, { "name": "defer-hydration", "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ], "superclass": { "name": "BahtElement", "module": "/src/components/base.js" }, "tagName": "baht-breadcrumbs", "customElement": true, "events": [ { "name": "name", "type": { "text": "CustomEvent" }, "inheritedFrom": { "name": "BahtElement", "module": "src/components/base.ts" } } ] } ], "exports": [ { "kind": "js", "name": "BahtBreadcrumbs", "declaration": { "name": "BahtBreadcrumbs", "module": "src/components/primitives/baht-breadcrumbs.ts" } }, { "kind": "custom-element-definition", "name": "baht-breadcrumbs", "declaration": { "name": "BahtBreadcrumbs", "module": "src/components/primitives/baht-breadcrumbs.ts" } } ] }, { "kind": "javascript-module", "path": "src/components/primitives/baht-button.ts", "declarations": [ { "kind": "class", "description": "Design-system button (20baht: no scale, no shadow change — color does the work).\nStandalone primitive: children become the label, listen for the native `click`.\n(Light DOM has no , so the initial children are moved into the button.)\n\n Delete\n \n Copy\n \n ‹ \n Close \n\n`shortcut` binds a document-wide key combo that clicks the button (NOTES 2026-10-31):\nhover/focus shows a tooltip with the label and the keys (`⌥Q` on Mac, `Alt+Q`\nelsewhere) and the inner button gets `aria-keyshortcuts`. Disabled buttons, buttons\noutside the topmost open ``, and modifier-less combos while typing in a\nfield never fire.", "name": "BahtButton", "members": [ { "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": "disabled", "type": { "text": "boolean" }, "default": "false", "attribute": "disabled" }, { "kind": "field", "name": "type", "type": { "text": "'button' | 'submit'" }, "default": "'button'", "description": "Forwarded to the native button — 'button' (default) or 'submit'.", "attribute": "type" }, { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "''", "description": "Alternative to children for setting the label programmatically.", "attribute": "label" }, { "kind": "field", "name": "icon", "type": { "text": "IconName | ''" }, "default": "''", "description": "Optional leading icon from the curated set (copy/check/download/…).", "attribute": "icon" }, { "kind": "field", "name": "iconOnly", "type": { "text": "boolean" }, "default": "false", "description": "Square icon-only button. Requires `label` for the accessible name.", "attribute": "icon-only" }, { "kind": "field", "name": "hostAriaLabel", "type": { "text": "string" }, "default": "''", "description": "A host `aria-label` never reaches assistive tech on its own — light DOM has no\nimplicit ARIA relationship between a custom element and its rendered children, so an\n`aria-label` written on `` stays on the host and the inner native\n`