@websublime/line-components 0.1.4 → 0.2.0

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.
Files changed (2) hide show
  1. package/custom-elements.json +1294 -0
  2. package/package.json +9 -5
@@ -0,0 +1,1294 @@
1
+ {
2
+ "schemaVersion": "1.0.0",
3
+ "readme": "",
4
+ "modules": [
5
+ {
6
+ "kind": "javascript-module",
7
+ "path": "src/index.ts",
8
+ "declarations": [],
9
+ "exports": []
10
+ },
11
+ {
12
+ "kind": "javascript-module",
13
+ "path": "../line-core/src/form-associated.ts",
14
+ "declarations": [
15
+ {
16
+ "kind": "mixin",
17
+ "description": "FormAssociated mixin (D5). Makes a `LineElement` a form-associated custom\nelement backed by `ElementInternals`.\n\nSets `static formAssociated = true` and forwards the form API\n(`setFormValue`, `setValidity`, `reportValidity`, `checkValidity`, `form`,\n`validity`, `validationMessage`, `willValidate`) to the internals that\n`LineElement` attached, through `this[INTERNALS]`. `name` reads the host\nattribute and `type` is the local name. State reflection is the\n`LineElement` `reflectState` body.\n\nOpt-in per component: `class LineInput extends FormAssociated(LineElement) {}`.\nSub-classes implement the form lifecycle callbacks they need. The root entry\nexports it, and `./mixins/form-associated` re-exports it through the bare\nself-reference `@websublime/line-core` instead of a relative copy, so both\nspecifiers share one `INTERNALS` Symbol wherever that name resolves to the\nroot module: through `exports` in a bundler, on jsDelivr `+esm` only when\nevery URL names the same exact version, and on unpkg raw through the import\nmap's `@websublime/line-core` entry (spec §7.7; P6 checks both CDN paths).",
18
+ "name": "FormAssociated",
19
+ "members": [
20
+ {
21
+ "kind": "field",
22
+ "name": "formAssociated",
23
+ "static": true,
24
+ "default": "true",
25
+ "type": {
26
+ "text": "true"
27
+ }
28
+ },
29
+ {
30
+ "kind": "method",
31
+ "name": "setFormValue",
32
+ "return": {
33
+ "type": {
34
+ "text": "void"
35
+ }
36
+ },
37
+ "parameters": [
38
+ {
39
+ "name": "value",
40
+ "type": {
41
+ "text": "FormValue"
42
+ }
43
+ },
44
+ {
45
+ "name": "state",
46
+ "optional": true,
47
+ "type": {
48
+ "text": "FormValue"
49
+ }
50
+ }
51
+ ]
52
+ },
53
+ {
54
+ "kind": "method",
55
+ "name": "setValidity",
56
+ "return": {
57
+ "type": {
58
+ "text": "void"
59
+ }
60
+ },
61
+ "parameters": [
62
+ {
63
+ "name": "flags",
64
+ "type": {
65
+ "text": "ValidityStateFlags"
66
+ }
67
+ },
68
+ {
69
+ "name": "message",
70
+ "optional": true,
71
+ "type": {
72
+ "text": "string"
73
+ }
74
+ },
75
+ {
76
+ "name": "anchor",
77
+ "optional": true,
78
+ "type": {
79
+ "text": "HTMLElement"
80
+ }
81
+ }
82
+ ]
83
+ },
84
+ {
85
+ "kind": "method",
86
+ "name": "reportValidity",
87
+ "return": {
88
+ "type": {
89
+ "text": "boolean"
90
+ }
91
+ }
92
+ },
93
+ {
94
+ "kind": "method",
95
+ "name": "checkValidity",
96
+ "return": {
97
+ "type": {
98
+ "text": "boolean"
99
+ }
100
+ }
101
+ },
102
+ {
103
+ "kind": "field",
104
+ "name": "form",
105
+ "type": {
106
+ "text": "HTMLFormElement | null"
107
+ },
108
+ "readonly": true
109
+ },
110
+ {
111
+ "kind": "field",
112
+ "name": "name",
113
+ "type": {
114
+ "text": "string | null"
115
+ },
116
+ "readonly": true
117
+ },
118
+ {
119
+ "kind": "field",
120
+ "name": "type",
121
+ "type": {
122
+ "text": "string"
123
+ },
124
+ "readonly": true
125
+ },
126
+ {
127
+ "kind": "field",
128
+ "name": "validity",
129
+ "type": {
130
+ "text": "ValidityState"
131
+ },
132
+ "readonly": true
133
+ },
134
+ {
135
+ "kind": "field",
136
+ "name": "validationMessage",
137
+ "type": {
138
+ "text": "string"
139
+ },
140
+ "readonly": true
141
+ },
142
+ {
143
+ "kind": "field",
144
+ "name": "willValidate",
145
+ "type": {
146
+ "text": "boolean"
147
+ },
148
+ "readonly": true
149
+ },
150
+ {
151
+ "kind": "method",
152
+ "name": "formAssociatedCallback",
153
+ "return": {
154
+ "type": {
155
+ "text": "void"
156
+ }
157
+ },
158
+ "parameters": [
159
+ {
160
+ "name": "form",
161
+ "type": {
162
+ "text": "HTMLFormElement | null"
163
+ }
164
+ }
165
+ ]
166
+ },
167
+ {
168
+ "kind": "method",
169
+ "name": "formDisabledCallback",
170
+ "return": {
171
+ "type": {
172
+ "text": "void"
173
+ }
174
+ },
175
+ "parameters": [
176
+ {
177
+ "name": "disabled",
178
+ "type": {
179
+ "text": "boolean"
180
+ }
181
+ }
182
+ ]
183
+ },
184
+ {
185
+ "kind": "method",
186
+ "name": "formResetCallback",
187
+ "return": {
188
+ "type": {
189
+ "text": "void"
190
+ }
191
+ }
192
+ },
193
+ {
194
+ "kind": "method",
195
+ "name": "formStateRestoreCallback",
196
+ "return": {
197
+ "type": {
198
+ "text": "void"
199
+ }
200
+ },
201
+ "parameters": [
202
+ {
203
+ "name": "state",
204
+ "type": {
205
+ "text": "FormValue"
206
+ }
207
+ },
208
+ {
209
+ "name": "reason",
210
+ "type": {
211
+ "text": "'autocomplete' | 'restore'"
212
+ }
213
+ }
214
+ ]
215
+ }
216
+ ],
217
+ "parameters": [
218
+ {
219
+ "name": "Base",
220
+ "type": {
221
+ "text": "T"
222
+ }
223
+ }
224
+ ]
225
+ }
226
+ ],
227
+ "exports": [
228
+ {
229
+ "kind": "js",
230
+ "name": "FormAssociated",
231
+ "declaration": {
232
+ "name": "FormAssociated",
233
+ "module": "../line-core/src/form-associated.ts"
234
+ }
235
+ }
236
+ ]
237
+ },
238
+ {
239
+ "kind": "javascript-module",
240
+ "path": "../line-core/src/index.ts",
241
+ "declarations": [],
242
+ "exports": [
243
+ {
244
+ "kind": "js",
245
+ "name": "FormAssociated",
246
+ "declaration": {
247
+ "name": "FormAssociated",
248
+ "module": "./form-associated.js"
249
+ }
250
+ },
251
+ {
252
+ "kind": "js",
253
+ "name": "FormAssociatedMembers",
254
+ "declaration": {
255
+ "name": "FormAssociatedMembers",
256
+ "module": "./form-associated.js"
257
+ }
258
+ },
259
+ {
260
+ "kind": "js",
261
+ "name": "INTERNALS",
262
+ "declaration": {
263
+ "name": "INTERNALS",
264
+ "module": "./internals.js"
265
+ }
266
+ },
267
+ {
268
+ "kind": "js",
269
+ "name": "LineElement",
270
+ "declaration": {
271
+ "name": "LineElement",
272
+ "module": "./line-element.js"
273
+ }
274
+ }
275
+ ]
276
+ },
277
+ {
278
+ "kind": "javascript-module",
279
+ "path": "../line-core/src/internals.ts",
280
+ "declarations": [
281
+ {
282
+ "kind": "variable",
283
+ "name": "INTERNALS",
284
+ "description": "Key of the `ElementInternals` accessor on the `LineElement` prototype. Subclasses and mixins reach the\nelement's internals as `this[INTERNALS]`; no public `internals` property exists.\n\nA plain `Symbol`, not `Symbol.for`, so only code that imports it can reach the internals. Its\ndescription is `line.internals`, never `internals` or `privateInternals`: axe-core looks up an element's\ninternals through own-property symbols with those two descriptions, and the prototype accessor with this\ndescription keeps every line://ui element outside that lookup. This module imports nothing, so\n`line-element.ts`, `form-associated.ts` and `index.ts` share it without an import cycle."
285
+ }
286
+ ],
287
+ "exports": [
288
+ {
289
+ "kind": "js",
290
+ "name": "INTERNALS",
291
+ "declaration": {
292
+ "name": "INTERNALS",
293
+ "module": "../line-core/src/internals.ts"
294
+ }
295
+ }
296
+ ]
297
+ },
298
+ {
299
+ "kind": "javascript-module",
300
+ "path": "../line-core/src/line-element.ts",
301
+ "declarations": [
302
+ {
303
+ "kind": "class",
304
+ "description": "`LineElement` — the base class for every line://ui web component.\n\nComposes the Inspector, Metadata, and Direction mixins over `LitElement`.\nPer spec §6.D.1 it intentionally:\n\n- **does NOT** auto-inject `commonReset` (every component declares its\n resets explicitly — ARCHITECTURE §14.6 invariant), and\n- **does NOT** bake in `FormAssociated` (that mixin is opt-in per component,\n e.g. `class LineInput extends FormAssociated(LineElement) {}`), so it never\n sets `formAssociated`.\n\nEvery element attaches its `ElementInternals` once, in its constructor, and\nkeeps them private; subclasses and mixins reach them as `this[INTERNALS]`.\n`reflectState` writes machine state to the host as `data-<state>` and\n`:state(<state>)` (ARCHITECTURE §14.8).",
305
+ "name": "LineElement",
306
+ "members": [
307
+ {
308
+ "kind": "field",
309
+ "name": "version",
310
+ "type": {
311
+ "text": "string"
312
+ },
313
+ "static": true,
314
+ "default": "'0.0.0'",
315
+ "description": "Static version string surfaced by the Inspector mixin.",
316
+ "inheritedFrom": {
317
+ "name": "MetadataMixin",
318
+ "module": "../line-core/src/mixins/metadata.ts"
319
+ }
320
+ },
321
+ {
322
+ "kind": "field",
323
+ "name": "#internals",
324
+ "privacy": "private",
325
+ "type": {
326
+ "text": "ElementInternals"
327
+ }
328
+ },
329
+ {
330
+ "kind": "field",
331
+ "name": "[INTERNALS]",
332
+ "type": {
333
+ "text": "ElementInternals"
334
+ },
335
+ "privacy": "protected",
336
+ "description": "The element's `ElementInternals`, attached once in the constructor (spec §6.C.2, SD19).",
337
+ "readonly": true
338
+ },
339
+ {
340
+ "kind": "method",
341
+ "name": "reflectState",
342
+ "privacy": "protected",
343
+ "return": {
344
+ "type": {
345
+ "text": "void"
346
+ }
347
+ },
348
+ "parameters": [
349
+ {
350
+ "name": "name",
351
+ "type": {
352
+ "text": "string"
353
+ }
354
+ },
355
+ {
356
+ "name": "active",
357
+ "type": {
358
+ "text": "boolean"
359
+ }
360
+ }
361
+ ],
362
+ "description": "Reflects machine state `name` on the host as the attribute `data-<name>`\nand the custom state `:state(<name>)`, both verbatim, so a kebab-case name\nsuch as `focus-visible` keeps its spelling. The custom state is skipped\nwhere the internals have no `states`."
363
+ },
364
+ {
365
+ "kind": "field",
366
+ "name": "properties",
367
+ "type": {
368
+ "text": "PropertyDeclarations"
369
+ },
370
+ "static": true,
371
+ "default": "{ direction: { attribute: false, noAccessor: true }, }",
372
+ "description": "`direction` is reactive but owns its accessor and has no attribute.",
373
+ "inheritedFrom": {
374
+ "name": "DirectionMixin",
375
+ "module": "../line-core/src/mixins/direction.ts"
376
+ }
377
+ },
378
+ {
379
+ "kind": "field",
380
+ "name": "#direction",
381
+ "privacy": "private",
382
+ "type": {
383
+ "text": "Direction"
384
+ },
385
+ "default": "'ltr'",
386
+ "inheritedFrom": {
387
+ "name": "DirectionMixin",
388
+ "module": "../line-core/src/mixins/direction.ts"
389
+ }
390
+ },
391
+ {
392
+ "kind": "field",
393
+ "name": "#recomputeDirection",
394
+ "privacy": "private",
395
+ "readonly": true,
396
+ "inheritedFrom": {
397
+ "name": "DirectionMixin",
398
+ "module": "../line-core/src/mixins/direction.ts"
399
+ }
400
+ },
401
+ {
402
+ "kind": "field",
403
+ "name": "direction",
404
+ "privacy": "public",
405
+ "type": {
406
+ "text": "Direction"
407
+ },
408
+ "description": "Resolved text direction of the host.",
409
+ "readonly": true,
410
+ "inheritedFrom": {
411
+ "name": "DirectionMixin",
412
+ "module": "../line-core/src/mixins/direction.ts"
413
+ }
414
+ },
415
+ {
416
+ "kind": "field",
417
+ "name": "docs",
418
+ "type": {
419
+ "text": "string"
420
+ },
421
+ "static": true,
422
+ "default": "''",
423
+ "description": "Documentation URL. Surfaced by the Inspector as `data-line-docs` when set.",
424
+ "inheritedFrom": {
425
+ "name": "MetadataMixin",
426
+ "module": "../line-core/src/mixins/metadata.ts"
427
+ }
428
+ },
429
+ {
430
+ "kind": "field",
431
+ "name": "qa",
432
+ "type": {
433
+ "text": "string[]"
434
+ },
435
+ "static": true,
436
+ "default": "[]",
437
+ "description": "QA tags for the component.",
438
+ "inheritedFrom": {
439
+ "name": "MetadataMixin",
440
+ "module": "../line-core/src/mixins/metadata.ts"
441
+ }
442
+ },
443
+ {
444
+ "kind": "field",
445
+ "name": "scope",
446
+ "type": {
447
+ "text": "string"
448
+ },
449
+ "static": true,
450
+ "default": "''",
451
+ "description": "Component scope identifier.",
452
+ "inheritedFrom": {
453
+ "name": "MetadataMixin",
454
+ "module": "../line-core/src/mixins/metadata.ts"
455
+ }
456
+ },
457
+ {
458
+ "kind": "field",
459
+ "name": "#inspectorDialog",
460
+ "privacy": "private",
461
+ "type": {
462
+ "text": "HTMLDialogElement | null"
463
+ },
464
+ "default": "null",
465
+ "description": "Active dialog panel while the inspector is enabled, else `null`.",
466
+ "inheritedFrom": {
467
+ "name": "InspectorMixin",
468
+ "module": "../line-core/src/mixins/inspector.ts"
469
+ }
470
+ },
471
+ {
472
+ "kind": "field",
473
+ "name": "#onInspectorKeydown",
474
+ "privacy": "private",
475
+ "readonly": true,
476
+ "description": "Bound keydown handler, retained so it can be removed on disconnect.",
477
+ "inheritedFrom": {
478
+ "name": "InspectorMixin",
479
+ "module": "../line-core/src/mixins/inspector.ts"
480
+ }
481
+ },
482
+ {
483
+ "kind": "method",
484
+ "name": "#activateInspector",
485
+ "privacy": "private",
486
+ "return": {
487
+ "type": {
488
+ "text": "void"
489
+ }
490
+ },
491
+ "description": "Wire activation marker, host metadata attributes, the hotkey, and the\ndev-only hover-outline stylesheet.",
492
+ "inheritedFrom": {
493
+ "name": "InspectorMixin",
494
+ "module": "../line-core/src/mixins/inspector.ts"
495
+ }
496
+ },
497
+ {
498
+ "kind": "method",
499
+ "name": "#deactivateInspector",
500
+ "privacy": "private",
501
+ "return": {
502
+ "type": {
503
+ "text": "void"
504
+ }
505
+ },
506
+ "description": "Remove the hotkey, tear down the dialog, drop host attributes, and remove\nthe dev-only hover-outline sheet so the active path leaks nothing.",
507
+ "inheritedFrom": {
508
+ "name": "InspectorMixin",
509
+ "module": "../line-core/src/mixins/inspector.ts"
510
+ }
511
+ },
512
+ {
513
+ "kind": "method",
514
+ "name": "#inspectorRoot",
515
+ "privacy": "private",
516
+ "return": {
517
+ "type": {
518
+ "text": "ShadowRoot | null"
519
+ }
520
+ },
521
+ "description": "The shadow root that carries `adoptedStyleSheets`, or `null`.",
522
+ "inheritedFrom": {
523
+ "name": "InspectorMixin",
524
+ "module": "../line-core/src/mixins/inspector.ts"
525
+ }
526
+ },
527
+ {
528
+ "kind": "method",
529
+ "name": "#adoptInspectorOutline",
530
+ "privacy": "private",
531
+ "return": {
532
+ "type": {
533
+ "text": "void"
534
+ }
535
+ },
536
+ "description": "Append the singleton hover-outline sheet to the shadow root's\n`adoptedStyleSheets` (idempotent — never duplicated, never replaces the\narray). No-op when the sheet or root is unavailable.",
537
+ "inheritedFrom": {
538
+ "name": "InspectorMixin",
539
+ "module": "../line-core/src/mixins/inspector.ts"
540
+ }
541
+ },
542
+ {
543
+ "kind": "method",
544
+ "name": "#releaseInspectorOutline",
545
+ "privacy": "private",
546
+ "return": {
547
+ "type": {
548
+ "text": "void"
549
+ }
550
+ },
551
+ "description": "Remove the singleton hover-outline sheet from the shadow root's\n`adoptedStyleSheets`, preserving every other adopted sheet.",
552
+ "inheritedFrom": {
553
+ "name": "InspectorMixin",
554
+ "module": "../line-core/src/mixins/inspector.ts"
555
+ }
556
+ },
557
+ {
558
+ "kind": "method",
559
+ "name": "#inspectorVersion",
560
+ "privacy": "private",
561
+ "return": {
562
+ "type": {
563
+ "text": "string"
564
+ }
565
+ },
566
+ "description": "Read the host's static `version`, defaulting to `''` when absent.",
567
+ "inheritedFrom": {
568
+ "name": "InspectorMixin",
569
+ "module": "../line-core/src/mixins/inspector.ts"
570
+ }
571
+ },
572
+ {
573
+ "kind": "method",
574
+ "name": "#inspectorDocs",
575
+ "privacy": "private",
576
+ "return": {
577
+ "type": {
578
+ "text": "string"
579
+ }
580
+ },
581
+ "description": "Read the host's static `docs` URL defensively (D3 may not provide one).",
582
+ "inheritedFrom": {
583
+ "name": "InspectorMixin",
584
+ "module": "../line-core/src/mixins/inspector.ts"
585
+ }
586
+ },
587
+ {
588
+ "kind": "method",
589
+ "name": "#toggleInspectorPanel",
590
+ "privacy": "private",
591
+ "return": {
592
+ "type": {
593
+ "text": "void"
594
+ }
595
+ },
596
+ "description": "Open the panel if closed, close it if already open.",
597
+ "inheritedFrom": {
598
+ "name": "InspectorMixin",
599
+ "module": "../line-core/src/mixins/inspector.ts"
600
+ }
601
+ },
602
+ {
603
+ "kind": "method",
604
+ "name": "#openInspectorPanel",
605
+ "privacy": "private",
606
+ "return": {
607
+ "type": {
608
+ "text": "void"
609
+ }
610
+ },
611
+ "description": "Build (once) and open the `<dialog>` metadata panel in the shadow root.",
612
+ "inheritedFrom": {
613
+ "name": "InspectorMixin",
614
+ "module": "../line-core/src/mixins/inspector.ts"
615
+ }
616
+ }
617
+ ],
618
+ "mixins": [
619
+ {
620
+ "name": "DirectionMixin",
621
+ "module": "/line-core/src/mixins/direction.js"
622
+ },
623
+ {
624
+ "name": "MetadataMixin",
625
+ "module": "/line-core/src/mixins/metadata.js"
626
+ },
627
+ {
628
+ "name": "InspectorMixin",
629
+ "module": "/line-core/src/mixins/inspector.js"
630
+ }
631
+ ],
632
+ "superclass": {
633
+ "name": "LitElement",
634
+ "package": "lit"
635
+ },
636
+ "customElement": true
637
+ }
638
+ ],
639
+ "exports": [
640
+ {
641
+ "kind": "js",
642
+ "name": "LineElement",
643
+ "declaration": {
644
+ "name": "LineElement",
645
+ "module": "../line-core/src/line-element.ts"
646
+ }
647
+ }
648
+ ]
649
+ },
650
+ {
651
+ "kind": "javascript-module",
652
+ "path": "../line-core/src/mixins/direction.ts",
653
+ "declarations": [
654
+ {
655
+ "kind": "mixin",
656
+ "description": "Direction mixin (D4). Adds a read-only `direction` with the host's resolved\ntext direction.\n\nThe value is `this.matches(':dir(rtl)') ? 'rtl' : 'ltr'`, so the engine\nresolves inheritance, author `dir` on the host, and `dir=\"auto\"`. The mixin\nrecomputes it on connect and on any `dir` attribute mutation in the\ndocument, through one `MutationObserver` shared by every connected host. A\nchanged value calls `requestUpdate('direction', oldValue)`.\n\nThe mixin never writes the host `dir` attribute and leaves the native\n`HTMLElement.dir` alone. Component CSS targets RTL with `:host(:dir(rtl))`.\n\nThe observer does not see `dir` changes inside shadow trees, and a text\nchange under `dir=\"auto\"` mutates no attribute. In both cases `direction`\nstays stale until the next document-level `dir` mutation or reconnect.",
657
+ "name": "DirectionMixin",
658
+ "members": [
659
+ {
660
+ "kind": "field",
661
+ "name": "properties",
662
+ "type": {
663
+ "text": "PropertyDeclarations"
664
+ },
665
+ "static": true,
666
+ "default": "{ direction: { attribute: false, noAccessor: true }, }",
667
+ "description": "`direction` is reactive but owns its accessor and has no attribute."
668
+ },
669
+ {
670
+ "kind": "field",
671
+ "name": "#direction",
672
+ "privacy": "private",
673
+ "type": {
674
+ "text": "Direction"
675
+ },
676
+ "default": "'ltr'"
677
+ },
678
+ {
679
+ "kind": "field",
680
+ "name": "#recomputeDirection",
681
+ "privacy": "private",
682
+ "readonly": true
683
+ },
684
+ {
685
+ "kind": "field",
686
+ "name": "direction",
687
+ "privacy": "public",
688
+ "type": {
689
+ "text": "Direction"
690
+ },
691
+ "description": "Resolved text direction of the host.",
692
+ "readonly": true
693
+ }
694
+ ],
695
+ "parameters": [
696
+ {
697
+ "name": "Base",
698
+ "type": {
699
+ "text": "T"
700
+ }
701
+ }
702
+ ]
703
+ }
704
+ ],
705
+ "exports": [
706
+ {
707
+ "kind": "js",
708
+ "name": "DirectionMixin",
709
+ "declaration": {
710
+ "name": "DirectionMixin",
711
+ "module": "../line-core/src/mixins/direction.ts"
712
+ }
713
+ }
714
+ ]
715
+ },
716
+ {
717
+ "kind": "javascript-module",
718
+ "path": "../line-core/src/mixins/form-associated.ts",
719
+ "declarations": [],
720
+ "exports": [
721
+ {
722
+ "kind": "js",
723
+ "name": "FormAssociated",
724
+ "declaration": {
725
+ "name": "FormAssociated",
726
+ "package": "@websublime/line-core"
727
+ }
728
+ },
729
+ {
730
+ "kind": "js",
731
+ "name": "FormAssociatedMembers",
732
+ "declaration": {
733
+ "name": "FormAssociatedMembers",
734
+ "package": "@websublime/line-core"
735
+ }
736
+ }
737
+ ]
738
+ },
739
+ {
740
+ "kind": "javascript-module",
741
+ "path": "../line-core/src/mixins/inspector.ts",
742
+ "declarations": [
743
+ {
744
+ "kind": "mixin",
745
+ "description": "Inspector mixin (D2 — dev-mode element inspection).\n\nGreenfield implementation (spec §6.D.2 / AM-021). There is **no** prior\nin-tree Inspector to preserve; the legacy `<ui-inspector>` custom element was\ndeleted in re-init `939cad2`. Activation is the single contract\n`localStorage.getItem('line-ui:inspector') === 'on'`.\n\nWhen the flag is **unset**, the mixin is a zero-overhead no-op: it adds no\nhost attributes, no listeners, and no inspection behaviour (production path).\n\nWhen the flag is **set to `'on'`**, on connect the mixin:\n- sets `data-line-inspect` on the host — the activation marker that also\n drives the dev-only hover outline (`:host(:hover[data-line-inspect])`) and\n signals that parts/slots are exposed for inspection;\n- adopts a dev-only singleton `CSSStyleSheet` carrying that hover-outline rule\n into the shadow root's `adoptedStyleSheets` (APPENDED, never replacing the\n array — a component's own styles are preserved; ARCHITECTURE §14.6);\n- surfaces the component version as `data-line-version` (read defensively\n from the host's static `version`, default `'0.0.0'` per §6.D.1);\n- surfaces metadata members **defensively** — the docs URL as\n `data-line-docs` only when the Metadata mixin (D3) has provided one\n (D3 is still a stub; D2 ships independently per ORCHESTRATOR_DECISION);\n- installs a `keydown` listener for **`Ctrl+Shift+L`** (`Cmd+Shift+L` on\n macOS — §10/Q5) that toggles a `<dialog>` metadata panel in the shadow\n root, listing the version and any present metadata fields.\n\nOn disconnect the listener, dialog, and outline sheet are torn down so the\nactive path leaks nothing. The file path, export name, and generic signature\nare stable so TypeScript 7.x `tsc --emitDeclarationOnly` emits a\ndeterministic `.d.ts` (D1 constraint).",
746
+ "name": "InspectorMixin",
747
+ "members": [
748
+ {
749
+ "kind": "field",
750
+ "name": "#inspectorDialog",
751
+ "privacy": "private",
752
+ "type": {
753
+ "text": "HTMLDialogElement | null"
754
+ },
755
+ "default": "null",
756
+ "description": "Active dialog panel while the inspector is enabled, else `null`."
757
+ },
758
+ {
759
+ "kind": "field",
760
+ "name": "#onInspectorKeydown",
761
+ "privacy": "private",
762
+ "readonly": true,
763
+ "description": "Bound keydown handler, retained so it can be removed on disconnect."
764
+ },
765
+ {
766
+ "kind": "method",
767
+ "name": "#activateInspector",
768
+ "privacy": "private",
769
+ "return": {
770
+ "type": {
771
+ "text": "void"
772
+ }
773
+ },
774
+ "description": "Wire activation marker, host metadata attributes, the hotkey, and the\ndev-only hover-outline stylesheet."
775
+ },
776
+ {
777
+ "kind": "method",
778
+ "name": "#deactivateInspector",
779
+ "privacy": "private",
780
+ "return": {
781
+ "type": {
782
+ "text": "void"
783
+ }
784
+ },
785
+ "description": "Remove the hotkey, tear down the dialog, drop host attributes, and remove\nthe dev-only hover-outline sheet so the active path leaks nothing."
786
+ },
787
+ {
788
+ "kind": "method",
789
+ "name": "#inspectorRoot",
790
+ "privacy": "private",
791
+ "return": {
792
+ "type": {
793
+ "text": "ShadowRoot | null"
794
+ }
795
+ },
796
+ "description": "The shadow root that carries `adoptedStyleSheets`, or `null`."
797
+ },
798
+ {
799
+ "kind": "method",
800
+ "name": "#adoptInspectorOutline",
801
+ "privacy": "private",
802
+ "return": {
803
+ "type": {
804
+ "text": "void"
805
+ }
806
+ },
807
+ "description": "Append the singleton hover-outline sheet to the shadow root's\n`adoptedStyleSheets` (idempotent — never duplicated, never replaces the\narray). No-op when the sheet or root is unavailable."
808
+ },
809
+ {
810
+ "kind": "method",
811
+ "name": "#releaseInspectorOutline",
812
+ "privacy": "private",
813
+ "return": {
814
+ "type": {
815
+ "text": "void"
816
+ }
817
+ },
818
+ "description": "Remove the singleton hover-outline sheet from the shadow root's\n`adoptedStyleSheets`, preserving every other adopted sheet."
819
+ },
820
+ {
821
+ "kind": "method",
822
+ "name": "#inspectorVersion",
823
+ "privacy": "private",
824
+ "return": {
825
+ "type": {
826
+ "text": "string"
827
+ }
828
+ },
829
+ "description": "Read the host's static `version`, defaulting to `''` when absent."
830
+ },
831
+ {
832
+ "kind": "method",
833
+ "name": "#inspectorDocs",
834
+ "privacy": "private",
835
+ "return": {
836
+ "type": {
837
+ "text": "string"
838
+ }
839
+ },
840
+ "description": "Read the host's static `docs` URL defensively (D3 may not provide one)."
841
+ },
842
+ {
843
+ "kind": "method",
844
+ "name": "#toggleInspectorPanel",
845
+ "privacy": "private",
846
+ "return": {
847
+ "type": {
848
+ "text": "void"
849
+ }
850
+ },
851
+ "description": "Open the panel if closed, close it if already open."
852
+ },
853
+ {
854
+ "kind": "method",
855
+ "name": "#openInspectorPanel",
856
+ "privacy": "private",
857
+ "return": {
858
+ "type": {
859
+ "text": "void"
860
+ }
861
+ },
862
+ "description": "Build (once) and open the `<dialog>` metadata panel in the shadow root."
863
+ }
864
+ ],
865
+ "parameters": [
866
+ {
867
+ "name": "Base",
868
+ "type": {
869
+ "text": "T"
870
+ }
871
+ }
872
+ ]
873
+ }
874
+ ],
875
+ "exports": [
876
+ {
877
+ "kind": "js",
878
+ "name": "InspectorMixin",
879
+ "declaration": {
880
+ "name": "InspectorMixin",
881
+ "module": "../line-core/src/mixins/inspector.ts"
882
+ }
883
+ }
884
+ ]
885
+ },
886
+ {
887
+ "kind": "javascript-module",
888
+ "path": "../line-core/src/mixins/metadata.ts",
889
+ "declarations": [
890
+ {
891
+ "kind": "mixin",
892
+ "description": "Metadata mixin (D3 — static element metadata members).\n\nDeclares the four static metadata members every line://ui component carries\n(spec §6.D.3):\n\n- `version` — the component's semver string (mirrors / defaults the value the\n Inspector mixin surfaces as `data-line-version`).\n- `docs` — a URL string pointing at the component's documentation.\n- `qa` — an array of QA tags (`string[]`).\n- `scope` — a string naming the component's scope.\n\nComponents override the members declaratively, e.g. `static version = '0.1.0'`.\n\nSURFACING the members as host attributes (`data-line-version`,\n`data-line-docs`, …) is the Inspector mixin's (D2) responsibility — it reads\nthese static members defensively off `this.constructor`. This mixin owns the\nDECLARATION only; it does not touch the DOM.\n\nThe file path, export name, and generic signature remain stable from the D1\nstub (`.d.ts`-determinism invariant; the `LineElement` composition chain in\n`line-element.ts` depends on them).",
893
+ "name": "MetadataMixin",
894
+ "members": [
895
+ {
896
+ "kind": "field",
897
+ "name": "version",
898
+ "type": {
899
+ "text": "string"
900
+ },
901
+ "static": true,
902
+ "default": "'0.0.0'",
903
+ "description": "Component semver string. Surfaced by the Inspector as `data-line-version`."
904
+ },
905
+ {
906
+ "kind": "field",
907
+ "name": "docs",
908
+ "type": {
909
+ "text": "string"
910
+ },
911
+ "static": true,
912
+ "default": "''",
913
+ "description": "Documentation URL. Surfaced by the Inspector as `data-line-docs` when set."
914
+ },
915
+ {
916
+ "kind": "field",
917
+ "name": "qa",
918
+ "type": {
919
+ "text": "string[]"
920
+ },
921
+ "static": true,
922
+ "default": "[]",
923
+ "description": "QA tags for the component."
924
+ },
925
+ {
926
+ "kind": "field",
927
+ "name": "scope",
928
+ "type": {
929
+ "text": "string"
930
+ },
931
+ "static": true,
932
+ "default": "''",
933
+ "description": "Component scope identifier."
934
+ }
935
+ ],
936
+ "parameters": [
937
+ {
938
+ "name": "Base",
939
+ "type": {
940
+ "text": "T"
941
+ }
942
+ }
943
+ ]
944
+ }
945
+ ],
946
+ "exports": [
947
+ {
948
+ "kind": "js",
949
+ "name": "MetadataMixin",
950
+ "declaration": {
951
+ "name": "MetadataMixin",
952
+ "module": "../line-core/src/mixins/metadata.ts"
953
+ }
954
+ }
955
+ ]
956
+ },
957
+ {
958
+ "kind": "javascript-module",
959
+ "path": "../line-core/src/styles/index.ts",
960
+ "declarations": [
961
+ {
962
+ "kind": "variable",
963
+ "name": "commonReset"
964
+ },
965
+ {
966
+ "kind": "variable",
967
+ "name": "inputReset"
968
+ },
969
+ {
970
+ "kind": "variable",
971
+ "name": "buttonReset"
972
+ },
973
+ {
974
+ "kind": "variable",
975
+ "name": "textareaReset"
976
+ },
977
+ {
978
+ "kind": "variable",
979
+ "name": "selectReset"
980
+ },
981
+ {
982
+ "kind": "variable",
983
+ "name": "rangeReset"
984
+ },
985
+ {
986
+ "kind": "variable",
987
+ "name": "progressReset"
988
+ },
989
+ {
990
+ "kind": "variable",
991
+ "name": "summaryReset"
992
+ },
993
+ {
994
+ "kind": "variable",
995
+ "name": "fieldsetReset"
996
+ },
997
+ {
998
+ "kind": "variable",
999
+ "name": "tableReset"
1000
+ },
1001
+ {
1002
+ "kind": "variable",
1003
+ "name": "scrollbarReset"
1004
+ }
1005
+ ],
1006
+ "exports": [
1007
+ {
1008
+ "kind": "js",
1009
+ "name": "commonReset",
1010
+ "declaration": {
1011
+ "name": "commonReset",
1012
+ "module": "../line-core/src/styles/index.ts"
1013
+ }
1014
+ },
1015
+ {
1016
+ "kind": "js",
1017
+ "name": "inputReset",
1018
+ "declaration": {
1019
+ "name": "inputReset",
1020
+ "module": "../line-core/src/styles/index.ts"
1021
+ }
1022
+ },
1023
+ {
1024
+ "kind": "js",
1025
+ "name": "buttonReset",
1026
+ "declaration": {
1027
+ "name": "buttonReset",
1028
+ "module": "../line-core/src/styles/index.ts"
1029
+ }
1030
+ },
1031
+ {
1032
+ "kind": "js",
1033
+ "name": "textareaReset",
1034
+ "declaration": {
1035
+ "name": "textareaReset",
1036
+ "module": "../line-core/src/styles/index.ts"
1037
+ }
1038
+ },
1039
+ {
1040
+ "kind": "js",
1041
+ "name": "selectReset",
1042
+ "declaration": {
1043
+ "name": "selectReset",
1044
+ "module": "../line-core/src/styles/index.ts"
1045
+ }
1046
+ },
1047
+ {
1048
+ "kind": "js",
1049
+ "name": "rangeReset",
1050
+ "declaration": {
1051
+ "name": "rangeReset",
1052
+ "module": "../line-core/src/styles/index.ts"
1053
+ }
1054
+ },
1055
+ {
1056
+ "kind": "js",
1057
+ "name": "progressReset",
1058
+ "declaration": {
1059
+ "name": "progressReset",
1060
+ "module": "../line-core/src/styles/index.ts"
1061
+ }
1062
+ },
1063
+ {
1064
+ "kind": "js",
1065
+ "name": "summaryReset",
1066
+ "declaration": {
1067
+ "name": "summaryReset",
1068
+ "module": "../line-core/src/styles/index.ts"
1069
+ }
1070
+ },
1071
+ {
1072
+ "kind": "js",
1073
+ "name": "fieldsetReset",
1074
+ "declaration": {
1075
+ "name": "fieldsetReset",
1076
+ "module": "../line-core/src/styles/index.ts"
1077
+ }
1078
+ },
1079
+ {
1080
+ "kind": "js",
1081
+ "name": "tableReset",
1082
+ "declaration": {
1083
+ "name": "tableReset",
1084
+ "module": "../line-core/src/styles/index.ts"
1085
+ }
1086
+ },
1087
+ {
1088
+ "kind": "js",
1089
+ "name": "scrollbarReset",
1090
+ "declaration": {
1091
+ "name": "scrollbarReset",
1092
+ "module": "../line-core/src/styles/index.ts"
1093
+ }
1094
+ }
1095
+ ]
1096
+ },
1097
+ {
1098
+ "kind": "javascript-module",
1099
+ "path": "../line-core/src/machine/index.ts",
1100
+ "declarations": [],
1101
+ "exports": [
1102
+ {
1103
+ "kind": "js",
1104
+ "name": "Attrs",
1105
+ "declaration": {
1106
+ "name": "Attrs",
1107
+ "package": "@zag-js/vanilla"
1108
+ }
1109
+ },
1110
+ {
1111
+ "kind": "js",
1112
+ "name": "mergeProps",
1113
+ "declaration": {
1114
+ "name": "mergeProps",
1115
+ "package": "@zag-js/vanilla"
1116
+ }
1117
+ },
1118
+ {
1119
+ "kind": "js",
1120
+ "name": "normalizeProps",
1121
+ "declaration": {
1122
+ "name": "normalizeProps",
1123
+ "package": "@zag-js/vanilla"
1124
+ }
1125
+ },
1126
+ {
1127
+ "kind": "js",
1128
+ "name": "spreadProps",
1129
+ "declaration": {
1130
+ "name": "spreadProps",
1131
+ "package": "@zag-js/vanilla"
1132
+ }
1133
+ },
1134
+ {
1135
+ "kind": "js",
1136
+ "name": "VanillaMachine",
1137
+ "declaration": {
1138
+ "name": "VanillaMachine",
1139
+ "package": "@zag-js/vanilla"
1140
+ }
1141
+ },
1142
+ {
1143
+ "kind": "js",
1144
+ "name": "LineMachineController",
1145
+ "declaration": {
1146
+ "name": "LineMachineController",
1147
+ "module": "./line-machine-controller.js"
1148
+ }
1149
+ },
1150
+ {
1151
+ "kind": "js",
1152
+ "name": "LineMachineControllerOptions",
1153
+ "declaration": {
1154
+ "name": "LineMachineControllerOptions",
1155
+ "module": "./line-machine-controller.js"
1156
+ }
1157
+ }
1158
+ ]
1159
+ },
1160
+ {
1161
+ "kind": "javascript-module",
1162
+ "path": "../line-core/src/machine/line-machine-controller.ts",
1163
+ "declarations": [
1164
+ {
1165
+ "kind": "class",
1166
+ "description": "",
1167
+ "name": "LineMachineController",
1168
+ "members": [
1169
+ {
1170
+ "kind": "field",
1171
+ "name": "#host",
1172
+ "privacy": "private",
1173
+ "type": {
1174
+ "text": "ReactiveControllerHost"
1175
+ },
1176
+ "default": "host"
1177
+ },
1178
+ {
1179
+ "kind": "field",
1180
+ "name": "#vanilla",
1181
+ "privacy": "private",
1182
+ "type": {
1183
+ "text": "VanillaMachine<T> | null"
1184
+ },
1185
+ "default": "null"
1186
+ },
1187
+ {
1188
+ "kind": "field",
1189
+ "name": "#unsubscribe",
1190
+ "privacy": "private",
1191
+ "type": {
1192
+ "text": "VoidFunction | null"
1193
+ },
1194
+ "default": "null"
1195
+ },
1196
+ {
1197
+ "kind": "field",
1198
+ "name": "#fallback",
1199
+ "privacy": "private",
1200
+ "type": {
1201
+ "text": "boolean"
1202
+ },
1203
+ "default": "false"
1204
+ },
1205
+ {
1206
+ "kind": "field",
1207
+ "name": "#options",
1208
+ "privacy": "private",
1209
+ "type": {
1210
+ "text": "LineMachineControllerOptions<T>"
1211
+ },
1212
+ "default": "options"
1213
+ },
1214
+ {
1215
+ "kind": "field",
1216
+ "name": "state",
1217
+ "readonly": true
1218
+ },
1219
+ {
1220
+ "kind": "field",
1221
+ "name": "context",
1222
+ "readonly": true
1223
+ },
1224
+ {
1225
+ "kind": "field",
1226
+ "name": "refs",
1227
+ "readonly": true
1228
+ },
1229
+ {
1230
+ "kind": "field",
1231
+ "name": "service",
1232
+ "readonly": true
1233
+ },
1234
+ {
1235
+ "kind": "field",
1236
+ "name": "fallback",
1237
+ "readonly": true
1238
+ },
1239
+ {
1240
+ "kind": "method",
1241
+ "name": "send",
1242
+ "parameters": [
1243
+ {
1244
+ "name": "event",
1245
+ "type": {
1246
+ "text": "Parameters<VanillaMachine<T>['send']>[0]"
1247
+ }
1248
+ }
1249
+ ]
1250
+ },
1251
+ {
1252
+ "kind": "method",
1253
+ "name": "hostConnected",
1254
+ "return": {
1255
+ "type": {
1256
+ "text": "void"
1257
+ }
1258
+ }
1259
+ },
1260
+ {
1261
+ "kind": "method",
1262
+ "name": "hostUpdate",
1263
+ "return": {
1264
+ "type": {
1265
+ "text": "void"
1266
+ }
1267
+ },
1268
+ "description": "Signals the machine before every render that the host props may have changed (D7)."
1269
+ },
1270
+ {
1271
+ "kind": "method",
1272
+ "name": "hostDisconnected",
1273
+ "return": {
1274
+ "type": {
1275
+ "text": "void"
1276
+ }
1277
+ }
1278
+ }
1279
+ ]
1280
+ }
1281
+ ],
1282
+ "exports": [
1283
+ {
1284
+ "kind": "js",
1285
+ "name": "LineMachineController",
1286
+ "declaration": {
1287
+ "name": "LineMachineController",
1288
+ "module": "../line-core/src/machine/line-machine-controller.ts"
1289
+ }
1290
+ }
1291
+ ]
1292
+ }
1293
+ ]
1294
+ }
package/package.json CHANGED
@@ -1,17 +1,19 @@
1
1
  {
2
2
  "name": "@websublime/line-components",
3
- "version": "0.1.4",
3
+ "version": "0.2.0",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "files": [
7
7
  "dist",
8
- "src"
8
+ "src",
9
+ "custom-elements.json"
9
10
  ],
10
11
  "repository": {
11
12
  "type": "git",
12
13
  "url": "git+https://github.com/websublime/line-ui.git",
13
14
  "directory": "packages/line-components"
14
15
  },
16
+ "customElements": "./custom-elements.json",
15
17
  "publishConfig": {
16
18
  "access": "public"
17
19
  },
@@ -19,7 +21,8 @@
19
21
  ".": {
20
22
  "types": "./dist/index.d.ts",
21
23
  "import": "./dist/index.js"
22
- }
24
+ },
25
+ "./custom-elements.json": "./custom-elements.json"
23
26
  },
24
27
  "dependencies": {
25
28
  "@websublime/line-core": "^0.2.1",
@@ -33,9 +36,10 @@
33
36
  "@websublime/line-schemas": "^0.1.1"
34
37
  },
35
38
  "scripts": {
36
- "build": "vite build && tsc -p tsconfig.json --noEmit false --emitDeclarationOnly",
39
+ "build": "vite build && tsc -p tsconfig.json --noEmit false --emitDeclarationOnly && bun run analyze",
40
+ "analyze": "custom-elements-manifest analyze --config custom-elements-manifest.config.mjs",
37
41
  "dev": "trap 'kill 0' INT TERM; vite build --watch & tsc -p tsconfig.json --noEmit false --emitDeclarationOnly --watch & wait",
38
- "clean": "rm -rf dist",
42
+ "clean": "rm -rf dist custom-elements.json",
39
43
  "typecheck": "tsc --noEmit"
40
44
  }
41
45
  }