@kubex/zinc 1.1.63 → 1.1.64

package/dist/custom-elements.json

@@ -12949,7 +12949,17 @@
               "name": "formControlController",
               "privacy": "private",
               "readonly": true,
-              "default": "new FormControlController(this, { assumeInteractionOn: ['zn-change'], value: (el: ZnFile) => el.files })"
+              "default": "new FormControlController(this, { assumeInteractionOn: ['zn-change'], // An explicitly cleared control submits an empty value so the server can // remove the stored upload; an untouched empty control submits nothing. value: (el: ZnFile) => { if (el.files?.length) return el.files; return el.clearedByUser ? '' : undefined; } })"
+            },
+            {
+              "kind": "field",
+              "name": "clearedByUser",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Set when the user clears the control; reset when a file is chosen."
             },
             {
               "kind": "field",
@@ -29615,6 +29625,15 @@
               "default": "[]",
               "attribute": "show-values"
             },
+            {
+              "kind": "field",
+              "name": "_usedFilterIds",
+              "type": {
+                "text": "Set<string>"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "validationMessage",
@@ -29860,7 +29879,7 @@
                 {
                   "name": "event",
                   "type": {
-                    "text": "Event | { target: ZnDatepicker | HTMLDivElement }"
+                    "text": "Event | {\n    target: ZnDatepicker | HTMLDivElement\n  }"
                   }
                 },
                 {
@@ -31531,6 +31550,912 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/remarkd-editor/remarkd-editor.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnRemarkdEditor",
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            },
+            {
+              "description": "The always-visible block-insert toolbar.",
+              "name": "toolbar"
+            },
+            {
+              "description": "A rendered block wrapper.",
+              "name": "block"
+            },
+            {
+              "description": "The rendered remarkd output of a block.",
+              "name": "rendered"
+            },
+            {
+              "description": "The textarea shown while editing a block.",
+              "name": "input"
+            },
+            {
+              "description": "The context menu opened by typing \"/\" in a block.",
+              "name": "slash-menu"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "formControlController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new FormControlController(this, { assumeInteractionOn: ['zn-input', 'zn-change'], })"
+            },
+            {
+              "kind": "field",
+              "name": "editingDraft",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "suppressValueSync",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "suppressBlurCommit",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "validationInput",
+              "type": {
+                "text": "HTMLTextAreaElement"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "blocks",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "editingIndex",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "slashMenuOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "slashQuery",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "slashActiveIndex",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "imageDialogOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "dropIndicator",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "dragIndex",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "editShell",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "imageInsertIndex",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "pendingDragHandle",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "dragStartX",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "dragStartY",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "dragGhost",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The name of the control, submitted as part of form data.",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The current remarkd source.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "defaultValue",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The default value — used when resetting the form."
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Type something…'",
+              "description": "Placeholder shown when the document is empty.",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "attachmentUrl",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Endpoint for image uploads. Posting the file metadata here must return\n`{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and\n`uploadPath` is inserted into the document. When unset, adding an image\nprompts for a URL instead.",
+              "attribute": "attachment-url"
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the editor required for form submission.",
+              "attribute": "required",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "readonly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the editor read-only.",
+              "attribute": "readonly",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the editor.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "validity",
+              "type": {
+                "text": "ValidityState"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "validationMessage",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getForm",
+              "return": {
+                "type": {
+                  "text": "HTMLFormElement | null"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "setCustomValidity",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "description": "Starts editing the first block, or a new block if the document is empty."
+            },
+            {
+              "kind": "method",
+              "name": "blur",
+              "description": "Commits any in-progress block edit."
+            },
+            {
+              "kind": "method",
+              "name": "handleValueChange"
+            },
+            {
+              "kind": "method",
+              "name": "splitBlocks",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "source",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Splits remarkd source into blocks on blank lines, keeping fenced /\ndelimited containers (``` ==== !!!! .... ----) as single blocks."
+            },
+            {
+              "kind": "method",
+              "name": "fenceMarker",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "line",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "closesFence",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "line",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "fence",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "updateBlocks",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "blocks",
+                  "type": {
+                    "text": "string[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleRenderedClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "toggleCheckbox",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "checkbox",
+                  "type": {
+                    "text": "HTMLInputElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "startEdit",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "draft",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "computeEditShell",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "draft",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The remarkd chrome the editing block should keep, derived from its first\nline — so a NOTE still looks like a note while its source is edited."
+            },
+            {
+              "kind": "method",
+              "name": "focusInput",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "addBlockAt",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "content",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "insertDraftBlock",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "prefill",
+                  "default": "''"
+                }
+              ],
+              "description": "Inserts a draft block — committed (or dropped, if left empty) on blur."
+            },
+            {
+              "kind": "field",
+              "name": "handleEditBlur",
+              "privacy": "private",
+              "description": "Blur handler for the editing textarea. Re-renders that replace the\nfocused textarea (e.g. Shift+Enter committing and opening the next\nblock) fire blur mid-transition — `suppressBlurCommit` masks those."
+            },
+            {
+              "kind": "field",
+              "name": "commitEdit",
+              "privacy": "private",
+              "description": "Commits the in-progress edit; returns the index after the committed parts."
+            },
+            {
+              "kind": "field",
+              "name": "filteredSlashItems",
+              "type": {
+                "text": "BlockType[]"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "handleDraftInput",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleEditKeydown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "applySlashItem",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "BlockType"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "handleEditPaste",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleDragOver",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleDrop",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "insertionIndexFromY",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "y",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The insertion index a drop at `y` maps to, from the rendered block positions."
+            },
+            {
+              "kind": "field",
+              "name": "handleHandlePointerDown",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleDragPointerMove",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleDragPointerUp",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "cancelDrag",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "createDragGhost",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "moveDragGhost",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "x",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "y",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "pickImage",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "handleImageDialogClose",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleImageInsert",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "insertImage",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "File"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "uploadImage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<string>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "File"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "autosize",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "input",
+                  "type": {
+                    "text": "HTMLTextAreaElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleToolbarInsert",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "BlockType"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderSlashMenu",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "renderBlock",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "block",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderImageDialog",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted on each keystroke while editing a block.",
+              "name": "zn-input"
+            },
+            {
+              "description": "Emitted when a block edit is committed and the value changes.",
+              "name": "zn-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The name of the control, submitted as part of form data.",
+              "fieldName": "name"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The current remarkd source.",
+              "fieldName": "value"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Type something…'",
+              "description": "Placeholder shown when the document is empty.",
+              "fieldName": "placeholder"
+            },
+            {
+              "name": "attachment-url",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Endpoint for image uploads. Posting the file metadata here must return\n`{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and\n`uploadPath` is inserted into the document. When unset, adding an image\nprompts for a URL instead.",
+              "fieldName": "attachmentUrl"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the editor required for form submission.",
+              "fieldName": "required"
+            },
+            {
+              "name": "readonly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the editor read-only.",
+              "fieldName": "readonly"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the editor.",
+              "fieldName": "disabled"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.",
+          "tagNameWithoutPrefix": "remarkd-editor",
+          "tagName": "zn-remarkd-editor",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.\n * @documentation https://zinc.style/components/remarkd-editor\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-button\n * @dependency zn-button-group\n * @dependency zn-icon\n * @dependency zn-dialog\n * @dependency zn-file\n * @dependency zn-input\n *\n * @event zn-input - Emitted on each keystroke while editing a block.\n * @event zn-change - Emitted when a block edit is committed and the value changes.\n *\n * @csspart base - The component's base wrapper.\n * @csspart toolbar - The always-visible block-insert toolbar.\n * @csspart block - A rendered block wrapper.\n * @csspart rendered - The rendered remarkd output of a block.\n * @csspart input - The textarea shown while editing a block.\n * @csspart slash-menu - The context menu opened by typing \"/\" in a block.\n */",
+          "documentation": "https://zinc.style/components/remarkd-editor",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-button",
+            "zn-button-group",
+            "zn-icon",
+            "zn-dialog",
+            "zn-file",
+            "zn-input"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnRemarkdEditor",
+            "module": "components/remarkd-editor/remarkd-editor.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/reveal/reveal.js",
@@ -41157,7 +42082,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.63",
+    "version": "1.1.64",
     "author": "",
     "license": "MIT"
   }