@kubex/zinc 1.1.107 → 1.1.109

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.
@@ -56,79 +56,6 @@
56
56
  }
57
57
  ]
58
58
  },
59
- {
60
- "kind": "javascript-module",
61
- "path": "components/action-bar/action-bar.js",
62
- "declarations": [
63
- {
64
- "kind": "class",
65
- "description": "",
66
- "name": "ZnActionBar",
67
- "cssProperties": [
68
- {
69
- "description": "An example CSS custom property.",
70
- "name": "--example"
71
- }
72
- ],
73
- "cssParts": [
74
- {
75
- "description": "The component's base wrapper.",
76
- "name": "base"
77
- }
78
- ],
79
- "slots": [
80
- {
81
- "description": "The default slot.",
82
- "name": ""
83
- },
84
- {
85
- "description": "An example slot.",
86
- "name": "example"
87
- }
88
- ],
89
- "members": [
90
- {
91
- "kind": "field",
92
- "name": "localize",
93
- "privacy": "private",
94
- "readonly": true,
95
- "default": "new LocalizeController(this)"
96
- }
97
- ],
98
- "events": [
99
- {
100
- "description": "Emitted as an example.",
101
- "name": "zn-event-name"
102
- }
103
- ],
104
- "superclass": {
105
- "name": "ZincElement",
106
- "module": "/src/internal/zinc-element"
107
- },
108
- "summary": "Short summary of the component's intended use.",
109
- "tagNameWithoutPrefix": "action-bar",
110
- "tagName": "zn-action-bar",
111
- "customElement": true,
112
- "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/action-bar\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 * @cssproperty --example - An example CSS custom property.\n */",
113
- "documentation": "https://zinc.style/components/action-bar",
114
- "status": "experimental",
115
- "since": "1.0",
116
- "dependencies": [
117
- "zn-example"
118
- ]
119
- }
120
- ],
121
- "exports": [
122
- {
123
- "kind": "js",
124
- "name": "default",
125
- "declaration": {
126
- "name": "ZnActionBar",
127
- "module": "components/action-bar/action-bar.js"
128
- }
129
- }
130
- ]
131
- },
132
59
  {
133
60
  "kind": "javascript-module",
134
61
  "path": "components/alert/alert.js",
@@ -323,6 +250,79 @@
323
250
  }
324
251
  ]
325
252
  },
253
+ {
254
+ "kind": "javascript-module",
255
+ "path": "components/action-bar/action-bar.js",
256
+ "declarations": [
257
+ {
258
+ "kind": "class",
259
+ "description": "",
260
+ "name": "ZnActionBar",
261
+ "cssProperties": [
262
+ {
263
+ "description": "An example CSS custom property.",
264
+ "name": "--example"
265
+ }
266
+ ],
267
+ "cssParts": [
268
+ {
269
+ "description": "The component's base wrapper.",
270
+ "name": "base"
271
+ }
272
+ ],
273
+ "slots": [
274
+ {
275
+ "description": "The default slot.",
276
+ "name": ""
277
+ },
278
+ {
279
+ "description": "An example slot.",
280
+ "name": "example"
281
+ }
282
+ ],
283
+ "members": [
284
+ {
285
+ "kind": "field",
286
+ "name": "localize",
287
+ "privacy": "private",
288
+ "readonly": true,
289
+ "default": "new LocalizeController(this)"
290
+ }
291
+ ],
292
+ "events": [
293
+ {
294
+ "description": "Emitted as an example.",
295
+ "name": "zn-event-name"
296
+ }
297
+ ],
298
+ "superclass": {
299
+ "name": "ZincElement",
300
+ "module": "/src/internal/zinc-element"
301
+ },
302
+ "summary": "Short summary of the component's intended use.",
303
+ "tagNameWithoutPrefix": "action-bar",
304
+ "tagName": "zn-action-bar",
305
+ "customElement": true,
306
+ "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/action-bar\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 * @cssproperty --example - An example CSS custom property.\n */",
307
+ "documentation": "https://zinc.style/components/action-bar",
308
+ "status": "experimental",
309
+ "since": "1.0",
310
+ "dependencies": [
311
+ "zn-example"
312
+ ]
313
+ }
314
+ ],
315
+ "exports": [
316
+ {
317
+ "kind": "js",
318
+ "name": "default",
319
+ "declaration": {
320
+ "name": "ZnActionBar",
321
+ "module": "components/action-bar/action-bar.js"
322
+ }
323
+ }
324
+ ]
325
+ },
326
326
  {
327
327
  "kind": "javascript-module",
328
328
  "path": "components/animated-button/animated-button.js",
@@ -2582,290 +2582,6 @@
2582
2582
  }
2583
2583
  ]
2584
2584
  },
2585
- {
2586
- "kind": "javascript-module",
2587
- "path": "components/button-menu/button-menu.js",
2588
- "declarations": [
2589
- {
2590
- "kind": "class",
2591
- "description": "",
2592
- "name": "ZnButtonMenu",
2593
- "slots": [
2594
- {
2595
- "description": "The default slot.",
2596
- "name": ""
2597
- }
2598
- ],
2599
- "members": [
2600
- {
2601
- "kind": "field",
2602
- "name": "maxWidth",
2603
- "type": {
2604
- "text": "number"
2605
- },
2606
- "privacy": "public",
2607
- "attribute": "max-width"
2608
- },
2609
- {
2610
- "kind": "field",
2611
- "name": "containerWidth",
2612
- "type": {
2613
- "text": "number"
2614
- },
2615
- "privacy": "public",
2616
- "attribute": "containerWidth"
2617
- },
2618
- {
2619
- "kind": "field",
2620
- "name": "limit",
2621
- "type": {
2622
- "text": "number"
2623
- },
2624
- "privacy": "public",
2625
- "default": "-1",
2626
- "attribute": "limit"
2627
- },
2628
- {
2629
- "kind": "field",
2630
- "name": "maxLevel",
2631
- "type": {
2632
- "text": "number"
2633
- },
2634
- "privacy": "public",
2635
- "default": "2",
2636
- "attribute": "max-level"
2637
- },
2638
- {
2639
- "kind": "field",
2640
- "name": "iconSize",
2641
- "type": {
2642
- "text": "number"
2643
- },
2644
- "default": "20",
2645
- "attribute": "icon-size",
2646
- "reflects": true
2647
- },
2648
- {
2649
- "kind": "field",
2650
- "name": "noGap",
2651
- "type": {
2652
- "text": "boolean"
2653
- },
2654
- "privacy": "public",
2655
- "attribute": "no-gap"
2656
- },
2657
- {
2658
- "kind": "field",
2659
- "name": "noPadding",
2660
- "type": {
2661
- "text": "boolean"
2662
- },
2663
- "privacy": "public",
2664
- "attribute": "no-padding"
2665
- },
2666
- {
2667
- "kind": "field",
2668
- "name": "_buttons",
2669
- "type": {
2670
- "text": "CustomButtonWidths[]"
2671
- },
2672
- "privacy": "private",
2673
- "default": "[]"
2674
- },
2675
- {
2676
- "kind": "field",
2677
- "name": "_originalButtons",
2678
- "type": {
2679
- "text": "CustomButtonWidths[]"
2680
- },
2681
- "privacy": "private",
2682
- "default": "[]"
2683
- },
2684
- {
2685
- "kind": "field",
2686
- "name": "_resizeRafId",
2687
- "type": {
2688
- "text": "number"
2689
- },
2690
- "privacy": "private",
2691
- "default": "0"
2692
- },
2693
- {
2694
- "kind": "field",
2695
- "name": "resizeObserver",
2696
- "privacy": "private",
2697
- "readonly": true,
2698
- "default": "new ResizeController(this, { target: null, callback: () => { if (this._resizeRafId) return; this._resizeRafId = requestAnimationFrame(() => { this._resizeRafId = 0; this.containerWidth = this.offsetWidth; }); }, })"
2699
- },
2700
- {
2701
- "kind": "method",
2702
- "name": "watchContainerMaxWidth"
2703
- },
2704
- {
2705
- "kind": "method",
2706
- "name": "calculateVisibleButtons"
2707
- },
2708
- {
2709
- "kind": "method",
2710
- "name": "calculateMenuButtons",
2711
- "parameters": [
2712
- {
2713
- "name": "totalButtons",
2714
- "type": {
2715
- "text": "number"
2716
- }
2717
- },
2718
- {
2719
- "name": "visibleButtons",
2720
- "type": {
2721
- "text": "number"
2722
- }
2723
- },
2724
- {
2725
- "name": "buttons",
2726
- "type": {
2727
- "text": "CustomButtonWidths[]"
2728
- }
2729
- }
2730
- ]
2731
- },
2732
- {
2733
- "kind": "method",
2734
- "name": "getButtonLabel",
2735
- "privacy": "private",
2736
- "parameters": [
2737
- {
2738
- "name": "button",
2739
- "type": {
2740
- "text": "ZnButton"
2741
- }
2742
- }
2743
- ]
2744
- },
2745
- {
2746
- "kind": "method",
2747
- "name": "addButton",
2748
- "privacy": "public",
2749
- "parameters": [
2750
- {
2751
- "name": "button",
2752
- "type": {
2753
- "text": "ZnButton"
2754
- }
2755
- }
2756
- ]
2757
- },
2758
- {
2759
- "kind": "method",
2760
- "name": "setDynamicButtons",
2761
- "privacy": "public",
2762
- "parameters": [
2763
- {
2764
- "name": "btns",
2765
- "type": {
2766
- "text": "NodeListOf<ZnButton>"
2767
- }
2768
- }
2769
- ]
2770
- },
2771
- {
2772
- "kind": "method",
2773
- "name": "removeButton",
2774
- "privacy": "public",
2775
- "parameters": [
2776
- {
2777
- "name": "id",
2778
- "type": {
2779
- "text": "string"
2780
- }
2781
- }
2782
- ]
2783
- },
2784
- {
2785
- "kind": "method",
2786
- "name": "removeAllButtons",
2787
- "privacy": "public"
2788
- }
2789
- ],
2790
- "attributes": [
2791
- {
2792
- "name": "max-width",
2793
- "type": {
2794
- "text": "number"
2795
- },
2796
- "fieldName": "maxWidth"
2797
- },
2798
- {
2799
- "name": "containerWidth",
2800
- "type": {
2801
- "text": "number"
2802
- },
2803
- "fieldName": "containerWidth"
2804
- },
2805
- {
2806
- "name": "limit",
2807
- "type": {
2808
- "text": "number"
2809
- },
2810
- "default": "-1",
2811
- "fieldName": "limit"
2812
- },
2813
- {
2814
- "name": "max-level",
2815
- "type": {
2816
- "text": "number"
2817
- },
2818
- "default": "2",
2819
- "fieldName": "maxLevel"
2820
- },
2821
- {
2822
- "name": "icon-size",
2823
- "type": {
2824
- "text": "number"
2825
- },
2826
- "default": "20",
2827
- "fieldName": "iconSize"
2828
- },
2829
- {
2830
- "name": "no-gap",
2831
- "type": {
2832
- "text": "boolean"
2833
- },
2834
- "fieldName": "noGap"
2835
- },
2836
- {
2837
- "name": "no-padding",
2838
- "type": {
2839
- "text": "boolean"
2840
- },
2841
- "fieldName": "noPadding"
2842
- }
2843
- ],
2844
- "superclass": {
2845
- "name": "ZincElement",
2846
- "module": "/src/internal/zinc-element"
2847
- },
2848
- "summary": "Automatically hides buttons in a menu when the screen is too small.",
2849
- "tagNameWithoutPrefix": "button-menu",
2850
- "tagName": "zn-button-menu",
2851
- "customElement": true,
2852
- "jsDoc": "/**\n * @summary Automatically hides buttons in a menu when the screen is too small.\n * @documentation https://zinc.style/components/button-menu\n * @status experimental\n * @since 1.0\n *\n * @slot - The default slot.\n *\n */",
2853
- "documentation": "https://zinc.style/components/button-menu",
2854
- "status": "experimental",
2855
- "since": "1.0"
2856
- }
2857
- ],
2858
- "exports": [
2859
- {
2860
- "kind": "js",
2861
- "name": "default",
2862
- "declaration": {
2863
- "name": "ZnButtonMenu",
2864
- "module": "components/button-menu/button-menu.js"
2865
- }
2866
- }
2867
- ]
2868
- },
2869
2585
  {
2870
2586
  "kind": "javascript-module",
2871
2587
  "path": "components/channel-tile/channel-tile.js",
@@ -3939,6 +3655,290 @@
3939
3655
  }
3940
3656
  ]
3941
3657
  },
3658
+ {
3659
+ "kind": "javascript-module",
3660
+ "path": "components/button-menu/button-menu.js",
3661
+ "declarations": [
3662
+ {
3663
+ "kind": "class",
3664
+ "description": "",
3665
+ "name": "ZnButtonMenu",
3666
+ "slots": [
3667
+ {
3668
+ "description": "The default slot.",
3669
+ "name": ""
3670
+ }
3671
+ ],
3672
+ "members": [
3673
+ {
3674
+ "kind": "field",
3675
+ "name": "maxWidth",
3676
+ "type": {
3677
+ "text": "number"
3678
+ },
3679
+ "privacy": "public",
3680
+ "attribute": "max-width"
3681
+ },
3682
+ {
3683
+ "kind": "field",
3684
+ "name": "containerWidth",
3685
+ "type": {
3686
+ "text": "number"
3687
+ },
3688
+ "privacy": "public",
3689
+ "attribute": "containerWidth"
3690
+ },
3691
+ {
3692
+ "kind": "field",
3693
+ "name": "limit",
3694
+ "type": {
3695
+ "text": "number"
3696
+ },
3697
+ "privacy": "public",
3698
+ "default": "-1",
3699
+ "attribute": "limit"
3700
+ },
3701
+ {
3702
+ "kind": "field",
3703
+ "name": "maxLevel",
3704
+ "type": {
3705
+ "text": "number"
3706
+ },
3707
+ "privacy": "public",
3708
+ "default": "2",
3709
+ "attribute": "max-level"
3710
+ },
3711
+ {
3712
+ "kind": "field",
3713
+ "name": "iconSize",
3714
+ "type": {
3715
+ "text": "number"
3716
+ },
3717
+ "default": "20",
3718
+ "attribute": "icon-size",
3719
+ "reflects": true
3720
+ },
3721
+ {
3722
+ "kind": "field",
3723
+ "name": "noGap",
3724
+ "type": {
3725
+ "text": "boolean"
3726
+ },
3727
+ "privacy": "public",
3728
+ "attribute": "no-gap"
3729
+ },
3730
+ {
3731
+ "kind": "field",
3732
+ "name": "noPadding",
3733
+ "type": {
3734
+ "text": "boolean"
3735
+ },
3736
+ "privacy": "public",
3737
+ "attribute": "no-padding"
3738
+ },
3739
+ {
3740
+ "kind": "field",
3741
+ "name": "_buttons",
3742
+ "type": {
3743
+ "text": "CustomButtonWidths[]"
3744
+ },
3745
+ "privacy": "private",
3746
+ "default": "[]"
3747
+ },
3748
+ {
3749
+ "kind": "field",
3750
+ "name": "_originalButtons",
3751
+ "type": {
3752
+ "text": "CustomButtonWidths[]"
3753
+ },
3754
+ "privacy": "private",
3755
+ "default": "[]"
3756
+ },
3757
+ {
3758
+ "kind": "field",
3759
+ "name": "_resizeRafId",
3760
+ "type": {
3761
+ "text": "number"
3762
+ },
3763
+ "privacy": "private",
3764
+ "default": "0"
3765
+ },
3766
+ {
3767
+ "kind": "field",
3768
+ "name": "resizeObserver",
3769
+ "privacy": "private",
3770
+ "readonly": true,
3771
+ "default": "new ResizeController(this, { target: null, callback: () => { if (this._resizeRafId) return; this._resizeRafId = requestAnimationFrame(() => { this._resizeRafId = 0; this.containerWidth = this.offsetWidth; }); }, })"
3772
+ },
3773
+ {
3774
+ "kind": "method",
3775
+ "name": "watchContainerMaxWidth"
3776
+ },
3777
+ {
3778
+ "kind": "method",
3779
+ "name": "calculateVisibleButtons"
3780
+ },
3781
+ {
3782
+ "kind": "method",
3783
+ "name": "calculateMenuButtons",
3784
+ "parameters": [
3785
+ {
3786
+ "name": "totalButtons",
3787
+ "type": {
3788
+ "text": "number"
3789
+ }
3790
+ },
3791
+ {
3792
+ "name": "visibleButtons",
3793
+ "type": {
3794
+ "text": "number"
3795
+ }
3796
+ },
3797
+ {
3798
+ "name": "buttons",
3799
+ "type": {
3800
+ "text": "CustomButtonWidths[]"
3801
+ }
3802
+ }
3803
+ ]
3804
+ },
3805
+ {
3806
+ "kind": "method",
3807
+ "name": "getButtonLabel",
3808
+ "privacy": "private",
3809
+ "parameters": [
3810
+ {
3811
+ "name": "button",
3812
+ "type": {
3813
+ "text": "ZnButton"
3814
+ }
3815
+ }
3816
+ ]
3817
+ },
3818
+ {
3819
+ "kind": "method",
3820
+ "name": "addButton",
3821
+ "privacy": "public",
3822
+ "parameters": [
3823
+ {
3824
+ "name": "button",
3825
+ "type": {
3826
+ "text": "ZnButton"
3827
+ }
3828
+ }
3829
+ ]
3830
+ },
3831
+ {
3832
+ "kind": "method",
3833
+ "name": "setDynamicButtons",
3834
+ "privacy": "public",
3835
+ "parameters": [
3836
+ {
3837
+ "name": "btns",
3838
+ "type": {
3839
+ "text": "NodeListOf<ZnButton>"
3840
+ }
3841
+ }
3842
+ ]
3843
+ },
3844
+ {
3845
+ "kind": "method",
3846
+ "name": "removeButton",
3847
+ "privacy": "public",
3848
+ "parameters": [
3849
+ {
3850
+ "name": "id",
3851
+ "type": {
3852
+ "text": "string"
3853
+ }
3854
+ }
3855
+ ]
3856
+ },
3857
+ {
3858
+ "kind": "method",
3859
+ "name": "removeAllButtons",
3860
+ "privacy": "public"
3861
+ }
3862
+ ],
3863
+ "attributes": [
3864
+ {
3865
+ "name": "max-width",
3866
+ "type": {
3867
+ "text": "number"
3868
+ },
3869
+ "fieldName": "maxWidth"
3870
+ },
3871
+ {
3872
+ "name": "containerWidth",
3873
+ "type": {
3874
+ "text": "number"
3875
+ },
3876
+ "fieldName": "containerWidth"
3877
+ },
3878
+ {
3879
+ "name": "limit",
3880
+ "type": {
3881
+ "text": "number"
3882
+ },
3883
+ "default": "-1",
3884
+ "fieldName": "limit"
3885
+ },
3886
+ {
3887
+ "name": "max-level",
3888
+ "type": {
3889
+ "text": "number"
3890
+ },
3891
+ "default": "2",
3892
+ "fieldName": "maxLevel"
3893
+ },
3894
+ {
3895
+ "name": "icon-size",
3896
+ "type": {
3897
+ "text": "number"
3898
+ },
3899
+ "default": "20",
3900
+ "fieldName": "iconSize"
3901
+ },
3902
+ {
3903
+ "name": "no-gap",
3904
+ "type": {
3905
+ "text": "boolean"
3906
+ },
3907
+ "fieldName": "noGap"
3908
+ },
3909
+ {
3910
+ "name": "no-padding",
3911
+ "type": {
3912
+ "text": "boolean"
3913
+ },
3914
+ "fieldName": "noPadding"
3915
+ }
3916
+ ],
3917
+ "superclass": {
3918
+ "name": "ZincElement",
3919
+ "module": "/src/internal/zinc-element"
3920
+ },
3921
+ "summary": "Automatically hides buttons in a menu when the screen is too small.",
3922
+ "tagNameWithoutPrefix": "button-menu",
3923
+ "tagName": "zn-button-menu",
3924
+ "customElement": true,
3925
+ "jsDoc": "/**\n * @summary Automatically hides buttons in a menu when the screen is too small.\n * @documentation https://zinc.style/components/button-menu\n * @status experimental\n * @since 1.0\n *\n * @slot - The default slot.\n *\n */",
3926
+ "documentation": "https://zinc.style/components/button-menu",
3927
+ "status": "experimental",
3928
+ "since": "1.0"
3929
+ }
3930
+ ],
3931
+ "exports": [
3932
+ {
3933
+ "kind": "js",
3934
+ "name": "default",
3935
+ "declaration": {
3936
+ "name": "ZnButtonMenu",
3937
+ "module": "components/button-menu/button-menu.js"
3938
+ }
3939
+ }
3940
+ ]
3941
+ },
3942
3942
  {
3943
3943
  "kind": "javascript-module",
3944
3944
  "path": "components/chat-message/chat-message.js",
@@ -31022,7 +31022,7 @@
31022
31022
  "name": "formControlController",
31023
31023
  "privacy": "protected",
31024
31024
  "readonly": true,
31025
- "default": "new FormControlController(this, { value: (control: ZnPriorityList) => { return JSON.stringify(control.getPriorityMap()); }, defaultValue: (control: ZnPriorityList) => control.defaultValue, setValue: (control: ZnPriorityList, value: string) => { if (value) { try { const parsed: unknown = JSON.parse(value); if (Array.isArray(parsed) && parsed.every((item: unknown): item is string => typeof item === 'string')) { control.value = parsed as string[]; } } catch { // ignore parse errors } } }, })"
31025
+ "default": "new FormControlController(this, { value: (control: ZnPriorityList) => { return JSON.stringify(control.getPriorityMap()); }, defaultValue: (control: ZnPriorityList) => control.defaultValue, // A form reset passes defaultValue straight back in, so this has to accept the // key array as well as the serialised value other callers set. setValue: (control: ZnPriorityList, value: string | string[]) => { if (!value || (Array.isArray(value) && value.length === 0)) return; const keys: unknown = Array.isArray(value) ? value : safeParse(value); if (Array.isArray(keys) && keys.every((item: unknown): item is string => typeof item === 'string')) { control.value = keys as string[]; } }, })"
31026
31026
  },
31027
31027
  {
31028
31028
  "kind": "field",
@@ -33784,142 +33784,99 @@
33784
33784
  },
33785
33785
  {
33786
33786
  "kind": "javascript-module",
33787
- "path": "components/remarkd-editor/remarkd-editor.js",
33787
+ "path": "components/rating/rating.js",
33788
33788
  "declarations": [
33789
33789
  {
33790
33790
  "kind": "class",
33791
33791
  "description": "",
33792
- "name": "ZnRemarkdEditor",
33792
+ "name": "ZnRating",
33793
33793
  "cssProperties": [
33794
33794
  {
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"
33803
- },
33804
- {
33805
- "description": "The always-visible block-insert and inline-formatting toolbar.",
33806
- "name": "toolbar"
33807
- },
33808
- {
33809
- "description": "The button that switches between the block view and the raw source view.",
33810
- "name": "raw-toggle"
33811
- },
33812
- {
33813
- "description": "A rendered block wrapper.",
33814
- "name": "block"
33795
+ "description": "An example CSS custom property.",
33796
+ "name": "--example"
33815
33797
  },
33816
33798
  {
33817
- "description": "The rendered remarkd output of a block.",
33818
- "name": "rendered"
33799
+ "description": "The color of the preview value.",
33800
+ "name": "--preview-color"
33819
33801
  },
33820
33802
  {
33821
- "description": "A labelled wrapper for an ifdef/ifndef/ifeval/iftrue/iffalse/ifempty/ifnempty range.",
33822
- "name": "conditional"
33823
- },
33803
+ "description": "The font size of the preview value.",
33804
+ "name": "--preview-size"
33805
+ }
33806
+ ],
33807
+ "cssParts": [
33824
33808
  {
33825
- "description": "A chip rendered for a document attribute, title, or bracket line.",
33826
- "name": "variable"
33809
+ "description": "The form control that wraps the symbols and help text.",
33810
+ "name": "form-control"
33827
33811
  },
33828
33812
  {
33829
- "description": "The textarea shown while editing a block.",
33830
- "name": "input"
33813
+ "description": "The help text's wrapper.",
33814
+ "name": "form-control-help-text"
33831
33815
  },
33832
33816
  {
33833
- "description": "The full-document textarea shown in raw source mode.",
33834
- "name": "raw"
33817
+ "description": "The component's base wrapper.",
33818
+ "name": "base"
33835
33819
  },
33836
33820
  {
33837
- "description": "The `zn-slash-menu` opened by typing \"/\" in an empty block.",
33838
- "name": "slash-menu"
33839
- },
33821
+ "description": "The value shown next to the symbols when `preview` is enabled.",
33822
+ "name": "preview"
33823
+ }
33824
+ ],
33825
+ "slots": [
33840
33826
  {
33841
- "description": "The caption / alignment / size panel shown when an image block is clicked.",
33842
- "name": "image-controls"
33827
+ "description": "The default slot.",
33828
+ "name": ""
33843
33829
  },
33844
33830
  {
33845
- "description": "The chip rendered in place of an `include::` directive.",
33846
- "name": "include"
33831
+ "description": "An example slot.",
33832
+ "name": "example"
33847
33833
  },
33848
33834
  {
33849
- "description": "The inline Include picker opened from the toolbar or \"/include\".",
33850
- "name": "include-picker"
33835
+ "description": "Text that describes how to use the rating. Alternatively, you can use the `help-text` attribute.",
33836
+ "name": "help-text"
33851
33837
  }
33852
33838
  ],
33853
33839
  "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
- },
33863
33840
  {
33864
33841
  "kind": "field",
33865
33842
  "name": "formControlController",
33866
33843
  "privacy": "private",
33867
33844
  "readonly": true,
33868
- "default": "new FormControlController(this, { assumeInteractionOn: ['zn-input', 'zn-change'], })"
33869
- },
33870
- {
33871
- "kind": "field",
33872
- "name": "slashController",
33873
- "privacy": "private",
33874
- "readonly": true,
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) })"
33845
+ "default": "new FormControlController(this, { assumeInteractionOn: ['zn-blur', 'zn-input'] })"
33876
33846
  },
33877
33847
  {
33878
33848
  "kind": "field",
33879
- "name": "toolbarOverflow",
33849
+ "name": "hasSlotController",
33880
33850
  "privacy": "private",
33881
33851
  "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",
33887
- "type": {
33888
- "text": "string"
33889
- },
33890
- "privacy": "private",
33891
- "default": "''"
33852
+ "default": "new HasSlotController(this, 'help-text')"
33892
33853
  },
33893
33854
  {
33894
33855
  "kind": "field",
33895
- "name": "includeRequest",
33856
+ "name": "rating",
33896
33857
  "type": {
33897
- "text": "Promise<IncludeOption[]> | null"
33898
- },
33899
- "privacy": "private",
33900
- "default": "null"
33858
+ "text": "HTMLElement"
33859
+ }
33901
33860
  },
33902
33861
  {
33903
33862
  "kind": "field",
33904
- "name": "rawEntryValue",
33863
+ "name": "symbols",
33905
33864
  "type": {
33906
- "text": "string"
33907
- },
33908
- "privacy": "private",
33909
- "default": "''"
33865
+ "text": "HTMLElement"
33866
+ }
33910
33867
  },
33911
33868
  {
33912
33869
  "kind": "field",
33913
- "name": "suppressValueSync",
33870
+ "name": "hoverValue",
33914
33871
  "type": {
33915
- "text": "boolean"
33872
+ "text": "number"
33916
33873
  },
33917
33874
  "privacy": "private",
33918
- "default": "false"
33875
+ "default": "0"
33919
33876
  },
33920
33877
  {
33921
33878
  "kind": "field",
33922
- "name": "suppressBlurCommit",
33879
+ "name": "isHovering",
33923
33880
  "type": {
33924
33881
  "text": "boolean"
33925
33882
  },
@@ -33928,201 +33885,21 @@
33928
33885
  },
33929
33886
  {
33930
33887
  "kind": "field",
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",
33966
- "type": {
33967
- "text": "string"
33968
- },
33969
- "default": "''",
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",
33888
+ "name": "label",
34022
33889
  "type": {
34023
33890
  "text": "string"
34024
33891
  },
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"
33892
+ "attribute": "label"
34063
33893
  },
34064
33894
  {
34065
33895
  "kind": "field",
34066
- "name": "includeQuery",
33896
+ "name": "helpText",
34067
33897
  "type": {
34068
33898
  "text": "string"
34069
33899
  },
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"
33900
+ "default": "''",
33901
+ "description": "The rating's help text. If you need to display HTML, use the `help-text` slot instead.",
33902
+ "attribute": "help-text"
34126
33903
  },
34127
33904
  {
34128
33905
  "kind": "field",
@@ -34130,117 +33907,99 @@
34130
33907
  "type": {
34131
33908
  "text": "string"
34132
33909
  },
34133
- "default": "''",
34134
- "description": "The name of the control, submitted as part of form data.",
34135
33910
  "attribute": "name"
34136
33911
  },
34137
33912
  {
34138
33913
  "kind": "field",
34139
33914
  "name": "value",
34140
33915
  "type": {
34141
- "text": "string"
33916
+ "text": "number"
34142
33917
  },
34143
- "default": "''",
34144
- "description": "The current remarkd source.",
33918
+ "default": "0",
34145
33919
  "attribute": "value"
34146
33920
  },
34147
33921
  {
34148
33922
  "kind": "field",
34149
33923
  "name": "defaultValue",
34150
33924
  "type": {
34151
- "text": "string"
33925
+ "text": "number"
34152
33926
  },
34153
- "default": "''",
34154
- "description": "The default value used when resetting the form."
33927
+ "default": "0",
33928
+ "description": "The default value of the form control. Primarily used for resetting the form control."
34155
33929
  },
34156
33930
  {
34157
33931
  "kind": "field",
34158
- "name": "placeholder",
33932
+ "name": "max",
34159
33933
  "type": {
34160
- "text": "string"
33934
+ "text": "number"
34161
33935
  },
34162
- "default": "'Type something…'",
34163
- "description": "Placeholder shown when the document is empty.",
34164
- "attribute": "placeholder"
33936
+ "default": "5",
33937
+ "attribute": "max"
34165
33938
  },
34166
33939
  {
34167
33940
  "kind": "field",
34168
- "name": "attachmentUrl",
33941
+ "name": "precision",
34169
33942
  "type": {
34170
- "text": "string"
33943
+ "text": "number"
34171
33944
  },
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"
33945
+ "default": "1",
33946
+ "attribute": "precision"
34175
33947
  },
34176
33948
  {
34177
33949
  "kind": "field",
34178
- "name": "includeUrl",
33950
+ "name": "readonly",
34179
33951
  "type": {
34180
- "text": "string"
33952
+ "text": "boolean"
34181
33953
  },
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"
33954
+ "default": "false",
33955
+ "attribute": "readonly"
34185
33956
  },
34186
33957
  {
34187
33958
  "kind": "field",
34188
- "name": "allowRaw",
33959
+ "name": "disabled",
34189
33960
  "type": {
34190
33961
  "text": "boolean"
34191
33962
  },
34192
33963
  "default": "false",
34193
- "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
34194
- "attribute": "allow-raw",
34195
- "reflects": true
33964
+ "attribute": "disabled"
34196
33965
  },
34197
33966
  {
34198
33967
  "kind": "field",
34199
- "name": "required",
33968
+ "name": "preview",
34200
33969
  "type": {
34201
33970
  "text": "boolean"
34202
33971
  },
34203
33972
  "default": "false",
34204
- "description": "Makes the editor required for form submission.",
34205
- "attribute": "required",
34206
- "reflects": true
33973
+ "description": "Displays the value alongside the symbols, updating live as the pointer moves across them.",
33974
+ "attribute": "preview"
34207
33975
  },
34208
33976
  {
34209
33977
  "kind": "field",
34210
- "name": "readonly",
33978
+ "name": "size",
34211
33979
  "type": {
34212
- "text": "boolean"
33980
+ "text": "'small' | 'medium' | 'large'"
34213
33981
  },
34214
- "default": "false",
34215
- "description": "Makes the editor read-only.",
34216
- "attribute": "readonly",
34217
- "reflects": true
33982
+ "default": "'medium'",
33983
+ "attribute": "size"
34218
33984
  },
34219
33985
  {
34220
33986
  "kind": "field",
34221
- "name": "disabled",
33987
+ "name": "getSymbol",
34222
33988
  "type": {
34223
- "text": "boolean"
33989
+ "text": "(value: number) => string"
34224
33990
  },
34225
- "default": "false",
34226
- "description": "Disables the editor.",
34227
- "attribute": "disabled",
34228
- "reflects": true
33991
+ "attribute": "getSymbol"
34229
33992
  },
34230
33993
  {
34231
33994
  "kind": "field",
34232
33995
  "name": "validity",
34233
- "type": {
34234
- "text": "ValidityState"
34235
- },
33996
+ "description": "Gets the validity state object",
34236
33997
  "readonly": true
34237
33998
  },
34238
33999
  {
34239
34000
  "kind": "field",
34240
34001
  "name": "validationMessage",
34241
- "type": {
34242
- "text": "string"
34243
- },
34002
+ "description": "Gets the validation message",
34244
34003
  "readonly": true
34245
34004
  },
34246
34005
  {
@@ -34250,7 +34009,8 @@
34250
34009
  "type": {
34251
34010
  "text": "boolean"
34252
34011
  }
34253
- }
34012
+ },
34013
+ "description": "Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
34254
34014
  },
34255
34015
  {
34256
34016
  "kind": "method",
@@ -34259,139 +34019,122 @@
34259
34019
  "type": {
34260
34020
  "text": "HTMLFormElement | null"
34261
34021
  }
34262
- }
34022
+ },
34023
+ "description": "Gets the associated form, if one exists."
34263
34024
  },
34264
34025
  {
34265
34026
  "kind": "method",
34266
34027
  "name": "reportValidity",
34267
- "return": {
34268
- "type": {
34269
- "text": "boolean"
34270
- }
34271
- }
34028
+ "description": "Checks for validity and shows the browser's validation message if the control is invalid."
34272
34029
  },
34273
34030
  {
34274
34031
  "kind": "method",
34275
34032
  "name": "setCustomValidity",
34033
+ "description": "Sets a custom validation message. Pass an empty string to restore validity."
34034
+ },
34035
+ {
34036
+ "kind": "method",
34037
+ "name": "_roundToPrecision",
34038
+ "privacy": "private",
34276
34039
  "return": {
34277
34040
  "type": {
34278
- "text": "void"
34041
+ "text": "number"
34279
34042
  }
34280
34043
  },
34281
34044
  "parameters": [
34282
34045
  {
34283
- "name": "message",
34046
+ "name": "value",
34284
34047
  "type": {
34285
- "text": "string"
34048
+ "text": "number"
34049
+ }
34050
+ },
34051
+ {
34052
+ "name": "precision",
34053
+ "type": {
34054
+ "text": "number"
34286
34055
  }
34287
34056
  }
34288
34057
  ]
34289
34058
  },
34290
34059
  {
34291
34060
  "kind": "method",
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",
34061
+ "name": "_getValueFromXCoordinate",
34311
34062
  "privacy": "private",
34312
34063
  "return": {
34313
34064
  "type": {
34314
- "text": "string[]"
34065
+ "text": "number"
34315
34066
  }
34316
34067
  },
34317
34068
  "parameters": [
34318
34069
  {
34319
- "name": "source",
34070
+ "name": "coordinate",
34320
34071
  "type": {
34321
- "text": "string"
34072
+ "text": "number"
34322
34073
  }
34323
34074
  }
34324
- ],
34325
- "description": "Splits remarkd source into blocks on blank lines, keeping fenced /\ndelimited containers (``` ==== !!!! .... ---- ____ **** ////) as single blocks."
34075
+ ]
34326
34076
  },
34327
34077
  {
34328
34078
  "kind": "method",
34329
- "name": "fenceMarker",
34079
+ "name": "_formatValue",
34330
34080
  "privacy": "private",
34331
34081
  "return": {
34332
34082
  "type": {
34333
- "text": "string | null"
34083
+ "text": "string"
34334
34084
  }
34335
34085
  },
34336
34086
  "parameters": [
34337
34087
  {
34338
- "name": "line",
34088
+ "name": "value",
34339
34089
  "type": {
34340
- "text": "string"
34090
+ "text": "number"
34341
34091
  }
34342
34092
  }
34343
34093
  ]
34344
34094
  },
34345
34095
  {
34346
34096
  "kind": "method",
34347
- "name": "closesFence",
34097
+ "name": "_getValueFromMousePosition",
34348
34098
  "privacy": "private",
34349
34099
  "return": {
34350
34100
  "type": {
34351
- "text": "boolean"
34101
+ "text": "number"
34352
34102
  }
34353
34103
  },
34354
34104
  "parameters": [
34355
34105
  {
34356
- "name": "line",
34357
- "type": {
34358
- "text": "string"
34359
- }
34360
- },
34361
- {
34362
- "name": "fence",
34106
+ "name": "event",
34363
34107
  "type": {
34364
- "text": "string"
34108
+ "text": "MouseEvent"
34365
34109
  }
34366
34110
  }
34367
34111
  ]
34368
34112
  },
34369
34113
  {
34370
34114
  "kind": "method",
34371
- "name": "updateBlocks",
34115
+ "name": "_getValueFromTouchPosition",
34372
34116
  "privacy": "private",
34117
+ "return": {
34118
+ "type": {
34119
+ "text": "number"
34120
+ }
34121
+ },
34373
34122
  "parameters": [
34374
34123
  {
34375
- "name": "blocks",
34124
+ "name": "event",
34376
34125
  "type": {
34377
- "text": "string[]"
34126
+ "text": "TouchEvent"
34378
34127
  }
34379
34128
  }
34380
34129
  ]
34381
34130
  },
34382
34131
  {
34383
34132
  "kind": "method",
34384
- "name": "handleRenderedClick",
34133
+ "name": "_setValue",
34385
34134
  "privacy": "private",
34386
34135
  "parameters": [
34387
34136
  {
34388
- "name": "e",
34389
- "type": {
34390
- "text": "MouseEvent"
34391
- }
34392
- },
34393
- {
34394
- "name": "index",
34137
+ "name": "value",
34395
34138
  "type": {
34396
34139
  "text": "number"
34397
34140
  }
@@ -34400,556 +34143,817 @@
34400
34143
  },
34401
34144
  {
34402
34145
  "kind": "method",
34403
- "name": "parseImageBlock",
34146
+ "name": "_handleClick",
34404
34147
  "privacy": "private",
34405
- "return": {
34406
- "type": {
34407
- "text": "ImageBlockData | null"
34408
- }
34409
- },
34410
34148
  "parameters": [
34411
34149
  {
34412
- "name": "block",
34150
+ "name": "event",
34413
34151
  "type": {
34414
- "text": "string"
34152
+ "text": "MouseEvent"
34415
34153
  }
34416
34154
  }
34417
- ],
34418
- "description": "Parses a block that is purely an image (with optional caption/align lines)."
34155
+ ]
34419
34156
  },
34420
34157
  {
34421
34158
  "kind": "method",
34422
- "name": "parseIncludeBlock",
34159
+ "name": "_handleMouseEnter",
34423
34160
  "privacy": "private",
34424
- "return": {
34425
- "type": {
34426
- "text": "IncludeBlockData | null"
34427
- }
34428
- },
34429
34161
  "parameters": [
34430
34162
  {
34431
- "name": "block",
34163
+ "name": "event",
34432
34164
  "type": {
34433
- "text": "string"
34165
+ "text": "MouseEvent"
34434
34166
  }
34435
34167
  }
34436
- ],
34437
- "description": "Parses a block that is nothing but an include directive."
34168
+ ]
34438
34169
  },
34439
34170
  {
34440
34171
  "kind": "method",
34441
- "name": "serializeImageBlock",
34172
+ "name": "_handleMouseMove",
34442
34173
  "privacy": "private",
34443
- "return": {
34444
- "type": {
34445
- "text": "string"
34446
- }
34447
- },
34448
34174
  "parameters": [
34449
34175
  {
34450
- "name": "data",
34176
+ "name": "event",
34451
34177
  "type": {
34452
- "text": "ImageBlockData"
34178
+ "text": "MouseEvent"
34453
34179
  }
34454
34180
  }
34455
34181
  ]
34456
34182
  },
34457
34183
  {
34458
34184
  "kind": "method",
34459
- "name": "toggleCheckbox",
34185
+ "name": "_handleMouseLeave",
34186
+ "privacy": "private"
34187
+ },
34188
+ {
34189
+ "kind": "method",
34190
+ "name": "_handleTouchStart",
34460
34191
  "privacy": "private",
34461
34192
  "parameters": [
34462
34193
  {
34463
- "name": "index",
34464
- "type": {
34465
- "text": "number"
34466
- }
34467
- },
34468
- {
34469
- "name": "checkbox",
34194
+ "name": "event",
34470
34195
  "type": {
34471
- "text": "HTMLInputElement"
34196
+ "text": "TouchEvent"
34472
34197
  }
34473
34198
  }
34474
34199
  ]
34475
34200
  },
34476
34201
  {
34477
34202
  "kind": "method",
34478
- "name": "startEdit",
34203
+ "name": "_handleTouchMove",
34479
34204
  "privacy": "private",
34480
34205
  "parameters": [
34481
34206
  {
34482
- "name": "index",
34483
- "type": {
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,
34207
+ "name": "event",
34504
34208
  "type": {
34505
- "text": "number"
34209
+ "text": "TouchEvent"
34506
34210
  }
34507
34211
  }
34508
34212
  ]
34509
34213
  },
34510
34214
  {
34511
34215
  "kind": "method",
34512
- "name": "updateImageEdit",
34216
+ "name": "_handleTouchEnd",
34513
34217
  "privacy": "private",
34514
34218
  "parameters": [
34515
34219
  {
34516
- "name": "patch",
34220
+ "name": "event",
34517
34221
  "type": {
34518
- "text": "Partial<ImageBlockData>"
34222
+ "text": "TouchEvent"
34519
34223
  }
34520
34224
  }
34521
34225
  ]
34226
+ }
34227
+ ],
34228
+ "events": [
34229
+ {
34230
+ "description": "Emitted as an example.",
34231
+ "name": "zn-event-name"
34232
+ }
34233
+ ],
34234
+ "attributes": [
34235
+ {
34236
+ "name": "label",
34237
+ "type": {
34238
+ "text": "string"
34239
+ },
34240
+ "fieldName": "label"
34522
34241
  },
34523
34242
  {
34524
- "kind": "field",
34525
- "name": "saveImageEdit",
34526
- "privacy": "private"
34243
+ "name": "help-text",
34244
+ "type": {
34245
+ "text": "string"
34246
+ },
34247
+ "default": "''",
34248
+ "description": "The rating's help text. If you need to display HTML, use the `help-text` slot instead.",
34249
+ "fieldName": "helpText"
34527
34250
  },
34528
34251
  {
34529
- "kind": "field",
34530
- "name": "closeImageEdit",
34531
- "privacy": "private"
34252
+ "name": "name",
34253
+ "type": {
34254
+ "text": "string"
34255
+ },
34256
+ "fieldName": "name"
34532
34257
  },
34533
34258
  {
34534
- "kind": "field",
34535
- "name": "deleteImageBlock",
34536
- "privacy": "private"
34259
+ "name": "value",
34260
+ "type": {
34261
+ "text": "number"
34262
+ },
34263
+ "default": "0",
34264
+ "fieldName": "value"
34537
34265
  },
34538
34266
  {
34539
- "kind": "field",
34540
- "name": "editImageSource",
34541
- "privacy": "private"
34267
+ "name": "max",
34268
+ "type": {
34269
+ "text": "number"
34270
+ },
34271
+ "default": "5",
34272
+ "fieldName": "max"
34542
34273
  },
34543
34274
  {
34544
- "kind": "field",
34545
- "name": "handleImageControlsKeydown",
34546
- "privacy": "private"
34275
+ "name": "precision",
34276
+ "type": {
34277
+ "text": "number"
34278
+ },
34279
+ "default": "1",
34280
+ "fieldName": "precision"
34547
34281
  },
34548
34282
  {
34549
- "kind": "method",
34550
- "name": "computeEditShell",
34551
- "privacy": "private",
34552
- "return": {
34553
- "type": {
34554
- "text": "string"
34555
- }
34283
+ "name": "readonly",
34284
+ "type": {
34285
+ "text": "boolean"
34556
34286
  },
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."
34287
+ "default": "false",
34288
+ "fieldName": "readonly"
34566
34289
  },
34567
34290
  {
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
- ]
34291
+ "name": "disabled",
34292
+ "type": {
34293
+ "text": "boolean"
34294
+ },
34295
+ "default": "false",
34296
+ "fieldName": "disabled"
34587
34297
  },
34588
34298
  {
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."
34299
+ "name": "preview",
34300
+ "type": {
34301
+ "text": "boolean"
34302
+ },
34303
+ "default": "false",
34304
+ "description": "Displays the value alongside the symbols, updating live as the pointer moves across them.",
34305
+ "fieldName": "preview"
34608
34306
  },
34609
34307
  {
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
- ]
34308
+ "name": "size",
34309
+ "type": {
34310
+ "text": "'small' | 'medium' | 'large'"
34311
+ },
34312
+ "default": "'medium'",
34313
+ "fieldName": "size"
34628
34314
  },
34629
34315
  {
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."
34316
+ "name": "getSymbol",
34317
+ "type": {
34318
+ "text": "(value: number) => string"
34319
+ },
34320
+ "fieldName": "getSymbol"
34321
+ }
34322
+ ],
34323
+ "superclass": {
34324
+ "name": "ZincElement",
34325
+ "module": "/src/internal/zinc-element"
34326
+ },
34327
+ "summary": "Short summary of the component's intended use.",
34328
+ "tagNameWithoutPrefix": "rating",
34329
+ "tagName": "zn-rating",
34330
+ "customElement": true,
34331
+ "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 */",
34332
+ "documentation": "https://zinc.style/components/rating",
34333
+ "status": "experimental",
34334
+ "since": "1.0",
34335
+ "dependencies": [
34336
+ "zn-example"
34337
+ ]
34338
+ }
34339
+ ],
34340
+ "exports": [
34341
+ {
34342
+ "kind": "js",
34343
+ "name": "default",
34344
+ "declaration": {
34345
+ "name": "ZnRating",
34346
+ "module": "components/rating/rating.js"
34347
+ }
34348
+ }
34349
+ ]
34350
+ },
34351
+ {
34352
+ "kind": "javascript-module",
34353
+ "path": "components/remarkd-editor/remarkd-editor.js",
34354
+ "declarations": [
34355
+ {
34356
+ "kind": "class",
34357
+ "description": "",
34358
+ "name": "ZnRemarkdEditor",
34359
+ "cssProperties": [
34360
+ {
34361
+ "description": "The tallest the editor grows before its body scrolls. Defaults to `100dvh`.",
34362
+ "name": "--remarkd-editor-max-height"
34363
+ }
34364
+ ],
34365
+ "cssParts": [
34366
+ {
34367
+ "description": "The component's base wrapper.",
34368
+ "name": "base"
34642
34369
  },
34643
34370
  {
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
- ]
34371
+ "description": "The always-visible block-insert and inline-formatting toolbar.",
34372
+ "name": "toolbar"
34661
34373
  },
34662
34374
  {
34663
- "kind": "method",
34664
- "name": "deleteBlock",
34665
- "privacy": "private",
34666
- "parameters": [
34667
- {
34668
- "name": "index",
34669
- "type": {
34670
- "text": "number"
34671
- }
34672
- }
34673
- ]
34375
+ "description": "The button that switches between the block view and the raw source view.",
34376
+ "name": "raw-toggle"
34674
34377
  },
34675
34378
  {
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."
34379
+ "description": "A rendered block wrapper.",
34380
+ "name": "block"
34699
34381
  },
34700
34382
  {
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."
34383
+ "description": "The rendered remarkd output of a block.",
34384
+ "name": "rendered"
34705
34385
  },
34706
34386
  {
34707
- "kind": "field",
34708
- "name": "commitEdit",
34709
- "privacy": "private",
34710
- "description": "Commits the in-progress edit; returns the index after the committed parts."
34387
+ "description": "A labelled wrapper for an ifdef/ifndef/ifeval/iftrue/iffalse/ifempty/ifnempty range.",
34388
+ "name": "conditional"
34711
34389
  },
34712
34390
  {
34713
- "kind": "field",
34714
- "name": "handleDraftInput",
34715
- "privacy": "private"
34391
+ "description": "A chip rendered for a document attribute, title, or bracket line.",
34392
+ "name": "variable"
34716
34393
  },
34717
34394
  {
34718
- "kind": "field",
34719
- "name": "handleEditKeydown",
34720
- "privacy": "private"
34395
+ "description": "The textarea shown while editing a block.",
34396
+ "name": "input"
34721
34397
  },
34722
34398
  {
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."
34399
+ "description": "The full-document textarea shown in raw source mode.",
34400
+ "name": "raw"
34732
34401
  },
34733
34402
  {
34734
- "kind": "method",
34735
- "name": "mountSlashMenu",
34736
- "privacy": "private",
34737
- "return": {
34738
- "type": {
34739
- "text": "Promise<ZnSlashMenu | null>"
34740
- }
34741
- }
34403
+ "description": "The `zn-slash-menu` opened by typing \"/\" in an empty block.",
34404
+ "name": "slash-menu"
34742
34405
  },
34743
34406
  {
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."
34407
+ "description": "The caption / alignment / size panel shown when an image block is clicked.",
34408
+ "name": "image-controls"
34761
34409
  },
34762
34410
  {
34763
- "kind": "field",
34764
- "name": "handleEditPaste",
34765
- "privacy": "private"
34411
+ "description": "The chip rendered in place of an `include::` directive.",
34412
+ "name": "include"
34766
34413
  },
34414
+ {
34415
+ "description": "The inline Include picker opened from the toolbar or \"/include\".",
34416
+ "name": "include-picker"
34417
+ }
34418
+ ],
34419
+ "members": [
34767
34420
  {
34768
34421
  "kind": "field",
34769
- "name": "handleDragOver",
34770
- "privacy": "private"
34422
+ "name": "dependencies",
34423
+ "type": {
34424
+ "text": "object"
34425
+ },
34426
+ "static": true,
34427
+ "default": "{ 'zn-dropdown': ZnDropdown, 'zn-menu': ZnMenu, 'zn-menu-item': ZnMenuItem, 'zn-slash-menu': ZnSlashMenu }"
34771
34428
  },
34772
34429
  {
34773
34430
  "kind": "field",
34774
- "name": "handleDrop",
34775
- "privacy": "private"
34431
+ "name": "formControlController",
34432
+ "privacy": "private",
34433
+ "readonly": true,
34434
+ "default": "new FormControlController(this, { assumeInteractionOn: ['zn-input', 'zn-change'], })"
34776
34435
  },
34777
34436
  {
34778
- "kind": "method",
34779
- "name": "insertionIndexFromY",
34437
+ "kind": "field",
34438
+ "name": "slashController",
34780
34439
  "privacy": "private",
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."
34440
+ "readonly": true,
34441
+ "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) })"
34795
34442
  },
34796
34443
  {
34797
34444
  "kind": "field",
34798
- "name": "handleHandlePointerDown",
34799
- "privacy": "private"
34445
+ "name": "toolbarOverflow",
34446
+ "privacy": "private",
34447
+ "readonly": true,
34448
+ "default": "new ToolbarOverflowController(this, { groups: () => [...(this.shadowRoot?.querySelectorAll<HTMLElement>('.toolbar__group') ?? [])], container: () => this.shadowRoot?.querySelector<HTMLElement>('.remarkd-editor__toolbar'), })"
34800
34449
  },
34801
34450
  {
34802
34451
  "kind": "field",
34803
- "name": "handleDragPointerMove",
34804
- "privacy": "private"
34452
+ "name": "editingDraft",
34453
+ "type": {
34454
+ "text": "string"
34455
+ },
34456
+ "privacy": "private",
34457
+ "default": "''"
34805
34458
  },
34806
34459
  {
34807
34460
  "kind": "field",
34808
- "name": "stepAutoScroll",
34461
+ "name": "includeRequest",
34462
+ "type": {
34463
+ "text": "Promise<IncludeOption[]> | null"
34464
+ },
34809
34465
  "privacy": "private",
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."
34466
+ "default": "null"
34811
34467
  },
34812
34468
  {
34813
- "kind": "method",
34814
- "name": "autoScroll",
34469
+ "kind": "field",
34470
+ "name": "rawEntryValue",
34471
+ "type": {
34472
+ "text": "string"
34473
+ },
34815
34474
  "privacy": "private",
34816
- "return": {
34817
- "type": {
34818
- "text": "boolean"
34819
- }
34475
+ "default": "''"
34476
+ },
34477
+ {
34478
+ "kind": "field",
34479
+ "name": "suppressValueSync",
34480
+ "type": {
34481
+ "text": "boolean"
34820
34482
  },
34821
- "description": "Scrolls the editor body, falling through to the page once the body is at its limit."
34483
+ "privacy": "private",
34484
+ "default": "false"
34822
34485
  },
34823
34486
  {
34824
- "kind": "method",
34825
- "name": "edgeScrollDelta",
34487
+ "kind": "field",
34488
+ "name": "suppressBlurCommit",
34489
+ "type": {
34490
+ "text": "boolean"
34491
+ },
34826
34492
  "privacy": "private",
34827
- "return": {
34828
- "type": {
34829
- "text": "number"
34830
- }
34831
- },
34832
- "parameters": [
34833
- {
34834
- "name": "top",
34835
- "type": {
34836
- "text": "number"
34837
- }
34838
- },
34839
- {
34840
- "name": "bottom",
34841
- "type": {
34842
- "text": "number"
34843
- }
34844
- }
34845
- ],
34846
- "description": "Scroll step for this frame: nothing until the pointer is within `edge` of a boundary."
34493
+ "default": "false"
34847
34494
  },
34848
34495
  {
34849
34496
  "kind": "field",
34850
- "name": "handleDragPointerUp",
34497
+ "name": "validationInput",
34498
+ "type": {
34499
+ "text": "HTMLTextAreaElement"
34500
+ },
34851
34501
  "privacy": "private"
34852
34502
  },
34853
34503
  {
34854
34504
  "kind": "field",
34855
- "name": "cancelDrag",
34505
+ "name": "slashMenuElement",
34506
+ "type": {
34507
+ "text": "ZnSlashMenu | null"
34508
+ },
34856
34509
  "privacy": "private"
34857
34510
  },
34858
34511
  {
34859
- "kind": "method",
34860
- "name": "createDragGhost",
34512
+ "kind": "field",
34513
+ "name": "blocks",
34514
+ "type": {
34515
+ "text": "string[]"
34516
+ },
34517
+ "privacy": "private",
34518
+ "default": "[]"
34519
+ },
34520
+ {
34521
+ "kind": "field",
34522
+ "name": "editingIndex",
34523
+ "type": {
34524
+ "text": "number | null"
34525
+ },
34526
+ "privacy": "private",
34527
+ "default": "null"
34528
+ },
34529
+ {
34530
+ "kind": "field",
34531
+ "name": "slashRecentKey",
34532
+ "type": {
34533
+ "text": "string"
34534
+ },
34535
+ "default": "''",
34536
+ "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.",
34537
+ "attribute": "slash-recent-key"
34538
+ },
34539
+ {
34540
+ "kind": "field",
34541
+ "name": "hasSlashMenu",
34542
+ "type": {
34543
+ "text": "boolean"
34544
+ },
34545
+ "privacy": "private",
34546
+ "default": "false",
34547
+ "description": "Renders the slash menu only once it has been needed."
34548
+ },
34549
+ {
34550
+ "kind": "field",
34551
+ "name": "imagePickerIndex",
34552
+ "type": {
34553
+ "text": "number | null"
34554
+ },
34555
+ "privacy": "private",
34556
+ "default": "null"
34557
+ },
34558
+ {
34559
+ "kind": "field",
34560
+ "name": "imageEdit",
34561
+ "type": {
34562
+ "text": "ImageBlockData | null"
34563
+ },
34564
+ "privacy": "private",
34565
+ "default": "null"
34566
+ },
34567
+ {
34568
+ "kind": "field",
34569
+ "name": "dropIndicator",
34570
+ "type": {
34571
+ "text": "number | null"
34572
+ },
34573
+ "privacy": "private",
34574
+ "default": "null"
34575
+ },
34576
+ {
34577
+ "kind": "field",
34578
+ "name": "dragIndex",
34579
+ "type": {
34580
+ "text": "number | null"
34581
+ },
34582
+ "privacy": "private",
34583
+ "default": "null"
34584
+ },
34585
+ {
34586
+ "kind": "field",
34587
+ "name": "editShell",
34588
+ "type": {
34589
+ "text": "string"
34590
+ },
34591
+ "privacy": "private",
34592
+ "default": "''"
34593
+ },
34594
+ {
34595
+ "kind": "field",
34596
+ "name": "rawMode",
34597
+ "type": {
34598
+ "text": "boolean"
34599
+ },
34600
+ "privacy": "private",
34601
+ "default": "false"
34602
+ },
34603
+ {
34604
+ "kind": "field",
34605
+ "name": "includeOptions",
34606
+ "type": {
34607
+ "text": "IncludeOption[] | null"
34608
+ },
34861
34609
  "privacy": "private",
34610
+ "default": "null"
34611
+ },
34612
+ {
34613
+ "kind": "field",
34614
+ "name": "includeLoadFailed",
34615
+ "type": {
34616
+ "text": "boolean"
34617
+ },
34618
+ "privacy": "private",
34619
+ "default": "false"
34620
+ },
34621
+ {
34622
+ "kind": "field",
34623
+ "name": "includePickerIndex",
34624
+ "type": {
34625
+ "text": "number | null"
34626
+ },
34627
+ "privacy": "private",
34628
+ "default": "null"
34629
+ },
34630
+ {
34631
+ "kind": "field",
34632
+ "name": "includeQuery",
34633
+ "type": {
34634
+ "text": "string"
34635
+ },
34636
+ "privacy": "private",
34637
+ "default": "''"
34638
+ },
34639
+ {
34640
+ "kind": "field",
34641
+ "name": "pendingDragHandle",
34642
+ "type": {
34643
+ "text": "HTMLElement | null"
34644
+ },
34645
+ "privacy": "private",
34646
+ "default": "null"
34647
+ },
34648
+ {
34649
+ "kind": "field",
34650
+ "name": "dragStartX",
34651
+ "type": {
34652
+ "text": "number"
34653
+ },
34654
+ "privacy": "private",
34655
+ "default": "0"
34656
+ },
34657
+ {
34658
+ "kind": "field",
34659
+ "name": "dragStartY",
34660
+ "type": {
34661
+ "text": "number"
34662
+ },
34663
+ "privacy": "private",
34664
+ "default": "0"
34665
+ },
34666
+ {
34667
+ "kind": "field",
34668
+ "name": "dragGhost",
34669
+ "type": {
34670
+ "text": "HTMLElement | null"
34671
+ },
34672
+ "privacy": "private",
34673
+ "default": "null"
34674
+ },
34675
+ {
34676
+ "kind": "field",
34677
+ "name": "dragPointerY",
34678
+ "type": {
34679
+ "text": "number"
34680
+ },
34681
+ "privacy": "private",
34682
+ "default": "0"
34683
+ },
34684
+ {
34685
+ "kind": "field",
34686
+ "name": "autoScrollFrame",
34687
+ "type": {
34688
+ "text": "number | null"
34689
+ },
34690
+ "privacy": "private",
34691
+ "default": "null"
34692
+ },
34693
+ {
34694
+ "kind": "field",
34695
+ "name": "name",
34696
+ "type": {
34697
+ "text": "string"
34698
+ },
34699
+ "default": "''",
34700
+ "description": "The name of the control, submitted as part of form data.",
34701
+ "attribute": "name"
34702
+ },
34703
+ {
34704
+ "kind": "field",
34705
+ "name": "value",
34706
+ "type": {
34707
+ "text": "string"
34708
+ },
34709
+ "default": "''",
34710
+ "description": "The current remarkd source.",
34711
+ "attribute": "value"
34712
+ },
34713
+ {
34714
+ "kind": "field",
34715
+ "name": "defaultValue",
34716
+ "type": {
34717
+ "text": "string"
34718
+ },
34719
+ "default": "''",
34720
+ "description": "The default value — used when resetting the form."
34721
+ },
34722
+ {
34723
+ "kind": "field",
34724
+ "name": "placeholder",
34725
+ "type": {
34726
+ "text": "string"
34727
+ },
34728
+ "default": "'Type something…'",
34729
+ "description": "Placeholder shown when the document is empty.",
34730
+ "attribute": "placeholder"
34731
+ },
34732
+ {
34733
+ "kind": "field",
34734
+ "name": "attachmentUrl",
34735
+ "type": {
34736
+ "text": "string"
34737
+ },
34738
+ "default": "''",
34739
+ "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.",
34740
+ "attribute": "attachment-url"
34741
+ },
34742
+ {
34743
+ "kind": "field",
34744
+ "name": "includeUrl",
34745
+ "type": {
34746
+ "text": "string"
34747
+ },
34748
+ "default": "''",
34749
+ "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.",
34750
+ "attribute": "include-url"
34751
+ },
34752
+ {
34753
+ "kind": "field",
34754
+ "name": "allowRaw",
34755
+ "type": {
34756
+ "text": "boolean"
34757
+ },
34758
+ "default": "false",
34759
+ "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
34760
+ "attribute": "allow-raw",
34761
+ "reflects": true
34762
+ },
34763
+ {
34764
+ "kind": "field",
34765
+ "name": "required",
34766
+ "type": {
34767
+ "text": "boolean"
34768
+ },
34769
+ "default": "false",
34770
+ "description": "Makes the editor required for form submission.",
34771
+ "attribute": "required",
34772
+ "reflects": true
34773
+ },
34774
+ {
34775
+ "kind": "field",
34776
+ "name": "readonly",
34777
+ "type": {
34778
+ "text": "boolean"
34779
+ },
34780
+ "default": "false",
34781
+ "description": "Makes the editor read-only.",
34782
+ "attribute": "readonly",
34783
+ "reflects": true
34784
+ },
34785
+ {
34786
+ "kind": "field",
34787
+ "name": "disabled",
34788
+ "type": {
34789
+ "text": "boolean"
34790
+ },
34791
+ "default": "false",
34792
+ "description": "Disables the editor.",
34793
+ "attribute": "disabled",
34794
+ "reflects": true
34795
+ },
34796
+ {
34797
+ "kind": "field",
34798
+ "name": "validity",
34799
+ "type": {
34800
+ "text": "ValidityState"
34801
+ },
34802
+ "readonly": true
34803
+ },
34804
+ {
34805
+ "kind": "field",
34806
+ "name": "validationMessage",
34807
+ "type": {
34808
+ "text": "string"
34809
+ },
34810
+ "readonly": true
34811
+ },
34812
+ {
34813
+ "kind": "method",
34814
+ "name": "checkValidity",
34815
+ "return": {
34816
+ "type": {
34817
+ "text": "boolean"
34818
+ }
34819
+ }
34820
+ },
34821
+ {
34822
+ "kind": "method",
34823
+ "name": "getForm",
34824
+ "return": {
34825
+ "type": {
34826
+ "text": "HTMLFormElement | null"
34827
+ }
34828
+ }
34829
+ },
34830
+ {
34831
+ "kind": "method",
34832
+ "name": "reportValidity",
34833
+ "return": {
34834
+ "type": {
34835
+ "text": "boolean"
34836
+ }
34837
+ }
34838
+ },
34839
+ {
34840
+ "kind": "method",
34841
+ "name": "setCustomValidity",
34842
+ "return": {
34843
+ "type": {
34844
+ "text": "void"
34845
+ }
34846
+ },
34862
34847
  "parameters": [
34863
34848
  {
34864
- "name": "index",
34849
+ "name": "message",
34865
34850
  "type": {
34866
- "text": "number"
34851
+ "text": "string"
34867
34852
  }
34868
34853
  }
34869
34854
  ]
34870
34855
  },
34871
34856
  {
34872
34857
  "kind": "method",
34873
- "name": "moveDragGhost",
34858
+ "name": "focus",
34859
+ "description": "Starts editing the first block, or a new block if the document is empty."
34860
+ },
34861
+ {
34862
+ "kind": "method",
34863
+ "name": "blur",
34864
+ "description": "Commits any in-progress block or raw edit."
34865
+ },
34866
+ {
34867
+ "kind": "method",
34868
+ "name": "handleValueChange"
34869
+ },
34870
+ {
34871
+ "kind": "method",
34872
+ "name": "handleIncludeUrlChange"
34873
+ },
34874
+ {
34875
+ "kind": "method",
34876
+ "name": "splitBlocks",
34874
34877
  "privacy": "private",
34878
+ "return": {
34879
+ "type": {
34880
+ "text": "string[]"
34881
+ }
34882
+ },
34875
34883
  "parameters": [
34876
34884
  {
34877
- "name": "x",
34878
- "type": {
34879
- "text": "number"
34880
- }
34881
- },
34882
- {
34883
- "name": "y",
34885
+ "name": "source",
34884
34886
  "type": {
34885
- "text": "number"
34887
+ "text": "string"
34886
34888
  }
34887
34889
  }
34888
- ]
34890
+ ],
34891
+ "description": "Splits remarkd source into blocks on blank lines, keeping fenced /\ndelimited containers (``` ==== !!!! .... ---- ____ **** ////) as single blocks."
34889
34892
  },
34890
34893
  {
34891
34894
  "kind": "method",
34892
- "name": "pickImage",
34895
+ "name": "fenceMarker",
34893
34896
  "privacy": "private",
34897
+ "return": {
34898
+ "type": {
34899
+ "text": "string | null"
34900
+ }
34901
+ },
34894
34902
  "parameters": [
34895
34903
  {
34896
- "name": "index",
34904
+ "name": "line",
34897
34905
  "type": {
34898
- "text": "number"
34906
+ "text": "string"
34899
34907
  }
34900
34908
  }
34901
34909
  ]
34902
34910
  },
34903
34911
  {
34904
34912
  "kind": "method",
34905
- "name": "pickInclude",
34913
+ "name": "closesFence",
34906
34914
  "privacy": "private",
34915
+ "return": {
34916
+ "type": {
34917
+ "text": "boolean"
34918
+ }
34919
+ },
34907
34920
  "parameters": [
34908
34921
  {
34909
- "name": "index",
34922
+ "name": "line",
34910
34923
  "type": {
34911
- "text": "number"
34924
+ "text": "string"
34925
+ }
34926
+ },
34927
+ {
34928
+ "name": "fence",
34929
+ "type": {
34930
+ "text": "string"
34912
34931
  }
34913
34932
  }
34914
34933
  ]
34915
34934
  },
34916
- {
34917
- "kind": "field",
34918
- "name": "closeIncludePicker",
34919
- "privacy": "private"
34920
- },
34921
34935
  {
34922
34936
  "kind": "method",
34923
- "name": "insertInclude",
34937
+ "name": "updateBlocks",
34924
34938
  "privacy": "private",
34925
34939
  "parameters": [
34926
34940
  {
34927
- "name": "item",
34941
+ "name": "blocks",
34928
34942
  "type": {
34929
- "text": "IncludeOption"
34943
+ "text": "string[]"
34930
34944
  }
34931
34945
  }
34932
34946
  ]
34933
34947
  },
34934
- {
34935
- "kind": "field",
34936
- "name": "closeImagePicker",
34937
- "privacy": "private"
34938
- },
34939
- {
34940
- "kind": "field",
34941
- "name": "handleImagePicked",
34942
- "privacy": "private"
34943
- },
34944
34948
  {
34945
34949
  "kind": "method",
34946
- "name": "insertImage",
34950
+ "name": "handleRenderedClick",
34947
34951
  "privacy": "private",
34948
34952
  "parameters": [
34949
34953
  {
34950
- "name": "file",
34954
+ "name": "e",
34951
34955
  "type": {
34952
- "text": "File"
34956
+ "text": "MouseEvent"
34953
34957
  }
34954
34958
  },
34955
34959
  {
@@ -34962,1139 +34966,949 @@
34962
34966
  },
34963
34967
  {
34964
34968
  "kind": "method",
34965
- "name": "uploadImage",
34969
+ "name": "parseImageBlock",
34966
34970
  "privacy": "private",
34967
34971
  "return": {
34968
34972
  "type": {
34969
- "text": "Promise<string>"
34973
+ "text": "ImageBlockData | null"
34970
34974
  }
34971
34975
  },
34972
34976
  "parameters": [
34973
34977
  {
34974
- "name": "file",
34978
+ "name": "block",
34975
34979
  "type": {
34976
- "text": "File"
34980
+ "text": "string"
34977
34981
  }
34978
34982
  }
34979
- ]
34983
+ ],
34984
+ "description": "Parses a block that is purely an image (with optional caption/align lines)."
34980
34985
  },
34981
34986
  {
34982
34987
  "kind": "method",
34983
- "name": "appPath",
34988
+ "name": "parseIncludeBlock",
34984
34989
  "privacy": "private",
34985
34990
  "return": {
34986
34991
  "type": {
34987
- "text": "string"
34992
+ "text": "IncludeBlockData | null"
34988
34993
  }
34989
34994
  },
34990
34995
  "parameters": [
34991
34996
  {
34992
- "name": "path",
34997
+ "name": "block",
34993
34998
  "type": {
34994
34999
  "text": "string"
34995
35000
  }
34996
35001
  }
34997
35002
  ],
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."
34999
- },
35000
- {
35001
- "kind": "method",
35002
- "name": "hasIncludeBlock",
35003
- "privacy": "private",
35004
- "return": {
35005
- "type": {
35006
- "text": "boolean"
35007
- }
35008
- }
35003
+ "description": "Parses a block that is nothing but an include directive."
35009
35004
  },
35010
35005
  {
35011
35006
  "kind": "method",
35012
- "name": "loadIncludeOptions",
35007
+ "name": "serializeImageBlock",
35013
35008
  "privacy": "private",
35014
35009
  "return": {
35015
35010
  "type": {
35016
- "text": "Promise<IncludeOption[]>"
35011
+ "text": "string"
35017
35012
  }
35018
35013
  },
35019
- "description": "Fetches the include list once; every later caller shares the same promise."
35020
- },
35021
- {
35022
- "kind": "method",
35023
- "name": "autosize",
35024
- "privacy": "private",
35025
35014
  "parameters": [
35026
35015
  {
35027
- "name": "input",
35016
+ "name": "data",
35028
35017
  "type": {
35029
- "text": "HTMLTextAreaElement"
35018
+ "text": "ImageBlockData"
35030
35019
  }
35031
35020
  }
35032
35021
  ]
35033
35022
  },
35034
35023
  {
35035
35024
  "kind": "method",
35036
- "name": "applyInline",
35025
+ "name": "toggleCheckbox",
35037
35026
  "privacy": "private",
35038
35027
  "parameters": [
35039
35028
  {
35040
- "name": "mark",
35029
+ "name": "index",
35041
35030
  "type": {
35042
- "text": "InlineMark"
35031
+ "text": "number"
35043
35032
  }
35044
- }
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."
35047
- },
35048
- {
35049
- "kind": "field",
35050
- "name": "toggleRawMode",
35051
- "privacy": "private"
35052
- },
35053
- {
35054
- "kind": "method",
35055
- "name": "focusRaw",
35056
- "privacy": "private"
35057
- },
35058
- {
35059
- "kind": "field",
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."
35063
- },
35064
- {
35065
- "kind": "field",
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."
35069
- },
35070
- {
35071
- "kind": "method",
35072
- "name": "handleToolbarInsert",
35073
- "privacy": "private",
35074
- "parameters": [
35033
+ },
35075
35034
  {
35076
- "name": "action",
35035
+ "name": "checkbox",
35077
35036
  "type": {
35078
- "text": "EditorAction"
35037
+ "text": "HTMLInputElement"
35079
35038
  }
35080
35039
  }
35081
35040
  ]
35082
35041
  },
35083
35042
  {
35084
35043
  "kind": "method",
35085
- "name": "renderImageControls",
35086
- "privacy": "private"
35087
- },
35088
- {
35089
- "kind": "method",
35090
- "name": "renderIncludeChip",
35044
+ "name": "startEdit",
35091
35045
  "privacy": "private",
35092
35046
  "parameters": [
35093
35047
  {
35094
- "name": "data",
35048
+ "name": "index",
35095
35049
  "type": {
35096
- "text": "IncludeBlockData"
35050
+ "text": "number"
35051
+ }
35052
+ },
35053
+ {
35054
+ "name": "draft",
35055
+ "optional": true,
35056
+ "type": {
35057
+ "text": "string"
35058
+ }
35059
+ },
35060
+ {
35061
+ "name": "align",
35062
+ "default": "'nearest'",
35063
+ "type": {
35064
+ "text": "'nearest' | 'center'"
35065
+ }
35066
+ },
35067
+ {
35068
+ "name": "caretOffset",
35069
+ "optional": true,
35070
+ "type": {
35071
+ "text": "number"
35097
35072
  }
35098
35073
  }
35099
35074
  ]
35100
35075
  },
35101
35076
  {
35102
35077
  "kind": "method",
35103
- "name": "renderMetaChips",
35078
+ "name": "updateImageEdit",
35104
35079
  "privacy": "private",
35105
35080
  "parameters": [
35106
35081
  {
35107
- "name": "lines",
35082
+ "name": "patch",
35108
35083
  "type": {
35109
- "text": "MetaLine[]"
35084
+ "text": "Partial<ImageBlockData>"
35110
35085
  }
35111
35086
  }
35112
- ],
35113
- "description": "A metadata-only block parses to nothing, so show each of its lines as a chip instead."
35087
+ ]
35088
+ },
35089
+ {
35090
+ "kind": "field",
35091
+ "name": "saveImageEdit",
35092
+ "privacy": "private"
35093
+ },
35094
+ {
35095
+ "kind": "field",
35096
+ "name": "closeImageEdit",
35097
+ "privacy": "private"
35098
+ },
35099
+ {
35100
+ "kind": "field",
35101
+ "name": "deleteImageBlock",
35102
+ "privacy": "private"
35103
+ },
35104
+ {
35105
+ "kind": "field",
35106
+ "name": "editImageSource",
35107
+ "privacy": "private"
35108
+ },
35109
+ {
35110
+ "kind": "field",
35111
+ "name": "handleImageControlsKeydown",
35112
+ "privacy": "private"
35114
35113
  },
35115
35114
  {
35116
35115
  "kind": "method",
35117
- "name": "renderMetaChip",
35116
+ "name": "computeEditShell",
35118
35117
  "privacy": "private",
35118
+ "return": {
35119
+ "type": {
35120
+ "text": "string"
35121
+ }
35122
+ },
35119
35123
  "parameters": [
35120
35124
  {
35121
- "name": "line",
35125
+ "name": "draft",
35122
35126
  "type": {
35123
- "text": "MetaLine"
35127
+ "text": "string"
35124
35128
  }
35125
35129
  }
35126
35130
  ],
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."
35131
+ "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."
35128
35132
  },
35129
35133
  {
35130
35134
  "kind": "method",
35131
- "name": "markVariables",
35135
+ "name": "focusInput",
35132
35136
  "privacy": "private",
35133
35137
  "parameters": [
35134
35138
  {
35135
- "name": "root",
35139
+ "name": "align",
35140
+ "default": "'nearest'",
35136
35141
  "type": {
35137
- "text": "Element"
35142
+ "text": "'nearest' | 'center'"
35143
+ }
35144
+ },
35145
+ {
35146
+ "name": "caretOffset",
35147
+ "optional": true,
35148
+ "type": {
35149
+ "text": "number"
35138
35150
  }
35139
35151
  }
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."
35152
+ ]
35142
35153
  },
35143
35154
  {
35144
35155
  "kind": "method",
35145
- "name": "renderConditional",
35156
+ "name": "reveal",
35146
35157
  "privacy": "private",
35147
- "return": {
35148
- "type": {
35149
- "text": "TemplateResult | null"
35150
- }
35151
- },
35152
35158
  "parameters": [
35153
35159
  {
35154
- "name": "block",
35160
+ "name": "el",
35155
35161
  "type": {
35156
- "text": "string"
35162
+ "text": "Element | null | undefined"
35163
+ }
35164
+ },
35165
+ {
35166
+ "name": "align",
35167
+ "default": "'nearest'",
35168
+ "type": {
35169
+ "text": "'nearest' | 'center'"
35157
35170
  }
35158
35171
  }
35159
35172
  ],
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."
35173
+ "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."
35161
35174
  },
35162
35175
  {
35163
35176
  "kind": "method",
35164
- "name": "renderBlock",
35177
+ "name": "revealAfterUpdate",
35165
35178
  "privacy": "private",
35166
35179
  "parameters": [
35167
35180
  {
35168
- "name": "block",
35181
+ "name": "selector",
35169
35182
  "type": {
35170
35183
  "text": "string"
35171
35184
  }
35172
35185
  },
35173
35186
  {
35174
- "name": "index",
35187
+ "name": "align",
35188
+ "default": "'nearest'",
35175
35189
  "type": {
35176
- "text": "number"
35190
+ "text": "'nearest' | 'center'"
35177
35191
  }
35178
35192
  }
35179
35193
  ]
35180
35194
  },
35181
35195
  {
35182
35196
  "kind": "method",
35183
- "name": "isActionDisabled",
35197
+ "name": "revealBlock",
35184
35198
  "privacy": "private",
35185
- "return": {
35186
- "type": {
35187
- "text": "boolean"
35188
- }
35189
- },
35190
35199
  "parameters": [
35191
35200
  {
35192
- "name": "action",
35201
+ "name": "index",
35193
35202
  "type": {
35194
- "text": "EditorAction"
35203
+ "text": "number"
35195
35204
  }
35196
35205
  }
35197
35206
  ],
35198
- "description": "An inline action needs an open block to apply its mark to."
35207
+ "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."
35199
35208
  },
35200
35209
  {
35201
35210
  "kind": "method",
35202
- "name": "activateAction",
35211
+ "name": "addBlockAt",
35203
35212
  "privacy": "private",
35204
35213
  "parameters": [
35205
35214
  {
35206
- "name": "action",
35215
+ "name": "index",
35207
35216
  "type": {
35208
- "text": "EditorAction"
35217
+ "text": "number"
35218
+ }
35219
+ },
35220
+ {
35221
+ "name": "content",
35222
+ "type": {
35223
+ "text": "string"
35209
35224
  }
35210
35225
  }
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."
35226
+ ]
35213
35227
  },
35214
35228
  {
35215
35229
  "kind": "method",
35216
- "name": "renderAction",
35230
+ "name": "deleteBlock",
35217
35231
  "privacy": "private",
35218
35232
  "parameters": [
35219
35233
  {
35220
- "name": "action",
35234
+ "name": "index",
35221
35235
  "type": {
35222
- "text": "EditorAction"
35236
+ "text": "number"
35223
35237
  }
35224
35238
  }
35225
- ],
35226
- "description": "A single toolbar action button, shared by the toolbar bar and the overflow menu."
35239
+ ]
35227
35240
  },
35228
35241
  {
35229
35242
  "kind": "method",
35230
- "name": "renderMenuAction",
35243
+ "name": "insertDraftBlock",
35231
35244
  "privacy": "private",
35232
35245
  "parameters": [
35233
35246
  {
35234
- "name": "action",
35247
+ "name": "index",
35235
35248
  "type": {
35236
- "text": "EditorAction"
35249
+ "text": "number"
35250
+ }
35251
+ },
35252
+ {
35253
+ "name": "prefill",
35254
+ "default": "''"
35255
+ },
35256
+ {
35257
+ "name": "caretOffset",
35258
+ "optional": true,
35259
+ "type": {
35260
+ "text": "number"
35237
35261
  }
35238
35262
  }
35239
35263
  ],
35240
- "description": "The same action, rendered as a menu item for the overflow menu."
35241
- },
35242
- {
35243
- "kind": "method",
35244
- "name": "renderRaw",
35245
- "privacy": "private"
35246
- },
35247
- {
35248
- "kind": "method",
35249
- "name": "renderBody",
35250
- "privacy": "private",
35251
- "description": "The block views, with the inline image picker spliced in when active."
35252
- },
35253
- {
35254
- "kind": "method",
35255
- "name": "renderIncludePicker",
35256
- "privacy": "private"
35257
- },
35258
- {
35259
- "kind": "method",
35260
- "name": "renderImagePicker",
35261
- "privacy": "private"
35262
- }
35263
- ],
35264
- "events": [
35265
- {
35266
- "description": "Emitted on each keystroke while editing a block.",
35267
- "name": "zn-input"
35268
- },
35269
- {
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"
35279
- },
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"
35283
- },
35284
- {
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"
35292
- },
35293
- {
35294
- "name": "value",
35295
- "type": {
35296
- "text": "string"
35297
- },
35298
- "default": "''",
35299
- "description": "The current remarkd source.",
35300
- "fieldName": "value"
35301
- },
35302
- {
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"
35310
- },
35311
- {
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"
35319
- },
35320
- {
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"
35328
- },
35329
- {
35330
- "name": "allow-raw",
35331
- "type": {
35332
- "text": "boolean"
35333
- },
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": ""
35425
- },
35426
- {
35427
- "description": "An example slot.",
35428
- "name": "example"
35429
- }
35430
- ],
35431
- "members": [
35432
- {
35433
- "kind": "field",
35434
- "name": "duration",
35435
- "type": {
35436
- "text": "number"
35437
- },
35438
- "default": "2000",
35439
- "attribute": "duration"
35440
- },
35441
- {
35442
- "kind": "field",
35443
- "name": "initial",
35444
- "type": {
35445
- "text": "string"
35446
- },
35447
- "default": "''",
35448
- "attribute": "initial"
35449
- },
35450
- {
35451
- "kind": "field",
35452
- "name": "revealed",
35453
- "type": {
35454
- "text": "string"
35455
- },
35456
- "default": "''",
35457
- "attribute": "revealed"
35458
- },
35459
- {
35460
- "kind": "field",
35461
- "name": "hideDelay",
35462
- "type": {
35463
- "text": "number"
35464
- },
35465
- "default": "150",
35466
- "attribute": "hide-delay"
35467
- },
35468
- {
35469
- "kind": "field",
35470
- "name": "noToggle",
35471
- "type": {
35472
- "text": "boolean"
35473
- },
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"
35264
+ "description": "Inserts a draft block committed (or dropped, if left empty) on blur."
35477
35265
  },
35478
35266
  {
35479
35267
  "kind": "field",
35480
- "name": "_isRevealed",
35481
- "type": {
35482
- "text": "boolean"
35483
- },
35268
+ "name": "handleEditBlur",
35484
35269
  "privacy": "private",
35485
- "default": "false"
35270
+ "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."
35486
35271
  },
35487
35272
  {
35488
35273
  "kind": "field",
35489
- "name": "_isToggled",
35490
- "type": {
35491
- "text": "boolean"
35492
- },
35274
+ "name": "commitEdit",
35493
35275
  "privacy": "private",
35494
- "default": "false"
35276
+ "description": "Commits the in-progress edit; returns the index after the committed parts."
35495
35277
  },
35496
35278
  {
35497
35279
  "kind": "field",
35498
- "name": "_hideTimer",
35499
- "type": {
35500
- "text": "ReturnType<typeof setTimeout> | undefined"
35501
- },
35280
+ "name": "handleDraftInput",
35502
35281
  "privacy": "private"
35503
35282
  },
35504
35283
  {
35505
- "kind": "method",
35506
- "name": "_clearHideTimer",
35284
+ "kind": "field",
35285
+ "name": "handleEditKeydown",
35507
35286
  "privacy": "private"
35508
35287
  },
35509
35288
  {
35510
35289
  "kind": "method",
35511
- "name": "handleToggleReveal",
35512
- "privacy": "protected"
35290
+ "name": "isSlashBlock",
35291
+ "privacy": "private",
35292
+ "return": {
35293
+ "type": {
35294
+ "text": "boolean"
35295
+ }
35296
+ },
35297
+ "description": "Whether the block being edited is nothing but the slash command."
35513
35298
  },
35514
35299
  {
35515
35300
  "kind": "method",
35516
- "name": "handleMouseEnter",
35517
- "privacy": "protected"
35301
+ "name": "mountSlashMenu",
35302
+ "privacy": "private",
35303
+ "return": {
35304
+ "type": {
35305
+ "text": "Promise<ZnSlashMenu | null>"
35306
+ }
35307
+ }
35518
35308
  },
35519
35309
  {
35520
35310
  "kind": "method",
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"
35311
+ "name": "handleSlashSelect",
35312
+ "privacy": "private",
35313
+ "return": {
35314
+ "type": {
35315
+ "text": "boolean"
35316
+ }
35568
35317
  },
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"
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"
35318
+ "parameters": [
35319
+ {
35320
+ "name": "item",
35321
+ "type": {
35322
+ "text": "SlashMenuItem"
35323
+ }
35324
+ }
35325
+ ],
35326
+ "description": "Returns false for items the controller should not insert text for."
35636
35327
  },
35637
35328
  {
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": ""
35329
+ "kind": "field",
35330
+ "name": "handleEditPaste",
35331
+ "privacy": "private"
35646
35332
  },
35647
35333
  {
35648
- "description": "An example slot.",
35649
- "name": "example"
35334
+ "kind": "field",
35335
+ "name": "handleDragOver",
35336
+ "privacy": "private"
35650
35337
  },
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": [
35657
35338
  {
35658
35339
  "kind": "field",
35659
- "name": "formControlController",
35660
- "privacy": "private",
35661
- "readonly": true,
35662
- "default": "new FormControlController(this, { assumeInteractionOn: ['zn-blur', 'zn-input'] })"
35340
+ "name": "handleDrop",
35341
+ "privacy": "private"
35663
35342
  },
35664
35343
  {
35665
- "kind": "field",
35666
- "name": "hasSlotController",
35344
+ "kind": "method",
35345
+ "name": "insertionIndexFromY",
35667
35346
  "privacy": "private",
35668
- "readonly": true,
35669
- "default": "new HasSlotController(this, 'help-text')"
35347
+ "return": {
35348
+ "type": {
35349
+ "text": "number"
35350
+ }
35351
+ },
35352
+ "parameters": [
35353
+ {
35354
+ "name": "y",
35355
+ "type": {
35356
+ "text": "number"
35357
+ }
35358
+ }
35359
+ ],
35360
+ "description": "The insertion index a drop at `y` maps to, from the rendered block positions."
35670
35361
  },
35671
35362
  {
35672
35363
  "kind": "field",
35673
- "name": "rating",
35674
- "type": {
35675
- "text": "HTMLElement"
35676
- }
35364
+ "name": "handleHandlePointerDown",
35365
+ "privacy": "private"
35677
35366
  },
35678
35367
  {
35679
35368
  "kind": "field",
35680
- "name": "symbols",
35681
- "type": {
35682
- "text": "HTMLElement"
35683
- }
35369
+ "name": "handleDragPointerMove",
35370
+ "privacy": "private"
35684
35371
  },
35685
35372
  {
35686
35373
  "kind": "field",
35687
- "name": "hoverValue",
35688
- "type": {
35689
- "text": "number"
35690
- },
35374
+ "name": "stepAutoScroll",
35691
35375
  "privacy": "private",
35692
- "default": "0"
35376
+ "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."
35693
35377
  },
35694
35378
  {
35695
- "kind": "field",
35696
- "name": "isHovering",
35697
- "type": {
35698
- "text": "boolean"
35699
- },
35379
+ "kind": "method",
35380
+ "name": "autoScroll",
35700
35381
  "privacy": "private",
35701
- "default": "false"
35702
- },
35703
- {
35704
- "kind": "field",
35705
- "name": "label",
35706
- "type": {
35707
- "text": "string"
35708
- },
35709
- "attribute": "label"
35710
- },
35711
- {
35712
- "kind": "field",
35713
- "name": "helpText",
35714
- "type": {
35715
- "text": "string"
35382
+ "return": {
35383
+ "type": {
35384
+ "text": "boolean"
35385
+ }
35716
35386
  },
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"
35387
+ "description": "Scrolls the editor body, falling through to the page once the body is at its limit."
35720
35388
  },
35721
35389
  {
35722
- "kind": "field",
35723
- "name": "name",
35724
- "type": {
35725
- "text": "string"
35390
+ "kind": "method",
35391
+ "name": "edgeScrollDelta",
35392
+ "privacy": "private",
35393
+ "return": {
35394
+ "type": {
35395
+ "text": "number"
35396
+ }
35726
35397
  },
35727
- "attribute": "name"
35398
+ "parameters": [
35399
+ {
35400
+ "name": "top",
35401
+ "type": {
35402
+ "text": "number"
35403
+ }
35404
+ },
35405
+ {
35406
+ "name": "bottom",
35407
+ "type": {
35408
+ "text": "number"
35409
+ }
35410
+ }
35411
+ ],
35412
+ "description": "Scroll step for this frame: nothing until the pointer is within `edge` of a boundary."
35728
35413
  },
35729
35414
  {
35730
35415
  "kind": "field",
35731
- "name": "value",
35732
- "type": {
35733
- "text": "number"
35734
- },
35735
- "default": "0",
35736
- "attribute": "value"
35416
+ "name": "handleDragPointerUp",
35417
+ "privacy": "private"
35737
35418
  },
35738
35419
  {
35739
35420
  "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."
35421
+ "name": "cancelDrag",
35422
+ "privacy": "private"
35746
35423
  },
35747
35424
  {
35748
- "kind": "field",
35749
- "name": "max",
35750
- "type": {
35751
- "text": "number"
35752
- },
35753
- "default": "5",
35754
- "attribute": "max"
35425
+ "kind": "method",
35426
+ "name": "createDragGhost",
35427
+ "privacy": "private",
35428
+ "parameters": [
35429
+ {
35430
+ "name": "index",
35431
+ "type": {
35432
+ "text": "number"
35433
+ }
35434
+ }
35435
+ ]
35755
35436
  },
35756
35437
  {
35757
- "kind": "field",
35758
- "name": "precision",
35759
- "type": {
35760
- "text": "number"
35761
- },
35762
- "default": "1",
35763
- "attribute": "precision"
35438
+ "kind": "method",
35439
+ "name": "moveDragGhost",
35440
+ "privacy": "private",
35441
+ "parameters": [
35442
+ {
35443
+ "name": "x",
35444
+ "type": {
35445
+ "text": "number"
35446
+ }
35447
+ },
35448
+ {
35449
+ "name": "y",
35450
+ "type": {
35451
+ "text": "number"
35452
+ }
35453
+ }
35454
+ ]
35764
35455
  },
35765
35456
  {
35766
- "kind": "field",
35767
- "name": "readonly",
35768
- "type": {
35769
- "text": "boolean"
35770
- },
35771
- "default": "false",
35772
- "attribute": "readonly"
35457
+ "kind": "method",
35458
+ "name": "pickImage",
35459
+ "privacy": "private",
35460
+ "parameters": [
35461
+ {
35462
+ "name": "index",
35463
+ "type": {
35464
+ "text": "number"
35465
+ }
35466
+ }
35467
+ ]
35773
35468
  },
35774
35469
  {
35775
- "kind": "field",
35776
- "name": "disabled",
35777
- "type": {
35778
- "text": "boolean"
35779
- },
35780
- "default": "false",
35781
- "attribute": "disabled"
35470
+ "kind": "method",
35471
+ "name": "pickInclude",
35472
+ "privacy": "private",
35473
+ "parameters": [
35474
+ {
35475
+ "name": "index",
35476
+ "type": {
35477
+ "text": "number"
35478
+ }
35479
+ }
35480
+ ]
35782
35481
  },
35783
35482
  {
35784
35483
  "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"
35484
+ "name": "closeIncludePicker",
35485
+ "privacy": "private"
35792
35486
  },
35793
35487
  {
35794
- "kind": "field",
35795
- "name": "size",
35796
- "type": {
35797
- "text": "'small' | 'medium' | 'large'"
35798
- },
35799
- "default": "'medium'",
35800
- "attribute": "size"
35488
+ "kind": "method",
35489
+ "name": "insertInclude",
35490
+ "privacy": "private",
35491
+ "parameters": [
35492
+ {
35493
+ "name": "item",
35494
+ "type": {
35495
+ "text": "IncludeOption"
35496
+ }
35497
+ }
35498
+ ]
35801
35499
  },
35802
35500
  {
35803
35501
  "kind": "field",
35804
- "name": "getSymbol",
35805
- "type": {
35806
- "text": "(value: number) => string"
35807
- },
35808
- "attribute": "getSymbol"
35502
+ "name": "closeImagePicker",
35503
+ "privacy": "private"
35809
35504
  },
35810
35505
  {
35811
35506
  "kind": "field",
35812
- "name": "validity",
35813
- "description": "Gets the validity state object",
35814
- "readonly": true
35507
+ "name": "handleImagePicked",
35508
+ "privacy": "private"
35815
35509
  },
35816
35510
  {
35817
- "kind": "field",
35818
- "name": "validationMessage",
35819
- "description": "Gets the validation message",
35820
- "readonly": true
35511
+ "kind": "method",
35512
+ "name": "insertImage",
35513
+ "privacy": "private",
35514
+ "parameters": [
35515
+ {
35516
+ "name": "file",
35517
+ "type": {
35518
+ "text": "File"
35519
+ }
35520
+ },
35521
+ {
35522
+ "name": "index",
35523
+ "type": {
35524
+ "text": "number"
35525
+ }
35526
+ }
35527
+ ]
35821
35528
  },
35822
35529
  {
35823
35530
  "kind": "method",
35824
- "name": "checkValidity",
35531
+ "name": "uploadImage",
35532
+ "privacy": "private",
35825
35533
  "return": {
35826
35534
  "type": {
35827
- "text": "boolean"
35535
+ "text": "Promise<string>"
35828
35536
  }
35829
35537
  },
35830
- "description": "Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
35538
+ "parameters": [
35539
+ {
35540
+ "name": "file",
35541
+ "type": {
35542
+ "text": "File"
35543
+ }
35544
+ }
35545
+ ]
35831
35546
  },
35832
35547
  {
35833
35548
  "kind": "method",
35834
- "name": "getForm",
35549
+ "name": "appPath",
35550
+ "privacy": "private",
35835
35551
  "return": {
35836
35552
  "type": {
35837
- "text": "HTMLFormElement | null"
35553
+ "text": "string"
35838
35554
  }
35839
35555
  },
35840
- "description": "Gets the associated form, if one exists."
35841
- },
35842
- {
35843
- "kind": "method",
35844
- "name": "reportValidity",
35845
- "description": "Checks for validity and shows the browser's validation message if the control is invalid."
35556
+ "parameters": [
35557
+ {
35558
+ "name": "path",
35559
+ "type": {
35560
+ "text": "string"
35561
+ }
35562
+ }
35563
+ ],
35564
+ "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."
35846
35565
  },
35847
35566
  {
35848
35567
  "kind": "method",
35849
- "name": "setCustomValidity",
35850
- "description": "Sets a custom validation message. Pass an empty string to restore validity."
35568
+ "name": "hasIncludeBlock",
35569
+ "privacy": "private",
35570
+ "return": {
35571
+ "type": {
35572
+ "text": "boolean"
35573
+ }
35574
+ }
35851
35575
  },
35852
35576
  {
35853
35577
  "kind": "method",
35854
- "name": "_roundToPrecision",
35578
+ "name": "loadIncludeOptions",
35855
35579
  "privacy": "private",
35856
35580
  "return": {
35857
35581
  "type": {
35858
- "text": "number"
35582
+ "text": "Promise<IncludeOption[]>"
35859
35583
  }
35860
35584
  },
35585
+ "description": "Fetches the include list once; every later caller shares the same promise."
35586
+ },
35587
+ {
35588
+ "kind": "method",
35589
+ "name": "autosize",
35590
+ "privacy": "private",
35861
35591
  "parameters": [
35862
35592
  {
35863
- "name": "value",
35864
- "type": {
35865
- "text": "number"
35866
- }
35867
- },
35868
- {
35869
- "name": "precision",
35593
+ "name": "input",
35870
35594
  "type": {
35871
- "text": "number"
35595
+ "text": "HTMLTextAreaElement"
35872
35596
  }
35873
35597
  }
35874
35598
  ]
35875
35599
  },
35876
35600
  {
35877
35601
  "kind": "method",
35878
- "name": "_getValueFromXCoordinate",
35602
+ "name": "applyInline",
35879
35603
  "privacy": "private",
35880
- "return": {
35881
- "type": {
35882
- "text": "number"
35883
- }
35884
- },
35885
35604
  "parameters": [
35886
35605
  {
35887
- "name": "coordinate",
35606
+ "name": "mark",
35888
35607
  "type": {
35889
- "text": "number"
35608
+ "text": "InlineMark"
35890
35609
  }
35891
35610
  }
35892
- ]
35611
+ ],
35612
+ "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."
35613
+ },
35614
+ {
35615
+ "kind": "field",
35616
+ "name": "toggleRawMode",
35617
+ "privacy": "private"
35893
35618
  },
35894
35619
  {
35895
35620
  "kind": "method",
35896
- "name": "_formatValue",
35621
+ "name": "focusRaw",
35622
+ "privacy": "private"
35623
+ },
35624
+ {
35625
+ "kind": "field",
35626
+ "name": "handleRawInput",
35627
+ "privacy": "private",
35628
+ "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."
35629
+ },
35630
+ {
35631
+ "kind": "field",
35632
+ "name": "commitRaw",
35633
+ "privacy": "private",
35634
+ "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."
35635
+ },
35636
+ {
35637
+ "kind": "method",
35638
+ "name": "handleToolbarInsert",
35897
35639
  "privacy": "private",
35898
- "return": {
35899
- "type": {
35900
- "text": "string"
35901
- }
35902
- },
35903
35640
  "parameters": [
35904
35641
  {
35905
- "name": "value",
35642
+ "name": "action",
35906
35643
  "type": {
35907
- "text": "number"
35644
+ "text": "EditorAction"
35908
35645
  }
35909
35646
  }
35910
35647
  ]
35911
35648
  },
35912
35649
  {
35913
35650
  "kind": "method",
35914
- "name": "_getValueFromMousePosition",
35651
+ "name": "renderImageControls",
35652
+ "privacy": "private"
35653
+ },
35654
+ {
35655
+ "kind": "method",
35656
+ "name": "renderIncludeChip",
35915
35657
  "privacy": "private",
35916
- "return": {
35917
- "type": {
35918
- "text": "number"
35919
- }
35920
- },
35921
35658
  "parameters": [
35922
35659
  {
35923
- "name": "event",
35660
+ "name": "data",
35924
35661
  "type": {
35925
- "text": "MouseEvent"
35662
+ "text": "IncludeBlockData"
35926
35663
  }
35927
35664
  }
35928
35665
  ]
35929
35666
  },
35930
35667
  {
35931
35668
  "kind": "method",
35932
- "name": "_getValueFromTouchPosition",
35669
+ "name": "renderMetaChips",
35933
35670
  "privacy": "private",
35934
- "return": {
35935
- "type": {
35936
- "text": "number"
35937
- }
35938
- },
35939
35671
  "parameters": [
35940
35672
  {
35941
- "name": "event",
35673
+ "name": "lines",
35942
35674
  "type": {
35943
- "text": "TouchEvent"
35675
+ "text": "MetaLine[]"
35944
35676
  }
35945
35677
  }
35946
- ]
35678
+ ],
35679
+ "description": "A metadata-only block parses to nothing, so show each of its lines as a chip instead."
35947
35680
  },
35948
35681
  {
35949
35682
  "kind": "method",
35950
- "name": "_setValue",
35683
+ "name": "renderMetaChip",
35951
35684
  "privacy": "private",
35952
35685
  "parameters": [
35953
35686
  {
35954
- "name": "value",
35687
+ "name": "line",
35955
35688
  "type": {
35956
- "text": "number"
35689
+ "text": "MetaLine"
35957
35690
  }
35958
35691
  }
35959
- ]
35692
+ ],
35693
+ "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."
35960
35694
  },
35961
35695
  {
35962
35696
  "kind": "method",
35963
- "name": "_handleClick",
35697
+ "name": "markVariables",
35964
35698
  "privacy": "private",
35965
35699
  "parameters": [
35966
35700
  {
35967
- "name": "event",
35701
+ "name": "root",
35968
35702
  "type": {
35969
- "text": "MouseEvent"
35703
+ "text": "Element"
35970
35704
  }
35971
35705
  }
35972
- ]
35706
+ ],
35707
+ "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."
35973
35708
  },
35974
35709
  {
35975
35710
  "kind": "method",
35976
- "name": "_handleMouseEnter",
35711
+ "name": "renderConditional",
35977
35712
  "privacy": "private",
35713
+ "return": {
35714
+ "type": {
35715
+ "text": "TemplateResult | null"
35716
+ }
35717
+ },
35978
35718
  "parameters": [
35979
35719
  {
35980
- "name": "event",
35720
+ "name": "block",
35981
35721
  "type": {
35982
- "text": "MouseEvent"
35722
+ "text": "string"
35983
35723
  }
35984
35724
  }
35985
- ]
35725
+ ],
35726
+ "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."
35986
35727
  },
35987
35728
  {
35988
35729
  "kind": "method",
35989
- "name": "_handleMouseMove",
35730
+ "name": "renderBlock",
35990
35731
  "privacy": "private",
35991
35732
  "parameters": [
35992
35733
  {
35993
- "name": "event",
35734
+ "name": "block",
35994
35735
  "type": {
35995
- "text": "MouseEvent"
35736
+ "text": "string"
35737
+ }
35738
+ },
35739
+ {
35740
+ "name": "index",
35741
+ "type": {
35742
+ "text": "number"
35996
35743
  }
35997
35744
  }
35998
35745
  ]
35999
35746
  },
36000
35747
  {
36001
35748
  "kind": "method",
36002
- "name": "_handleMouseLeave",
36003
- "privacy": "private"
35749
+ "name": "isActionDisabled",
35750
+ "privacy": "private",
35751
+ "return": {
35752
+ "type": {
35753
+ "text": "boolean"
35754
+ }
35755
+ },
35756
+ "parameters": [
35757
+ {
35758
+ "name": "action",
35759
+ "type": {
35760
+ "text": "EditorAction"
35761
+ }
35762
+ }
35763
+ ],
35764
+ "description": "An inline action needs an open block to apply its mark to."
36004
35765
  },
36005
35766
  {
36006
35767
  "kind": "method",
36007
- "name": "_handleTouchStart",
35768
+ "name": "activateAction",
36008
35769
  "privacy": "private",
36009
35770
  "parameters": [
36010
35771
  {
36011
- "name": "event",
35772
+ "name": "action",
36012
35773
  "type": {
36013
- "text": "TouchEvent"
35774
+ "text": "EditorAction"
36014
35775
  }
36015
35776
  }
36016
- ]
35777
+ ],
35778
+ "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."
36017
35779
  },
36018
35780
  {
36019
35781
  "kind": "method",
36020
- "name": "_handleTouchMove",
35782
+ "name": "renderAction",
36021
35783
  "privacy": "private",
36022
35784
  "parameters": [
36023
35785
  {
36024
- "name": "event",
35786
+ "name": "action",
36025
35787
  "type": {
36026
- "text": "TouchEvent"
35788
+ "text": "EditorAction"
36027
35789
  }
36028
35790
  }
36029
- ]
35791
+ ],
35792
+ "description": "A single toolbar action button, shared by the toolbar bar and the overflow menu."
36030
35793
  },
36031
35794
  {
36032
35795
  "kind": "method",
36033
- "name": "_handleTouchEnd",
35796
+ "name": "renderMenuAction",
36034
35797
  "privacy": "private",
36035
35798
  "parameters": [
36036
35799
  {
36037
- "name": "event",
35800
+ "name": "action",
36038
35801
  "type": {
36039
- "text": "TouchEvent"
35802
+ "text": "EditorAction"
36040
35803
  }
36041
35804
  }
36042
- ]
35805
+ ],
35806
+ "description": "The same action, rendered as a menu item for the overflow menu."
35807
+ },
35808
+ {
35809
+ "kind": "method",
35810
+ "name": "renderRaw",
35811
+ "privacy": "private"
35812
+ },
35813
+ {
35814
+ "kind": "method",
35815
+ "name": "renderBody",
35816
+ "privacy": "private",
35817
+ "description": "The block views, with the inline image picker spliced in when active."
35818
+ },
35819
+ {
35820
+ "kind": "method",
35821
+ "name": "renderIncludePicker",
35822
+ "privacy": "private"
35823
+ },
35824
+ {
35825
+ "kind": "method",
35826
+ "name": "renderImagePicker",
35827
+ "privacy": "private"
36043
35828
  }
36044
35829
  ],
36045
35830
  "events": [
36046
35831
  {
36047
- "description": "Emitted as an example.",
36048
- "name": "zn-event-name"
35832
+ "description": "Emitted on each keystroke while editing a block.",
35833
+ "name": "zn-input"
35834
+ },
35835
+ {
35836
+ "description": "Emitted when a block edit is committed and the value changes.",
35837
+ "name": "zn-change"
36049
35838
  }
36050
35839
  ],
36051
35840
  "attributes": [
36052
35841
  {
36053
- "name": "label",
35842
+ "name": "slash-recent-key",
36054
35843
  "type": {
36055
35844
  "text": "string"
36056
35845
  },
36057
- "fieldName": "label"
35846
+ "default": "''",
35847
+ "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.",
35848
+ "fieldName": "slashRecentKey"
36058
35849
  },
36059
35850
  {
36060
- "name": "help-text",
35851
+ "name": "name",
36061
35852
  "type": {
36062
35853
  "text": "string"
36063
35854
  },
36064
35855
  "default": "''",
36065
- "description": "The rating's help text. If you need to display HTML, use the `help-text` slot instead.",
36066
- "fieldName": "helpText"
35856
+ "description": "The name of the control, submitted as part of form data.",
35857
+ "fieldName": "name"
36067
35858
  },
36068
35859
  {
36069
- "name": "name",
35860
+ "name": "value",
36070
35861
  "type": {
36071
35862
  "text": "string"
36072
35863
  },
36073
- "fieldName": "name"
35864
+ "default": "''",
35865
+ "description": "The current remarkd source.",
35866
+ "fieldName": "value"
36074
35867
  },
36075
35868
  {
36076
- "name": "value",
35869
+ "name": "placeholder",
36077
35870
  "type": {
36078
- "text": "number"
35871
+ "text": "string"
36079
35872
  },
36080
- "default": "0",
36081
- "fieldName": "value"
35873
+ "default": "'Type something…'",
35874
+ "description": "Placeholder shown when the document is empty.",
35875
+ "fieldName": "placeholder"
36082
35876
  },
36083
35877
  {
36084
- "name": "max",
35878
+ "name": "attachment-url",
36085
35879
  "type": {
36086
- "text": "number"
35880
+ "text": "string"
36087
35881
  },
36088
- "default": "5",
36089
- "fieldName": "max"
35882
+ "default": "''",
35883
+ "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.",
35884
+ "fieldName": "attachmentUrl"
36090
35885
  },
36091
35886
  {
36092
- "name": "precision",
35887
+ "name": "include-url",
36093
35888
  "type": {
36094
- "text": "number"
35889
+ "text": "string"
36095
35890
  },
36096
- "default": "1",
36097
- "fieldName": "precision"
35891
+ "default": "''",
35892
+ "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.",
35893
+ "fieldName": "includeUrl"
35894
+ },
35895
+ {
35896
+ "name": "allow-raw",
35897
+ "type": {
35898
+ "text": "boolean"
35899
+ },
35900
+ "default": "false",
35901
+ "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
35902
+ "fieldName": "allowRaw"
35903
+ },
35904
+ {
35905
+ "name": "required",
35906
+ "type": {
35907
+ "text": "boolean"
35908
+ },
35909
+ "default": "false",
35910
+ "description": "Makes the editor required for form submission.",
35911
+ "fieldName": "required"
36098
35912
  },
36099
35913
  {
36100
35914
  "name": "readonly",
@@ -36102,6 +35916,7 @@
36102
35916
  "text": "boolean"
36103
35917
  },
36104
35918
  "default": "false",
35919
+ "description": "Makes the editor read-only.",
36105
35920
  "fieldName": "readonly"
36106
35921
  },
36107
35922
  {
@@ -36110,31 +35925,216 @@
36110
35925
  "text": "boolean"
36111
35926
  },
36112
35927
  "default": "false",
35928
+ "description": "Disables the editor.",
36113
35929
  "fieldName": "disabled"
35930
+ }
35931
+ ],
35932
+ "superclass": {
35933
+ "name": "ZincElement",
35934
+ "module": "/src/internal/zinc-element"
35935
+ },
35936
+ "summary": "A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.",
35937
+ "tagNameWithoutPrefix": "remarkd-editor",
35938
+ "tagName": "zn-remarkd-editor",
35939
+ "customElement": true,
35940
+ "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 */",
35941
+ "documentation": "https://zinc.style/components/remarkd-editor",
35942
+ "status": "experimental",
35943
+ "since": "1.0",
35944
+ "dependencies": [
35945
+ "zn-button",
35946
+ "zn-button-group",
35947
+ "zn-dropdown",
35948
+ "zn-icon",
35949
+ "zn-file",
35950
+ "zn-menu",
35951
+ "zn-menu-item",
35952
+ "zn-slash-menu"
35953
+ ]
35954
+ }
35955
+ ],
35956
+ "exports": [
35957
+ {
35958
+ "kind": "js",
35959
+ "name": "default",
35960
+ "declaration": {
35961
+ "name": "ZnRemarkdEditor",
35962
+ "module": "components/remarkd-editor/remarkd-editor.js"
35963
+ }
35964
+ }
35965
+ ]
35966
+ },
35967
+ {
35968
+ "kind": "javascript-module",
35969
+ "path": "components/reveal/reveal.js",
35970
+ "declarations": [
35971
+ {
35972
+ "kind": "class",
35973
+ "description": "",
35974
+ "name": "ZnReveal",
35975
+ "cssProperties": [
35976
+ {
35977
+ "description": "An example CSS custom property.",
35978
+ "name": "--example"
35979
+ }
35980
+ ],
35981
+ "cssParts": [
35982
+ {
35983
+ "description": "The component's base wrapper.",
35984
+ "name": "base"
35985
+ }
35986
+ ],
35987
+ "slots": [
35988
+ {
35989
+ "description": "The default slot.",
35990
+ "name": ""
36114
35991
  },
36115
35992
  {
36116
- "name": "preview",
35993
+ "description": "An example slot.",
35994
+ "name": "example"
35995
+ }
35996
+ ],
35997
+ "members": [
35998
+ {
35999
+ "kind": "field",
36000
+ "name": "duration",
36001
+ "type": {
36002
+ "text": "number"
36003
+ },
36004
+ "default": "2000",
36005
+ "attribute": "duration"
36006
+ },
36007
+ {
36008
+ "kind": "field",
36009
+ "name": "initial",
36010
+ "type": {
36011
+ "text": "string"
36012
+ },
36013
+ "default": "''",
36014
+ "attribute": "initial"
36015
+ },
36016
+ {
36017
+ "kind": "field",
36018
+ "name": "revealed",
36019
+ "type": {
36020
+ "text": "string"
36021
+ },
36022
+ "default": "''",
36023
+ "attribute": "revealed"
36024
+ },
36025
+ {
36026
+ "kind": "field",
36027
+ "name": "hideDelay",
36028
+ "type": {
36029
+ "text": "number"
36030
+ },
36031
+ "default": "150",
36032
+ "attribute": "hide-delay"
36033
+ },
36034
+ {
36035
+ "kind": "field",
36036
+ "name": "noToggle",
36117
36037
  "type": {
36118
36038
  "text": "boolean"
36119
36039
  },
36120
36040
  "default": "false",
36121
- "description": "Displays the value alongside the symbols, updating live as the pointer moves across them.",
36122
- "fieldName": "preview"
36041
+ "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
36042
+ "attribute": "no-toggle"
36123
36043
  },
36124
36044
  {
36125
- "name": "size",
36045
+ "kind": "field",
36046
+ "name": "_isRevealed",
36126
36047
  "type": {
36127
- "text": "'small' | 'medium' | 'large'"
36048
+ "text": "boolean"
36128
36049
  },
36129
- "default": "'medium'",
36130
- "fieldName": "size"
36050
+ "privacy": "private",
36051
+ "default": "false"
36131
36052
  },
36132
36053
  {
36133
- "name": "getSymbol",
36054
+ "kind": "field",
36055
+ "name": "_isToggled",
36134
36056
  "type": {
36135
- "text": "(value: number) => string"
36057
+ "text": "boolean"
36136
36058
  },
36137
- "fieldName": "getSymbol"
36059
+ "privacy": "private",
36060
+ "default": "false"
36061
+ },
36062
+ {
36063
+ "kind": "field",
36064
+ "name": "_hideTimer",
36065
+ "type": {
36066
+ "text": "ReturnType<typeof setTimeout> | undefined"
36067
+ },
36068
+ "privacy": "private"
36069
+ },
36070
+ {
36071
+ "kind": "method",
36072
+ "name": "_clearHideTimer",
36073
+ "privacy": "private"
36074
+ },
36075
+ {
36076
+ "kind": "method",
36077
+ "name": "handleToggleReveal",
36078
+ "privacy": "protected"
36079
+ },
36080
+ {
36081
+ "kind": "method",
36082
+ "name": "handleMouseEnter",
36083
+ "privacy": "protected"
36084
+ },
36085
+ {
36086
+ "kind": "method",
36087
+ "name": "handleMouseLeave",
36088
+ "privacy": "protected"
36089
+ }
36090
+ ],
36091
+ "events": [
36092
+ {
36093
+ "description": "Emitted as an example.",
36094
+ "name": "zn-event-name"
36095
+ }
36096
+ ],
36097
+ "attributes": [
36098
+ {
36099
+ "name": "duration",
36100
+ "type": {
36101
+ "text": "number"
36102
+ },
36103
+ "default": "2000",
36104
+ "fieldName": "duration"
36105
+ },
36106
+ {
36107
+ "name": "initial",
36108
+ "type": {
36109
+ "text": "string"
36110
+ },
36111
+ "default": "''",
36112
+ "fieldName": "initial"
36113
+ },
36114
+ {
36115
+ "name": "revealed",
36116
+ "type": {
36117
+ "text": "string"
36118
+ },
36119
+ "default": "''",
36120
+ "fieldName": "revealed"
36121
+ },
36122
+ {
36123
+ "name": "hide-delay",
36124
+ "type": {
36125
+ "text": "number"
36126
+ },
36127
+ "default": "150",
36128
+ "fieldName": "hideDelay"
36129
+ },
36130
+ {
36131
+ "name": "no-toggle",
36132
+ "type": {
36133
+ "text": "boolean"
36134
+ },
36135
+ "default": "false",
36136
+ "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
36137
+ "fieldName": "noToggle"
36138
36138
  }
36139
36139
  ],
36140
36140
  "superclass": {
@@ -36142,11 +36142,11 @@
36142
36142
  "module": "/src/internal/zinc-element"
36143
36143
  },
36144
36144
  "summary": "Short summary of the component's intended use.",
36145
- "tagNameWithoutPrefix": "rating",
36146
- "tagName": "zn-rating",
36145
+ "tagNameWithoutPrefix": "reveal",
36146
+ "tagName": "zn-reveal",
36147
36147
  "customElement": true,
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",
36148
+ "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 */",
36149
+ "documentation": "https://zinc.style/components/reveal",
36150
36150
  "status": "experimental",
36151
36151
  "since": "1.0",
36152
36152
  "dependencies": [
@@ -36159,8 +36159,8 @@
36159
36159
  "kind": "js",
36160
36160
  "name": "default",
36161
36161
  "declaration": {
36162
- "name": "ZnRating",
36163
- "module": "components/rating/rating.js"
36162
+ "name": "ZnReveal",
36163
+ "module": "components/reveal/reveal.js"
36164
36164
  }
36165
36165
  }
36166
36166
  ]
@@ -50889,7 +50889,7 @@
50889
50889
  "package": {
50890
50890
  "name": "@kubex/zinc",
50891
50891
  "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
50892
- "version": "1.1.107",
50892
+ "version": "1.1.109",
50893
50893
  "author": "",
50894
50894
  "license": "MIT"
50895
50895
  }