@kubex/zinc 1.1.62 → 1.1.64

package/dist/zn.d.ts

@@ -1327,6 +1327,7 @@ declare module "components/toggle/toggle.component" {
         title: string;
         name: string;
         value: string;
+        /** The value submitted when the toggle is unchecked, so the toggle always submits a value. */
         fallbackValue: string;
         size: 'small' | 'medium' | 'large';
         disabled: boolean;
@@ -3119,6 +3120,7 @@ declare module "components/query-builder/query-builder.component" {
         name: string;
         value: PropertyKey;
         showValues: string[];
+        private get _usedFilterIds();
         get validationMessage(): string;
         get validity(): ValidityState;
         protected firstUpdated(_changedProperties: PropertyValues): void;
@@ -6572,6 +6574,7 @@ declare module "components/form-group/form-group.component" {
      * @since 1.0
      *
      * @slot - The default slot.
+     * @slot chip - A chip displayed under the form group's help text.
      *
      */
     export default class ZnFormGroup extends ZincElement {
@@ -6591,6 +6594,7 @@ declare module "components/form-group/form-group.component" {
         helpText: string;
         forceCols: boolean;
         layout: string;
+        pad: boolean;
         render(): import("lit-html").TemplateResult<1>;
     }
 }
@@ -7054,6 +7058,8 @@ declare module "components/file/file.component" {
             'zn-dialog': typeof ZnDialog;
         };
         private readonly formControlController;
+        /** Set when the user clears the control; reset when a file is chosen. */
+        private clearedByUser;
         private readonly hasSlotController;
         private readonly localize;
         private userIsDragging;
@@ -8692,6 +8698,154 @@ declare module "components/markdown-editor/index" {
         }
     }
 }
+declare module "components/remarkd-editor/remarkd-editor.component" {
+    import { type CSSResultGroup, type PropertyValues } from 'lit';
+    import ZincElement from "internal/zinc-element";
+    import type { ZincFormControl } from "internal/zinc-element";
+    /**
+     * @summary A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.
+     * @documentation https://zinc.style/components/remarkd-editor
+     * @status experimental
+     * @since 1.0
+     *
+     * @dependency zn-button
+     * @dependency zn-button-group
+     * @dependency zn-icon
+     * @dependency zn-dialog
+     * @dependency zn-file
+     * @dependency zn-input
+     *
+     * @event zn-input - Emitted on each keystroke while editing a block.
+     * @event zn-change - Emitted when a block edit is committed and the value changes.
+     *
+     * @csspart base - The component's base wrapper.
+     * @csspart toolbar - The always-visible block-insert toolbar.
+     * @csspart block - A rendered block wrapper.
+     * @csspart rendered - The rendered remarkd output of a block.
+     * @csspart input - The textarea shown while editing a block.
+     * @csspart slash-menu - The context menu opened by typing "/" in a block.
+     */
+    export default class ZnRemarkdEditor extends ZincElement implements ZincFormControl {
+        static styles: CSSResultGroup;
+        private readonly formControlController;
+        private editingDraft;
+        private suppressValueSync;
+        private suppressBlurCommit;
+        private validationInput;
+        private blocks;
+        private editingIndex;
+        private slashMenuOpen;
+        private slashQuery;
+        private slashActiveIndex;
+        private imageDialogOpen;
+        private dropIndicator;
+        private dragIndex;
+        private editShell;
+        private imageInsertIndex;
+        private pendingDragHandle;
+        private dragStartX;
+        private dragStartY;
+        private dragGhost;
+        /** The name of the control, submitted as part of form data. */
+        name: string;
+        /** The current remarkd source. */
+        value: string;
+        /** The default value — used when resetting the form. */
+        defaultValue: string;
+        /** Placeholder shown when the document is empty. */
+        placeholder: string;
+        /**
+         * Endpoint for image uploads. Posting the file metadata here must return
+         * `{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and
+         * `uploadPath` is inserted into the document. When unset, adding an image
+         * prompts for a URL instead.
+         */
+        attachmentUrl: string;
+        /** Makes the editor required for form submission. */
+        required: boolean;
+        /** Makes the editor read-only. */
+        readonly: boolean;
+        /** Disables the editor. */
+        disabled: boolean;
+        get validity(): ValidityState;
+        get validationMessage(): string;
+        checkValidity(): boolean;
+        getForm(): HTMLFormElement | null;
+        reportValidity(): boolean;
+        setCustomValidity(message: string): void;
+        /** Starts editing the first block, or a new block if the document is empty. */
+        focus(): void;
+        /** Commits any in-progress block edit. */
+        blur(): void;
+        protected firstUpdated(_changedProperties: PropertyValues): void;
+        disconnectedCallback(): void;
+        handleValueChange(): void;
+        /**
+         * Splits remarkd source into blocks on blank lines, keeping fenced /
+         * delimited containers (``` ==== !!!! .... ----) as single blocks.
+         */
+        private splitBlocks;
+        private fenceMarker;
+        private closesFence;
+        private updateBlocks;
+        private handleRenderedClick;
+        private toggleCheckbox;
+        private startEdit;
+        /**
+         * The remarkd chrome the editing block should keep, derived from its first
+         * line — so a NOTE still looks like a note while its source is edited.
+         */
+        private computeEditShell;
+        private focusInput;
+        private addBlockAt;
+        /** Inserts a draft block — committed (or dropped, if left empty) on blur. */
+        private insertDraftBlock;
+        /**
+         * Blur handler for the editing textarea. Re-renders that replace the
+         * focused textarea (e.g. Shift+Enter committing and opening the next
+         * block) fire blur mid-transition — `suppressBlurCommit` masks those.
+         */
+        private handleEditBlur;
+        /** Commits the in-progress edit; returns the index after the committed parts. */
+        private commitEdit;
+        private get filteredSlashItems();
+        private handleDraftInput;
+        private handleEditKeydown;
+        private applySlashItem;
+        private handleEditPaste;
+        private handleDragOver;
+        private handleDrop;
+        /** The insertion index a drop at `y` maps to, from the rendered block positions. */
+        private insertionIndexFromY;
+        private handleHandlePointerDown;
+        private handleDragPointerMove;
+        private handleDragPointerUp;
+        private cancelDrag;
+        private createDragGhost;
+        private moveDragGhost;
+        private pickImage;
+        private handleImageDialogClose;
+        private handleImageInsert;
+        private insertImage;
+        private uploadImage;
+        private autosize;
+        private handleToolbarInsert;
+        private renderSlashMenu;
+        private renderBlock;
+        render(): import("lit-html").TemplateResult<1>;
+        private renderImageDialog;
+    }
+}
+declare module "components/remarkd-editor/index" {
+    import ZnRemarkdEditor from "components/remarkd-editor/remarkd-editor.component";
+    export * from "components/remarkd-editor/remarkd-editor.component";
+    export default ZnRemarkdEditor;
+    global {
+        interface HTMLElementTagNameMap {
+            'zn-remarkd-editor': ZnRemarkdEditor;
+        }
+    }
+}
 declare module "components/flow-builder/flow.types" {
     import type { TemplateResult } from 'lit';
     /** Which steps-panel tab a node type appears under. */
@@ -10157,6 +10311,84 @@ declare module "components/page-builder/index" {
         }
     }
 }
+declare module "components/preview-frame/preview-frame.component" {
+    import { type CSSResultGroup } from 'lit';
+    import ZincElement from "internal/zinc-element";
+    /**
+     * @summary Embeds a live preview iframe and drives the hp-preview postMessage
+     * protocol: answers the frame's ready handshake with a config payload fetched
+     * from data-uri, auto-saves watched forms on change, and refreshes the
+     * preview after each save.
+     * @documentation https://zinc.style/components/preview-frame
+     * @status experimental
+     * @since 1.0
+     *
+     * @event zn-error - Emitted when the preview reports a render error or a save fails.
+     *
+     * @csspart base - The component's base wrapper.
+     * @csspart iframe - The preview iframe.
+     * @csspart error - The error overlay.
+     */
+    export default class ZnPreviewFrame extends ZincElement {
+        static styles: CSSResultGroup;
+        /** URL of the preview shell page (tokened embed URL). */
+        src: string;
+        /** Expected origin of the iframe; all postMessage traffic is checked against it. */
+        frameOrigin: string;
+        /** Endpoint returning the hp-preview:config payload JSON. The console proxy rewrites this attribute to an app-prefixed path for proper fetch resolution. */
+        dataUri: string;
+        /**
+         * Selector (resolved against the component's root node) for the forms to watch.
+         * Defaults to only forms explicitly opted in via a `data-auto-save` attribute —
+         * unmarked forms keep normal submit behavior and are never intercepted,
+         * auto-saved, or used to trigger a preview refresh. Override to widen the scope.
+         */
+        watch: string;
+        /** Debounce in ms between a form change and its auto-save. */
+        debounce: number;
+        /**
+         * Zooms the previewed page out (0–1]. The frame always fills the panel;
+         * zoom shrinks the content browser-style, so 0.4 shows the page at 40%
+         * size with correspondingly more of it visible. 1 = natural size.
+         */
+        zoom: number;
+        /**
+         * The visible height (in CSS pixels) of the preview panel. Fixed rather
+         * than measured, because a measured height would feed back into the
+         * scaled iframe's layout box and grow unbounded.
+         */
+        minHeight: number;
+        frame: HTMLIFrameElement;
+        private error;
+        private _generation;
+        private readonly _watchedForms;
+        private readonly _debounceTimers;
+        private readonly _formObserver;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+        private readonly _onMessage;
+        /** Re-fetches the payload and pushes a fresh config to the preview. */
+        refresh(): Promise<void>;
+        private _sendConfig;
+        private _attachForms;
+        private _detachForm;
+        private readonly _onChange;
+        private readonly _onSubmit;
+        private _save;
+        private _fail;
+        render(): import("lit-html").TemplateResult<1>;
+    }
+}
+declare module "components/preview-frame/index" {
+    import ZnPreviewFrame from "components/preview-frame/preview-frame.component";
+    export * from "components/preview-frame/preview-frame.component";
+    export default ZnPreviewFrame;
+    global {
+        interface HTMLElementTagNameMap {
+            'zn-preview-frame': ZnPreviewFrame;
+        }
+    }
+}
 declare module "utilities/form" {
     export { clearFormStoreValues } from "internal/form";
 }
@@ -10447,6 +10679,7 @@ declare module "zinc" {
     export { default as OptGroup } from "components/opt-group/index";
     export { default as PriorityList } from "components/priority-list/index";
     export { default as MarkdownEditor } from "components/markdown-editor/index";
+    export { default as RemarkdEditor } from "components/remarkd-editor/index";
     export { default as FlowBuilder } from "components/flow-builder/index";
     export { default as FlowSteps } from "components/flow-builder/modules/flow-steps/index";
     export { default as FlowStepGroup } from "components/flow-builder/modules/flow-step-group/index";
@@ -10455,6 +10688,7 @@ declare module "zinc" {
     export { default as PageBuilder } from "components/page-builder/index";
     export { default as PagePaletteItem } from "components/page-builder/modules/page-palette-item/index";
     export { default as PageSectionCard } from "components/page-builder/modules/page-section-card/index";
+    export { default as PreviewFrame } from "components/preview-frame/index";
     export { default as ZincElement } from "internal/zinc-element";
     export * from "utilities/on";
     export * from "utilities/query";
@@ -10570,6 +10804,7 @@ declare module "events/zn-element-added" {
 declare module "events/zn-error" {
     export type ZnErrorEvent = CustomEvent<{
         status?: number;
+        message?: string;
     }>;
     global {
         interface GlobalEventHandlersEventMap {