@kubex/zinc 1.1.106 → 1.1.107

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.
@@ -7966,6 +7966,15 @@
7966
7966
  "description": "The value of the select. Used for form submission. When `multiple` is enabled, this is an array of strings.",
7967
7967
  "attribute": "value"
7968
7968
  },
7969
+ {
7970
+ "kind": "field",
7971
+ "name": "defaultValue",
7972
+ "type": {
7973
+ "text": "string | string[]"
7974
+ },
7975
+ "default": "''",
7976
+ "description": "The default value of the form control. Primarily used for resetting the form control."
7977
+ },
7969
7978
  {
7970
7979
  "kind": "field",
7971
7980
  "name": "provider",
@@ -21687,6 +21696,15 @@
21687
21696
  },
21688
21697
  "attribute": "value"
21689
21698
  },
21699
+ {
21700
+ "kind": "field",
21701
+ "name": "defaultValue",
21702
+ "type": {
21703
+ "text": "string"
21704
+ },
21705
+ "default": "''",
21706
+ "description": "The default value of the form control. Primarily used for resetting the form control."
21707
+ },
21690
21708
  {
21691
21709
  "kind": "field",
21692
21710
  "name": "checked",
@@ -33766,99 +33784,133 @@
33766
33784
  },
33767
33785
  {
33768
33786
  "kind": "javascript-module",
33769
- "path": "components/rating/rating.js",
33787
+ "path": "components/remarkd-editor/remarkd-editor.js",
33770
33788
  "declarations": [
33771
33789
  {
33772
33790
  "kind": "class",
33773
33791
  "description": "",
33774
- "name": "ZnRating",
33792
+ "name": "ZnRemarkdEditor",
33775
33793
  "cssProperties": [
33776
33794
  {
33777
- "description": "An example CSS custom property.",
33778
- "name": "--example"
33795
+ "description": "The tallest the editor grows before its body scrolls. Defaults to `100dvh`.",
33796
+ "name": "--remarkd-editor-max-height"
33797
+ }
33798
+ ],
33799
+ "cssParts": [
33800
+ {
33801
+ "description": "The component's base wrapper.",
33802
+ "name": "base"
33779
33803
  },
33780
33804
  {
33781
- "description": "The color of the preview value.",
33782
- "name": "--preview-color"
33805
+ "description": "The always-visible block-insert and inline-formatting toolbar.",
33806
+ "name": "toolbar"
33783
33807
  },
33784
33808
  {
33785
- "description": "The font size of the preview value.",
33786
- "name": "--preview-size"
33787
- }
33788
- ],
33789
- "cssParts": [
33809
+ "description": "The button that switches between the block view and the raw source view.",
33810
+ "name": "raw-toggle"
33811
+ },
33790
33812
  {
33791
- "description": "The form control that wraps the symbols and help text.",
33792
- "name": "form-control"
33813
+ "description": "A rendered block wrapper.",
33814
+ "name": "block"
33793
33815
  },
33794
33816
  {
33795
- "description": "The help text's wrapper.",
33796
- "name": "form-control-help-text"
33817
+ "description": "The rendered remarkd output of a block.",
33818
+ "name": "rendered"
33797
33819
  },
33798
33820
  {
33799
- "description": "The component's base wrapper.",
33800
- "name": "base"
33821
+ "description": "A labelled wrapper for an ifdef/ifndef/ifeval/iftrue/iffalse/ifempty/ifnempty range.",
33822
+ "name": "conditional"
33801
33823
  },
33802
33824
  {
33803
- "description": "The value shown next to the symbols when `preview` is enabled.",
33804
- "name": "preview"
33805
- }
33806
- ],
33807
- "slots": [
33825
+ "description": "A chip rendered for a document attribute, title, or bracket line.",
33826
+ "name": "variable"
33827
+ },
33808
33828
  {
33809
- "description": "The default slot.",
33810
- "name": ""
33829
+ "description": "The textarea shown while editing a block.",
33830
+ "name": "input"
33811
33831
  },
33812
33832
  {
33813
- "description": "An example slot.",
33814
- "name": "example"
33833
+ "description": "The full-document textarea shown in raw source mode.",
33834
+ "name": "raw"
33815
33835
  },
33816
33836
  {
33817
- "description": "Text that describes how to use the rating. Alternatively, you can use the `help-text` attribute.",
33818
- "name": "help-text"
33837
+ "description": "The `zn-slash-menu` opened by typing \"/\" in an empty block.",
33838
+ "name": "slash-menu"
33839
+ },
33840
+ {
33841
+ "description": "The caption / alignment / size panel shown when an image block is clicked.",
33842
+ "name": "image-controls"
33843
+ },
33844
+ {
33845
+ "description": "The chip rendered in place of an `include::` directive.",
33846
+ "name": "include"
33847
+ },
33848
+ {
33849
+ "description": "The inline Include picker opened from the toolbar or \"/include\".",
33850
+ "name": "include-picker"
33819
33851
  }
33820
33852
  ],
33821
33853
  "members": [
33854
+ {
33855
+ "kind": "field",
33856
+ "name": "dependencies",
33857
+ "type": {
33858
+ "text": "object"
33859
+ },
33860
+ "static": true,
33861
+ "default": "{ 'zn-dropdown': ZnDropdown, 'zn-menu': ZnMenu, 'zn-menu-item': ZnMenuItem, 'zn-slash-menu': ZnSlashMenu }"
33862
+ },
33822
33863
  {
33823
33864
  "kind": "field",
33824
33865
  "name": "formControlController",
33825
33866
  "privacy": "private",
33826
33867
  "readonly": true,
33827
- "default": "new FormControlController(this, { assumeInteractionOn: ['zn-blur', 'zn-input'] })"
33868
+ "default": "new FormControlController(this, { assumeInteractionOn: ['zn-input', 'zn-change'], })"
33828
33869
  },
33829
33870
  {
33830
33871
  "kind": "field",
33831
- "name": "hasSlotController",
33872
+ "name": "slashController",
33832
33873
  "privacy": "private",
33833
33874
  "readonly": true,
33834
- "default": "new HasSlotController(this, 'help-text')"
33875
+ "default": "new SlashMenuController(this, { menu: () => this.mountSlashMenu(), // The menu only belongs in a block that is nothing but the slash command — a // block prefix like \"## \" is not valid remarkd part-way through a line. items: () => this.isSlashBlock() ? SLASH_ITEMS.filter(item => item.action !== 'include' || !!this.includeUrl) : [], onSelect: item => this.handleSlashSelect(item) })"
33835
33876
  },
33836
33877
  {
33837
33878
  "kind": "field",
33838
- "name": "rating",
33879
+ "name": "toolbarOverflow",
33880
+ "privacy": "private",
33881
+ "readonly": true,
33882
+ "default": "new ToolbarOverflowController(this, { groups: () => [...(this.shadowRoot?.querySelectorAll<HTMLElement>('.toolbar__group') ?? [])], container: () => this.shadowRoot?.querySelector<HTMLElement>('.remarkd-editor__toolbar'), })"
33883
+ },
33884
+ {
33885
+ "kind": "field",
33886
+ "name": "editingDraft",
33839
33887
  "type": {
33840
- "text": "HTMLElement"
33841
- }
33888
+ "text": "string"
33889
+ },
33890
+ "privacy": "private",
33891
+ "default": "''"
33842
33892
  },
33843
33893
  {
33844
33894
  "kind": "field",
33845
- "name": "symbols",
33895
+ "name": "includeRequest",
33846
33896
  "type": {
33847
- "text": "HTMLElement"
33848
- }
33897
+ "text": "Promise<IncludeOption[]> | null"
33898
+ },
33899
+ "privacy": "private",
33900
+ "default": "null"
33849
33901
  },
33850
33902
  {
33851
33903
  "kind": "field",
33852
- "name": "hoverValue",
33904
+ "name": "rawEntryValue",
33853
33905
  "type": {
33854
- "text": "number"
33906
+ "text": "string"
33855
33907
  },
33856
33908
  "privacy": "private",
33857
- "default": "0"
33909
+ "default": "''"
33858
33910
  },
33859
33911
  {
33860
33912
  "kind": "field",
33861
- "name": "isHovering",
33913
+ "name": "suppressValueSync",
33862
33914
  "type": {
33863
33915
  "text": "boolean"
33864
33916
  },
@@ -33867,21 +33919,210 @@
33867
33919
  },
33868
33920
  {
33869
33921
  "kind": "field",
33870
- "name": "label",
33922
+ "name": "suppressBlurCommit",
33871
33923
  "type": {
33872
- "text": "string"
33924
+ "text": "boolean"
33873
33925
  },
33874
- "attribute": "label"
33926
+ "privacy": "private",
33927
+ "default": "false"
33875
33928
  },
33876
33929
  {
33877
33930
  "kind": "field",
33878
- "name": "helpText",
33931
+ "name": "validationInput",
33932
+ "type": {
33933
+ "text": "HTMLTextAreaElement"
33934
+ },
33935
+ "privacy": "private"
33936
+ },
33937
+ {
33938
+ "kind": "field",
33939
+ "name": "slashMenuElement",
33940
+ "type": {
33941
+ "text": "ZnSlashMenu | null"
33942
+ },
33943
+ "privacy": "private"
33944
+ },
33945
+ {
33946
+ "kind": "field",
33947
+ "name": "blocks",
33948
+ "type": {
33949
+ "text": "string[]"
33950
+ },
33951
+ "privacy": "private",
33952
+ "default": "[]"
33953
+ },
33954
+ {
33955
+ "kind": "field",
33956
+ "name": "editingIndex",
33957
+ "type": {
33958
+ "text": "number | null"
33959
+ },
33960
+ "privacy": "private",
33961
+ "default": "null"
33962
+ },
33963
+ {
33964
+ "kind": "field",
33965
+ "name": "slashRecentKey",
33879
33966
  "type": {
33880
33967
  "text": "string"
33881
33968
  },
33882
33969
  "default": "''",
33883
- "description": "The rating's help text. If you need to display HTML, use the `help-text` slot instead.",
33884
- "attribute": "help-text"
33970
+ "description": "Lists the blocks most recently inserted here above the rest of the slash menu, remembered in\n`localStorage` under this key. Leave unset to offer no recently used section.",
33971
+ "attribute": "slash-recent-key"
33972
+ },
33973
+ {
33974
+ "kind": "field",
33975
+ "name": "hasSlashMenu",
33976
+ "type": {
33977
+ "text": "boolean"
33978
+ },
33979
+ "privacy": "private",
33980
+ "default": "false",
33981
+ "description": "Renders the slash menu only once it has been needed."
33982
+ },
33983
+ {
33984
+ "kind": "field",
33985
+ "name": "imagePickerIndex",
33986
+ "type": {
33987
+ "text": "number | null"
33988
+ },
33989
+ "privacy": "private",
33990
+ "default": "null"
33991
+ },
33992
+ {
33993
+ "kind": "field",
33994
+ "name": "imageEdit",
33995
+ "type": {
33996
+ "text": "ImageBlockData | null"
33997
+ },
33998
+ "privacy": "private",
33999
+ "default": "null"
34000
+ },
34001
+ {
34002
+ "kind": "field",
34003
+ "name": "dropIndicator",
34004
+ "type": {
34005
+ "text": "number | null"
34006
+ },
34007
+ "privacy": "private",
34008
+ "default": "null"
34009
+ },
34010
+ {
34011
+ "kind": "field",
34012
+ "name": "dragIndex",
34013
+ "type": {
34014
+ "text": "number | null"
34015
+ },
34016
+ "privacy": "private",
34017
+ "default": "null"
34018
+ },
34019
+ {
34020
+ "kind": "field",
34021
+ "name": "editShell",
34022
+ "type": {
34023
+ "text": "string"
34024
+ },
34025
+ "privacy": "private",
34026
+ "default": "''"
34027
+ },
34028
+ {
34029
+ "kind": "field",
34030
+ "name": "rawMode",
34031
+ "type": {
34032
+ "text": "boolean"
34033
+ },
34034
+ "privacy": "private",
34035
+ "default": "false"
34036
+ },
34037
+ {
34038
+ "kind": "field",
34039
+ "name": "includeOptions",
34040
+ "type": {
34041
+ "text": "IncludeOption[] | null"
34042
+ },
34043
+ "privacy": "private",
34044
+ "default": "null"
34045
+ },
34046
+ {
34047
+ "kind": "field",
34048
+ "name": "includeLoadFailed",
34049
+ "type": {
34050
+ "text": "boolean"
34051
+ },
34052
+ "privacy": "private",
34053
+ "default": "false"
34054
+ },
34055
+ {
34056
+ "kind": "field",
34057
+ "name": "includePickerIndex",
34058
+ "type": {
34059
+ "text": "number | null"
34060
+ },
34061
+ "privacy": "private",
34062
+ "default": "null"
34063
+ },
34064
+ {
34065
+ "kind": "field",
34066
+ "name": "includeQuery",
34067
+ "type": {
34068
+ "text": "string"
34069
+ },
34070
+ "privacy": "private",
34071
+ "default": "''"
34072
+ },
34073
+ {
34074
+ "kind": "field",
34075
+ "name": "pendingDragHandle",
34076
+ "type": {
34077
+ "text": "HTMLElement | null"
34078
+ },
34079
+ "privacy": "private",
34080
+ "default": "null"
34081
+ },
34082
+ {
34083
+ "kind": "field",
34084
+ "name": "dragStartX",
34085
+ "type": {
34086
+ "text": "number"
34087
+ },
34088
+ "privacy": "private",
34089
+ "default": "0"
34090
+ },
34091
+ {
34092
+ "kind": "field",
34093
+ "name": "dragStartY",
34094
+ "type": {
34095
+ "text": "number"
34096
+ },
34097
+ "privacy": "private",
34098
+ "default": "0"
34099
+ },
34100
+ {
34101
+ "kind": "field",
34102
+ "name": "dragGhost",
34103
+ "type": {
34104
+ "text": "HTMLElement | null"
34105
+ },
34106
+ "privacy": "private",
34107
+ "default": "null"
34108
+ },
34109
+ {
34110
+ "kind": "field",
34111
+ "name": "dragPointerY",
34112
+ "type": {
34113
+ "text": "number"
34114
+ },
34115
+ "privacy": "private",
34116
+ "default": "0"
34117
+ },
34118
+ {
34119
+ "kind": "field",
34120
+ "name": "autoScrollFrame",
34121
+ "type": {
34122
+ "text": "number | null"
34123
+ },
34124
+ "privacy": "private",
34125
+ "default": "null"
33885
34126
  },
33886
34127
  {
33887
34128
  "kind": "field",
@@ -33889,90 +34130,117 @@
33889
34130
  "type": {
33890
34131
  "text": "string"
33891
34132
  },
34133
+ "default": "''",
34134
+ "description": "The name of the control, submitted as part of form data.",
33892
34135
  "attribute": "name"
33893
34136
  },
33894
34137
  {
33895
34138
  "kind": "field",
33896
34139
  "name": "value",
33897
34140
  "type": {
33898
- "text": "number"
34141
+ "text": "string"
33899
34142
  },
33900
- "default": "0",
34143
+ "default": "''",
34144
+ "description": "The current remarkd source.",
33901
34145
  "attribute": "value"
33902
34146
  },
33903
34147
  {
33904
34148
  "kind": "field",
33905
- "name": "max",
34149
+ "name": "defaultValue",
33906
34150
  "type": {
33907
- "text": "number"
34151
+ "text": "string"
33908
34152
  },
33909
- "default": "5",
33910
- "attribute": "max"
34153
+ "default": "''",
34154
+ "description": "The default value — used when resetting the form."
33911
34155
  },
33912
34156
  {
33913
34157
  "kind": "field",
33914
- "name": "precision",
34158
+ "name": "placeholder",
33915
34159
  "type": {
33916
- "text": "number"
34160
+ "text": "string"
33917
34161
  },
33918
- "default": "1",
33919
- "attribute": "precision"
34162
+ "default": "'Type something…'",
34163
+ "description": "Placeholder shown when the document is empty.",
34164
+ "attribute": "placeholder"
33920
34165
  },
33921
34166
  {
33922
34167
  "kind": "field",
33923
- "name": "readonly",
34168
+ "name": "attachmentUrl",
33924
34169
  "type": {
33925
- "text": "boolean"
34170
+ "text": "string"
33926
34171
  },
33927
- "default": "false",
33928
- "attribute": "readonly"
34172
+ "default": "''",
34173
+ "description": "Endpoint for image uploads — required for image support. Posting the file\nmetadata here must return `{uploadPath, uploadUrl}`; the file is then PUT\nto `uploadUrl` and the returned `uploadPath` is embedded as the image URL.",
34174
+ "attribute": "attachment-url"
33929
34175
  },
33930
34176
  {
33931
34177
  "kind": "field",
33932
- "name": "disabled",
34178
+ "name": "includeUrl",
34179
+ "type": {
34180
+ "text": "string"
34181
+ },
34182
+ "default": "''",
34183
+ "description": "Endpoint listing the Includes this document may embed, as\n`{\"items\":[{id,title,description,scope,keywords,languages,url}]}`. Labels the\nchips rendered for `include::` directives and feeds the include picker.",
34184
+ "attribute": "include-url"
34185
+ },
34186
+ {
34187
+ "kind": "field",
34188
+ "name": "allowRaw",
33933
34189
  "type": {
33934
34190
  "text": "boolean"
33935
34191
  },
33936
34192
  "default": "false",
33937
- "attribute": "disabled"
34193
+ "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
34194
+ "attribute": "allow-raw",
34195
+ "reflects": true
33938
34196
  },
33939
34197
  {
33940
34198
  "kind": "field",
33941
- "name": "preview",
34199
+ "name": "required",
33942
34200
  "type": {
33943
34201
  "text": "boolean"
33944
34202
  },
33945
34203
  "default": "false",
33946
- "description": "Displays the value alongside the symbols, updating live as the pointer moves across them.",
33947
- "attribute": "preview"
34204
+ "description": "Makes the editor required for form submission.",
34205
+ "attribute": "required",
34206
+ "reflects": true
33948
34207
  },
33949
34208
  {
33950
34209
  "kind": "field",
33951
- "name": "size",
34210
+ "name": "readonly",
33952
34211
  "type": {
33953
- "text": "'small' | 'medium' | 'large'"
34212
+ "text": "boolean"
33954
34213
  },
33955
- "default": "'medium'",
33956
- "attribute": "size"
34214
+ "default": "false",
34215
+ "description": "Makes the editor read-only.",
34216
+ "attribute": "readonly",
34217
+ "reflects": true
33957
34218
  },
33958
34219
  {
33959
34220
  "kind": "field",
33960
- "name": "getSymbol",
34221
+ "name": "disabled",
33961
34222
  "type": {
33962
- "text": "(value: number) => string"
34223
+ "text": "boolean"
33963
34224
  },
33964
- "attribute": "getSymbol"
34225
+ "default": "false",
34226
+ "description": "Disables the editor.",
34227
+ "attribute": "disabled",
34228
+ "reflects": true
33965
34229
  },
33966
34230
  {
33967
34231
  "kind": "field",
33968
34232
  "name": "validity",
33969
- "description": "Gets the validity state object",
34233
+ "type": {
34234
+ "text": "ValidityState"
34235
+ },
33970
34236
  "readonly": true
33971
34237
  },
33972
34238
  {
33973
34239
  "kind": "field",
33974
34240
  "name": "validationMessage",
33975
- "description": "Gets the validation message",
34241
+ "type": {
34242
+ "text": "string"
34243
+ },
33976
34244
  "readonly": true
33977
34245
  },
33978
34246
  {
@@ -33982,8 +34250,7 @@
33982
34250
  "type": {
33983
34251
  "text": "boolean"
33984
34252
  }
33985
- },
33986
- "description": "Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
34253
+ }
33987
34254
  },
33988
34255
  {
33989
34256
  "kind": "method",
@@ -33992,122 +34259,139 @@
33992
34259
  "type": {
33993
34260
  "text": "HTMLFormElement | null"
33994
34261
  }
33995
- },
33996
- "description": "Gets the associated form, if one exists."
34262
+ }
33997
34263
  },
33998
34264
  {
33999
34265
  "kind": "method",
34000
34266
  "name": "reportValidity",
34001
- "description": "Checks for validity and shows the browser's validation message if the control is invalid."
34267
+ "return": {
34268
+ "type": {
34269
+ "text": "boolean"
34270
+ }
34271
+ }
34002
34272
  },
34003
34273
  {
34004
34274
  "kind": "method",
34005
34275
  "name": "setCustomValidity",
34006
- "description": "Sets a custom validation message. Pass an empty string to restore validity."
34007
- },
34008
- {
34009
- "kind": "method",
34010
- "name": "_roundToPrecision",
34011
- "privacy": "private",
34012
34276
  "return": {
34013
34277
  "type": {
34014
- "text": "number"
34278
+ "text": "void"
34015
34279
  }
34016
34280
  },
34017
34281
  "parameters": [
34018
34282
  {
34019
- "name": "value",
34020
- "type": {
34021
- "text": "number"
34022
- }
34023
- },
34024
- {
34025
- "name": "precision",
34283
+ "name": "message",
34026
34284
  "type": {
34027
- "text": "number"
34285
+ "text": "string"
34028
34286
  }
34029
34287
  }
34030
34288
  ]
34031
34289
  },
34032
34290
  {
34033
34291
  "kind": "method",
34034
- "name": "_getValueFromXCoordinate",
34292
+ "name": "focus",
34293
+ "description": "Starts editing the first block, or a new block if the document is empty."
34294
+ },
34295
+ {
34296
+ "kind": "method",
34297
+ "name": "blur",
34298
+ "description": "Commits any in-progress block or raw edit."
34299
+ },
34300
+ {
34301
+ "kind": "method",
34302
+ "name": "handleValueChange"
34303
+ },
34304
+ {
34305
+ "kind": "method",
34306
+ "name": "handleIncludeUrlChange"
34307
+ },
34308
+ {
34309
+ "kind": "method",
34310
+ "name": "splitBlocks",
34035
34311
  "privacy": "private",
34036
34312
  "return": {
34037
34313
  "type": {
34038
- "text": "number"
34314
+ "text": "string[]"
34039
34315
  }
34040
34316
  },
34041
34317
  "parameters": [
34042
34318
  {
34043
- "name": "coordinate",
34319
+ "name": "source",
34044
34320
  "type": {
34045
- "text": "number"
34321
+ "text": "string"
34046
34322
  }
34047
34323
  }
34048
- ]
34324
+ ],
34325
+ "description": "Splits remarkd source into blocks on blank lines, keeping fenced /\ndelimited containers (``` ==== !!!! .... ---- ____ **** ////) as single blocks."
34049
34326
  },
34050
34327
  {
34051
34328
  "kind": "method",
34052
- "name": "_formatValue",
34329
+ "name": "fenceMarker",
34053
34330
  "privacy": "private",
34054
34331
  "return": {
34055
34332
  "type": {
34056
- "text": "string"
34333
+ "text": "string | null"
34057
34334
  }
34058
34335
  },
34059
34336
  "parameters": [
34060
34337
  {
34061
- "name": "value",
34338
+ "name": "line",
34062
34339
  "type": {
34063
- "text": "number"
34340
+ "text": "string"
34064
34341
  }
34065
34342
  }
34066
34343
  ]
34067
34344
  },
34068
34345
  {
34069
34346
  "kind": "method",
34070
- "name": "_getValueFromMousePosition",
34347
+ "name": "closesFence",
34071
34348
  "privacy": "private",
34072
34349
  "return": {
34073
34350
  "type": {
34074
- "text": "number"
34351
+ "text": "boolean"
34075
34352
  }
34076
34353
  },
34077
34354
  "parameters": [
34078
34355
  {
34079
- "name": "event",
34356
+ "name": "line",
34080
34357
  "type": {
34081
- "text": "MouseEvent"
34358
+ "text": "string"
34359
+ }
34360
+ },
34361
+ {
34362
+ "name": "fence",
34363
+ "type": {
34364
+ "text": "string"
34082
34365
  }
34083
34366
  }
34084
34367
  ]
34085
34368
  },
34086
34369
  {
34087
34370
  "kind": "method",
34088
- "name": "_getValueFromTouchPosition",
34371
+ "name": "updateBlocks",
34089
34372
  "privacy": "private",
34090
- "return": {
34091
- "type": {
34092
- "text": "number"
34093
- }
34094
- },
34095
34373
  "parameters": [
34096
34374
  {
34097
- "name": "event",
34375
+ "name": "blocks",
34098
34376
  "type": {
34099
- "text": "TouchEvent"
34377
+ "text": "string[]"
34100
34378
  }
34101
34379
  }
34102
34380
  ]
34103
34381
  },
34104
34382
  {
34105
34383
  "kind": "method",
34106
- "name": "_setValue",
34384
+ "name": "handleRenderedClick",
34107
34385
  "privacy": "private",
34108
34386
  "parameters": [
34109
34387
  {
34110
- "name": "value",
34388
+ "name": "e",
34389
+ "type": {
34390
+ "text": "MouseEvent"
34391
+ }
34392
+ },
34393
+ {
34394
+ "name": "index",
34111
34395
  "type": {
34112
34396
  "text": "number"
34113
34397
  }
@@ -34116,817 +34400,556 @@
34116
34400
  },
34117
34401
  {
34118
34402
  "kind": "method",
34119
- "name": "_handleClick",
34403
+ "name": "parseImageBlock",
34120
34404
  "privacy": "private",
34405
+ "return": {
34406
+ "type": {
34407
+ "text": "ImageBlockData | null"
34408
+ }
34409
+ },
34121
34410
  "parameters": [
34122
34411
  {
34123
- "name": "event",
34412
+ "name": "block",
34124
34413
  "type": {
34125
- "text": "MouseEvent"
34414
+ "text": "string"
34126
34415
  }
34127
34416
  }
34128
- ]
34417
+ ],
34418
+ "description": "Parses a block that is purely an image (with optional caption/align lines)."
34129
34419
  },
34130
34420
  {
34131
34421
  "kind": "method",
34132
- "name": "_handleMouseEnter",
34422
+ "name": "parseIncludeBlock",
34133
34423
  "privacy": "private",
34424
+ "return": {
34425
+ "type": {
34426
+ "text": "IncludeBlockData | null"
34427
+ }
34428
+ },
34134
34429
  "parameters": [
34135
34430
  {
34136
- "name": "event",
34431
+ "name": "block",
34137
34432
  "type": {
34138
- "text": "MouseEvent"
34433
+ "text": "string"
34139
34434
  }
34140
34435
  }
34141
- ]
34436
+ ],
34437
+ "description": "Parses a block that is nothing but an include directive."
34142
34438
  },
34143
34439
  {
34144
34440
  "kind": "method",
34145
- "name": "_handleMouseMove",
34441
+ "name": "serializeImageBlock",
34146
34442
  "privacy": "private",
34443
+ "return": {
34444
+ "type": {
34445
+ "text": "string"
34446
+ }
34447
+ },
34147
34448
  "parameters": [
34148
34449
  {
34149
- "name": "event",
34450
+ "name": "data",
34150
34451
  "type": {
34151
- "text": "MouseEvent"
34452
+ "text": "ImageBlockData"
34152
34453
  }
34153
34454
  }
34154
34455
  ]
34155
34456
  },
34156
34457
  {
34157
34458
  "kind": "method",
34158
- "name": "_handleMouseLeave",
34159
- "privacy": "private"
34160
- },
34161
- {
34162
- "kind": "method",
34163
- "name": "_handleTouchStart",
34459
+ "name": "toggleCheckbox",
34164
34460
  "privacy": "private",
34165
34461
  "parameters": [
34166
34462
  {
34167
- "name": "event",
34463
+ "name": "index",
34168
34464
  "type": {
34169
- "text": "TouchEvent"
34465
+ "text": "number"
34466
+ }
34467
+ },
34468
+ {
34469
+ "name": "checkbox",
34470
+ "type": {
34471
+ "text": "HTMLInputElement"
34170
34472
  }
34171
34473
  }
34172
34474
  ]
34173
34475
  },
34174
34476
  {
34175
34477
  "kind": "method",
34176
- "name": "_handleTouchMove",
34478
+ "name": "startEdit",
34177
34479
  "privacy": "private",
34178
34480
  "parameters": [
34179
34481
  {
34180
- "name": "event",
34482
+ "name": "index",
34181
34483
  "type": {
34182
- "text": "TouchEvent"
34484
+ "text": "number"
34485
+ }
34486
+ },
34487
+ {
34488
+ "name": "draft",
34489
+ "optional": true,
34490
+ "type": {
34491
+ "text": "string"
34492
+ }
34493
+ },
34494
+ {
34495
+ "name": "align",
34496
+ "default": "'nearest'",
34497
+ "type": {
34498
+ "text": "'nearest' | 'center'"
34499
+ }
34500
+ },
34501
+ {
34502
+ "name": "caretOffset",
34503
+ "optional": true,
34504
+ "type": {
34505
+ "text": "number"
34183
34506
  }
34184
34507
  }
34185
34508
  ]
34186
34509
  },
34187
34510
  {
34188
34511
  "kind": "method",
34189
- "name": "_handleTouchEnd",
34512
+ "name": "updateImageEdit",
34190
34513
  "privacy": "private",
34191
34514
  "parameters": [
34192
34515
  {
34193
- "name": "event",
34516
+ "name": "patch",
34194
34517
  "type": {
34195
- "text": "TouchEvent"
34518
+ "text": "Partial<ImageBlockData>"
34196
34519
  }
34197
34520
  }
34198
34521
  ]
34199
- }
34200
- ],
34201
- "events": [
34202
- {
34203
- "description": "Emitted as an example.",
34204
- "name": "zn-event-name"
34205
- }
34206
- ],
34207
- "attributes": [
34208
- {
34209
- "name": "label",
34210
- "type": {
34211
- "text": "string"
34212
- },
34213
- "fieldName": "label"
34214
34522
  },
34215
34523
  {
34216
- "name": "help-text",
34217
- "type": {
34218
- "text": "string"
34219
- },
34220
- "default": "''",
34221
- "description": "The rating's help text. If you need to display HTML, use the `help-text` slot instead.",
34222
- "fieldName": "helpText"
34223
- },
34224
- {
34225
- "name": "name",
34226
- "type": {
34227
- "text": "string"
34228
- },
34229
- "fieldName": "name"
34524
+ "kind": "field",
34525
+ "name": "saveImageEdit",
34526
+ "privacy": "private"
34230
34527
  },
34231
34528
  {
34232
- "name": "value",
34233
- "type": {
34234
- "text": "number"
34235
- },
34236
- "default": "0",
34237
- "fieldName": "value"
34529
+ "kind": "field",
34530
+ "name": "closeImageEdit",
34531
+ "privacy": "private"
34238
34532
  },
34239
34533
  {
34240
- "name": "max",
34241
- "type": {
34242
- "text": "number"
34243
- },
34244
- "default": "5",
34245
- "fieldName": "max"
34534
+ "kind": "field",
34535
+ "name": "deleteImageBlock",
34536
+ "privacy": "private"
34246
34537
  },
34247
34538
  {
34248
- "name": "precision",
34249
- "type": {
34250
- "text": "number"
34251
- },
34252
- "default": "1",
34253
- "fieldName": "precision"
34539
+ "kind": "field",
34540
+ "name": "editImageSource",
34541
+ "privacy": "private"
34254
34542
  },
34255
34543
  {
34256
- "name": "readonly",
34257
- "type": {
34258
- "text": "boolean"
34259
- },
34260
- "default": "false",
34261
- "fieldName": "readonly"
34544
+ "kind": "field",
34545
+ "name": "handleImageControlsKeydown",
34546
+ "privacy": "private"
34262
34547
  },
34263
34548
  {
34264
- "name": "disabled",
34265
- "type": {
34266
- "text": "boolean"
34549
+ "kind": "method",
34550
+ "name": "computeEditShell",
34551
+ "privacy": "private",
34552
+ "return": {
34553
+ "type": {
34554
+ "text": "string"
34555
+ }
34267
34556
  },
34268
- "default": "false",
34269
- "fieldName": "disabled"
34557
+ "parameters": [
34558
+ {
34559
+ "name": "draft",
34560
+ "type": {
34561
+ "text": "string"
34562
+ }
34563
+ }
34564
+ ],
34565
+ "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."
34270
34566
  },
34271
34567
  {
34272
- "name": "preview",
34273
- "type": {
34274
- "text": "boolean"
34275
- },
34276
- "default": "false",
34277
- "description": "Displays the value alongside the symbols, updating live as the pointer moves across them.",
34278
- "fieldName": "preview"
34568
+ "kind": "method",
34569
+ "name": "focusInput",
34570
+ "privacy": "private",
34571
+ "parameters": [
34572
+ {
34573
+ "name": "align",
34574
+ "default": "'nearest'",
34575
+ "type": {
34576
+ "text": "'nearest' | 'center'"
34577
+ }
34578
+ },
34579
+ {
34580
+ "name": "caretOffset",
34581
+ "optional": true,
34582
+ "type": {
34583
+ "text": "number"
34584
+ }
34585
+ }
34586
+ ]
34279
34587
  },
34280
34588
  {
34281
- "name": "size",
34282
- "type": {
34283
- "text": "'small' | 'medium' | 'large'"
34284
- },
34285
- "default": "'medium'",
34286
- "fieldName": "size"
34589
+ "kind": "method",
34590
+ "name": "reveal",
34591
+ "privacy": "private",
34592
+ "parameters": [
34593
+ {
34594
+ "name": "el",
34595
+ "type": {
34596
+ "text": "Element | null | undefined"
34597
+ }
34598
+ },
34599
+ {
34600
+ "name": "align",
34601
+ "default": "'nearest'",
34602
+ "type": {
34603
+ "text": "'nearest' | 'center'"
34604
+ }
34605
+ }
34606
+ ],
34607
+ "description": "Scrolls the editor's own body to bring `el` into view. Never `scrollIntoView()` and\nnever `focus()` without preventScroll: both walk every scrollable ancestor, and an\n`overflow: hidden`/`auto` panel around the editor is scrollable too — that shifts a\ncontainer the user never asked to move."
34287
34608
  },
34288
34609
  {
34289
- "name": "getSymbol",
34290
- "type": {
34291
- "text": "(value: number) => string"
34292
- },
34293
- "fieldName": "getSymbol"
34294
- }
34295
- ],
34296
- "superclass": {
34297
- "name": "ZincElement",
34298
- "module": "/src/internal/zinc-element"
34299
- },
34300
- "summary": "Short summary of the component's intended use.",
34301
- "tagNameWithoutPrefix": "rating",
34302
- "tagName": "zn-rating",
34303
- "customElement": true,
34304
- "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/rating\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n * @slot help-text - Text that describes how to use the rating. Alternatively, you can use the `help-text` attribute.\n *\n * @csspart form-control - The form control that wraps the symbols and help text.\n * @csspart form-control-help-text - The help text's wrapper.\n * @csspart base - The component's base wrapper.\n * @csspart preview - The value shown next to the symbols when `preview` is enabled.\n *\n * @cssproperty --example - An example CSS custom property.\n * @cssproperty --preview-color - The color of the preview value.\n * @cssproperty --preview-size - The font size of the preview value.\n */",
34305
- "documentation": "https://zinc.style/components/rating",
34306
- "status": "experimental",
34307
- "since": "1.0",
34308
- "dependencies": [
34309
- "zn-example"
34310
- ]
34311
- }
34312
- ],
34313
- "exports": [
34314
- {
34315
- "kind": "js",
34316
- "name": "default",
34317
- "declaration": {
34318
- "name": "ZnRating",
34319
- "module": "components/rating/rating.js"
34320
- }
34321
- }
34322
- ]
34323
- },
34324
- {
34325
- "kind": "javascript-module",
34326
- "path": "components/remarkd-editor/remarkd-editor.js",
34327
- "declarations": [
34328
- {
34329
- "kind": "class",
34330
- "description": "",
34331
- "name": "ZnRemarkdEditor",
34332
- "cssProperties": [
34333
- {
34334
- "description": "The tallest the editor grows before its body scrolls. Defaults to `100dvh`.",
34335
- "name": "--remarkd-editor-max-height"
34336
- }
34337
- ],
34338
- "cssParts": [
34339
- {
34340
- "description": "The component's base wrapper.",
34341
- "name": "base"
34610
+ "kind": "method",
34611
+ "name": "revealAfterUpdate",
34612
+ "privacy": "private",
34613
+ "parameters": [
34614
+ {
34615
+ "name": "selector",
34616
+ "type": {
34617
+ "text": "string"
34618
+ }
34619
+ },
34620
+ {
34621
+ "name": "align",
34622
+ "default": "'nearest'",
34623
+ "type": {
34624
+ "text": "'nearest' | 'center'"
34625
+ }
34626
+ }
34627
+ ]
34342
34628
  },
34343
34629
  {
34344
- "description": "The always-visible block-insert and inline-formatting toolbar.",
34345
- "name": "toolbar"
34630
+ "kind": "method",
34631
+ "name": "revealBlock",
34632
+ "privacy": "private",
34633
+ "parameters": [
34634
+ {
34635
+ "name": "index",
34636
+ "type": {
34637
+ "text": "number"
34638
+ }
34639
+ }
34640
+ ],
34641
+ "description": "Centres a block added without opening an editor. An image has no height until it\nloads, so the first pass scrolls against a layout that is still short — the second\npass corrects it once the real dimensions are in."
34346
34642
  },
34347
34643
  {
34348
- "description": "The button that switches between the block view and the raw source view.",
34349
- "name": "raw-toggle"
34644
+ "kind": "method",
34645
+ "name": "addBlockAt",
34646
+ "privacy": "private",
34647
+ "parameters": [
34648
+ {
34649
+ "name": "index",
34650
+ "type": {
34651
+ "text": "number"
34652
+ }
34653
+ },
34654
+ {
34655
+ "name": "content",
34656
+ "type": {
34657
+ "text": "string"
34658
+ }
34659
+ }
34660
+ ]
34350
34661
  },
34351
34662
  {
34352
- "description": "A rendered block wrapper.",
34353
- "name": "block"
34663
+ "kind": "method",
34664
+ "name": "deleteBlock",
34665
+ "privacy": "private",
34666
+ "parameters": [
34667
+ {
34668
+ "name": "index",
34669
+ "type": {
34670
+ "text": "number"
34671
+ }
34672
+ }
34673
+ ]
34354
34674
  },
34355
34675
  {
34356
- "description": "The rendered remarkd output of a block.",
34357
- "name": "rendered"
34676
+ "kind": "method",
34677
+ "name": "insertDraftBlock",
34678
+ "privacy": "private",
34679
+ "parameters": [
34680
+ {
34681
+ "name": "index",
34682
+ "type": {
34683
+ "text": "number"
34684
+ }
34685
+ },
34686
+ {
34687
+ "name": "prefill",
34688
+ "default": "''"
34689
+ },
34690
+ {
34691
+ "name": "caretOffset",
34692
+ "optional": true,
34693
+ "type": {
34694
+ "text": "number"
34695
+ }
34696
+ }
34697
+ ],
34698
+ "description": "Inserts a draft block — committed (or dropped, if left empty) on blur."
34358
34699
  },
34359
34700
  {
34360
- "description": "A labelled wrapper for an ifdef/ifndef/ifeval/iftrue/iffalse/ifempty/ifnempty range.",
34361
- "name": "conditional"
34701
+ "kind": "field",
34702
+ "name": "handleEditBlur",
34703
+ "privacy": "private",
34704
+ "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."
34362
34705
  },
34363
34706
  {
34364
- "description": "A chip rendered for a document attribute, title, or bracket line.",
34365
- "name": "variable"
34707
+ "kind": "field",
34708
+ "name": "commitEdit",
34709
+ "privacy": "private",
34710
+ "description": "Commits the in-progress edit; returns the index after the committed parts."
34366
34711
  },
34367
34712
  {
34368
- "description": "The textarea shown while editing a block.",
34369
- "name": "input"
34713
+ "kind": "field",
34714
+ "name": "handleDraftInput",
34715
+ "privacy": "private"
34370
34716
  },
34371
34717
  {
34372
- "description": "The full-document textarea shown in raw source mode.",
34373
- "name": "raw"
34718
+ "kind": "field",
34719
+ "name": "handleEditKeydown",
34720
+ "privacy": "private"
34374
34721
  },
34375
34722
  {
34376
- "description": "The `zn-slash-menu` opened by typing \"/\" in an empty block.",
34377
- "name": "slash-menu"
34723
+ "kind": "method",
34724
+ "name": "isSlashBlock",
34725
+ "privacy": "private",
34726
+ "return": {
34727
+ "type": {
34728
+ "text": "boolean"
34729
+ }
34730
+ },
34731
+ "description": "Whether the block being edited is nothing but the slash command."
34378
34732
  },
34379
34733
  {
34380
- "description": "The caption / alignment / size panel shown when an image block is clicked.",
34381
- "name": "image-controls"
34734
+ "kind": "method",
34735
+ "name": "mountSlashMenu",
34736
+ "privacy": "private",
34737
+ "return": {
34738
+ "type": {
34739
+ "text": "Promise<ZnSlashMenu | null>"
34740
+ }
34741
+ }
34382
34742
  },
34383
34743
  {
34384
- "description": "The chip rendered in place of an `include::` directive.",
34385
- "name": "include"
34744
+ "kind": "method",
34745
+ "name": "handleSlashSelect",
34746
+ "privacy": "private",
34747
+ "return": {
34748
+ "type": {
34749
+ "text": "boolean"
34750
+ }
34751
+ },
34752
+ "parameters": [
34753
+ {
34754
+ "name": "item",
34755
+ "type": {
34756
+ "text": "SlashMenuItem"
34757
+ }
34758
+ }
34759
+ ],
34760
+ "description": "Returns false for items the controller should not insert text for."
34386
34761
  },
34387
- {
34388
- "description": "The inline Include picker opened from the toolbar or \"/include\".",
34389
- "name": "include-picker"
34390
- }
34391
- ],
34392
- "members": [
34393
34762
  {
34394
34763
  "kind": "field",
34395
- "name": "dependencies",
34396
- "type": {
34397
- "text": "object"
34398
- },
34399
- "static": true,
34400
- "default": "{ 'zn-dropdown': ZnDropdown, 'zn-menu': ZnMenu, 'zn-menu-item': ZnMenuItem, 'zn-slash-menu': ZnSlashMenu }"
34764
+ "name": "handleEditPaste",
34765
+ "privacy": "private"
34401
34766
  },
34402
34767
  {
34403
34768
  "kind": "field",
34404
- "name": "formControlController",
34405
- "privacy": "private",
34406
- "readonly": true,
34407
- "default": "new FormControlController(this, { assumeInteractionOn: ['zn-input', 'zn-change'], })"
34769
+ "name": "handleDragOver",
34770
+ "privacy": "private"
34408
34771
  },
34409
34772
  {
34410
34773
  "kind": "field",
34411
- "name": "slashController",
34412
- "privacy": "private",
34413
- "readonly": true,
34414
- "default": "new SlashMenuController(this, { menu: () => this.mountSlashMenu(), // The menu only belongs in a block that is nothing but the slash command — a // block prefix like \"## \" is not valid remarkd part-way through a line. items: () => this.isSlashBlock() ? SLASH_ITEMS.filter(item => item.action !== 'include' || !!this.includeUrl) : [], onSelect: item => this.handleSlashSelect(item) })"
34774
+ "name": "handleDrop",
34775
+ "privacy": "private"
34415
34776
  },
34416
34777
  {
34417
- "kind": "field",
34418
- "name": "toolbarOverflow",
34778
+ "kind": "method",
34779
+ "name": "insertionIndexFromY",
34419
34780
  "privacy": "private",
34420
- "readonly": true,
34421
- "default": "new ToolbarOverflowController(this, { groups: () => [...(this.shadowRoot?.querySelectorAll<HTMLElement>('.toolbar__group') ?? [])], container: () => this.shadowRoot?.querySelector<HTMLElement>('.remarkd-editor__toolbar'), })"
34781
+ "return": {
34782
+ "type": {
34783
+ "text": "number"
34784
+ }
34785
+ },
34786
+ "parameters": [
34787
+ {
34788
+ "name": "y",
34789
+ "type": {
34790
+ "text": "number"
34791
+ }
34792
+ }
34793
+ ],
34794
+ "description": "The insertion index a drop at `y` maps to, from the rendered block positions."
34422
34795
  },
34423
34796
  {
34424
34797
  "kind": "field",
34425
- "name": "editingDraft",
34426
- "type": {
34427
- "text": "string"
34428
- },
34429
- "privacy": "private",
34430
- "default": "''"
34798
+ "name": "handleHandlePointerDown",
34799
+ "privacy": "private"
34431
34800
  },
34432
34801
  {
34433
34802
  "kind": "field",
34434
- "name": "includeRequest",
34435
- "type": {
34436
- "text": "Promise<IncludeOption[]> | null"
34437
- },
34438
- "privacy": "private",
34439
- "default": "null"
34803
+ "name": "handleDragPointerMove",
34804
+ "privacy": "private"
34440
34805
  },
34441
34806
  {
34442
34807
  "kind": "field",
34443
- "name": "rawEntryValue",
34444
- "type": {
34445
- "text": "string"
34446
- },
34808
+ "name": "stepAutoScroll",
34447
34809
  "privacy": "private",
34448
- "default": "''"
34449
- },
34450
- {
34451
- "kind": "field",
34452
- "name": "suppressValueSync",
34453
- "type": {
34454
- "text": "boolean"
34455
- },
34456
- "privacy": "private",
34457
- "default": "false"
34458
- },
34459
- {
34460
- "kind": "field",
34461
- "name": "suppressBlurCommit",
34462
- "type": {
34463
- "text": "boolean"
34464
- },
34465
- "privacy": "private",
34466
- "default": "false"
34467
- },
34468
- {
34469
- "kind": "field",
34470
- "name": "validationInput",
34471
- "type": {
34472
- "text": "HTMLTextAreaElement"
34473
- },
34474
- "privacy": "private"
34475
- },
34476
- {
34477
- "kind": "field",
34478
- "name": "slashMenuElement",
34479
- "type": {
34480
- "text": "ZnSlashMenu | null"
34481
- },
34482
- "privacy": "private"
34483
- },
34484
- {
34485
- "kind": "field",
34486
- "name": "blocks",
34487
- "type": {
34488
- "text": "string[]"
34489
- },
34490
- "privacy": "private",
34491
- "default": "[]"
34492
- },
34493
- {
34494
- "kind": "field",
34495
- "name": "editingIndex",
34496
- "type": {
34497
- "text": "number | null"
34498
- },
34499
- "privacy": "private",
34500
- "default": "null"
34501
- },
34502
- {
34503
- "kind": "field",
34504
- "name": "slashRecentKey",
34505
- "type": {
34506
- "text": "string"
34507
- },
34508
- "default": "''",
34509
- "description": "Lists the blocks most recently inserted here above the rest of the slash menu, remembered in\n`localStorage` under this key. Leave unset to offer no recently used section.",
34510
- "attribute": "slash-recent-key"
34511
- },
34512
- {
34513
- "kind": "field",
34514
- "name": "hasSlashMenu",
34515
- "type": {
34516
- "text": "boolean"
34517
- },
34518
- "privacy": "private",
34519
- "default": "false",
34520
- "description": "Renders the slash menu only once it has been needed."
34521
- },
34522
- {
34523
- "kind": "field",
34524
- "name": "imagePickerIndex",
34525
- "type": {
34526
- "text": "number | null"
34527
- },
34528
- "privacy": "private",
34529
- "default": "null"
34530
- },
34531
- {
34532
- "kind": "field",
34533
- "name": "imageEdit",
34534
- "type": {
34535
- "text": "ImageBlockData | null"
34536
- },
34537
- "privacy": "private",
34538
- "default": "null"
34539
- },
34540
- {
34541
- "kind": "field",
34542
- "name": "dropIndicator",
34543
- "type": {
34544
- "text": "number | null"
34545
- },
34546
- "privacy": "private",
34547
- "default": "null"
34548
- },
34549
- {
34550
- "kind": "field",
34551
- "name": "dragIndex",
34552
- "type": {
34553
- "text": "number | null"
34554
- },
34555
- "privacy": "private",
34556
- "default": "null"
34557
- },
34558
- {
34559
- "kind": "field",
34560
- "name": "editShell",
34561
- "type": {
34562
- "text": "string"
34563
- },
34564
- "privacy": "private",
34565
- "default": "''"
34566
- },
34567
- {
34568
- "kind": "field",
34569
- "name": "rawMode",
34570
- "type": {
34571
- "text": "boolean"
34572
- },
34573
- "privacy": "private",
34574
- "default": "false"
34575
- },
34576
- {
34577
- "kind": "field",
34578
- "name": "includeOptions",
34579
- "type": {
34580
- "text": "IncludeOption[] | null"
34581
- },
34582
- "privacy": "private",
34583
- "default": "null"
34584
- },
34585
- {
34586
- "kind": "field",
34587
- "name": "includeLoadFailed",
34588
- "type": {
34589
- "text": "boolean"
34590
- },
34591
- "privacy": "private",
34592
- "default": "false"
34593
- },
34594
- {
34595
- "kind": "field",
34596
- "name": "includePickerIndex",
34597
- "type": {
34598
- "text": "number | null"
34599
- },
34600
- "privacy": "private",
34601
- "default": "null"
34602
- },
34603
- {
34604
- "kind": "field",
34605
- "name": "includeQuery",
34606
- "type": {
34607
- "text": "string"
34608
- },
34609
- "privacy": "private",
34610
- "default": "''"
34611
- },
34612
- {
34613
- "kind": "field",
34614
- "name": "pendingDragHandle",
34615
- "type": {
34616
- "text": "HTMLElement | null"
34617
- },
34618
- "privacy": "private",
34619
- "default": "null"
34620
- },
34621
- {
34622
- "kind": "field",
34623
- "name": "dragStartX",
34624
- "type": {
34625
- "text": "number"
34626
- },
34627
- "privacy": "private",
34628
- "default": "0"
34629
- },
34630
- {
34631
- "kind": "field",
34632
- "name": "dragStartY",
34633
- "type": {
34634
- "text": "number"
34635
- },
34636
- "privacy": "private",
34637
- "default": "0"
34638
- },
34639
- {
34640
- "kind": "field",
34641
- "name": "dragGhost",
34642
- "type": {
34643
- "text": "HTMLElement | null"
34644
- },
34645
- "privacy": "private",
34646
- "default": "null"
34647
- },
34648
- {
34649
- "kind": "field",
34650
- "name": "dragPointerY",
34651
- "type": {
34652
- "text": "number"
34653
- },
34654
- "privacy": "private",
34655
- "default": "0"
34656
- },
34657
- {
34658
- "kind": "field",
34659
- "name": "autoScrollFrame",
34660
- "type": {
34661
- "text": "number | null"
34662
- },
34663
- "privacy": "private",
34664
- "default": "null"
34665
- },
34666
- {
34667
- "kind": "field",
34668
- "name": "name",
34669
- "type": {
34670
- "text": "string"
34671
- },
34672
- "default": "''",
34673
- "description": "The name of the control, submitted as part of form data.",
34674
- "attribute": "name"
34675
- },
34676
- {
34677
- "kind": "field",
34678
- "name": "value",
34679
- "type": {
34680
- "text": "string"
34681
- },
34682
- "default": "''",
34683
- "description": "The current remarkd source.",
34684
- "attribute": "value"
34685
- },
34686
- {
34687
- "kind": "field",
34688
- "name": "defaultValue",
34689
- "type": {
34690
- "text": "string"
34691
- },
34692
- "default": "''",
34693
- "description": "The default value — used when resetting the form."
34694
- },
34695
- {
34696
- "kind": "field",
34697
- "name": "placeholder",
34698
- "type": {
34699
- "text": "string"
34700
- },
34701
- "default": "'Type something…'",
34702
- "description": "Placeholder shown when the document is empty.",
34703
- "attribute": "placeholder"
34704
- },
34705
- {
34706
- "kind": "field",
34707
- "name": "attachmentUrl",
34708
- "type": {
34709
- "text": "string"
34710
- },
34711
- "default": "''",
34712
- "description": "Endpoint for image uploads — required for image support. Posting the file\nmetadata here must return `{uploadPath, uploadUrl}`; the file is then PUT\nto `uploadUrl` and the returned `uploadPath` is embedded as the image URL.",
34713
- "attribute": "attachment-url"
34714
- },
34715
- {
34716
- "kind": "field",
34717
- "name": "includeUrl",
34718
- "type": {
34719
- "text": "string"
34720
- },
34721
- "default": "''",
34722
- "description": "Endpoint listing the Includes this document may embed, as\n`{\"items\":[{id,title,description,scope,keywords,languages,url}]}`. Labels the\nchips rendered for `include::` directives and feeds the include picker.",
34723
- "attribute": "include-url"
34724
- },
34725
- {
34726
- "kind": "field",
34727
- "name": "allowRaw",
34728
- "type": {
34729
- "text": "boolean"
34730
- },
34731
- "default": "false",
34732
- "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
34733
- "attribute": "allow-raw",
34734
- "reflects": true
34735
- },
34736
- {
34737
- "kind": "field",
34738
- "name": "required",
34739
- "type": {
34740
- "text": "boolean"
34741
- },
34742
- "default": "false",
34743
- "description": "Makes the editor required for form submission.",
34744
- "attribute": "required",
34745
- "reflects": true
34746
- },
34747
- {
34748
- "kind": "field",
34749
- "name": "readonly",
34750
- "type": {
34751
- "text": "boolean"
34752
- },
34753
- "default": "false",
34754
- "description": "Makes the editor read-only.",
34755
- "attribute": "readonly",
34756
- "reflects": true
34757
- },
34758
- {
34759
- "kind": "field",
34760
- "name": "disabled",
34761
- "type": {
34762
- "text": "boolean"
34763
- },
34764
- "default": "false",
34765
- "description": "Disables the editor.",
34766
- "attribute": "disabled",
34767
- "reflects": true
34768
- },
34769
- {
34770
- "kind": "field",
34771
- "name": "validity",
34772
- "type": {
34773
- "text": "ValidityState"
34774
- },
34775
- "readonly": true
34776
- },
34777
- {
34778
- "kind": "field",
34779
- "name": "validationMessage",
34780
- "type": {
34781
- "text": "string"
34782
- },
34783
- "readonly": true
34784
- },
34785
- {
34786
- "kind": "method",
34787
- "name": "checkValidity",
34788
- "return": {
34789
- "type": {
34790
- "text": "boolean"
34791
- }
34792
- }
34793
- },
34794
- {
34795
- "kind": "method",
34796
- "name": "getForm",
34797
- "return": {
34798
- "type": {
34799
- "text": "HTMLFormElement | null"
34800
- }
34801
- }
34810
+ "description": "Holding the pointer near a scroll edge keeps the content moving, so a block can\nbe dragged past the visible slice of a long document. Runs per frame rather than\nper pointermove — a pointer parked at the edge stops emitting moves."
34802
34811
  },
34803
34812
  {
34804
34813
  "kind": "method",
34805
- "name": "reportValidity",
34814
+ "name": "autoScroll",
34815
+ "privacy": "private",
34806
34816
  "return": {
34807
34817
  "type": {
34808
34818
  "text": "boolean"
34809
34819
  }
34810
- }
34820
+ },
34821
+ "description": "Scrolls the editor body, falling through to the page once the body is at its limit."
34811
34822
  },
34812
34823
  {
34813
34824
  "kind": "method",
34814
- "name": "setCustomValidity",
34825
+ "name": "edgeScrollDelta",
34826
+ "privacy": "private",
34815
34827
  "return": {
34816
34828
  "type": {
34817
- "text": "void"
34829
+ "text": "number"
34818
34830
  }
34819
34831
  },
34820
34832
  "parameters": [
34821
34833
  {
34822
- "name": "message",
34834
+ "name": "top",
34823
34835
  "type": {
34824
- "text": "string"
34836
+ "text": "number"
34837
+ }
34838
+ },
34839
+ {
34840
+ "name": "bottom",
34841
+ "type": {
34842
+ "text": "number"
34825
34843
  }
34826
34844
  }
34827
- ]
34828
- },
34829
- {
34830
- "kind": "method",
34831
- "name": "focus",
34832
- "description": "Starts editing the first block, or a new block if the document is empty."
34833
- },
34834
- {
34835
- "kind": "method",
34836
- "name": "blur",
34837
- "description": "Commits any in-progress block or raw edit."
34845
+ ],
34846
+ "description": "Scroll step for this frame: nothing until the pointer is within `edge` of a boundary."
34838
34847
  },
34839
34848
  {
34840
- "kind": "method",
34841
- "name": "handleValueChange"
34849
+ "kind": "field",
34850
+ "name": "handleDragPointerUp",
34851
+ "privacy": "private"
34842
34852
  },
34843
34853
  {
34844
- "kind": "method",
34845
- "name": "handleIncludeUrlChange"
34854
+ "kind": "field",
34855
+ "name": "cancelDrag",
34856
+ "privacy": "private"
34846
34857
  },
34847
34858
  {
34848
34859
  "kind": "method",
34849
- "name": "splitBlocks",
34860
+ "name": "createDragGhost",
34850
34861
  "privacy": "private",
34851
- "return": {
34852
- "type": {
34853
- "text": "string[]"
34854
- }
34855
- },
34856
34862
  "parameters": [
34857
34863
  {
34858
- "name": "source",
34864
+ "name": "index",
34859
34865
  "type": {
34860
- "text": "string"
34866
+ "text": "number"
34861
34867
  }
34862
34868
  }
34863
- ],
34864
- "description": "Splits remarkd source into blocks on blank lines, keeping fenced /\ndelimited containers (``` ==== !!!! .... ---- ____ **** ////) as single blocks."
34869
+ ]
34865
34870
  },
34866
34871
  {
34867
34872
  "kind": "method",
34868
- "name": "fenceMarker",
34873
+ "name": "moveDragGhost",
34869
34874
  "privacy": "private",
34870
- "return": {
34871
- "type": {
34872
- "text": "string | null"
34873
- }
34874
- },
34875
34875
  "parameters": [
34876
34876
  {
34877
- "name": "line",
34877
+ "name": "x",
34878
34878
  "type": {
34879
- "text": "string"
34879
+ "text": "number"
34880
+ }
34881
+ },
34882
+ {
34883
+ "name": "y",
34884
+ "type": {
34885
+ "text": "number"
34880
34886
  }
34881
34887
  }
34882
34888
  ]
34883
34889
  },
34884
34890
  {
34885
34891
  "kind": "method",
34886
- "name": "closesFence",
34892
+ "name": "pickImage",
34887
34893
  "privacy": "private",
34888
- "return": {
34889
- "type": {
34890
- "text": "boolean"
34891
- }
34892
- },
34893
34894
  "parameters": [
34894
34895
  {
34895
- "name": "line",
34896
+ "name": "index",
34896
34897
  "type": {
34897
- "text": "string"
34898
+ "text": "number"
34898
34899
  }
34899
- },
34900
+ }
34901
+ ]
34902
+ },
34903
+ {
34904
+ "kind": "method",
34905
+ "name": "pickInclude",
34906
+ "privacy": "private",
34907
+ "parameters": [
34900
34908
  {
34901
- "name": "fence",
34909
+ "name": "index",
34902
34910
  "type": {
34903
- "text": "string"
34911
+ "text": "number"
34904
34912
  }
34905
34913
  }
34906
34914
  ]
34907
34915
  },
34916
+ {
34917
+ "kind": "field",
34918
+ "name": "closeIncludePicker",
34919
+ "privacy": "private"
34920
+ },
34908
34921
  {
34909
34922
  "kind": "method",
34910
- "name": "updateBlocks",
34923
+ "name": "insertInclude",
34911
34924
  "privacy": "private",
34912
34925
  "parameters": [
34913
34926
  {
34914
- "name": "blocks",
34927
+ "name": "item",
34915
34928
  "type": {
34916
- "text": "string[]"
34929
+ "text": "IncludeOption"
34917
34930
  }
34918
34931
  }
34919
34932
  ]
34920
34933
  },
34934
+ {
34935
+ "kind": "field",
34936
+ "name": "closeImagePicker",
34937
+ "privacy": "private"
34938
+ },
34939
+ {
34940
+ "kind": "field",
34941
+ "name": "handleImagePicked",
34942
+ "privacy": "private"
34943
+ },
34921
34944
  {
34922
34945
  "kind": "method",
34923
- "name": "handleRenderedClick",
34946
+ "name": "insertImage",
34924
34947
  "privacy": "private",
34925
34948
  "parameters": [
34926
34949
  {
34927
- "name": "e",
34950
+ "name": "file",
34928
34951
  "type": {
34929
- "text": "MouseEvent"
34952
+ "text": "File"
34930
34953
  }
34931
34954
  },
34932
34955
  {
@@ -34939,778 +34962,996 @@
34939
34962
  },
34940
34963
  {
34941
34964
  "kind": "method",
34942
- "name": "parseImageBlock",
34965
+ "name": "uploadImage",
34943
34966
  "privacy": "private",
34944
34967
  "return": {
34945
34968
  "type": {
34946
- "text": "ImageBlockData | null"
34969
+ "text": "Promise<string>"
34947
34970
  }
34948
34971
  },
34949
34972
  "parameters": [
34950
34973
  {
34951
- "name": "block",
34974
+ "name": "file",
34952
34975
  "type": {
34953
- "text": "string"
34976
+ "text": "File"
34954
34977
  }
34955
34978
  }
34956
- ],
34957
- "description": "Parses a block that is purely an image (with optional caption/align lines)."
34979
+ ]
34958
34980
  },
34959
34981
  {
34960
34982
  "kind": "method",
34961
- "name": "parseIncludeBlock",
34983
+ "name": "appPath",
34962
34984
  "privacy": "private",
34963
34985
  "return": {
34964
34986
  "type": {
34965
- "text": "IncludeBlockData | null"
34987
+ "text": "string"
34966
34988
  }
34967
34989
  },
34968
34990
  "parameters": [
34969
34991
  {
34970
- "name": "block",
34992
+ "name": "path",
34971
34993
  "type": {
34972
34994
  "text": "string"
34973
34995
  }
34974
34996
  }
34975
34997
  ],
34976
- "description": "Parses a block that is nothing but an include directive."
34998
+ "description": "Resolves an app-relative path the way the console's pagelet handler does:\nan app fragment's URLs sit under the app base, and the console puts the app's\n`gaid` on the host element. Links rendered here live in the shadow root,\nwhere a click retargets to the host, so that handler never sees them the\nhref has to carry the base itself."
34977
34999
  },
34978
35000
  {
34979
35001
  "kind": "method",
34980
- "name": "serializeImageBlock",
35002
+ "name": "hasIncludeBlock",
34981
35003
  "privacy": "private",
34982
35004
  "return": {
34983
35005
  "type": {
34984
- "text": "string"
34985
- }
34986
- },
34987
- "parameters": [
34988
- {
34989
- "name": "data",
34990
- "type": {
34991
- "text": "ImageBlockData"
34992
- }
35006
+ "text": "boolean"
34993
35007
  }
34994
- ]
35008
+ }
34995
35009
  },
34996
35010
  {
34997
35011
  "kind": "method",
34998
- "name": "toggleCheckbox",
35012
+ "name": "loadIncludeOptions",
34999
35013
  "privacy": "private",
35000
- "parameters": [
35001
- {
35002
- "name": "index",
35003
- "type": {
35004
- "text": "number"
35005
- }
35006
- },
35007
- {
35008
- "name": "checkbox",
35009
- "type": {
35010
- "text": "HTMLInputElement"
35011
- }
35014
+ "return": {
35015
+ "type": {
35016
+ "text": "Promise<IncludeOption[]>"
35012
35017
  }
35013
- ]
35018
+ },
35019
+ "description": "Fetches the include list once; every later caller shares the same promise."
35014
35020
  },
35015
35021
  {
35016
35022
  "kind": "method",
35017
- "name": "startEdit",
35023
+ "name": "autosize",
35018
35024
  "privacy": "private",
35019
35025
  "parameters": [
35020
35026
  {
35021
- "name": "index",
35022
- "type": {
35023
- "text": "number"
35024
- }
35025
- },
35026
- {
35027
- "name": "draft",
35028
- "optional": true,
35029
- "type": {
35030
- "text": "string"
35031
- }
35032
- },
35033
- {
35034
- "name": "align",
35035
- "default": "'nearest'",
35036
- "type": {
35037
- "text": "'nearest' | 'center'"
35038
- }
35039
- },
35040
- {
35041
- "name": "caretOffset",
35042
- "optional": true,
35027
+ "name": "input",
35043
35028
  "type": {
35044
- "text": "number"
35029
+ "text": "HTMLTextAreaElement"
35045
35030
  }
35046
35031
  }
35047
35032
  ]
35048
35033
  },
35049
35034
  {
35050
35035
  "kind": "method",
35051
- "name": "updateImageEdit",
35036
+ "name": "applyInline",
35052
35037
  "privacy": "private",
35053
35038
  "parameters": [
35054
35039
  {
35055
- "name": "patch",
35040
+ "name": "mark",
35056
35041
  "type": {
35057
- "text": "Partial<ImageBlockData>"
35042
+ "text": "InlineMark"
35058
35043
  }
35059
35044
  }
35060
- ]
35045
+ ],
35046
+ "description": "Applies an inline mark to the open block's textarea: wraps the selection, toggles the\nmark off when it is already wrapped, or inserts a selected placeholder when there is\nno selection. Goes through `editingDraft` so `zn-input` still fires."
35061
35047
  },
35062
35048
  {
35063
35049
  "kind": "field",
35064
- "name": "saveImageEdit",
35050
+ "name": "toggleRawMode",
35065
35051
  "privacy": "private"
35066
35052
  },
35067
35053
  {
35068
- "kind": "field",
35069
- "name": "closeImageEdit",
35054
+ "kind": "method",
35055
+ "name": "focusRaw",
35070
35056
  "privacy": "private"
35071
35057
  },
35072
35058
  {
35073
35059
  "kind": "field",
35074
- "name": "deleteImageBlock",
35075
- "privacy": "private"
35060
+ "name": "handleRawInput",
35061
+ "privacy": "private",
35062
+ "description": "Raw mode keeps the whole document in one textarea, so the textarea — not\nthe block list — is authoritative while it is open: re-splitting on every\nkeystroke would normalise blank lines out from under the cursor."
35076
35063
  },
35077
35064
  {
35078
35065
  "kind": "field",
35079
- "name": "editImageSource",
35080
- "privacy": "private"
35066
+ "name": "commitRaw",
35067
+ "privacy": "private",
35068
+ "description": "Re-splits the raw source into blocks. Not `updateBlocks` — that only\nreports a change when the re-join differs from the value, and raw edits\nhave already written straight to the value."
35081
35069
  },
35082
35070
  {
35083
- "kind": "field",
35084
- "name": "handleImageControlsKeydown",
35071
+ "kind": "method",
35072
+ "name": "handleToolbarInsert",
35073
+ "privacy": "private",
35074
+ "parameters": [
35075
+ {
35076
+ "name": "action",
35077
+ "type": {
35078
+ "text": "EditorAction"
35079
+ }
35080
+ }
35081
+ ]
35082
+ },
35083
+ {
35084
+ "kind": "method",
35085
+ "name": "renderImageControls",
35085
35086
  "privacy": "private"
35086
35087
  },
35087
35088
  {
35088
35089
  "kind": "method",
35089
- "name": "computeEditShell",
35090
+ "name": "renderIncludeChip",
35090
35091
  "privacy": "private",
35091
- "return": {
35092
- "type": {
35093
- "text": "string"
35094
- }
35095
- },
35096
35092
  "parameters": [
35097
35093
  {
35098
- "name": "draft",
35094
+ "name": "data",
35099
35095
  "type": {
35100
- "text": "string"
35096
+ "text": "IncludeBlockData"
35101
35097
  }
35102
35098
  }
35103
- ],
35104
- "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."
35099
+ ]
35105
35100
  },
35106
35101
  {
35107
35102
  "kind": "method",
35108
- "name": "focusInput",
35103
+ "name": "renderMetaChips",
35109
35104
  "privacy": "private",
35110
35105
  "parameters": [
35111
35106
  {
35112
- "name": "align",
35113
- "default": "'nearest'",
35107
+ "name": "lines",
35114
35108
  "type": {
35115
- "text": "'nearest' | 'center'"
35109
+ "text": "MetaLine[]"
35116
35110
  }
35117
- },
35111
+ }
35112
+ ],
35113
+ "description": "A metadata-only block parses to nothing, so show each of its lines as a chip instead."
35114
+ },
35115
+ {
35116
+ "kind": "method",
35117
+ "name": "renderMetaChip",
35118
+ "privacy": "private",
35119
+ "parameters": [
35118
35120
  {
35119
- "name": "caretOffset",
35120
- "optional": true,
35121
+ "name": "line",
35121
35122
  "type": {
35122
- "text": "number"
35123
+ "text": "MetaLine"
35123
35124
  }
35124
35125
  }
35125
- ]
35126
+ ],
35127
+ "description": "One shared chip treatment for every metadata line kind — each kind just supplies an\nicon, a name, and an optional value/state, display-only in all three cases."
35126
35128
  },
35127
35129
  {
35128
35130
  "kind": "method",
35129
- "name": "reveal",
35131
+ "name": "markVariables",
35130
35132
  "privacy": "private",
35131
35133
  "parameters": [
35132
35134
  {
35133
- "name": "el",
35135
+ "name": "root",
35134
35136
  "type": {
35135
- "text": "Element | null | undefined"
35137
+ "text": "Element"
35136
35138
  }
35137
- },
35139
+ }
35140
+ ],
35141
+ "description": "Wraps `{name}` references so they read as variables rather than literal text. Walks text\nnodes and skips code, so a brace in a sample stays a brace, and no regex touches markup."
35142
+ },
35143
+ {
35144
+ "kind": "method",
35145
+ "name": "renderConditional",
35146
+ "privacy": "private",
35147
+ "return": {
35148
+ "type": {
35149
+ "text": "TemplateResult | null"
35150
+ }
35151
+ },
35152
+ "parameters": [
35138
35153
  {
35139
- "name": "align",
35140
- "default": "'nearest'",
35154
+ "name": "block",
35141
35155
  "type": {
35142
- "text": "'nearest' | 'center'"
35156
+ "text": "string"
35143
35157
  }
35144
35158
  }
35145
35159
  ],
35146
- "description": "Scrolls the editor's own body to bring `el` into view. Never `scrollIntoView()` and\nnever `focus()` without preventScroll: both walk every scrollable ancestor, and an\n`overflow: hidden`/`auto` panel around the editor is scrollable toothat shifts a\ncontainer the user never asked to move."
35160
+ "description": "A conditional range as a labelled wrapper. The inner content is parsed without the\ndirective lines: evaluating instead would blank the block whenever the flag is not\ndefined in this same block, hiding the author's content while they edit it. It also\nkeeps both halves of an if/else idiom visible with evaluation you could never see\nthe `ifndef` branch while the `ifdef` condition held. Nesting is handled by\n`splitConditionalParts`/`renderConditionalWrapper` below, recursively."
35147
35161
  },
35148
35162
  {
35149
35163
  "kind": "method",
35150
- "name": "revealAfterUpdate",
35164
+ "name": "renderBlock",
35151
35165
  "privacy": "private",
35152
35166
  "parameters": [
35153
35167
  {
35154
- "name": "selector",
35168
+ "name": "block",
35155
35169
  "type": {
35156
35170
  "text": "string"
35157
35171
  }
35158
35172
  },
35159
35173
  {
35160
- "name": "align",
35161
- "default": "'nearest'",
35174
+ "name": "index",
35162
35175
  "type": {
35163
- "text": "'nearest' | 'center'"
35176
+ "text": "number"
35164
35177
  }
35165
35178
  }
35166
35179
  ]
35167
35180
  },
35168
35181
  {
35169
35182
  "kind": "method",
35170
- "name": "revealBlock",
35183
+ "name": "isActionDisabled",
35171
35184
  "privacy": "private",
35185
+ "return": {
35186
+ "type": {
35187
+ "text": "boolean"
35188
+ }
35189
+ },
35172
35190
  "parameters": [
35173
35191
  {
35174
- "name": "index",
35192
+ "name": "action",
35175
35193
  "type": {
35176
- "text": "number"
35194
+ "text": "EditorAction"
35177
35195
  }
35178
35196
  }
35179
35197
  ],
35180
- "description": "Centres a block added without opening an editor. An image has no height until it\nloads, so the first pass scrolls against a layout that is still short — the second\npass corrects it once the real dimensions are in."
35198
+ "description": "An inline action needs an open block to apply its mark to."
35181
35199
  },
35182
35200
  {
35183
35201
  "kind": "method",
35184
- "name": "addBlockAt",
35202
+ "name": "activateAction",
35185
35203
  "privacy": "private",
35186
35204
  "parameters": [
35187
35205
  {
35188
- "name": "index",
35189
- "type": {
35190
- "text": "number"
35191
- }
35192
- },
35193
- {
35194
- "name": "content",
35206
+ "name": "action",
35195
35207
  "type": {
35196
- "text": "string"
35208
+ "text": "EditorAction"
35197
35209
  }
35198
35210
  }
35199
- ]
35211
+ ],
35212
+ "description": "Routes a toolbar/menu action to the inline or block insert path — the one place both\n`renderAction` and `renderMenuAction` call, so the bar and the overflow menu cannot\ndrift out of sync on what a given action actually does."
35200
35213
  },
35201
35214
  {
35202
35215
  "kind": "method",
35203
- "name": "deleteBlock",
35216
+ "name": "renderAction",
35204
35217
  "privacy": "private",
35205
35218
  "parameters": [
35206
35219
  {
35207
- "name": "index",
35220
+ "name": "action",
35208
35221
  "type": {
35209
- "text": "number"
35222
+ "text": "EditorAction"
35210
35223
  }
35211
35224
  }
35212
- ]
35225
+ ],
35226
+ "description": "A single toolbar action button, shared by the toolbar bar and the overflow menu."
35213
35227
  },
35214
35228
  {
35215
35229
  "kind": "method",
35216
- "name": "insertDraftBlock",
35230
+ "name": "renderMenuAction",
35217
35231
  "privacy": "private",
35218
35232
  "parameters": [
35219
35233
  {
35220
- "name": "index",
35221
- "type": {
35222
- "text": "number"
35223
- }
35224
- },
35225
- {
35226
- "name": "prefill",
35227
- "default": "''"
35228
- },
35229
- {
35230
- "name": "caretOffset",
35231
- "optional": true,
35234
+ "name": "action",
35232
35235
  "type": {
35233
- "text": "number"
35236
+ "text": "EditorAction"
35234
35237
  }
35235
35238
  }
35236
35239
  ],
35237
- "description": "Inserts a draft block committed (or dropped, if left empty) on blur."
35240
+ "description": "The same action, rendered as a menu item for the overflow menu."
35238
35241
  },
35239
35242
  {
35240
- "kind": "field",
35241
- "name": "handleEditBlur",
35242
- "privacy": "private",
35243
- "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."
35243
+ "kind": "method",
35244
+ "name": "renderRaw",
35245
+ "privacy": "private"
35244
35246
  },
35245
35247
  {
35246
- "kind": "field",
35247
- "name": "commitEdit",
35248
+ "kind": "method",
35249
+ "name": "renderBody",
35248
35250
  "privacy": "private",
35249
- "description": "Commits the in-progress edit; returns the index after the committed parts."
35251
+ "description": "The block views, with the inline image picker spliced in when active."
35250
35252
  },
35251
35253
  {
35252
- "kind": "field",
35253
- "name": "handleDraftInput",
35254
+ "kind": "method",
35255
+ "name": "renderIncludePicker",
35254
35256
  "privacy": "private"
35255
35257
  },
35256
35258
  {
35257
- "kind": "field",
35258
- "name": "handleEditKeydown",
35259
+ "kind": "method",
35260
+ "name": "renderImagePicker",
35259
35261
  "privacy": "private"
35262
+ }
35263
+ ],
35264
+ "events": [
35265
+ {
35266
+ "description": "Emitted on each keystroke while editing a block.",
35267
+ "name": "zn-input"
35260
35268
  },
35261
35269
  {
35262
- "kind": "method",
35263
- "name": "isSlashBlock",
35264
- "privacy": "private",
35265
- "return": {
35266
- "type": {
35267
- "text": "boolean"
35268
- }
35270
+ "description": "Emitted when a block edit is committed and the value changes.",
35271
+ "name": "zn-change"
35272
+ }
35273
+ ],
35274
+ "attributes": [
35275
+ {
35276
+ "name": "slash-recent-key",
35277
+ "type": {
35278
+ "text": "string"
35269
35279
  },
35270
- "description": "Whether the block being edited is nothing but the slash command."
35280
+ "default": "''",
35281
+ "description": "Lists the blocks most recently inserted here above the rest of the slash menu, remembered in\n`localStorage` under this key. Leave unset to offer no recently used section.",
35282
+ "fieldName": "slashRecentKey"
35271
35283
  },
35272
35284
  {
35273
- "kind": "method",
35274
- "name": "mountSlashMenu",
35275
- "privacy": "private",
35276
- "return": {
35277
- "type": {
35278
- "text": "Promise<ZnSlashMenu | null>"
35279
- }
35280
- }
35285
+ "name": "name",
35286
+ "type": {
35287
+ "text": "string"
35288
+ },
35289
+ "default": "''",
35290
+ "description": "The name of the control, submitted as part of form data.",
35291
+ "fieldName": "name"
35281
35292
  },
35282
35293
  {
35283
- "kind": "method",
35284
- "name": "handleSlashSelect",
35285
- "privacy": "private",
35286
- "return": {
35287
- "type": {
35288
- "text": "boolean"
35289
- }
35294
+ "name": "value",
35295
+ "type": {
35296
+ "text": "string"
35290
35297
  },
35291
- "parameters": [
35292
- {
35293
- "name": "item",
35294
- "type": {
35295
- "text": "SlashMenuItem"
35296
- }
35297
- }
35298
- ],
35299
- "description": "Returns false for items the controller should not insert text for."
35298
+ "default": "''",
35299
+ "description": "The current remarkd source.",
35300
+ "fieldName": "value"
35300
35301
  },
35301
35302
  {
35302
- "kind": "field",
35303
- "name": "handleEditPaste",
35304
- "privacy": "private"
35303
+ "name": "placeholder",
35304
+ "type": {
35305
+ "text": "string"
35306
+ },
35307
+ "default": "'Type something…'",
35308
+ "description": "Placeholder shown when the document is empty.",
35309
+ "fieldName": "placeholder"
35305
35310
  },
35306
35311
  {
35307
- "kind": "field",
35308
- "name": "handleDragOver",
35309
- "privacy": "private"
35312
+ "name": "attachment-url",
35313
+ "type": {
35314
+ "text": "string"
35315
+ },
35316
+ "default": "''",
35317
+ "description": "Endpoint for image uploads — required for image support. Posting the file\nmetadata here must return `{uploadPath, uploadUrl}`; the file is then PUT\nto `uploadUrl` and the returned `uploadPath` is embedded as the image URL.",
35318
+ "fieldName": "attachmentUrl"
35310
35319
  },
35311
35320
  {
35312
- "kind": "field",
35313
- "name": "handleDrop",
35314
- "privacy": "private"
35321
+ "name": "include-url",
35322
+ "type": {
35323
+ "text": "string"
35324
+ },
35325
+ "default": "''",
35326
+ "description": "Endpoint listing the Includes this document may embed, as\n`{\"items\":[{id,title,description,scope,keywords,languages,url}]}`. Labels the\nchips rendered for `include::` directives and feeds the include picker.",
35327
+ "fieldName": "includeUrl"
35315
35328
  },
35316
35329
  {
35317
- "kind": "method",
35318
- "name": "insertionIndexFromY",
35319
- "privacy": "private",
35320
- "return": {
35321
- "type": {
35322
- "text": "number"
35323
- }
35330
+ "name": "allow-raw",
35331
+ "type": {
35332
+ "text": "boolean"
35324
35333
  },
35325
- "parameters": [
35326
- {
35327
- "name": "y",
35328
- "type": {
35329
- "text": "number"
35330
- }
35331
- }
35332
- ],
35333
- "description": "The insertion index a drop at `y` maps to, from the rendered block positions."
35334
+ "default": "false",
35335
+ "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
35336
+ "fieldName": "allowRaw"
35337
+ },
35338
+ {
35339
+ "name": "required",
35340
+ "type": {
35341
+ "text": "boolean"
35342
+ },
35343
+ "default": "false",
35344
+ "description": "Makes the editor required for form submission.",
35345
+ "fieldName": "required"
35346
+ },
35347
+ {
35348
+ "name": "readonly",
35349
+ "type": {
35350
+ "text": "boolean"
35351
+ },
35352
+ "default": "false",
35353
+ "description": "Makes the editor read-only.",
35354
+ "fieldName": "readonly"
35355
+ },
35356
+ {
35357
+ "name": "disabled",
35358
+ "type": {
35359
+ "text": "boolean"
35360
+ },
35361
+ "default": "false",
35362
+ "description": "Disables the editor.",
35363
+ "fieldName": "disabled"
35364
+ }
35365
+ ],
35366
+ "superclass": {
35367
+ "name": "ZincElement",
35368
+ "module": "/src/internal/zinc-element"
35369
+ },
35370
+ "summary": "A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.",
35371
+ "tagNameWithoutPrefix": "remarkd-editor",
35372
+ "tagName": "zn-remarkd-editor",
35373
+ "customElement": true,
35374
+ "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-dropdown\n * @dependency zn-icon\n * @dependency zn-file\n * @dependency zn-menu\n * @dependency zn-menu-item\n * @dependency zn-slash-menu\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 and inline-formatting toolbar.\n * @csspart raw-toggle - The button that switches between the block view and the raw source view.\n * @csspart block - A rendered block wrapper.\n * @csspart rendered - The rendered remarkd output of a block.\n * @csspart conditional - A labelled wrapper for an ifdef/ifndef/ifeval/iftrue/iffalse/ifempty/ifnempty range.\n * @csspart variable - A chip rendered for a document attribute, title, or bracket line.\n * @csspart input - The textarea shown while editing a block.\n * @csspart raw - The full-document textarea shown in raw source mode.\n * @csspart slash-menu - The `zn-slash-menu` opened by typing \"/\" in an empty block.\n * @csspart image-controls - The caption / alignment / size panel shown when an image block is clicked.\n * @csspart include - The chip rendered in place of an `include::` directive.\n * @csspart include-picker - The inline Include picker opened from the toolbar or \"/include\".\n *\n * @cssproperty --remarkd-editor-max-height - The tallest the editor grows before its body scrolls. Defaults to `100dvh`.\n */",
35375
+ "documentation": "https://zinc.style/components/remarkd-editor",
35376
+ "status": "experimental",
35377
+ "since": "1.0",
35378
+ "dependencies": [
35379
+ "zn-button",
35380
+ "zn-button-group",
35381
+ "zn-dropdown",
35382
+ "zn-icon",
35383
+ "zn-file",
35384
+ "zn-menu",
35385
+ "zn-menu-item",
35386
+ "zn-slash-menu"
35387
+ ]
35388
+ }
35389
+ ],
35390
+ "exports": [
35391
+ {
35392
+ "kind": "js",
35393
+ "name": "default",
35394
+ "declaration": {
35395
+ "name": "ZnRemarkdEditor",
35396
+ "module": "components/remarkd-editor/remarkd-editor.js"
35397
+ }
35398
+ }
35399
+ ]
35400
+ },
35401
+ {
35402
+ "kind": "javascript-module",
35403
+ "path": "components/reveal/reveal.js",
35404
+ "declarations": [
35405
+ {
35406
+ "kind": "class",
35407
+ "description": "",
35408
+ "name": "ZnReveal",
35409
+ "cssProperties": [
35410
+ {
35411
+ "description": "An example CSS custom property.",
35412
+ "name": "--example"
35413
+ }
35414
+ ],
35415
+ "cssParts": [
35416
+ {
35417
+ "description": "The component's base wrapper.",
35418
+ "name": "base"
35419
+ }
35420
+ ],
35421
+ "slots": [
35422
+ {
35423
+ "description": "The default slot.",
35424
+ "name": ""
35334
35425
  },
35426
+ {
35427
+ "description": "An example slot.",
35428
+ "name": "example"
35429
+ }
35430
+ ],
35431
+ "members": [
35335
35432
  {
35336
35433
  "kind": "field",
35337
- "name": "handleHandlePointerDown",
35338
- "privacy": "private"
35434
+ "name": "duration",
35435
+ "type": {
35436
+ "text": "number"
35437
+ },
35438
+ "default": "2000",
35439
+ "attribute": "duration"
35339
35440
  },
35340
35441
  {
35341
35442
  "kind": "field",
35342
- "name": "handleDragPointerMove",
35343
- "privacy": "private"
35443
+ "name": "initial",
35444
+ "type": {
35445
+ "text": "string"
35446
+ },
35447
+ "default": "''",
35448
+ "attribute": "initial"
35344
35449
  },
35345
35450
  {
35346
35451
  "kind": "field",
35347
- "name": "stepAutoScroll",
35348
- "privacy": "private",
35349
- "description": "Holding the pointer near a scroll edge keeps the content moving, so a block can\nbe dragged past the visible slice of a long document. Runs per frame rather than\nper pointermove — a pointer parked at the edge stops emitting moves."
35452
+ "name": "revealed",
35453
+ "type": {
35454
+ "text": "string"
35455
+ },
35456
+ "default": "''",
35457
+ "attribute": "revealed"
35350
35458
  },
35351
35459
  {
35352
- "kind": "method",
35353
- "name": "autoScroll",
35354
- "privacy": "private",
35355
- "return": {
35356
- "type": {
35357
- "text": "boolean"
35358
- }
35460
+ "kind": "field",
35461
+ "name": "hideDelay",
35462
+ "type": {
35463
+ "text": "number"
35359
35464
  },
35360
- "description": "Scrolls the editor body, falling through to the page once the body is at its limit."
35465
+ "default": "150",
35466
+ "attribute": "hide-delay"
35361
35467
  },
35362
35468
  {
35363
- "kind": "method",
35364
- "name": "edgeScrollDelta",
35365
- "privacy": "private",
35366
- "return": {
35367
- "type": {
35368
- "text": "number"
35369
- }
35469
+ "kind": "field",
35470
+ "name": "noToggle",
35471
+ "type": {
35472
+ "text": "boolean"
35370
35473
  },
35371
- "parameters": [
35372
- {
35373
- "name": "top",
35374
- "type": {
35375
- "text": "number"
35376
- }
35377
- },
35378
- {
35379
- "name": "bottom",
35380
- "type": {
35381
- "text": "number"
35382
- }
35383
- }
35384
- ],
35385
- "description": "Scroll step for this frame: nothing until the pointer is within `edge` of a boundary."
35474
+ "default": "false",
35475
+ "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
35476
+ "attribute": "no-toggle"
35386
35477
  },
35387
35478
  {
35388
35479
  "kind": "field",
35389
- "name": "handleDragPointerUp",
35390
- "privacy": "private"
35480
+ "name": "_isRevealed",
35481
+ "type": {
35482
+ "text": "boolean"
35483
+ },
35484
+ "privacy": "private",
35485
+ "default": "false"
35391
35486
  },
35392
35487
  {
35393
35488
  "kind": "field",
35394
- "name": "cancelDrag",
35489
+ "name": "_isToggled",
35490
+ "type": {
35491
+ "text": "boolean"
35492
+ },
35493
+ "privacy": "private",
35494
+ "default": "false"
35495
+ },
35496
+ {
35497
+ "kind": "field",
35498
+ "name": "_hideTimer",
35499
+ "type": {
35500
+ "text": "ReturnType<typeof setTimeout> | undefined"
35501
+ },
35395
35502
  "privacy": "private"
35396
35503
  },
35397
35504
  {
35398
35505
  "kind": "method",
35399
- "name": "createDragGhost",
35400
- "privacy": "private",
35401
- "parameters": [
35402
- {
35403
- "name": "index",
35404
- "type": {
35405
- "text": "number"
35406
- }
35407
- }
35408
- ]
35506
+ "name": "_clearHideTimer",
35507
+ "privacy": "private"
35409
35508
  },
35410
35509
  {
35411
35510
  "kind": "method",
35412
- "name": "moveDragGhost",
35413
- "privacy": "private",
35414
- "parameters": [
35415
- {
35416
- "name": "x",
35417
- "type": {
35418
- "text": "number"
35419
- }
35420
- },
35421
- {
35422
- "name": "y",
35423
- "type": {
35424
- "text": "number"
35425
- }
35426
- }
35427
- ]
35511
+ "name": "handleToggleReveal",
35512
+ "privacy": "protected"
35428
35513
  },
35429
35514
  {
35430
35515
  "kind": "method",
35431
- "name": "pickImage",
35432
- "privacy": "private",
35433
- "parameters": [
35434
- {
35435
- "name": "index",
35436
- "type": {
35437
- "text": "number"
35438
- }
35439
- }
35440
- ]
35516
+ "name": "handleMouseEnter",
35517
+ "privacy": "protected"
35441
35518
  },
35442
35519
  {
35443
35520
  "kind": "method",
35444
- "name": "pickInclude",
35445
- "privacy": "private",
35446
- "parameters": [
35447
- {
35448
- "name": "index",
35449
- "type": {
35450
- "text": "number"
35451
- }
35452
- }
35453
- ]
35521
+ "name": "handleMouseLeave",
35522
+ "privacy": "protected"
35523
+ }
35524
+ ],
35525
+ "events": [
35526
+ {
35527
+ "description": "Emitted as an example.",
35528
+ "name": "zn-event-name"
35529
+ }
35530
+ ],
35531
+ "attributes": [
35532
+ {
35533
+ "name": "duration",
35534
+ "type": {
35535
+ "text": "number"
35536
+ },
35537
+ "default": "2000",
35538
+ "fieldName": "duration"
35539
+ },
35540
+ {
35541
+ "name": "initial",
35542
+ "type": {
35543
+ "text": "string"
35544
+ },
35545
+ "default": "''",
35546
+ "fieldName": "initial"
35547
+ },
35548
+ {
35549
+ "name": "revealed",
35550
+ "type": {
35551
+ "text": "string"
35552
+ },
35553
+ "default": "''",
35554
+ "fieldName": "revealed"
35555
+ },
35556
+ {
35557
+ "name": "hide-delay",
35558
+ "type": {
35559
+ "text": "number"
35560
+ },
35561
+ "default": "150",
35562
+ "fieldName": "hideDelay"
35563
+ },
35564
+ {
35565
+ "name": "no-toggle",
35566
+ "type": {
35567
+ "text": "boolean"
35568
+ },
35569
+ "default": "false",
35570
+ "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
35571
+ "fieldName": "noToggle"
35572
+ }
35573
+ ],
35574
+ "superclass": {
35575
+ "name": "ZincElement",
35576
+ "module": "/src/internal/zinc-element"
35577
+ },
35578
+ "summary": "Short summary of the component's intended use.",
35579
+ "tagNameWithoutPrefix": "reveal",
35580
+ "tagName": "zn-reveal",
35581
+ "customElement": true,
35582
+ "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/reveal\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @usage\n * ```html\n * <zn-reveal duration=\"3000\"\n * initial=\"******@hotmail.com\"\n * revealed=\"john.doe@hotmail.com\" toggle>\n * </zn-reveal>\n * ```\n *\n * @cssproperty --example - An example CSS custom property.\n */",
35583
+ "documentation": "https://zinc.style/components/reveal",
35584
+ "status": "experimental",
35585
+ "since": "1.0",
35586
+ "dependencies": [
35587
+ "zn-example"
35588
+ ]
35589
+ }
35590
+ ],
35591
+ "exports": [
35592
+ {
35593
+ "kind": "js",
35594
+ "name": "default",
35595
+ "declaration": {
35596
+ "name": "ZnReveal",
35597
+ "module": "components/reveal/reveal.js"
35598
+ }
35599
+ }
35600
+ ]
35601
+ },
35602
+ {
35603
+ "kind": "javascript-module",
35604
+ "path": "components/rating/rating.js",
35605
+ "declarations": [
35606
+ {
35607
+ "kind": "class",
35608
+ "description": "",
35609
+ "name": "ZnRating",
35610
+ "cssProperties": [
35611
+ {
35612
+ "description": "An example CSS custom property.",
35613
+ "name": "--example"
35454
35614
  },
35615
+ {
35616
+ "description": "The color of the preview value.",
35617
+ "name": "--preview-color"
35618
+ },
35619
+ {
35620
+ "description": "The font size of the preview value.",
35621
+ "name": "--preview-size"
35622
+ }
35623
+ ],
35624
+ "cssParts": [
35625
+ {
35626
+ "description": "The form control that wraps the symbols and help text.",
35627
+ "name": "form-control"
35628
+ },
35629
+ {
35630
+ "description": "The help text's wrapper.",
35631
+ "name": "form-control-help-text"
35632
+ },
35633
+ {
35634
+ "description": "The component's base wrapper.",
35635
+ "name": "base"
35636
+ },
35637
+ {
35638
+ "description": "The value shown next to the symbols when `preview` is enabled.",
35639
+ "name": "preview"
35640
+ }
35641
+ ],
35642
+ "slots": [
35643
+ {
35644
+ "description": "The default slot.",
35645
+ "name": ""
35646
+ },
35647
+ {
35648
+ "description": "An example slot.",
35649
+ "name": "example"
35650
+ },
35651
+ {
35652
+ "description": "Text that describes how to use the rating. Alternatively, you can use the `help-text` attribute.",
35653
+ "name": "help-text"
35654
+ }
35655
+ ],
35656
+ "members": [
35455
35657
  {
35456
35658
  "kind": "field",
35457
- "name": "closeIncludePicker",
35458
- "privacy": "private"
35659
+ "name": "formControlController",
35660
+ "privacy": "private",
35661
+ "readonly": true,
35662
+ "default": "new FormControlController(this, { assumeInteractionOn: ['zn-blur', 'zn-input'] })"
35459
35663
  },
35460
35664
  {
35461
- "kind": "method",
35462
- "name": "insertInclude",
35665
+ "kind": "field",
35666
+ "name": "hasSlotController",
35463
35667
  "privacy": "private",
35464
- "parameters": [
35465
- {
35466
- "name": "item",
35467
- "type": {
35468
- "text": "IncludeOption"
35469
- }
35470
- }
35471
- ]
35668
+ "readonly": true,
35669
+ "default": "new HasSlotController(this, 'help-text')"
35472
35670
  },
35473
35671
  {
35474
35672
  "kind": "field",
35475
- "name": "closeImagePicker",
35476
- "privacy": "private"
35673
+ "name": "rating",
35674
+ "type": {
35675
+ "text": "HTMLElement"
35676
+ }
35477
35677
  },
35478
35678
  {
35479
35679
  "kind": "field",
35480
- "name": "handleImagePicked",
35481
- "privacy": "private"
35680
+ "name": "symbols",
35681
+ "type": {
35682
+ "text": "HTMLElement"
35683
+ }
35482
35684
  },
35483
35685
  {
35484
- "kind": "method",
35485
- "name": "insertImage",
35686
+ "kind": "field",
35687
+ "name": "hoverValue",
35688
+ "type": {
35689
+ "text": "number"
35690
+ },
35486
35691
  "privacy": "private",
35487
- "parameters": [
35488
- {
35489
- "name": "file",
35490
- "type": {
35491
- "text": "File"
35492
- }
35493
- },
35494
- {
35495
- "name": "index",
35496
- "type": {
35497
- "text": "number"
35498
- }
35499
- }
35500
- ]
35692
+ "default": "0"
35501
35693
  },
35502
35694
  {
35503
- "kind": "method",
35504
- "name": "uploadImage",
35695
+ "kind": "field",
35696
+ "name": "isHovering",
35697
+ "type": {
35698
+ "text": "boolean"
35699
+ },
35505
35700
  "privacy": "private",
35506
- "return": {
35507
- "type": {
35508
- "text": "Promise<string>"
35509
- }
35701
+ "default": "false"
35702
+ },
35703
+ {
35704
+ "kind": "field",
35705
+ "name": "label",
35706
+ "type": {
35707
+ "text": "string"
35510
35708
  },
35511
- "parameters": [
35512
- {
35513
- "name": "file",
35514
- "type": {
35515
- "text": "File"
35516
- }
35517
- }
35518
- ]
35709
+ "attribute": "label"
35519
35710
  },
35520
35711
  {
35521
- "kind": "method",
35522
- "name": "appPath",
35523
- "privacy": "private",
35524
- "return": {
35525
- "type": {
35526
- "text": "string"
35527
- }
35712
+ "kind": "field",
35713
+ "name": "helpText",
35714
+ "type": {
35715
+ "text": "string"
35528
35716
  },
35529
- "parameters": [
35530
- {
35531
- "name": "path",
35532
- "type": {
35533
- "text": "string"
35534
- }
35535
- }
35536
- ],
35537
- "description": "Resolves an app-relative path the way the console's pagelet handler does:\nan app fragment's URLs sit under the app base, and the console puts the app's\n`gaid` on the host element. Links rendered here live in the shadow root,\nwhere a click retargets to the host, so that handler never sees them — the\nhref has to carry the base itself."
35717
+ "default": "''",
35718
+ "description": "The rating's help text. If you need to display HTML, use the `help-text` slot instead.",
35719
+ "attribute": "help-text"
35538
35720
  },
35539
35721
  {
35540
- "kind": "method",
35541
- "name": "hasIncludeBlock",
35542
- "privacy": "private",
35543
- "return": {
35544
- "type": {
35545
- "text": "boolean"
35546
- }
35547
- }
35722
+ "kind": "field",
35723
+ "name": "name",
35724
+ "type": {
35725
+ "text": "string"
35726
+ },
35727
+ "attribute": "name"
35548
35728
  },
35549
35729
  {
35550
- "kind": "method",
35551
- "name": "loadIncludeOptions",
35552
- "privacy": "private",
35553
- "return": {
35554
- "type": {
35555
- "text": "Promise<IncludeOption[]>"
35556
- }
35730
+ "kind": "field",
35731
+ "name": "value",
35732
+ "type": {
35733
+ "text": "number"
35557
35734
  },
35558
- "description": "Fetches the include list once; every later caller shares the same promise."
35735
+ "default": "0",
35736
+ "attribute": "value"
35559
35737
  },
35560
35738
  {
35561
- "kind": "method",
35562
- "name": "autosize",
35563
- "privacy": "private",
35564
- "parameters": [
35565
- {
35566
- "name": "input",
35567
- "type": {
35568
- "text": "HTMLTextAreaElement"
35569
- }
35570
- }
35571
- ]
35739
+ "kind": "field",
35740
+ "name": "defaultValue",
35741
+ "type": {
35742
+ "text": "number"
35743
+ },
35744
+ "default": "0",
35745
+ "description": "The default value of the form control. Primarily used for resetting the form control."
35572
35746
  },
35573
35747
  {
35574
- "kind": "method",
35575
- "name": "applyInline",
35576
- "privacy": "private",
35577
- "parameters": [
35578
- {
35579
- "name": "mark",
35580
- "type": {
35581
- "text": "InlineMark"
35582
- }
35583
- }
35584
- ],
35585
- "description": "Applies an inline mark to the open block's textarea: wraps the selection, toggles the\nmark off when it is already wrapped, or inserts a selected placeholder when there is\nno selection. Goes through `editingDraft` so `zn-input` still fires."
35748
+ "kind": "field",
35749
+ "name": "max",
35750
+ "type": {
35751
+ "text": "number"
35752
+ },
35753
+ "default": "5",
35754
+ "attribute": "max"
35755
+ },
35756
+ {
35757
+ "kind": "field",
35758
+ "name": "precision",
35759
+ "type": {
35760
+ "text": "number"
35761
+ },
35762
+ "default": "1",
35763
+ "attribute": "precision"
35764
+ },
35765
+ {
35766
+ "kind": "field",
35767
+ "name": "readonly",
35768
+ "type": {
35769
+ "text": "boolean"
35770
+ },
35771
+ "default": "false",
35772
+ "attribute": "readonly"
35773
+ },
35774
+ {
35775
+ "kind": "field",
35776
+ "name": "disabled",
35777
+ "type": {
35778
+ "text": "boolean"
35779
+ },
35780
+ "default": "false",
35781
+ "attribute": "disabled"
35782
+ },
35783
+ {
35784
+ "kind": "field",
35785
+ "name": "preview",
35786
+ "type": {
35787
+ "text": "boolean"
35788
+ },
35789
+ "default": "false",
35790
+ "description": "Displays the value alongside the symbols, updating live as the pointer moves across them.",
35791
+ "attribute": "preview"
35586
35792
  },
35587
35793
  {
35588
35794
  "kind": "field",
35589
- "name": "toggleRawMode",
35590
- "privacy": "private"
35795
+ "name": "size",
35796
+ "type": {
35797
+ "text": "'small' | 'medium' | 'large'"
35798
+ },
35799
+ "default": "'medium'",
35800
+ "attribute": "size"
35591
35801
  },
35592
35802
  {
35593
- "kind": "method",
35594
- "name": "focusRaw",
35595
- "privacy": "private"
35803
+ "kind": "field",
35804
+ "name": "getSymbol",
35805
+ "type": {
35806
+ "text": "(value: number) => string"
35807
+ },
35808
+ "attribute": "getSymbol"
35596
35809
  },
35597
35810
  {
35598
35811
  "kind": "field",
35599
- "name": "handleRawInput",
35600
- "privacy": "private",
35601
- "description": "Raw mode keeps the whole document in one textarea, so the textarea — not\nthe block list — is authoritative while it is open: re-splitting on every\nkeystroke would normalise blank lines out from under the cursor."
35812
+ "name": "validity",
35813
+ "description": "Gets the validity state object",
35814
+ "readonly": true
35602
35815
  },
35603
35816
  {
35604
35817
  "kind": "field",
35605
- "name": "commitRaw",
35606
- "privacy": "private",
35607
- "description": "Re-splits the raw source into blocks. Not `updateBlocks` — that only\nreports a change when the re-join differs from the value, and raw edits\nhave already written straight to the value."
35818
+ "name": "validationMessage",
35819
+ "description": "Gets the validation message",
35820
+ "readonly": true
35608
35821
  },
35609
35822
  {
35610
35823
  "kind": "method",
35611
- "name": "handleToolbarInsert",
35612
- "privacy": "private",
35613
- "parameters": [
35614
- {
35615
- "name": "action",
35616
- "type": {
35617
- "text": "EditorAction"
35618
- }
35824
+ "name": "checkValidity",
35825
+ "return": {
35826
+ "type": {
35827
+ "text": "boolean"
35619
35828
  }
35620
- ]
35829
+ },
35830
+ "description": "Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
35621
35831
  },
35622
35832
  {
35623
35833
  "kind": "method",
35624
- "name": "renderImageControls",
35625
- "privacy": "private"
35834
+ "name": "getForm",
35835
+ "return": {
35836
+ "type": {
35837
+ "text": "HTMLFormElement | null"
35838
+ }
35839
+ },
35840
+ "description": "Gets the associated form, if one exists."
35626
35841
  },
35627
35842
  {
35628
35843
  "kind": "method",
35629
- "name": "renderIncludeChip",
35844
+ "name": "reportValidity",
35845
+ "description": "Checks for validity and shows the browser's validation message if the control is invalid."
35846
+ },
35847
+ {
35848
+ "kind": "method",
35849
+ "name": "setCustomValidity",
35850
+ "description": "Sets a custom validation message. Pass an empty string to restore validity."
35851
+ },
35852
+ {
35853
+ "kind": "method",
35854
+ "name": "_roundToPrecision",
35630
35855
  "privacy": "private",
35856
+ "return": {
35857
+ "type": {
35858
+ "text": "number"
35859
+ }
35860
+ },
35631
35861
  "parameters": [
35632
35862
  {
35633
- "name": "data",
35863
+ "name": "value",
35634
35864
  "type": {
35635
- "text": "IncludeBlockData"
35865
+ "text": "number"
35866
+ }
35867
+ },
35868
+ {
35869
+ "name": "precision",
35870
+ "type": {
35871
+ "text": "number"
35636
35872
  }
35637
35873
  }
35638
35874
  ]
35639
35875
  },
35640
35876
  {
35641
35877
  "kind": "method",
35642
- "name": "renderMetaChips",
35878
+ "name": "_getValueFromXCoordinate",
35643
35879
  "privacy": "private",
35880
+ "return": {
35881
+ "type": {
35882
+ "text": "number"
35883
+ }
35884
+ },
35644
35885
  "parameters": [
35645
35886
  {
35646
- "name": "lines",
35887
+ "name": "coordinate",
35647
35888
  "type": {
35648
- "text": "MetaLine[]"
35889
+ "text": "number"
35649
35890
  }
35650
35891
  }
35651
- ],
35652
- "description": "A metadata-only block parses to nothing, so show each of its lines as a chip instead."
35892
+ ]
35653
35893
  },
35654
35894
  {
35655
35895
  "kind": "method",
35656
- "name": "renderMetaChip",
35896
+ "name": "_formatValue",
35657
35897
  "privacy": "private",
35898
+ "return": {
35899
+ "type": {
35900
+ "text": "string"
35901
+ }
35902
+ },
35658
35903
  "parameters": [
35659
35904
  {
35660
- "name": "line",
35905
+ "name": "value",
35661
35906
  "type": {
35662
- "text": "MetaLine"
35907
+ "text": "number"
35663
35908
  }
35664
35909
  }
35665
- ],
35666
- "description": "One shared chip treatment for every metadata line kind — each kind just supplies an\nicon, a name, and an optional value/state, display-only in all three cases."
35910
+ ]
35667
35911
  },
35668
35912
  {
35669
35913
  "kind": "method",
35670
- "name": "markVariables",
35914
+ "name": "_getValueFromMousePosition",
35671
35915
  "privacy": "private",
35916
+ "return": {
35917
+ "type": {
35918
+ "text": "number"
35919
+ }
35920
+ },
35672
35921
  "parameters": [
35673
35922
  {
35674
- "name": "root",
35923
+ "name": "event",
35675
35924
  "type": {
35676
- "text": "Element"
35925
+ "text": "MouseEvent"
35677
35926
  }
35678
35927
  }
35679
- ],
35680
- "description": "Wraps `{name}` references so they read as variables rather than literal text. Walks text\nnodes and skips code, so a brace in a sample stays a brace, and no regex touches markup."
35928
+ ]
35681
35929
  },
35682
35930
  {
35683
35931
  "kind": "method",
35684
- "name": "renderConditional",
35932
+ "name": "_getValueFromTouchPosition",
35685
35933
  "privacy": "private",
35686
35934
  "return": {
35687
35935
  "type": {
35688
- "text": "TemplateResult | null"
35936
+ "text": "number"
35689
35937
  }
35690
35938
  },
35691
35939
  "parameters": [
35692
35940
  {
35693
- "name": "block",
35941
+ "name": "event",
35694
35942
  "type": {
35695
- "text": "string"
35943
+ "text": "TouchEvent"
35696
35944
  }
35697
35945
  }
35698
- ],
35699
- "description": "A conditional range as a labelled wrapper. The inner content is parsed without the\ndirective lines: evaluating instead would blank the block whenever the flag is not\ndefined in this same block, hiding the author's content while they edit it. It also\nkeeps both halves of an if/else idiom visible — with evaluation you could never see\nthe `ifndef` branch while the `ifdef` condition held. Nesting is handled by\n`splitConditionalParts`/`renderConditionalWrapper` below, recursively."
35946
+ ]
35700
35947
  },
35701
35948
  {
35702
35949
  "kind": "method",
35703
- "name": "renderBlock",
35950
+ "name": "_setValue",
35704
35951
  "privacy": "private",
35705
35952
  "parameters": [
35706
35953
  {
35707
- "name": "block",
35708
- "type": {
35709
- "text": "string"
35710
- }
35711
- },
35712
- {
35713
- "name": "index",
35954
+ "name": "value",
35714
35955
  "type": {
35715
35956
  "text": "number"
35716
35957
  }
@@ -35719,169 +35960,141 @@
35719
35960
  },
35720
35961
  {
35721
35962
  "kind": "method",
35722
- "name": "isActionDisabled",
35963
+ "name": "_handleClick",
35723
35964
  "privacy": "private",
35724
- "return": {
35725
- "type": {
35726
- "text": "boolean"
35727
- }
35728
- },
35729
35965
  "parameters": [
35730
35966
  {
35731
- "name": "action",
35967
+ "name": "event",
35732
35968
  "type": {
35733
- "text": "EditorAction"
35969
+ "text": "MouseEvent"
35734
35970
  }
35735
35971
  }
35736
- ],
35737
- "description": "An inline action needs an open block to apply its mark to."
35972
+ ]
35738
35973
  },
35739
35974
  {
35740
35975
  "kind": "method",
35741
- "name": "activateAction",
35976
+ "name": "_handleMouseEnter",
35742
35977
  "privacy": "private",
35743
35978
  "parameters": [
35744
35979
  {
35745
- "name": "action",
35980
+ "name": "event",
35746
35981
  "type": {
35747
- "text": "EditorAction"
35982
+ "text": "MouseEvent"
35748
35983
  }
35749
35984
  }
35750
- ],
35751
- "description": "Routes a toolbar/menu action to the inline or block insert path — the one place both\n`renderAction` and `renderMenuAction` call, so the bar and the overflow menu cannot\ndrift out of sync on what a given action actually does."
35985
+ ]
35752
35986
  },
35753
35987
  {
35754
35988
  "kind": "method",
35755
- "name": "renderAction",
35989
+ "name": "_handleMouseMove",
35756
35990
  "privacy": "private",
35757
35991
  "parameters": [
35758
35992
  {
35759
- "name": "action",
35993
+ "name": "event",
35760
35994
  "type": {
35761
- "text": "EditorAction"
35995
+ "text": "MouseEvent"
35762
35996
  }
35763
35997
  }
35764
- ],
35765
- "description": "A single toolbar action button, shared by the toolbar bar and the overflow menu."
35998
+ ]
35766
35999
  },
35767
36000
  {
35768
36001
  "kind": "method",
35769
- "name": "renderMenuAction",
36002
+ "name": "_handleMouseLeave",
36003
+ "privacy": "private"
36004
+ },
36005
+ {
36006
+ "kind": "method",
36007
+ "name": "_handleTouchStart",
35770
36008
  "privacy": "private",
35771
36009
  "parameters": [
35772
36010
  {
35773
- "name": "action",
36011
+ "name": "event",
35774
36012
  "type": {
35775
- "text": "EditorAction"
36013
+ "text": "TouchEvent"
35776
36014
  }
35777
36015
  }
35778
- ],
35779
- "description": "The same action, rendered as a menu item for the overflow menu."
35780
- },
35781
- {
35782
- "kind": "method",
35783
- "name": "renderRaw",
35784
- "privacy": "private"
36016
+ ]
35785
36017
  },
35786
36018
  {
35787
36019
  "kind": "method",
35788
- "name": "renderBody",
36020
+ "name": "_handleTouchMove",
35789
36021
  "privacy": "private",
35790
- "description": "The block views, with the inline image picker spliced in when active."
35791
- },
35792
- {
35793
- "kind": "method",
35794
- "name": "renderIncludePicker",
35795
- "privacy": "private"
36022
+ "parameters": [
36023
+ {
36024
+ "name": "event",
36025
+ "type": {
36026
+ "text": "TouchEvent"
36027
+ }
36028
+ }
36029
+ ]
35796
36030
  },
35797
36031
  {
35798
36032
  "kind": "method",
35799
- "name": "renderImagePicker",
35800
- "privacy": "private"
36033
+ "name": "_handleTouchEnd",
36034
+ "privacy": "private",
36035
+ "parameters": [
36036
+ {
36037
+ "name": "event",
36038
+ "type": {
36039
+ "text": "TouchEvent"
36040
+ }
36041
+ }
36042
+ ]
35801
36043
  }
35802
36044
  ],
35803
36045
  "events": [
35804
36046
  {
35805
- "description": "Emitted on each keystroke while editing a block.",
35806
- "name": "zn-input"
35807
- },
35808
- {
35809
- "description": "Emitted when a block edit is committed and the value changes.",
35810
- "name": "zn-change"
36047
+ "description": "Emitted as an example.",
36048
+ "name": "zn-event-name"
35811
36049
  }
35812
36050
  ],
35813
36051
  "attributes": [
35814
36052
  {
35815
- "name": "slash-recent-key",
35816
- "type": {
35817
- "text": "string"
35818
- },
35819
- "default": "''",
35820
- "description": "Lists the blocks most recently inserted here above the rest of the slash menu, remembered in\n`localStorage` under this key. Leave unset to offer no recently used section.",
35821
- "fieldName": "slashRecentKey"
35822
- },
35823
- {
35824
- "name": "name",
36053
+ "name": "label",
35825
36054
  "type": {
35826
36055
  "text": "string"
35827
36056
  },
35828
- "default": "''",
35829
- "description": "The name of the control, submitted as part of form data.",
35830
- "fieldName": "name"
36057
+ "fieldName": "label"
35831
36058
  },
35832
36059
  {
35833
- "name": "value",
36060
+ "name": "help-text",
35834
36061
  "type": {
35835
36062
  "text": "string"
35836
36063
  },
35837
36064
  "default": "''",
35838
- "description": "The current remarkd source.",
35839
- "fieldName": "value"
35840
- },
35841
- {
35842
- "name": "placeholder",
35843
- "type": {
35844
- "text": "string"
35845
- },
35846
- "default": "'Type something…'",
35847
- "description": "Placeholder shown when the document is empty.",
35848
- "fieldName": "placeholder"
36065
+ "description": "The rating's help text. If you need to display HTML, use the `help-text` slot instead.",
36066
+ "fieldName": "helpText"
35849
36067
  },
35850
36068
  {
35851
- "name": "attachment-url",
36069
+ "name": "name",
35852
36070
  "type": {
35853
36071
  "text": "string"
35854
36072
  },
35855
- "default": "''",
35856
- "description": "Endpoint for image uploads — required for image support. Posting the file\nmetadata here must return `{uploadPath, uploadUrl}`; the file is then PUT\nto `uploadUrl` and the returned `uploadPath` is embedded as the image URL.",
35857
- "fieldName": "attachmentUrl"
36073
+ "fieldName": "name"
35858
36074
  },
35859
36075
  {
35860
- "name": "include-url",
36076
+ "name": "value",
35861
36077
  "type": {
35862
- "text": "string"
36078
+ "text": "number"
35863
36079
  },
35864
- "default": "''",
35865
- "description": "Endpoint listing the Includes this document may embed, as\n`{\"items\":[{id,title,description,scope,keywords,languages,url}]}`. Labels the\nchips rendered for `include::` directives and feeds the include picker.",
35866
- "fieldName": "includeUrl"
36080
+ "default": "0",
36081
+ "fieldName": "value"
35867
36082
  },
35868
36083
  {
35869
- "name": "allow-raw",
36084
+ "name": "max",
35870
36085
  "type": {
35871
- "text": "boolean"
36086
+ "text": "number"
35872
36087
  },
35873
- "default": "false",
35874
- "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
35875
- "fieldName": "allowRaw"
36088
+ "default": "5",
36089
+ "fieldName": "max"
35876
36090
  },
35877
36091
  {
35878
- "name": "required",
36092
+ "name": "precision",
35879
36093
  "type": {
35880
- "text": "boolean"
36094
+ "text": "number"
35881
36095
  },
35882
- "default": "false",
35883
- "description": "Makes the editor required for form submission.",
35884
- "fieldName": "required"
36096
+ "default": "1",
36097
+ "fieldName": "precision"
35885
36098
  },
35886
36099
  {
35887
36100
  "name": "readonly",
@@ -35889,7 +36102,6 @@
35889
36102
  "text": "boolean"
35890
36103
  },
35891
36104
  "default": "false",
35892
- "description": "Makes the editor read-only.",
35893
36105
  "fieldName": "readonly"
35894
36106
  },
35895
36107
  {
@@ -35898,216 +36110,31 @@
35898
36110
  "text": "boolean"
35899
36111
  },
35900
36112
  "default": "false",
35901
- "description": "Disables the editor.",
35902
36113
  "fieldName": "disabled"
35903
- }
35904
- ],
35905
- "superclass": {
35906
- "name": "ZincElement",
35907
- "module": "/src/internal/zinc-element"
35908
- },
35909
- "summary": "A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.",
35910
- "tagNameWithoutPrefix": "remarkd-editor",
35911
- "tagName": "zn-remarkd-editor",
35912
- "customElement": true,
35913
- "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-dropdown\n * @dependency zn-icon\n * @dependency zn-file\n * @dependency zn-menu\n * @dependency zn-menu-item\n * @dependency zn-slash-menu\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 and inline-formatting toolbar.\n * @csspart raw-toggle - The button that switches between the block view and the raw source view.\n * @csspart block - A rendered block wrapper.\n * @csspart rendered - The rendered remarkd output of a block.\n * @csspart conditional - A labelled wrapper for an ifdef/ifndef/ifeval/iftrue/iffalse/ifempty/ifnempty range.\n * @csspart variable - A chip rendered for a document attribute, title, or bracket line.\n * @csspart input - The textarea shown while editing a block.\n * @csspart raw - The full-document textarea shown in raw source mode.\n * @csspart slash-menu - The `zn-slash-menu` opened by typing \"/\" in an empty block.\n * @csspart image-controls - The caption / alignment / size panel shown when an image block is clicked.\n * @csspart include - The chip rendered in place of an `include::` directive.\n * @csspart include-picker - The inline Include picker opened from the toolbar or \"/include\".\n *\n * @cssproperty --remarkd-editor-max-height - The tallest the editor grows before its body scrolls. Defaults to `100dvh`.\n */",
35914
- "documentation": "https://zinc.style/components/remarkd-editor",
35915
- "status": "experimental",
35916
- "since": "1.0",
35917
- "dependencies": [
35918
- "zn-button",
35919
- "zn-button-group",
35920
- "zn-dropdown",
35921
- "zn-icon",
35922
- "zn-file",
35923
- "zn-menu",
35924
- "zn-menu-item",
35925
- "zn-slash-menu"
35926
- ]
35927
- }
35928
- ],
35929
- "exports": [
35930
- {
35931
- "kind": "js",
35932
- "name": "default",
35933
- "declaration": {
35934
- "name": "ZnRemarkdEditor",
35935
- "module": "components/remarkd-editor/remarkd-editor.js"
35936
- }
35937
- }
35938
- ]
35939
- },
35940
- {
35941
- "kind": "javascript-module",
35942
- "path": "components/reveal/reveal.js",
35943
- "declarations": [
35944
- {
35945
- "kind": "class",
35946
- "description": "",
35947
- "name": "ZnReveal",
35948
- "cssProperties": [
35949
- {
35950
- "description": "An example CSS custom property.",
35951
- "name": "--example"
35952
- }
35953
- ],
35954
- "cssParts": [
35955
- {
35956
- "description": "The component's base wrapper.",
35957
- "name": "base"
35958
- }
35959
- ],
35960
- "slots": [
35961
- {
35962
- "description": "The default slot.",
35963
- "name": ""
35964
- },
35965
- {
35966
- "description": "An example slot.",
35967
- "name": "example"
35968
- }
35969
- ],
35970
- "members": [
35971
- {
35972
- "kind": "field",
35973
- "name": "duration",
35974
- "type": {
35975
- "text": "number"
35976
- },
35977
- "default": "2000",
35978
- "attribute": "duration"
35979
- },
35980
- {
35981
- "kind": "field",
35982
- "name": "initial",
35983
- "type": {
35984
- "text": "string"
35985
- },
35986
- "default": "''",
35987
- "attribute": "initial"
35988
- },
35989
- {
35990
- "kind": "field",
35991
- "name": "revealed",
35992
- "type": {
35993
- "text": "string"
35994
- },
35995
- "default": "''",
35996
- "attribute": "revealed"
35997
- },
35998
- {
35999
- "kind": "field",
36000
- "name": "hideDelay",
36001
- "type": {
36002
- "text": "number"
36003
- },
36004
- "default": "150",
36005
- "attribute": "hide-delay"
36006
36114
  },
36007
36115
  {
36008
- "kind": "field",
36009
- "name": "noToggle",
36116
+ "name": "preview",
36010
36117
  "type": {
36011
36118
  "text": "boolean"
36012
36119
  },
36013
36120
  "default": "false",
36014
- "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
36015
- "attribute": "no-toggle"
36016
- },
36017
- {
36018
- "kind": "field",
36019
- "name": "_isRevealed",
36020
- "type": {
36021
- "text": "boolean"
36022
- },
36023
- "privacy": "private",
36024
- "default": "false"
36025
- },
36026
- {
36027
- "kind": "field",
36028
- "name": "_isToggled",
36029
- "type": {
36030
- "text": "boolean"
36031
- },
36032
- "privacy": "private",
36033
- "default": "false"
36034
- },
36035
- {
36036
- "kind": "field",
36037
- "name": "_hideTimer",
36038
- "type": {
36039
- "text": "ReturnType<typeof setTimeout> | undefined"
36040
- },
36041
- "privacy": "private"
36042
- },
36043
- {
36044
- "kind": "method",
36045
- "name": "_clearHideTimer",
36046
- "privacy": "private"
36047
- },
36048
- {
36049
- "kind": "method",
36050
- "name": "handleToggleReveal",
36051
- "privacy": "protected"
36052
- },
36053
- {
36054
- "kind": "method",
36055
- "name": "handleMouseEnter",
36056
- "privacy": "protected"
36057
- },
36058
- {
36059
- "kind": "method",
36060
- "name": "handleMouseLeave",
36061
- "privacy": "protected"
36062
- }
36063
- ],
36064
- "events": [
36065
- {
36066
- "description": "Emitted as an example.",
36067
- "name": "zn-event-name"
36068
- }
36069
- ],
36070
- "attributes": [
36071
- {
36072
- "name": "duration",
36073
- "type": {
36074
- "text": "number"
36075
- },
36076
- "default": "2000",
36077
- "fieldName": "duration"
36078
- },
36079
- {
36080
- "name": "initial",
36081
- "type": {
36082
- "text": "string"
36083
- },
36084
- "default": "''",
36085
- "fieldName": "initial"
36086
- },
36087
- {
36088
- "name": "revealed",
36089
- "type": {
36090
- "text": "string"
36091
- },
36092
- "default": "''",
36093
- "fieldName": "revealed"
36121
+ "description": "Displays the value alongside the symbols, updating live as the pointer moves across them.",
36122
+ "fieldName": "preview"
36094
36123
  },
36095
36124
  {
36096
- "name": "hide-delay",
36125
+ "name": "size",
36097
36126
  "type": {
36098
- "text": "number"
36127
+ "text": "'small' | 'medium' | 'large'"
36099
36128
  },
36100
- "default": "150",
36101
- "fieldName": "hideDelay"
36129
+ "default": "'medium'",
36130
+ "fieldName": "size"
36102
36131
  },
36103
36132
  {
36104
- "name": "no-toggle",
36133
+ "name": "getSymbol",
36105
36134
  "type": {
36106
- "text": "boolean"
36135
+ "text": "(value: number) => string"
36107
36136
  },
36108
- "default": "false",
36109
- "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
36110
- "fieldName": "noToggle"
36137
+ "fieldName": "getSymbol"
36111
36138
  }
36112
36139
  ],
36113
36140
  "superclass": {
@@ -36115,11 +36142,11 @@
36115
36142
  "module": "/src/internal/zinc-element"
36116
36143
  },
36117
36144
  "summary": "Short summary of the component's intended use.",
36118
- "tagNameWithoutPrefix": "reveal",
36119
- "tagName": "zn-reveal",
36145
+ "tagNameWithoutPrefix": "rating",
36146
+ "tagName": "zn-rating",
36120
36147
  "customElement": true,
36121
- "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/reveal\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @usage\n * ```html\n * <zn-reveal duration=\"3000\"\n * initial=\"******@hotmail.com\"\n * revealed=\"john.doe@hotmail.com\" toggle>\n * </zn-reveal>\n * ```\n *\n * @cssproperty --example - An example CSS custom property.\n */",
36122
- "documentation": "https://zinc.style/components/reveal",
36148
+ "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/rating\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n * @slot help-text - Text that describes how to use the rating. Alternatively, you can use the `help-text` attribute.\n *\n * @csspart form-control - The form control that wraps the symbols and help text.\n * @csspart form-control-help-text - The help text's wrapper.\n * @csspart base - The component's base wrapper.\n * @csspart preview - The value shown next to the symbols when `preview` is enabled.\n *\n * @cssproperty --example - An example CSS custom property.\n * @cssproperty --preview-color - The color of the preview value.\n * @cssproperty --preview-size - The font size of the preview value.\n */",
36149
+ "documentation": "https://zinc.style/components/rating",
36123
36150
  "status": "experimental",
36124
36151
  "since": "1.0",
36125
36152
  "dependencies": [
@@ -36132,8 +36159,8 @@
36132
36159
  "kind": "js",
36133
36160
  "name": "default",
36134
36161
  "declaration": {
36135
- "name": "ZnReveal",
36136
- "module": "components/reveal/reveal.js"
36162
+ "name": "ZnRating",
36163
+ "module": "components/rating/rating.js"
36137
36164
  }
36138
36165
  }
36139
36166
  ]
@@ -50862,7 +50889,7 @@
50862
50889
  "package": {
50863
50890
  "name": "@kubex/zinc",
50864
50891
  "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
50865
- "version": "1.1.106",
50892
+ "version": "1.1.107",
50866
50893
  "author": "",
50867
50894
  "license": "MIT"
50868
50895
  }