@kubex/zinc 1.1.12 → 1.1.13

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.
@@ -13,6 +13,17 @@
13
13
  }
14
14
  ]
15
15
  },
16
+ {
17
+ "name": "zn-action-bar",
18
+ "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
19
+ "attributes": [],
20
+ "references": [
21
+ {
22
+ "name": "Documentation",
23
+ "url": "https://zinc.style/components/action-bar"
24
+ }
25
+ ]
26
+ },
16
27
  {
17
28
  "name": "zn-alert",
18
29
  "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -52,17 +63,6 @@
52
63
  }
53
64
  ]
54
65
  },
55
- {
56
- "name": "zn-action-bar",
57
- "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
58
- "attributes": [],
59
- "references": [
60
- {
61
- "name": "Documentation",
62
- "url": "https://zinc.style/components/action-bar"
63
- }
64
- ]
65
- },
66
66
  {
67
67
  "name": "zn-animated-button",
68
68
  "description": "\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -324,6 +324,109 @@
324
324
  }
325
325
  ]
326
326
  },
327
+ {
328
+ "name": "zn-channel-tile",
329
+ "description": "A channel/queue slot tile with two faces: an active (occupied) state\nshowing an in-progress item, and an available (empty) state advertising\ncapacity — optionally reserving an incoming item with an auto-accept countdown.\n---\n\n\n### **Events:**\n - **zn-accept** - Emitted when an available tile is accepted (click or auto-accept). Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch.\n- **zn-reject** - Emitted when the reject control is pressed.\n\n### **Slots:**\n - **leading** - Replaces the leading icon in the active state.\n- **action** - Action content for the available state (e.g. a form). Falls back to a default accept button.\n- **footer** - Trailing content (e.g. status badges) in the active state.\n\n### **CSS Properties:**\n - **--channel-tile-color** - Resolved accent color (set from the `color` property). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **progress** - The progress indicator (incoming countdown overlay or active progress bar).",
330
+ "attributes": [
331
+ {
332
+ "name": "available",
333
+ "description": "Renders the empty/available face instead of the active face.",
334
+ "values": []
335
+ },
336
+ {
337
+ "name": "incoming",
338
+ "description": "(Available only) the tile is reserving an incoming item awaiting acceptance.",
339
+ "values": []
340
+ },
341
+ {
342
+ "name": "variant",
343
+ "description": "Free-form grouping/theming key (reflected so consumers can query/style by it).",
344
+ "values": []
345
+ },
346
+ {
347
+ "name": "header",
348
+ "description": "Top-bar text (e.g. brand).",
349
+ "values": []
350
+ },
351
+ {
352
+ "name": "icon",
353
+ "description": "Leading icon (active state).",
354
+ "values": []
355
+ },
356
+ {
357
+ "name": "color",
358
+ "description": "Accent color driving the leading icon and `--channel-tile-color`.",
359
+ "values": [{ "name": "ChannelTileColor" }]
360
+ },
361
+ {
362
+ "name": "title",
363
+ "description": "Primary line. Defaults to \"Available\" in the available state when unset.",
364
+ "values": []
365
+ },
366
+ { "name": "subtitle", "description": "Secondary line.", "values": [] },
367
+ {
368
+ "name": "progress",
369
+ "description": "(Active only) progress bar fill, 0–100.",
370
+ "values": []
371
+ },
372
+ {
373
+ "name": "progress-color",
374
+ "description": "(Active only) CSS color for the progress bar fill.",
375
+ "values": []
376
+ },
377
+ {
378
+ "name": "fid",
379
+ "description": "Identifier carried in `zn-accept` / `zn-reject` event details.",
380
+ "values": []
381
+ },
382
+ {
383
+ "name": "accept-uri",
384
+ "description": "(Available only) when set, accepting fetches this URI unless `zn-accept` is canceled.",
385
+ "values": []
386
+ },
387
+ {
388
+ "name": "reserved-until",
389
+ "description": "(Available/incoming) epoch (seconds or millis) at which the reservation window ends.",
390
+ "values": []
391
+ },
392
+ {
393
+ "name": "auto-accept-delay",
394
+ "description": "(Available/incoming) auto-accept window length in milliseconds.",
395
+ "values": []
396
+ },
397
+ {
398
+ "name": "rejectable",
399
+ "description": "(Available/incoming) whether a reject control is offered.",
400
+ "values": []
401
+ },
402
+ {
403
+ "name": "accept-icon",
404
+ "description": "Icon for the built-in accept button.",
405
+ "values": []
406
+ },
407
+ {
408
+ "name": "accept-gaid",
409
+ "description": "Optional analytics id forwarded to the built-in accept button.",
410
+ "values": []
411
+ },
412
+ {
413
+ "name": "reject-icon",
414
+ "description": "Icon for the reject control.",
415
+ "values": []
416
+ },
417
+ {
418
+ "name": "reject-label",
419
+ "description": "Accessible label for the reject control.",
420
+ "values": []
421
+ }
422
+ ],
423
+ "references": [
424
+ {
425
+ "name": "Documentation",
426
+ "url": "https://zinc.style/components/channel-tile"
427
+ }
428
+ ]
429
+ },
327
430
  {
328
431
  "name": "zn-chart",
329
432
  "description": "Chart component powered by Apache ECharts.\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -2448,82 +2551,6 @@
2448
2551
  }
2449
2552
  ]
2450
2553
  },
2451
- {
2452
- "name": "zn-priority-list",
2453
- "description": "A reorderable list where each item receives a numerical priority based on its position. Supports drag-and-drop\nand keyboard reordering. Priority values are submitted as form data via hidden inputs.\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when the order of items changes.\n- **zn-reorder** - Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.\n\n### **Methods:**\n - **getPriorityMap(): _PriorityItem[]_** - Returns the priority map: an array of { key, priority } objects.\n- **checkValidity(): _boolean_** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(_message)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing).\n- **label** - The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.\n- **label-tooltip** - Used to add text displayed in a tooltip next to the label.\n- **help-text** - Text that describes how to use the component. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-priority-list-item-gap** - The gap between list items. Defaults to `var(--zn-spacing-2x-small)`. _(default: undefined)_\n- **--zn-priority-list-item-padding** - The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`. _(default: undefined)_\n- **--zn-priority-list-handle-color** - The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`. _(default: undefined)_\n- **--zn-priority-list-priority-color** - The color of the priority number. Defaults to `var(--zn-color-neutral-600)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control wrapper.\n- **form-control-label** - The label wrapper.\n- **form-control-input** - The input area wrapper.\n- **form-control-help-text** - The help text wrapper.\n- **list** - The list container.\n- **item** - An individual list item row.\n- **drag-handle** - The drag handle icon.\n- **priority** - The priority number badge.\n- **content** - The content area of an item.",
2454
- "attributes": [
2455
- {
2456
- "name": "name",
2457
- "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
2458
- "values": []
2459
- },
2460
- {
2461
- "name": "value",
2462
- "description": "The current ordered list of item keys, reflecting the visual order. This is the source of truth for ordering.\nEach entry should match a `value` attribute on a slotted child element.",
2463
- "values": [{ "name": "string[]" }]
2464
- },
2465
- {
2466
- "name": "label",
2467
- "description": "The component's label. Required for proper accessibility.",
2468
- "values": []
2469
- },
2470
- {
2471
- "name": "label-tooltip",
2472
- "description": "Text that appears in a tooltip next to the label.",
2473
- "values": []
2474
- },
2475
- {
2476
- "name": "help-text",
2477
- "description": "Help text that describes how to use the component.",
2478
- "values": []
2479
- },
2480
- {
2481
- "name": "form",
2482
- "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
2483
- "values": []
2484
- },
2485
- {
2486
- "name": "size",
2487
- "description": "The size of the list items.",
2488
- "values": [
2489
- { "name": "small" },
2490
- { "name": "medium" },
2491
- { "name": "large" }
2492
- ]
2493
- },
2494
- {
2495
- "name": "disabled",
2496
- "description": "Whether the priority list is disabled.",
2497
- "values": []
2498
- },
2499
- {
2500
- "name": "required",
2501
- "description": "Ensures the form control has a value before allowing submission.",
2502
- "values": []
2503
- },
2504
- {
2505
- "name": "priority-start",
2506
- "description": "The starting priority number. Defaults to 1.",
2507
- "values": []
2508
- },
2509
- {
2510
- "name": "formaction",
2511
- "description": "When set, the associated form will be submitted with the given action URL whenever items are reordered.\nIf set to an empty string, the form will be submitted using its existing action.",
2512
- "values": []
2513
- },
2514
- {
2515
- "name": "order",
2516
- "description": "A comma-separated list of item keys defining the initial display order.\nKeys must match the `value` attributes on slotted children.\nAny slotted items not listed are appended at the end in DOM order.",
2517
- "values": []
2518
- }
2519
- ],
2520
- "references": [
2521
- {
2522
- "name": "Documentation",
2523
- "url": "https://zinc.style/components/priority-list"
2524
- }
2525
- ]
2526
- },
2527
2554
  {
2528
2555
  "name": "zn-popup",
2529
2556
  "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -2673,6 +2700,82 @@
2673
2700
  }
2674
2701
  ]
2675
2702
  },
2703
+ {
2704
+ "name": "zn-priority-list",
2705
+ "description": "A reorderable list where each item receives a numerical priority based on its position. Supports drag-and-drop\nand keyboard reordering. Priority values are submitted as form data via hidden inputs.\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when the order of items changes.\n- **zn-reorder** - Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.\n\n### **Methods:**\n - **getPriorityMap(): _PriorityItem[]_** - Returns the priority map: an array of { key, priority } objects.\n- **checkValidity(): _boolean_** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(_message)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing).\n- **label** - The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.\n- **label-tooltip** - Used to add text displayed in a tooltip next to the label.\n- **help-text** - Text that describes how to use the component. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-priority-list-item-gap** - The gap between list items. Defaults to `var(--zn-spacing-2x-small)`. _(default: undefined)_\n- **--zn-priority-list-item-padding** - The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`. _(default: undefined)_\n- **--zn-priority-list-handle-color** - The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`. _(default: undefined)_\n- **--zn-priority-list-priority-color** - The color of the priority number. Defaults to `var(--zn-color-neutral-600)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control wrapper.\n- **form-control-label** - The label wrapper.\n- **form-control-input** - The input area wrapper.\n- **form-control-help-text** - The help text wrapper.\n- **list** - The list container.\n- **item** - An individual list item row.\n- **drag-handle** - The drag handle icon.\n- **priority** - The priority number badge.\n- **content** - The content area of an item.",
2706
+ "attributes": [
2707
+ {
2708
+ "name": "name",
2709
+ "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
2710
+ "values": []
2711
+ },
2712
+ {
2713
+ "name": "value",
2714
+ "description": "The current ordered list of item keys, reflecting the visual order. This is the source of truth for ordering.\nEach entry should match a `value` attribute on a slotted child element.",
2715
+ "values": [{ "name": "string[]" }]
2716
+ },
2717
+ {
2718
+ "name": "label",
2719
+ "description": "The component's label. Required for proper accessibility.",
2720
+ "values": []
2721
+ },
2722
+ {
2723
+ "name": "label-tooltip",
2724
+ "description": "Text that appears in a tooltip next to the label.",
2725
+ "values": []
2726
+ },
2727
+ {
2728
+ "name": "help-text",
2729
+ "description": "Help text that describes how to use the component.",
2730
+ "values": []
2731
+ },
2732
+ {
2733
+ "name": "form",
2734
+ "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
2735
+ "values": []
2736
+ },
2737
+ {
2738
+ "name": "size",
2739
+ "description": "The size of the list items.",
2740
+ "values": [
2741
+ { "name": "small" },
2742
+ { "name": "medium" },
2743
+ { "name": "large" }
2744
+ ]
2745
+ },
2746
+ {
2747
+ "name": "disabled",
2748
+ "description": "Whether the priority list is disabled.",
2749
+ "values": []
2750
+ },
2751
+ {
2752
+ "name": "required",
2753
+ "description": "Ensures the form control has a value before allowing submission.",
2754
+ "values": []
2755
+ },
2756
+ {
2757
+ "name": "priority-start",
2758
+ "description": "The starting priority number. Defaults to 1.",
2759
+ "values": []
2760
+ },
2761
+ {
2762
+ "name": "formaction",
2763
+ "description": "When set, the associated form will be submitted with the given action URL whenever items are reordered.\nIf set to an empty string, the form will be submitted using its existing action.",
2764
+ "values": []
2765
+ },
2766
+ {
2767
+ "name": "order",
2768
+ "description": "A comma-separated list of item keys defining the initial display order.\nKeys must match the `value` attributes on slotted children.\nAny slotted items not listed are appended at the end in DOM order.",
2769
+ "values": []
2770
+ }
2771
+ ],
2772
+ "references": [
2773
+ {
2774
+ "name": "Documentation",
2775
+ "url": "https://zinc.style/components/priority-list"
2776
+ }
2777
+ ]
2778
+ },
2676
2779
  {
2677
2780
  "name": "zn-progress-bar",
2678
2781
  "description": "Progress bars provide visual feedback about the completion status of a task or process.\n---\n\n\n### **CSS Properties:**\n - **--zn-border-color** - The color of the progress bar background track. _(default: undefined)_\n- **--zn-progress-bar-color** - The color of the progress bar fill. _(default: undefined)_\n- **--zn-text-heading** - The color of the caption text. _(default: undefined)_\n- **--zn-text** - The color of the progress percentage and description text. _(default: undefined)_\n- **--zn-spacing-x-small** - The spacing between header/footer and the progress bar. _(default: undefined)_\n\n### **CSS Parts:**\n - **header** - The header container that contains the caption and progress text.\n- **caption** - The caption text element.\n- **progress** - The progress percentage text element.\n- **bar** - The SVG element containing the progress bar.\n- **track** - The background track of the progress bar.\n- **fill** - The filled portion of the progress bar indicating progress.\n- **footer** - The footer container that contains the description.\n- **info** - The description text element.",