@aparte/core 1.1.2 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.md +3 -2
  2. package/dist/client/aparte-client.d.ts.map +1 -1
  3. package/dist/client/wire-history.d.ts +3 -1
  4. package/dist/client/wire-history.d.ts.map +1 -1
  5. package/dist/components/launcher/aparte-launcher.d.ts +151 -13
  6. package/dist/components/launcher/aparte-launcher.d.ts.map +1 -1
  7. package/dist/components/split/aparte-split.d.ts +26 -0
  8. package/dist/components/split/aparte-split.d.ts.map +1 -1
  9. package/dist/config/aparte-config.d.ts +6 -1
  10. package/dist/config/aparte-config.d.ts.map +1 -1
  11. package/dist/config/icon-provider.d.ts +4 -0
  12. package/dist/config/icon-provider.d.ts.map +1 -1
  13. package/dist/config/locale.d.ts +15 -1
  14. package/dist/config/locale.d.ts.map +1 -1
  15. package/dist/config/sanitize.d.ts +1 -1
  16. package/dist/context/measure.d.ts.map +1 -1
  17. package/dist/custom-elements.json +543 -13
  18. package/dist/{defer-hydration-BBdqAZej.js → defer-hydration-lK-7XQXf.js} +43 -10
  19. package/dist/defer-hydration-lK-7XQXf.js.map +1 -0
  20. package/dist/generated/element-attributes.d.ts +12 -0
  21. package/dist/generated/element-attributes.d.ts.map +1 -1
  22. package/dist/{glyphs-DFp-825O.js → glyphs-LolG04CC.js} +20 -14
  23. package/dist/glyphs-LolG04CC.js.map +1 -0
  24. package/dist/icons/glyphs.d.ts +6 -0
  25. package/dist/icons/glyphs.d.ts.map +1 -1
  26. package/dist/icons.js +17 -15
  27. package/dist/index.css +1 -1
  28. package/dist/index.js +372 -33
  29. package/dist/index.js.map +1 -1
  30. package/dist/index.node.js +1 -1
  31. package/dist/interop/default-on-attributes.d.ts +17 -0
  32. package/dist/interop/default-on-attributes.d.ts.map +1 -0
  33. package/dist/interop/element-props.d.ts.map +1 -1
  34. package/dist/types/segments.d.ts +12 -0
  35. package/dist/types/segments.d.ts.map +1 -1
  36. package/package.json +2 -2
  37. package/dist/defer-hydration-BBdqAZej.js.map +0 -1
  38. package/dist/glyphs-DFp-825O.js.map +0 -1
@@ -7219,7 +7219,7 @@
7219
7219
  }
7220
7220
  }
7221
7221
  ],
7222
- "description": "Segments → the text a model can read back.\n\nFences and the language tag are kept. Without them the model re-reads its own\ncode as prose — which is how it starts explaining a snippet it believes it\nwrote in English.\n\nA type core does not know — a registered block grammar's (an artifact, a\ncitation, a file), a consumer's custom segment — follows one rule: its\n`content` if it has one, else its `fallback`, else nothing. Dropping such a\nsegment would make a document the model had just produced invisible on the very\nnext turn, so it could not be asked to change the thing it had built. An artifact\nis a plugin's type like any other and follows this rule.\n\n`thinking` and `tool_call` stay out on purpose — the first is the model's own\nscratchpad, and most APIs neither want it back nor bill for it kindly; the\nsecond is not text: `wireMessages` sends a reply's calls as the assistant's\n`toolCalls` and the `tool` messages answering them (`wireTurns`)."
7222
+ "description": "Segments → the text a model can read back.\n\nFences and the language tag are kept. Without them the model re-reads its own\ncode as prose — which is how it starts explaining a snippet it believes it\nwrote in English.\n\nA type core does not know — a registered block grammar's (an artifact, a\ncitation, a file), a consumer's custom segment — follows one rule: its\n`content` if it has one, else its `fallback`, else nothing. Dropping such a\nsegment would make a document the model had just produced invisible on the very\nnext turn, so it could not be asked to change the thing it had built. An artifact\nis a plugin's type like any other and follows this rule. Such a segment may also say\nwhat goes around its content (`wire`): the tag a grammar read it from, with the id the\nmodel needs to name it again.\n\n`thinking` and `tool_call` stay out on purpose — the first is the model's own\nscratchpad, and most APIs neither want it back nor bill for it kindly; the\nsecond is not text: `wireMessages` sends a reply's calls as the assistant's\n`toolCalls` and the `tool` messages answering them (`wireTurns`)."
7223
7223
  },
7224
7224
  {
7225
7225
  "kind": "function",
@@ -9647,7 +9647,16 @@
9647
9647
  "text": "string | null"
9648
9648
  }
9649
9649
  },
9650
- "description": "The registered tools' own `systemPrompt`s, in registration order with a blank line\nbetween, or `null` if none sets one. `AparteClient` sends them with every request, as a\nsystem message after the app's own (AparteConfig.resolveSystemPrompt| resolveSystemPrompt());\na request you assemble yourself should send them the same way, or the model loses the\ntools' instructions."
9650
+ "parameters": [
9651
+ {
9652
+ "name": "tools",
9653
+ "optional": true,
9654
+ "type": {
9655
+ "text": "readonly AparteTool[]"
9656
+ }
9657
+ }
9658
+ ],
9659
+ "description": "The registered tools' own `systemPrompt`s, in registration order with a blank line\nbetween, or `null` if none sets one. `AparteClient` sends them with every request, as a\nsystem message after the app's own (AparteConfig.resolveSystemPrompt| resolveSystemPrompt());\na request you assemble yourself should send them the same way, or the model loses the\ntools' instructions.\n\nPass the tools the request actually carries, and only theirs come back: an instruction\nto use a tool the model was not given (a model without `function_calling`, a turn sent\nwith `toolChoice: 'none'`) has it describe a call it cannot make. Without the argument,\nevery registered tool's."
9651
9660
  },
9652
9661
  {
9653
9662
  "kind": "method",
@@ -11470,7 +11479,7 @@
11470
11479
  "type": {
11471
11480
  "text": "AparteLocale"
11472
11481
  },
11473
- "default": "{ inputPlaceholder: \"Type a message...\", sendButton: \"Send\", copy: \"Copy\", copied: \"Copied!\", retry: \"Retry\", thinking: \"Thinking\", elicitationOther: \"Other…\", elicitationOtherPlaceholder: \"Type your answer…\", elicitationOtherLabel: \"Custom answer\", submitButton: \"Submit\", stopButton: \"Stop\", elicitationRecommended: \"Recommended\", elicitationSkip: \"Skip\", elicitationHide: \"Hide for now\", elicitationWaiting: \"Waiting for your answer\", elicitationYes: \"Yes\", elicitationNo: \"No\", elicitationAnswerLabel: \"Your answer\", approvalInstructionPlaceholder: \"Or tell it what to do instead…\", approvalAsk: \"Allow {tool}?\", approvalWaiting: \"Waiting\", scrollToBottom: \"Scroll to bottom\", suggestionsLabel: \"Suggested prompts\", contextLabel: \"Context window\", contextSystem: \"System prompt\", contextTools: \"Tools\", contextSummary: \"Summary\", contextMessages: \"Messages\", contextOther: \"Other\", contextFree: \"Free\", contextTotal: \"Total\", contextReclaim: \"Compacting now would free ~{n} tokens\", contextCompactNow: \"Compact now\", checkpointCount: \"{n} messages summarised for the model\", checkpointCountOne: \"1 message summarised for the model\", checkpointLegacy: \"Earlier messages were summarised\", checkpointGroup: \"Context summary\", checkpointShow: \"Show summary\", checkpointHide: \"Hide summary\", checkpointRestore: \"Restore\", checkpointRestoreConfirm: \"Send the original messages to the model again?\", checkpointPending: \"Summarising the context…\", checkpointFailed: \"Couldn't summarise the context\", toolRunning: \"Running\", toolCompleted: \"Done\", toolRejected: \"Rejected\", toolStopped: \"Stopped\", toolFailed: \"Failed\", toolInput: \"Input\", toolOutput: \"Output\", toolRejectedSaid: \"You said: “{instruction}”\", toolRefusedByPolicy: \"Refused by policy\", toolNotRunAfterRefusal: \"Not run: an earlier call was refused\", toolTimedOut: \"Timed out\", toolUnavailable: \"Not available here\", toolNoApprover: \"No one could approve it\", toolTurnLimit: \"Turn limit reached\", maxTurnsReached: \"Stopped after {n} turns to avoid an endless loop.\", sourcesCount: \"{n} sources\", sourcesOne: \"1 source\", sourcesCard: \"Sources\", sourcePrevious: \"Previous source\", sourceNext: \"Next source\", sourcePosition: \"Source {i} of {n}\", opensInNewTab: \"(opens in a new tab)\", imageLoad: \"Load the image from {host}\", imageLoadNamed: \"Load the image “{alt}” from {host}\", questionDeclined: \"You declined to answer.\", artifactNotCreated: \"Not created\", thoughtFor: \"Thought for {duration}\", thought: \"Thought\", turnWorking: \"Working…\", turnWorked: \"Worked {duration}\", turnUsed: \"Used {tools}\", turnTools: \"one:{n} tool|other:{n} tools\", feedbackReasonTitle: 'What went wrong?', feedbackReasonDismiss: 'Not now', triggersLoading: 'Loading…', triggersEmpty: 'No results', triggersError: 'This list could not be loaded', triggersRetry: 'Try again', triggersBack: 'Back', triggersCommandNew: 'Start a new conversation', triggersCommandStop: 'Stop the reply', triggersCommandRetry: 'Answer again', triggersCommandCopy: 'Copy the last reply', triggersCommandCompact: 'Summarise the earlier messages', triggersCompactNothing: 'There is nothing to compact yet', triggersCompactBusy: 'Wait for the reply to finish', triggersCompactNoWindow: 'This model does not say how much it can read', triggersCompactFailed: 'The summary could not be written', triggersCommandModel: 'Change the model', triggersCommandApproval: 'Change the approval mode', approvalOptionsLabel: \"Your decision\", approvalArgsLabel: \"Arguments\", actionUpload: \"Attach file\", removeAttachment: \"Remove {name}\", messageFrom: \"Message from {name}\", selectSearchPlaceholder: \"Search…\", selectSearchLabel: \"Search options\", loading: \"Loading…\", download: \"Download\", openArtifact: \"Open\", modelContextWindow: \"{n} context\", previewPending: \"Press Preview to run this artifact.\", sandboxError: \"The sandbox failed during generation.\", sandboxErrorHint: \"Common cause: the model produced invalid code (undefined variable, wrong argument type). Retry the request — the model may produce different code.\", preview: \"Preview\", code: \"Code\", generating: \"Generating…\", rebuildingPreview: \"Rebuilding preview…\", typing: \"Typing\", responseCutOff: \"Cut off at the model's length limit.\", error: \"Error\", errorUnreachable: \"The assistant can’t be reached right now. Try again in a moment.\", errorTimeout: \"The answer took too long. Try again in a moment.\", errorRefused: \"The assistant isn’t allowed to answer right now.\", errorRateLimited: \"Too many requests right now. Try again in a moment.\", errorTooLong: \"This conversation is too long for the model. Start a new one.\", errorFailed: \"The assistant couldn’t answer. Try again in a moment.\", errorNoAnswer: \"The assistant couldn’t answer this request.\", running: \"Running...\", run: \"Run\", file: \"File\", modelSelectorPlaceholder: \"Select a model...\", approvalModeLabel: \"Approval mode\", roleNameUser: \"You\", roleNameAssistant: \"Assistant\", yourMessage: \"Your message\", assistantResponse: \"Assistant response\", messageActions: \"Message actions\", edit: \"Edit message\", editConfirm: \"Send\", editCancel: \"Cancel\", feedbackPositive: \"Good response\", feedbackNegative: \"Bad response\", previousResponse: \"Previous response\", nextResponse: \"Next response\", approveTool: \"Approve\", rejectTool: \"Reject\", messageInfo: \"Details\", newChat: \"New Chat\", loadingConversations: \"Loading conversations\", conversationSearchEmpty: \"No conversation matches\", conversationList: \"Conversations\", loadingConversation: \"Loading the conversation\", deleteConversation: \"Delete\", archiveConversation: \"Archive\", unarchiveConversation: \"Unarchive\", conversationActions: \"Conversation actions\", conversationRunning: \"Answering\", conversationWaiting: \"Waiting for you\", renameConversation: \"Rename\", conversationTitle: \"Conversation title\", pinConversation: \"Pin\", unpinConversation: \"Unpin\", deleteConversationConfirm: \"Delete “{title}”?\", cancel: \"Cancel\", conversationGroupPinned: \"Pinned\", conversationGroupToday: \"Today\", conversationGroupYesterday: \"Yesterday\", conversationGroupWeek: \"Previous 7 days\", conversationGroupMonth: \"Previous 30 days\", scrollRailLabel: \"Conversation outline\", sidebarLabel: \"Conversations\", splitHandleLabel: \"Resize the panes\", launcherOpen: \"Open the chat\", launcherClose: \"Close the chat\", transcript: \"Transcript\" }",
11482
+ "default": "{ inputPlaceholder: \"Type a message...\", sendButton: \"Send\", copy: \"Copy\", copied: \"Copied!\", retry: \"Retry\", thinking: \"Thinking\", elicitationOther: \"Other…\", elicitationOtherPlaceholder: \"Type your answer…\", elicitationOtherLabel: \"Custom answer\", submitButton: \"Submit\", stopButton: \"Stop\", elicitationRecommended: \"Recommended\", elicitationSkip: \"Skip\", elicitationHide: \"Hide for now\", elicitationWaiting: \"Waiting for your answer\", elicitationYes: \"Yes\", elicitationNo: \"No\", elicitationAnswerLabel: \"Your answer\", approvalInstructionPlaceholder: \"Or tell it what to do instead…\", approvalAsk: \"Allow {tool}?\", approvalWaiting: \"Waiting\", scrollToBottom: \"Scroll to bottom\", suggestionsLabel: \"Suggested prompts\", contextLabel: \"Context window\", contextSystem: \"System prompt\", contextTools: \"Tools\", contextSummary: \"Summary\", contextMessages: \"Messages\", contextOther: \"Other\", contextFree: \"Free\", contextTotal: \"Total\", contextReclaim: \"Compacting now would free ~{n} tokens\", contextCompactNow: \"Compact now\", checkpointCount: \"{n} messages summarised for the model\", checkpointCountOne: \"1 message summarised for the model\", checkpointLegacy: \"Earlier messages were summarised\", checkpointGroup: \"Context summary\", checkpointShow: \"Show summary\", checkpointHide: \"Hide summary\", checkpointRestore: \"Restore\", checkpointRestoreConfirm: \"Send the original messages to the model again?\", checkpointPending: \"Summarising the context…\", checkpointFailed: \"Couldn't summarise the context\", toolRunning: \"Running\", toolCompleted: \"Done\", toolRejected: \"Rejected\", toolStopped: \"Stopped\", toolFailed: \"Failed\", toolInput: \"Input\", toolOutput: \"Output\", toolRejectedSaid: \"You said: “{instruction}”\", toolRefusedByPolicy: \"Refused by policy\", toolNotRunAfterRefusal: \"Not run: an earlier call was refused\", toolTimedOut: \"Timed out\", toolUnavailable: \"Not available here\", toolNoApprover: \"No one could approve it\", toolTurnLimit: \"Turn limit reached\", maxTurnsReached: \"Stopped after {n} turns to avoid an endless loop.\", sourcesCount: \"{n} sources\", sourcesOne: \"1 source\", sourcesCard: \"Sources\", sourcePrevious: \"Previous source\", sourceNext: \"Next source\", sourcePosition: \"Source {i} of {n}\", opensInNewTab: \"(opens in a new tab)\", imageLoad: \"Load the image from {host}\", imageLoadNamed: \"Load the image “{alt}” from {host}\", questionDeclined: \"You declined to answer.\", artifactNotCreated: \"Not created\", thoughtFor: \"Thought for {duration}\", thought: \"Thought\", turnWorking: \"Working…\", turnWorked: \"Worked {duration}\", turnUsed: \"Used {tools}\", turnTools: \"one:{n} tool|other:{n} tools\", feedbackReasonTitle: 'What went wrong?', feedbackReasonDismiss: 'Not now', triggersLoading: 'Loading…', triggersEmpty: 'No results', triggersError: 'This list could not be loaded', triggersRetry: 'Try again', triggersBack: 'Back', triggersCommandNew: 'Start a new conversation', triggersCommandStop: 'Stop the reply', triggersCommandRetry: 'Answer again', triggersCommandCopy: 'Copy the last reply', triggersCommandCompact: 'Summarise the earlier messages', triggersCompactNothing: 'There is nothing to compact yet', triggersCompactBusy: 'Wait for the reply to finish', triggersCompactNoWindow: 'This model does not say how much it can read', triggersCompactFailed: 'The summary could not be written', triggersCommandModel: 'Change the model', triggersCommandApproval: 'Change the approval mode', approvalOptionsLabel: \"Your decision\", approvalArgsLabel: \"Arguments\", actionUpload: \"Attach file\", removeAttachment: \"Remove {name}\", messageFrom: \"Message from {name}\", selectSearchPlaceholder: \"Search…\", selectSearchLabel: \"Search options\", loading: \"Loading…\", download: \"Download\", openArtifact: \"Open\", closeArtifact: \"Close\", artifactVersion: \"Version {n} of {total}\", previousVersion: \"Previous version\", nextVersion: \"Next version\", modelContextWindow: \"{n} context\", previewPending: \"Press Preview to run this artifact.\", sandboxError: \"The sandbox failed during generation.\", sandboxErrorHint: \"Common cause: the model produced invalid code (undefined variable, wrong argument type). Retry the request — the model may produce different code.\", preview: \"Preview\", code: \"Code\", generating: \"Generating…\", rebuildingPreview: \"Rebuilding preview…\", typing: \"Typing\", responseCutOff: \"Cut off at the model's length limit.\", error: \"Error\", errorUnreachable: \"The assistant can’t be reached right now. Try again in a moment.\", errorTimeout: \"The answer took too long. Try again in a moment.\", errorRefused: \"The assistant isn’t allowed to answer right now.\", errorRateLimited: \"Too many requests right now. Try again in a moment.\", errorTooLong: \"This conversation is too long for the model. Start a new one.\", errorFailed: \"The assistant couldn’t answer. Try again in a moment.\", errorNoAnswer: \"The assistant couldn’t answer this request.\", running: \"Running...\", run: \"Run\", file: \"File\", modelSelectorPlaceholder: \"Select a model...\", approvalModeLabel: \"Approval mode\", roleNameUser: \"You\", roleNameAssistant: \"Assistant\", yourMessage: \"Your message\", assistantResponse: \"Assistant response\", messageActions: \"Message actions\", edit: \"Edit message\", editConfirm: \"Send\", editCancel: \"Cancel\", feedbackPositive: \"Good response\", feedbackNegative: \"Bad response\", previousResponse: \"Previous response\", nextResponse: \"Next response\", approveTool: \"Approve\", rejectTool: \"Reject\", messageInfo: \"Details\", newChat: \"New Chat\", loadingConversations: \"Loading conversations\", conversationSearchEmpty: \"No conversation matches\", conversationList: \"Conversations\", loadingConversation: \"Loading the conversation\", deleteConversation: \"Delete\", archiveConversation: \"Archive\", unarchiveConversation: \"Unarchive\", conversationActions: \"Conversation actions\", conversationRunning: \"Answering\", conversationWaiting: \"Waiting for you\", renameConversation: \"Rename\", conversationTitle: \"Conversation title\", pinConversation: \"Pin\", unpinConversation: \"Unpin\", deleteConversationConfirm: \"Delete “{title}”?\", cancel: \"Cancel\", conversationGroupPinned: \"Pinned\", conversationGroupToday: \"Today\", conversationGroupYesterday: \"Yesterday\", conversationGroupWeek: \"Previous 7 days\", conversationGroupMonth: \"Previous 30 days\", scrollRailLabel: \"Conversation outline\", sidebarLabel: \"Conversations\", splitHandleLabel: \"Resize the panes\", launcherOpen: \"Open the chat\", launcherClose: \"Close the chat\", launcherHeading: \"Chat\", launcherMaximize: \"Expand the chat\", launcherRestore: \"Shrink the chat\", transcript: \"Transcript\" }",
11474
11483
  "description": "Default English Locale (Zero-dependency)\nHardcoded to ensure the core works out-of-the-box."
11475
11484
  }
11476
11485
  ],
@@ -11498,8 +11507,8 @@
11498
11507
  {
11499
11508
  "kind": "variable",
11500
11509
  "name": "RESERVED_ATTRIBUTES",
11501
- "default": "new Set([ 'data-aparte-chat', 'data-aparte-host', 'data-aparte-theme', 'data-aparte-split-pane', 'data-aparte-launcher-close', 'data-aparte-suggestions', 'data-aparte-bubble', 'data-aparte-empty', 'data-aparte-panel', 'data-aparte-panel-host', 'data-aparte-card-part', 'data-segment-id', 'data-action', ])",
11502
- "description": "The attributes core READS, as a command or as a boundary, on an element it finds by\nwalking the DOM: a delegated click listener (`data-aparte-dialog-open`, the sidebar\nand split toggles, the launcher's close), the chat that owns a card's `send`\n(`data-aparte-chat`), the instance config a subtree resolves to (`data-aparte-host`),\nthe palette a subtree wears (`data-aparte-theme`), a checkpoint's Restore\n(`data-checkpoint-action`), the row a segment update targets (`data-segment-id`).\n\n`data-*` is otherwise kept (see `copyAttributes`), so these are the exceptions: model\nmarkup is text, and text cannot press a button or move a boundary core drew. The list\nis exact rather than the whole `data-aparte-` prefix on purpose — a Markdown provider\nwrites `data-aparte-open` before the sanitizer runs, and core marks its own state on\nDOM the sanitizer sees again (`data-aparte-highlighted`) — and\n`the-sanitizer-refuses-what-core-reads.test.ts` scans core's source so an attribute\nadded there cannot be forgotten here. Exported for that test; not from the barrel."
11510
+ "default": "new Set([ 'data-aparte-chat', 'data-aparte-host', 'data-aparte-theme', 'data-aparte-split-pane', 'data-aparte-launcher-close', 'data-aparte-launcher-maximize', 'data-aparte-suggestions', 'data-aparte-bubble', 'data-aparte-empty', 'data-aparte-panel', 'data-aparte-panel-host', 'data-aparte-card-part', 'data-segment-id', 'data-action', ])",
11511
+ "description": "The attributes core READS, as a command or as a boundary, on an element it finds by\nwalking the DOM: a delegated click listener (`data-aparte-dialog-open`, the sidebar\nand split toggles, the launcher's close and maximize), the chat that owns a card's `send`\n(`data-aparte-chat`), the instance config a subtree resolves to (`data-aparte-host`),\nthe palette a subtree wears (`data-aparte-theme`), a checkpoint's Restore\n(`data-checkpoint-action`), the row a segment update targets (`data-segment-id`).\n\n`data-*` is otherwise kept (see `copyAttributes`), so these are the exceptions: model\nmarkup is text, and text cannot press a button or move a boundary core drew. The list\nis exact rather than the whole `data-aparte-` prefix on purpose — a Markdown provider\nwrites `data-aparte-open` before the sanitizer runs, and core marks its own state on\nDOM the sanitizer sees again (`data-aparte-highlighted`) — and\n`the-sanitizer-refuses-what-core-reads.test.ts` scans core's source so an attribute\nadded there cannot be forgotten here. Exported for that test; not from the barrel."
11503
11512
  },
11504
11513
  {
11505
11514
  "kind": "variable",
@@ -15659,6 +15668,18 @@
15659
15668
  "default": "`<svg class=\"aparte-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M5.5 14.5 12 8l6.5 6.5\"/></svg>`",
15660
15669
  "description": "Collapse/show less icon"
15661
15670
  },
15671
+ {
15672
+ "kind": "variable",
15673
+ "name": "maximizeIcon",
15674
+ "default": "`<svg class=\"aparte-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M14 4.5h5.5V10\"/><path d=\"M10 19.5H4.5V14\"/><path d=\"m19.5 4.5-6 6\"/><path d=\"m4.5 19.5 6-6\"/></svg>`",
15675
+ "description": "Maximize — two corners pulled outward, along the diagonal."
15676
+ },
15677
+ {
15678
+ "kind": "variable",
15679
+ "name": "minimizeIcon",
15680
+ "default": "`<svg class=\"aparte-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M19.5 10H14V4.5\"/><path d=\"M4.5 14H10v5.5\"/><path d=\"m14 10 5.5-5.5\"/><path d=\"m10 14-5.5 5.5\"/></svg>`",
15681
+ "description": "Minimize — the same two corners pushed back in, the inverse of `maximize`."
15682
+ },
15662
15683
  {
15663
15684
  "kind": "variable",
15664
15685
  "name": "terminalIcon",
@@ -15813,9 +15834,9 @@
15813
15834
  "kind": "variable",
15814
15835
  "name": "APARTE_ICON_GLYPHS",
15815
15836
  "type": {
15816
- "text": "{\n copy: copyIcon,\n check: checkIcon,\n send: sendIcon,\n loading: loadingIcon,\n error: errorIcon,\n expand: expandIcon,\n collapse: collapseIcon,\n terminal: terminalIcon,\n paperclip: paperclipIcon,\n image: imageIcon,\n file: fileIcon,\n scrollDown: scrollDownIcon,\n retry: retryIcon,\n edit: editIcon,\n thumbUp: thumbUpIcon,\n thumbDown: thumbDownIcon,\n prevBranch: prevBranchIcon,\n nextBranch: nextBranchIcon,\n tool: toolIcon,\n close: closeIcon,\n stop: stopIcon,\n pause: pauseIcon,\n info: infoIcon,\n archive: archiveIcon,\n unarchive: unarchiveIcon,\n download: downloadIcon,\n more: moreIcon,\n pin: pinIcon,\n trash: trashIcon,\n menu: menuIcon,\n alertTriangle: alertTriangleIcon,\n messageSquare: messageSquareIcon,\n}"
15837
+ "text": "{\n copy: copyIcon,\n check: checkIcon,\n send: sendIcon,\n loading: loadingIcon,\n error: errorIcon,\n expand: expandIcon,\n collapse: collapseIcon,\n maximize: maximizeIcon,\n minimize: minimizeIcon,\n terminal: terminalIcon,\n paperclip: paperclipIcon,\n image: imageIcon,\n file: fileIcon,\n scrollDown: scrollDownIcon,\n retry: retryIcon,\n edit: editIcon,\n thumbUp: thumbUpIcon,\n thumbDown: thumbDownIcon,\n prevBranch: prevBranchIcon,\n nextBranch: nextBranchIcon,\n tool: toolIcon,\n close: closeIcon,\n stop: stopIcon,\n pause: pauseIcon,\n info: infoIcon,\n archive: archiveIcon,\n unarchive: unarchiveIcon,\n download: downloadIcon,\n more: moreIcon,\n pin: pinIcon,\n trash: trashIcon,\n menu: menuIcon,\n alertTriangle: alertTriangleIcon,\n messageSquare: messageSquareIcon,\n}"
15817
15838
  },
15818
- "default": "{ copy: copyIcon, check: checkIcon, send: sendIcon, loading: loadingIcon, error: errorIcon, expand: expandIcon, collapse: collapseIcon, terminal: terminalIcon, paperclip: paperclipIcon, image: imageIcon, file: fileIcon, scrollDown: scrollDownIcon, retry: retryIcon, edit: editIcon, thumbUp: thumbUpIcon, thumbDown: thumbDownIcon, prevBranch: prevBranchIcon, nextBranch: nextBranchIcon, tool: toolIcon, close: closeIcon, stop: stopIcon, pause: pauseIcon, info: infoIcon, archive: archiveIcon, unarchive: unarchiveIcon, download: downloadIcon, more: moreIcon, pin: pinIcon, trash: trashIcon, menu: menuIcon, alertTriangle: alertTriangleIcon, messageSquare: messageSquareIcon, }"
15839
+ "default": "{ copy: copyIcon, check: checkIcon, send: sendIcon, loading: loadingIcon, error: errorIcon, expand: expandIcon, collapse: collapseIcon, maximize: maximizeIcon, minimize: minimizeIcon, terminal: terminalIcon, paperclip: paperclipIcon, image: imageIcon, file: fileIcon, scrollDown: scrollDownIcon, retry: retryIcon, edit: editIcon, thumbUp: thumbUpIcon, thumbDown: thumbDownIcon, prevBranch: prevBranchIcon, nextBranch: nextBranchIcon, tool: toolIcon, close: closeIcon, stop: stopIcon, pause: pauseIcon, info: infoIcon, archive: archiveIcon, unarchive: unarchiveIcon, download: downloadIcon, more: moreIcon, pin: pinIcon, trash: trashIcon, menu: menuIcon, alertTriangle: alertTriangleIcon, messageSquare: messageSquareIcon, }"
15819
15840
  }
15820
15841
  ],
15821
15842
  "exports": [
@@ -15875,6 +15896,22 @@
15875
15896
  "module": "src/icons/glyphs.ts"
15876
15897
  }
15877
15898
  },
15899
+ {
15900
+ "kind": "js",
15901
+ "name": "maximizeIcon",
15902
+ "declaration": {
15903
+ "name": "maximizeIcon",
15904
+ "module": "src/icons/glyphs.ts"
15905
+ }
15906
+ },
15907
+ {
15908
+ "kind": "js",
15909
+ "name": "minimizeIcon",
15910
+ "declaration": {
15911
+ "name": "minimizeIcon",
15912
+ "module": "src/icons/glyphs.ts"
15913
+ }
15914
+ },
15878
15915
  {
15879
15916
  "kind": "js",
15880
15917
  "name": "terminalIcon",
@@ -16108,6 +16145,63 @@
16108
16145
  }
16109
16146
  ]
16110
16147
  },
16148
+ {
16149
+ "kind": "javascript-module",
16150
+ "path": "src/interop/default-on-attributes.ts",
16151
+ "declarations": [
16152
+ {
16153
+ "kind": "variable",
16154
+ "name": "APARTE_DEFAULT_ON_ATTRIBUTES",
16155
+ "type": {
16156
+ "text": "Readonly<Record<string, readonly string[]>>"
16157
+ },
16158
+ "default": "{ 'aparte-composer-add-attachment': ['multiple'], 'aparte-composer': ['submit-on-enter'], 'aparte-launcher': ['header'], }",
16159
+ "description": "The boolean attributes whose default is ON, turned off only by the string `\"false\"`.\n\nThe element reads them as `getAttribute(name) !== 'false'`, so an ABSENT attribute is ON,\nand a prop bag's `false` that removes it — what a presence attribute wants — turns the\ncontrol on instead. `applyElementProps` reads this list to write `\"false\"` there, which is\nthe path every wrapper's `AparteUi` takes. The Angular directives are generated from the\nsame knowledge (`threeStateBooleans` in `element-bindings.config.mjs`), and\n`default-on-attributes.test.ts` keeps the two lists equal: a runtime list cannot be read from\nthe generated registry, which is built, not committed.\n\nInternal: not exported from the package barrel."
16160
+ },
16161
+ {
16162
+ "kind": "function",
16163
+ "name": "isDefaultOn",
16164
+ "return": {
16165
+ "type": {
16166
+ "text": "boolean"
16167
+ }
16168
+ },
16169
+ "parameters": [
16170
+ {
16171
+ "name": "el",
16172
+ "type": {
16173
+ "text": "Element"
16174
+ }
16175
+ },
16176
+ {
16177
+ "name": "name",
16178
+ "type": {
16179
+ "text": "string"
16180
+ }
16181
+ }
16182
+ ],
16183
+ "description": "Whether `name` is ON by default on `el`, so its OFF is the string `\"false\"`."
16184
+ }
16185
+ ],
16186
+ "exports": [
16187
+ {
16188
+ "kind": "js",
16189
+ "name": "APARTE_DEFAULT_ON_ATTRIBUTES",
16190
+ "declaration": {
16191
+ "name": "APARTE_DEFAULT_ON_ATTRIBUTES",
16192
+ "module": "src/interop/default-on-attributes.ts"
16193
+ }
16194
+ },
16195
+ {
16196
+ "kind": "js",
16197
+ "name": "isDefaultOn",
16198
+ "declaration": {
16199
+ "name": "isDefaultOn",
16200
+ "module": "src/interop/default-on-attributes.ts"
16201
+ }
16202
+ }
16203
+ ]
16204
+ },
16111
16205
  {
16112
16206
  "kind": "javascript-module",
16113
16207
  "path": "src/interop/defer-hydration.ts",
@@ -29470,7 +29564,7 @@
29470
29564
  "declarations": [
29471
29565
  {
29472
29566
  "kind": "class",
29473
- "description": "A chat that floats in a corner of the page — the support widget every product site has,\nas an element. A round button sits at the bottom of the window, on the inline-end side;\na click opens the chat above it as a card, and a second click, Escape or any control\nmarked `data-aparte-launcher-close` inside closes it again.\n\nChildren are yours: put the chat in it — an `<aparte-chat>`, or your own card with a\nheader above one. The element adds its button after them and shows them only while it is\nopen, so a closed launcher keeps the chat mounted (the conversation and the client stay)\nbut out of the tab order and the accessibility tree. Nothing is stored: listen to\n`aparte-launcher-toggle` to remember the state.\n\n**On a phone.** Under `breakpoint` (30rem of window, wide or high, unless you set a width) the open chat\nfills the window as a sheet, Tab stays inside it, and the button moves to the top corner\nto close it — or hides, when your card holds its own `data-aparte-launcher-close`\ncontrol. The element reflects `data-sheet` while the window is that narrow.\n\n**The button** shows a speech bubble, or the bubble and your `label` (`label=\"Help\"`)\nas a pill; it is named by the locale's `launcherOpen`/`launcherClose` when it shows no\ntext. Its two icons are the `launcherOpen` and `launcherClose` icons when the config holds\nthem (`registerIcons`), else `messageSquare` and `close` — so a theme redraws this button\nwithout redrawing every close button in the chat. Opening with the button hands the focus to the composer, or to the first control of\nyour card; `show()` and `open` set from a script move no focus, so a page that restores the\nstate on load does not steal it. Closing gives the focus back to the button when it was\ninside.\n\n**Server rendering.** The button is drawn when the element connects, which on a\nserver-rendered page is before the framework hydrates, and hydration removes what it did\nnot render. Put `defer-hydration` on the launcher in the server's HTML and call\n`releaseDeferredHydration` once your framework has hydrated, so the element draws itself\nthen; if something takes the button out anyway, the element puts it back.",
29567
+ "description": "A chat that floats in a corner of the page — the support widget every product site has,\nas an element. A round button sits at the bottom of the window, on the inline-end side;\na click opens the chat above it as a card, and a second click, Escape or any control\nmarked `data-aparte-launcher-close` inside closes it again.\n\nChildren are yours: put the chat in it — an `<aparte-chat>`, or your own card with a\nheader above one. The element adds its button after them and shows them only while it is\nopen, so a closed launcher keeps the chat mounted (the conversation and the client stay)\nbut out of the tab order and the accessibility tree. Nothing is stored: listen to\n`aparte-launcher-toggle` to remember the state.\n\n**The header.** Over a card that has none, the element draws one: the assistant's avatar,\nas the config's avatar provider draws it in the messages (`setAvatarProvider`) and none\nwithout one, a title (`heading`, else the button's `label`, else the locale's\n`launcherHeading`), a line under it (`subheading`), and a ✕ that\ncloses the chat. A card that brings its own keeps it, and the element draws none: a\n`<header>` at the card's top level. `header=\"false\"` takes it away in any case. It is a `div` wearing the\n`aparte-app-header` recipe rather than a `<header>`, which outside a section is the\npage's banner landmark.\n\n**Maximize.** `maximizable` adds a button to that header which makes the open chat fill\nthe window — the sheet a phone gets, on any window — and brings the card back; so does\nEscape, before a second Escape closes the chat.\n`maximizable=\"panel\"` keeps the page in view instead: maximized, the chat is a panel the\nwindow's height along its inline-end edge, `--aparte-launcher-panel-width` wide. The\nbutton's name changes with the state, the way a window's Maximize turns into Restore: the\nlocale's `launcherMaximize`, then `launcherRestore`. In a header of your own, mark any\ncontrol `data-aparte-launcher-maximize`: it toggles the same state, and the element keeps\nits `aria-pressed`. The state is `maximized`, reflected and settable; `covers` says whether\nthe open chat covers the whole window, and `aparte-launcher-toggle` reports both. A sheet\nunder the breakpoint already fills the window, so it hides every maximize control.\n\n**On a phone.** Under `breakpoint` (30rem of window, wide or high, unless you set a width) the open chat\nfills the window as a sheet, under its header, and Tab stays inside it. The header's ✕\ncloses it; without a close control in the card (`header=\"false\"`), the button moves to\nthe top corner to close it. The element reflects `data-sheet` while the window is that\nnarrow.\n\n**The button** shows a speech bubble, or the bubble and your `label` (`label=\"Help\"`)\nas a pill; it is named by the locale's `launcherOpen`/`launcherClose` when it shows no\ntext. Its two icons are the `launcherOpen` and `launcherClose` icons when the config holds\nthem (`registerIcons`), else `messageSquare` and `close` — so a theme redraws this button\nwithout redrawing every close button in the chat. Opening with the button hands the focus to the composer, or to the first control of\nyour card; `show()` and `open` set from a script move no focus, so a page that restores the\nstate on load does not steal it. Closing gives the focus back to the button when it was\ninside.\n\n**Server rendering.** The button and the header are drawn when the element connects,\nwhich on a server-rendered page is before the framework hydrates, and hydration removes\nwhat it did not render. Put `defer-hydration` on the launcher in the server's HTML and call\n`releaseDeferredHydration` once your framework has hydrated, so the element draws itself\nthen; if something takes the button or the header out anyway, the element puts it back.",
29474
29568
  "name": "AparteLauncher",
29475
29569
  "cssProperties": [
29476
29570
  {
@@ -29479,10 +29573,20 @@
29479
29573
  "default": "23.75rem"
29480
29574
  },
29481
29575
  {
29482
- "description": "Height of the open card, shortened to fit a short window.",
29576
+ "description": "Height of the open card, the element's header included, shortened to fit a short window.",
29483
29577
  "name": "--aparte-launcher-height",
29484
29578
  "default": "37.5rem"
29485
29579
  },
29580
+ {
29581
+ "description": "Width of the maximized chat with `maximizable=\"panel\"`, never wider than the window.",
29582
+ "name": "--aparte-launcher-panel-width",
29583
+ "default": "36rem"
29584
+ },
29585
+ {
29586
+ "description": "Least height of the element's header, which grows with what a theme puts in it (a larger title, more padding); the card's height includes it.",
29587
+ "name": "--aparte-launcher-header-height",
29588
+ "default": "3.5rem"
29589
+ },
29486
29590
  {
29487
29591
  "description": "Distance from the window's edges to the button and the card.",
29488
29592
  "name": "--aparte-launcher-offset",
@@ -29509,6 +29613,80 @@
29509
29613
  "privacy": "private",
29510
29614
  "default": "null"
29511
29615
  },
29616
+ {
29617
+ "kind": "field",
29618
+ "name": "_header",
29619
+ "type": {
29620
+ "text": "HTMLElement | null"
29621
+ },
29622
+ "privacy": "private",
29623
+ "default": "null",
29624
+ "description": "The element's header and the parts of it a render updates. Built once and updated in\nplace, never redrawn: the maximize button is what the person just pressed, and a new\nnode would take the focus out from under them."
29625
+ },
29626
+ {
29627
+ "kind": "field",
29628
+ "name": "_avatar",
29629
+ "type": {
29630
+ "text": "HTMLElement | null"
29631
+ },
29632
+ "privacy": "private",
29633
+ "default": "null"
29634
+ },
29635
+ {
29636
+ "kind": "field",
29637
+ "name": "_avatarDrawnBy",
29638
+ "type": {
29639
+ "text": "AparteAvatarProvider | null"
29640
+ },
29641
+ "privacy": "private",
29642
+ "default": "null",
29643
+ "description": "The provider that drew the header's avatar, and what it returned to undo it."
29644
+ },
29645
+ {
29646
+ "kind": "field",
29647
+ "name": "_avatarCleanup",
29648
+ "type": {
29649
+ "text": "(() => void) | null"
29650
+ },
29651
+ "privacy": "private",
29652
+ "default": "null"
29653
+ },
29654
+ {
29655
+ "kind": "field",
29656
+ "name": "_title",
29657
+ "type": {
29658
+ "text": "HTMLElement | null"
29659
+ },
29660
+ "privacy": "private",
29661
+ "default": "null"
29662
+ },
29663
+ {
29664
+ "kind": "field",
29665
+ "name": "_subtitle",
29666
+ "type": {
29667
+ "text": "HTMLElement | null"
29668
+ },
29669
+ "privacy": "private",
29670
+ "default": "null"
29671
+ },
29672
+ {
29673
+ "kind": "field",
29674
+ "name": "_maximize",
29675
+ "type": {
29676
+ "text": "HTMLButtonElement | null"
29677
+ },
29678
+ "privacy": "private",
29679
+ "default": "null"
29680
+ },
29681
+ {
29682
+ "kind": "field",
29683
+ "name": "_closeControl",
29684
+ "type": {
29685
+ "text": "HTMLButtonElement | null"
29686
+ },
29687
+ "privacy": "private",
29688
+ "default": "null"
29689
+ },
29512
29690
  {
29513
29691
  "kind": "field",
29514
29692
  "name": "_childWatch",
@@ -29574,6 +29752,41 @@
29574
29752
  "description": "True while the window is under the breakpoint, where the open chat fills it.",
29575
29753
  "readonly": true
29576
29754
  },
29755
+ {
29756
+ "kind": "field",
29757
+ "name": "maximized",
29758
+ "type": {
29759
+ "text": "boolean"
29760
+ },
29761
+ "description": "The open chat is maximized: the whole window, or a panel along its edge with `maximizable=\"panel\"`."
29762
+ },
29763
+ {
29764
+ "kind": "field",
29765
+ "name": "covers",
29766
+ "type": {
29767
+ "text": "boolean"
29768
+ },
29769
+ "description": "The open chat covers the whole window: a sheet under the breakpoint, or maximized\nwithout `maximizable=\"panel\"`. What a page reads to take itself out of reach — the\nlauncher keeps Tab inside it meanwhile, and does not own the page.",
29770
+ "readonly": true
29771
+ },
29772
+ {
29773
+ "kind": "field",
29774
+ "name": "_panel",
29775
+ "type": {
29776
+ "text": "boolean"
29777
+ },
29778
+ "privacy": "private",
29779
+ "description": "Maximized, the chat is a panel along the window's edge rather than the whole window.",
29780
+ "readonly": true
29781
+ },
29782
+ {
29783
+ "kind": "field",
29784
+ "name": "header",
29785
+ "type": {
29786
+ "text": "boolean"
29787
+ },
29788
+ "description": "The element draws its header over a card that has none. A property as well as the\nattribute because the attribute's OFF is a value, `\"false\"`, and a framework handed\n`header={false}` removes a boolean attribute instead — which here means ON."
29789
+ },
29577
29790
  {
29578
29791
  "kind": "method",
29579
29792
  "name": "_announce",
@@ -29614,6 +29827,26 @@
29614
29827
  },
29615
29828
  "description": "Open the chat when it is closed, close it when it is open."
29616
29829
  },
29830
+ {
29831
+ "kind": "method",
29832
+ "name": "maximize",
29833
+ "return": {
29834
+ "type": {
29835
+ "text": "void"
29836
+ }
29837
+ },
29838
+ "description": "Maximize the chat: the whole window, or a panel along its edge with\n`maximizable=\"panel\"`. Kept while the chat is closed, so it opens maximized."
29839
+ },
29840
+ {
29841
+ "kind": "method",
29842
+ "name": "restore",
29843
+ "return": {
29844
+ "type": {
29845
+ "text": "void"
29846
+ }
29847
+ },
29848
+ "description": "Bring the chat back to its card."
29849
+ },
29617
29850
  {
29618
29851
  "kind": "field",
29619
29852
  "name": "_onButtonClick",
@@ -29625,6 +29858,28 @@
29625
29858
  "name": "_onConfigChange",
29626
29859
  "privacy": "private"
29627
29860
  },
29861
+ {
29862
+ "kind": "method",
29863
+ "name": "_render",
29864
+ "privacy": "private",
29865
+ "return": {
29866
+ "type": {
29867
+ "text": "void"
29868
+ }
29869
+ },
29870
+ "description": "Everything the element draws, for the state it is in and the config it answers to."
29871
+ },
29872
+ {
29873
+ "kind": "method",
29874
+ "name": "_onChildren",
29875
+ "privacy": "private",
29876
+ "return": {
29877
+ "type": {
29878
+ "text": "void"
29879
+ }
29880
+ },
29881
+ "description": "The children changed: a framework reconciled them, hydration took out what it did not\nrender, a card arrived late. The button and the header go back if they were taken out,\nand a card that now brings a header of its own is no longer given a second one."
29882
+ },
29628
29883
  {
29629
29884
  "kind": "method",
29630
29885
  "name": "_config",
@@ -29656,8 +29911,199 @@
29656
29911
  "text": "void"
29657
29912
  }
29658
29913
  },
29914
+ "parameters": [
29915
+ {
29916
+ "name": "config",
29917
+ "type": {
29918
+ "text": "AparteConfig"
29919
+ }
29920
+ }
29921
+ ],
29659
29922
  "description": "The button, for the state it is in: the bubble (and the label, as a pill) while\nclosed, a close glyph while open. Its name comes from the locale when it shows no\ntext, and from that text when it does — a visible label the name did not contain\nis what speech users cannot say to press it. `aria-expanded` is the disclosure's whole\ncontract: there is no `aria-controls`, since the one element it could name without\nwriting an id on the host's card is the launcher itself, the button's own ancestor."
29660
29923
  },
29924
+ {
29925
+ "kind": "method",
29926
+ "name": "_glyph",
29927
+ "privacy": "private",
29928
+ "static": true,
29929
+ "return": {
29930
+ "type": {
29931
+ "text": "HTMLElement"
29932
+ }
29933
+ },
29934
+ "parameters": [
29935
+ {
29936
+ "name": "svg",
29937
+ "type": {
29938
+ "text": "string"
29939
+ }
29940
+ }
29941
+ ],
29942
+ "description": "A glyph, out of the accessibility tree: what holds it is named by its label."
29943
+ },
29944
+ {
29945
+ "kind": "method",
29946
+ "name": "_cardHasHeader",
29947
+ "privacy": "private",
29948
+ "return": {
29949
+ "type": {
29950
+ "text": "boolean"
29951
+ }
29952
+ },
29953
+ "description": "A card that brings its own header: a `<header>` at its top level — how every card in\nthis repository with a header of its own is written, so they keep theirs and are not\ngiven a second. A close control alone is not one: an \"End chat\" in a card's footer is a\nclose control too, and took the header away when it counted."
29954
+ },
29955
+ {
29956
+ "kind": "method",
29957
+ "name": "_touchesParts",
29958
+ "privacy": "private",
29959
+ "static": true,
29960
+ "return": {
29961
+ "type": {
29962
+ "text": "boolean"
29963
+ }
29964
+ },
29965
+ "parameters": [
29966
+ {
29967
+ "name": "record",
29968
+ "type": {
29969
+ "text": "MutationRecord"
29970
+ }
29971
+ }
29972
+ ],
29973
+ "description": "A change deeper in the card that the element answers: a header, or a maximize\ncontrol, arriving or leaving — a framework rendering a card's header after the card,\na conditional control. A streamed reply adds text and spans, so it calls for nothing."
29974
+ },
29975
+ {
29976
+ "kind": "method",
29977
+ "name": "_headerButton",
29978
+ "privacy": "private",
29979
+ "static": true,
29980
+ "return": {
29981
+ "type": {
29982
+ "text": "HTMLButtonElement"
29983
+ }
29984
+ },
29985
+ "parameters": [
29986
+ {
29987
+ "name": "part",
29988
+ "type": {
29989
+ "text": "string"
29990
+ }
29991
+ }
29992
+ ],
29993
+ "description": "An icon-only control of the header: the recipe's ghost icon button."
29994
+ },
29995
+ {
29996
+ "kind": "method",
29997
+ "name": "_name",
29998
+ "privacy": "private",
29999
+ "static": true,
30000
+ "return": {
30001
+ "type": {
30002
+ "text": "void"
30003
+ }
30004
+ },
30005
+ "parameters": [
30006
+ {
30007
+ "name": "button",
30008
+ "type": {
30009
+ "text": "HTMLElement"
30010
+ }
30011
+ },
30012
+ {
30013
+ "name": "name",
30014
+ "type": {
30015
+ "text": "string"
30016
+ }
30017
+ },
30018
+ {
30019
+ "name": "svg",
30020
+ "type": {
30021
+ "text": "string"
30022
+ }
30023
+ }
30024
+ ],
30025
+ "description": "A control's name, spoken and shown on hover: an icon alone says nothing to a pointer."
30026
+ },
30027
+ {
30028
+ "kind": "method",
30029
+ "name": "_buildHeader",
30030
+ "privacy": "private",
30031
+ "return": {
30032
+ "type": {
30033
+ "text": "HTMLElement"
30034
+ }
30035
+ }
30036
+ },
30037
+ {
30038
+ "kind": "method",
30039
+ "name": "_renderHeader",
30040
+ "privacy": "private",
30041
+ "return": {
30042
+ "type": {
30043
+ "text": "void"
30044
+ }
30045
+ },
30046
+ "parameters": [
30047
+ {
30048
+ "name": "config",
30049
+ "type": {
30050
+ "text": "AparteConfig"
30051
+ }
30052
+ }
30053
+ ],
30054
+ "description": "The header, when the element draws one: the title, the line under it, the maximize\nbutton for its state, the ✕. It goes first among the children, and the stylesheet\njoins it to the card under it."
30055
+ },
30056
+ {
30057
+ "kind": "method",
30058
+ "name": "_drawAvatar",
30059
+ "privacy": "private",
30060
+ "return": {
30061
+ "type": {
30062
+ "text": "void"
30063
+ }
30064
+ },
30065
+ "parameters": [
30066
+ {
30067
+ "name": "config",
30068
+ "type": {
30069
+ "text": "AparteConfig"
30070
+ }
30071
+ }
30072
+ ],
30073
+ "description": "The assistant's avatar, by the provider that draws it in the messages — the one place an\napp says what its assistant looks like, a framework component included. Drawn again only\nwhen the provider changes, since a render runs on every attribute and a provider may\nmount a component. Empty without one, and the stylesheet folds an empty slot away."
30074
+ },
30075
+ {
30076
+ "kind": "method",
30077
+ "name": "_markAvatarImage",
30078
+ "privacy": "private",
30079
+ "return": {
30080
+ "type": {
30081
+ "text": "void"
30082
+ }
30083
+ },
30084
+ "description": "A picture from the stylesheet alone (`--aparte-avatar-image-assistant`), as a message's\nslot shows it: an empty slot that has one is marked, which lifts the rule folding an empty\nslot away. Read after the header is in the document, where its style resolves."
30085
+ },
30086
+ {
30087
+ "kind": "method",
30088
+ "name": "_clearAvatar",
30089
+ "privacy": "private",
30090
+ "return": {
30091
+ "type": {
30092
+ "text": "void"
30093
+ }
30094
+ }
30095
+ },
30096
+ {
30097
+ "kind": "method",
30098
+ "name": "_syncMaximizeControls",
30099
+ "privacy": "private",
30100
+ "return": {
30101
+ "type": {
30102
+ "text": "void"
30103
+ }
30104
+ },
30105
+ "description": "A maximize control of the host's says what it does: `aria-pressed` follows the state.\nThe element's own button is the exception, because it changes its NAME with the state\ninstead, and a toggle whose name changes must not also say it is pressed."
30106
+ },
29661
30107
  {
29662
30108
  "kind": "field",
29663
30109
  "name": "_onMediaChange",
@@ -29713,13 +30159,24 @@
29713
30159
  "text": "void"
29714
30160
  }
29715
30161
  },
29716
- "description": "The composer when there is one — the person opened the chat to write — else the\nfirst thing in the card that holds focus. The button itself never: it is what the\nperson just pressed."
30162
+ "description": "The composer when there is one — the person opened the chat to write — else the\nfirst thing in the card that holds focus. The button itself never: it is what the\nperson just pressed. Nor the element's header, which comes first in the DOM: its ✕\nis not what anyone opened the chat for, and focus landing there would read the way\nout before the way in."
30163
+ },
30164
+ {
30165
+ "kind": "method",
30166
+ "name": "_focusTarget",
30167
+ "privacy": "private",
30168
+ "return": {
30169
+ "type": {
30170
+ "text": "HTMLElement | undefined"
30171
+ }
30172
+ },
30173
+ "description": "Where the focus goes in the chat: the composer, else the card's first control, else —\nwhen the chat covers the window and its button is hidden — the header's ✕, the one way\nout left on screen."
29717
30174
  },
29718
30175
  {
29719
30176
  "kind": "field",
29720
30177
  "name": "_onClick",
29721
30178
  "privacy": "private",
29722
- "description": "A `[data-aparte-launcher-close]` inside closes the chat — no script in your card."
30179
+ "description": "A `[data-aparte-launcher-close]` inside closes the chat, and a\n`[data-aparte-launcher-maximize]` enlarges it or brings it back — no script in your card."
29723
30180
  },
29724
30181
  {
29725
30182
  "kind": "method",
@@ -29752,7 +30209,7 @@
29752
30209
  "type": {
29753
30210
  "text": "CustomEvent<AparteLauncherToggleDetail>"
29754
30211
  },
29755
- "description": "The chat opened or closed, by the button, by Escape, by a close control or by `open` being set — or, while it is open, turned into a sheet or back as the window crossed the breakpoint. Bubbles."
30212
+ "description": "The chat opened or closed, by the button, by Escape, by a close control or by `open` being set — or, while it is open, turned into a sheet or back as the window crossed the breakpoint — or it was maximized or brought back, by a control or by `maximized` being set. Bubbles."
29756
30213
  }
29757
30214
  ],
29758
30215
  "attributes": [
@@ -29777,6 +30234,41 @@
29777
30234
  },
29778
30235
  "description": "The window width under which the open chat fills the window: a length, or `none` for a card at any size. Unset, a window under 30rem wide or 30rem high."
29779
30236
  },
30237
+ {
30238
+ "name": "header",
30239
+ "type": {
30240
+ "text": "boolean"
30241
+ },
30242
+ "description": "The header the element draws over a card that has none. On unless set to the string `\"false\"`; a card with a header of its own keeps it, whatever this says."
30243
+ },
30244
+ {
30245
+ "name": "heading",
30246
+ "type": {
30247
+ "text": "string"
30248
+ },
30249
+ "description": "The header's title. Unset, the button's `label`, else the locale's `launcherHeading` (\"Chat\"); set but empty, no title."
30250
+ },
30251
+ {
30252
+ "name": "subheading",
30253
+ "type": {
30254
+ "text": "string"
30255
+ },
30256
+ "description": "A line under the title, smaller and quieter: who answers, how fast."
30257
+ },
30258
+ {
30259
+ "name": "maximizable",
30260
+ "type": {
30261
+ "text": "boolean | '' | 'panel'"
30262
+ },
30263
+ "description": "Adds the maximize button to the element's header, beside its ✕. Maximized, the chat fills the window; with `\"panel\"`, it is a panel the window's height along its inline-end edge, and the page stays in view."
30264
+ },
30265
+ {
30266
+ "name": "maximized",
30267
+ "type": {
30268
+ "text": "boolean"
30269
+ },
30270
+ "description": "The open chat is maximized: it fills the window, as the sheet does on a phone, or with `maximizable=\"panel\"` runs the window's height along its edge. Reflected; set it to start maximized."
30271
+ },
29780
30272
  {
29781
30273
  "type": {
29782
30274
  "text": "boolean"
@@ -29791,7 +30283,7 @@
29791
30283
  "tagName": "aparte-launcher",
29792
30284
  "customElement": true,
29793
30285
  "examples": [
29794
- "<!-- In a page it floats over the window; here, over a 30rem frame. -->\n<div style=\"height: 30rem\"></div>\n<aparte-launcher label=\"Help\" open breakpoint=\"none\" style=\"--aparte-launcher-height: 24rem\">\n <aparte-chat></aparte-chat>\n</aparte-launcher>"
30286
+ "<!-- In a page it floats over the window; here, over a 30rem frame. -->\n<div style=\"height: 30rem\"></div>\n<aparte-launcher label=\"Help\" heading=\"Kilnhouse support\" subheading=\"Usually answers in a minute\"\n maximizable open breakpoint=\"none\" style=\"--aparte-launcher-height: 24rem\">\n <aparte-chat></aparte-chat>\n</aparte-launcher>"
29795
30287
  ]
29796
30288
  }
29797
30289
  ],
@@ -31614,6 +32106,37 @@
31614
32106
  },
31615
32107
  "description": "Back to the position the split was FIRST connected with — a re-parent restores\nthat, it does not redefine it. What a double-click on the seam does."
31616
32108
  },
32109
+ {
32110
+ "kind": "field",
32111
+ "name": "_unmeasurable",
32112
+ "type": {
32113
+ "text": "boolean"
32114
+ },
32115
+ "privacy": "private",
32116
+ "description": "No layout worth reading: one pane is shown, or the tracks are in motion between one\nand two. Whatever measures the panes or moves the seam asks this, not `stacked`\nalone: a `pane` named while the split moves commits a position, and read from tracks\nthat are halfway it wrote the full width into `position`, so the split came back at\nits maximum instead of the size it had.",
32117
+ "readonly": true
32118
+ },
32119
+ {
32120
+ "kind": "field",
32121
+ "name": "_endMove",
32122
+ "type": {
32123
+ "text": "(() => void) | null"
32124
+ },
32125
+ "privacy": "private",
32126
+ "default": "null",
32127
+ "description": "Ends the move in flight: the inline tracks and the marker go, the sheet's state stays."
32128
+ },
32129
+ {
32130
+ "kind": "method",
32131
+ "name": "_moveBetweenOneAndTwo",
32132
+ "privacy": "private",
32133
+ "return": {
32134
+ "type": {
32135
+ "text": "void"
32136
+ }
32137
+ },
32138
+ "description": "`single` just changed: move between one pane and two instead of jumping.\n\nThe sheet's one-pane state takes the other pane out with `display: none`, which\ncannot be animated. So for the length of the move the element keeps its three tracks\n(`data-moving` holds the one-pane rules off) and drives them itself, in pixels it\nmeasured: from what is on screen to what the sheet will show. When the move ends the\ninline tracks and the marker are removed and the sheet's state is all that is left,\nexactly as if nothing had been animated.\n\nIt does nothing, and the change is immediate as before, when the reader asked for\nless motion, when the split is stacked by its breakpoint (one pane either way), and\nwhere there is no layout to measure."
32139
+ },
31617
32140
  {
31618
32141
  "kind": "method",
31619
32142
  "name": "_ensureHandle",
@@ -32029,6 +32552,13 @@
32029
32552
  },
32030
32553
  "description": "Written BY the element while one pane is shown. Read-only; style against it.",
32031
32554
  "name": "data-stacked"
32555
+ },
32556
+ {
32557
+ "type": {
32558
+ "text": "string"
32559
+ },
32560
+ "description": "Written BY the element while it moves between one pane and two after `single` changed (both panes are laid out for that time). Read-only. The move takes `--aparte-duration-slower`; `aparte-split[data-moving] { transition: none }` makes it immediate, and it is skipped under `prefers-reduced-motion`.",
32561
+ "name": "data-moving"
32032
32562
  }
32033
32563
  ],
32034
32564
  "superclass": {