@kubex/zinc 1.1.117 → 1.1.119

package/dist/zn.d.ts

@@ -7322,35 +7322,30 @@ declare module "components/form-group/form-group.component" {
         forceCols: boolean;
         layout: string;
         pad: boolean;
-        /** The scroller the label is tracked against by hand; null while native sticky is enough. */
-        private tracked;
+        /** The scroll containers we have clipped, against the inline overflow each carried before. */
+        private readonly clipped;
         private frame;
-        private rebind;
-        private offset;
         private resizeObserver;
         connectedCallback(): void;
         disconnectedCallback(): void;
         protected firstUpdated(changedProperties: PropertyValues): void;
         private get labelColumn();
-        /** Coalesces scroll and resize work into one frame, and out of the ResizeObserver callback. */
+        /** Coalesces resize work into one frame, and out of the ResizeObserver callback. */
         private schedule;
+        private readonly onViewportResize;
         /**
-         * Native sticky only follows the nearest scroll container. Where that container isn't the one
-         * the user actually scrolls — a `zn-panel` body sized to its content inside a scrolling
-         * slideout, say — the label never moves, so it gets translated by hand instead.
+         * Native sticky anchors to the nearest scroll container, even one that cannot scroll — a `zn-panel` body sized to
+         * its content, say — where it then holds the label still for the whole scroll. `overflow: clip` clips without
+         * making a scroll container, so clipping those takes them out of sticky's search and the label follows the box the
+         * user actually scrolls, moved by the compositor rather than by hand.
          */
-        private findScroller;
-        private trackScroller;
-        /** The document scrolls through the window, every other scroller reports its own events. */
-        private scrollTarget;
-        private readonly onScroll;
-        private readonly onViewportResize;
-        private positionLabel;
+        private freeSticky;
+        private clip;
+        private release;
         /** The box native sticky would anchor to, whether or not it can be scrolled. */
-        private nearestScrollContainer;
-        /** The nearest ancestor the user can actually scroll, falling back to the document. */
-        private scrollingAncestor;
+        private isStickyAnchor;
         private isScrollContainer;
+        private overflows;
         /** Walks the flattened tree, so slots and shadow boundaries are crossed the way layout does. */
         private ancestors;
         render(): import("lit-html").TemplateResult<1>;
@@ -9132,10 +9127,7 @@ declare module "components/translations/translations.component" {
         hasTranslation(language: string): boolean;
         /** The chip shown against a language, in the select's value and against each of its options. */
         private languageState;
-        /**
-         * `English (EN)` — the configured name plus its code, unless the name already is the code, in which case the code
-         * alone. `languages` is written both ways: `{"en": "English"}` and `{"en": "EN"}`.
-         */
+        /** The configured name, or the code where `languages` does not name the language. */
         private languageLabel;
         /**
          * `values`, falling back to the `value` attribute it is built from while that is still pending. A parent
@@ -9309,7 +9301,7 @@ declare module "components/animated-button/index" {
 declare module "components/translation-group/translation-group.component" {
     import { type CSSResultGroup, type PropertyValues } from 'lit';
     import ZnChip from "components/chip/index";
-    import ZnHeader from "components/header/index";
+    import ZnFormGroup from "components/form-group/index";
     import ZnOption from "components/option/index";
     import ZnPanel from "components/panel/panel.component";
     import ZnSelect from "components/select/index";
@@ -9320,8 +9312,12 @@ declare module "components/translation-group/translation-group.component" {
      * @status experimental
      * @since 1.0
      *
-     * The select sits at the top right of the header, opposite the caption. Choosing a language switches every child at
-     * once, and each child hides its own select while it is in a group — `grouped` is set on them here.
+     * The fields sit in a `zn-form-group`, so the caption, help text and the language select share its label column and
+     * the fields line up with every other form group around them. Choosing a language switches every child at once, and
+     * each child hides its own select while it is in a group — `grouped` is set on them here.
+     *
+     * The select is searchable. Each option holds its language code as its value, so typing `de` finds German without the
+     * code being on show.
      *
      * Closed, the select carries how many target languages are done — `1/5`. Its options each carry a chip aggregated
      * across the children:
@@ -9336,11 +9332,11 @@ declare module "components/translation-group/translation-group.component" {
      * The children own their values; this component only chooses which language is shown and reports on what they hold.
      * It reads them back on every child `zn-change`, so the chips and the count follow an edit as it is typed.
      *
-     * Extends `zn-panel`, so `caption`, `icon`, `flush`, `transparent` and the `footer` slot behave as they do there.
-     * Nested inside another panel, add `inline` to drop the chrome and keep the fields aligned with the surrounding form.
+     * Extends `zn-panel`, so `caption`, `flush`, `transparent` and the `footer` slot behave as they do there. Nested
+     * inside another panel, add `inline` to drop the chrome and keep the fields aligned with the surrounding form.
      *
      * @dependency zn-chip
-     * @dependency zn-header
+     * @dependency zn-form-group
      * @dependency zn-option
      * @dependency zn-select
      *
@@ -9350,27 +9346,29 @@ declare module "components/translation-group/translation-group.component" {
      * @slot actions - Buttons for the bottom of the panel, on the white body rather than the grey footer. They sit on
      *  the right, as zinc's form action rows do; `align="start"` moves one to the left. Write them in the order they
      *  should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.
-     * @slot footer - Content displayed in the grey panel footer. The header belongs to the language select; nothing
-     *  else is slotted into it.
+     * @slot footer - Content displayed in the grey panel footer.
      *
      * @csspart base - The component's base wrapper.
+     * @csspart form-group - The form group holding the caption, the language select and the fields.
      * @csspart actions - The row of buttons at the bottom of the body.
-     * @csspart language-field - The label and select that choose the language every child is editing.
+     * @csspart language-field - The select that chooses the language every child is editing, in the group's chip slot.
      * @csspart language-select - The select itself.
      */
     export default class ZnTranslationGroup extends ZnPanel {
         static styles: CSSResultGroup;
         static dependencies: {
             'zn-chip': typeof ZnChip;
-            'zn-header': typeof ZnHeader;
+            'zn-form-group': typeof ZnFormGroup;
             'zn-option': typeof ZnOption;
             'zn-select': typeof ZnSelect;
         };
         private readonly _slotController;
-        /** The caption shown in the panel header. An alias for the inherited `caption`, which wins where both are set. */
+        /** The form group's label. An alias for the inherited `caption`, which wins where both are set. */
         label: string;
+        /** Sits under the label, above the language select, as help text does in any other form group. */
+        helpText: string;
         /**
-         * Drops the panel chrome — border, background and padding — so the group reads as a section of the form around it
+         * Drops the panel chrome — border, background and padding — so the group reads as a section of the surrounding form
          * rather than a panel of its own. For groups nested inside another panel, where the fields would otherwise sit
          * indented behind a second border.
          */
@@ -9402,7 +9400,7 @@ declare module "components/translation-group/translation-group.component" {
          * count are read off the children, so a child's edit has to bring the group back round.
          */
         private languageState;
-        /** `English (EN)`, or the code alone where the configured name already is the code. */
+        /** The configured name, or the code where `languages` does not name the language. */
         private displayName;
         /** Children take their language list from the group, so a change to `languages` has to reach them. */
         private syncChildLanguages;
@@ -9726,7 +9724,7 @@ declare module "components/remarkd-editor/actions" {
         /** Where the caret lands within `prefix`. Defaults to the end. */
         caretOffset?: number;
         /** Actions that open their own picker instead of inserting text. */
-        opens?: 'image' | 'include';
+        opens?: 'image' | 'include' | 'link';
     }
     /** Toolbar order, most-used first — the last groups are the first to collapse. */
     export const ACTION_GROUPS: {
@@ -9842,6 +9840,16 @@ declare module "components/remarkd-editor/remarkd-editor.component" {
         private includeLoadFailed;
         private includePickerIndex;
         private includeQuery;
+        private linkPickerOpen;
+        private linkQuery;
+        private linkResults;
+        private linkSearchFailed;
+        private linkSelection;
+        private linkSearchTimer?;
+        private linkSearchToken;
+        /** Resolved link targets by reference; a null value is one the app does not know. */
+        private linkRefs;
+        private linkRefsPending;
         private pendingDragHandle;
         private dragStartX;
         private dragStartY;
@@ -9868,6 +9876,13 @@ declare module "components/remarkd-editor/remarkd-editor.component" {
          * chips rendered for `include::` directives and feeds the include picker.
          */
         includeUrl: string;
+        /**
+         * Endpoint the article link picker searches, as
+         * `{"items":[{ref,kind,title,context,status}]}`. Queried with `?q=<term>` as
+         * the author types and with `?refs=a,b` to resolve the references a body
+         * already carries.
+         */
+        linkUrl: string;
         /** Adds a toolbar toggle that swaps the block view for the full remarkd source. */
         allowRaw: boolean;
         /** Makes the editor required for form submission. */
@@ -9891,6 +9906,7 @@ declare module "components/remarkd-editor/remarkd-editor.component" {
         disconnectedCallback(): void;
         handleValueChange(): void;
         handleIncludeUrlChange(): void;
+        handleLinkUrlChange(): void;
         /**
          * Splits remarkd source into blocks on blank lines, keeping fenced /
          * delimited containers (``` ==== !!!! .... ---- ____ **** ////) as single blocks.
@@ -9975,6 +9991,15 @@ declare module "components/remarkd-editor/remarkd-editor.component" {
         private moveDragGhost;
         private pickImage;
         private pickInclude;
+        /**
+         * Opens the picker over the block being edited. The caret range is captured
+         * now: the picker's own filter takes focus, so the textarea's selection is
+         * gone by the time an option is chosen.
+         */
+        private pickLink;
+        private closeLinkPicker;
+        /** Debounced; only the newest response is kept. */
+        private searchLinks;
         private closeIncludePicker;
         private insertInclude;
         private closeImagePicker;
@@ -9992,6 +10017,13 @@ declare module "components/remarkd-editor/remarkd-editor.component" {
         private hasIncludeBlock;
         /** Fetches the include list once; every later caller shares the same promise. */
         private loadIncludeOptions;
+        /**
+         * Resolves the references in the body that have not been resolved yet, so a
+         * link whose target is gone can be marked. A failed request records nothing:
+         * an unanswered reference is not a broken one.
+         */
+        private resolveContentLinks;
+        private markContentLinks;
         private autosize;
         /**
          * Applies an inline mark to the open block's textarea: wraps the selection, toggles the
@@ -10038,8 +10070,11 @@ declare module "components/remarkd-editor/remarkd-editor.component" {
          */
         private renderConditional;
         private renderBlock;
-        /** An inline action needs an open block to apply its mark to. */
+        /** Inline marks and the article link both apply into an open block, not a new one. */
         private isActionDisabled;
+        /** A picker action with no endpoint configured is not offered at all. */
+        private actionAvailable;
+        private slashItemAvailable;
         /** Routes a toolbar/menu action to the inline or block insert path — the one place both
          * `renderAction` and `renderMenuAction` call, so the bar and the overflow menu cannot
          * drift out of sync on what a given action actually does. */
@@ -10053,6 +10088,8 @@ declare module "components/remarkd-editor/remarkd-editor.component" {
         /** The block views, with the inline image picker spliced in when active. */
         private renderBody;
         private renderIncludePicker;
+        private renderLinkPicker;
+        private insertLink;
         private renderImagePicker;
     }
 }