@g9tm/lynxcontrols-media 2.3.0 → 2.4.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.
@@ -0,0 +1,1235 @@
1
+ {
2
+ "catalogVersion": 1,
3
+ "package": "@g9tm/lynxcontrols-media",
4
+ "version": "2.4.0",
5
+ "generatedBy": "node scripts/check-docs.mjs --write",
6
+ "components": [
7
+ {
8
+ "id": "media.media.G9BlurhashView",
9
+ "export": "G9BlurhashView",
10
+ "from": "@g9tm/lynxcontrols-media",
11
+ "kind": "component",
12
+ "family": "media",
13
+ "summary": "A blurhash placeholder under a photo that fades in on load (one SVG built per hash).",
14
+ "since": null,
15
+ "props": [
16
+ {
17
+ "name": "className",
18
+ "type": {
19
+ "kind": "string"
20
+ },
21
+ "required": false,
22
+ "serializable": true,
23
+ "role": "appearance"
24
+ },
25
+ {
26
+ "name": "hash",
27
+ "type": {
28
+ "kind": "string"
29
+ },
30
+ "required": true,
31
+ "serializable": true,
32
+ "role": "behaviour"
33
+ },
34
+ {
35
+ "name": "height",
36
+ "type": {
37
+ "kind": "union",
38
+ "of": [
39
+ {
40
+ "kind": "string"
41
+ },
42
+ {
43
+ "kind": "number"
44
+ }
45
+ ]
46
+ },
47
+ "required": true,
48
+ "serializable": true,
49
+ "role": "behaviour"
50
+ },
51
+ {
52
+ "name": "id",
53
+ "type": {
54
+ "kind": "string"
55
+ },
56
+ "required": false,
57
+ "serializable": true,
58
+ "role": "identity"
59
+ },
60
+ {
61
+ "name": "mode",
62
+ "type": {
63
+ "kind": "enum",
64
+ "values": [
65
+ "aspectFill",
66
+ "aspectFit"
67
+ ]
68
+ },
69
+ "required": false,
70
+ "serializable": true,
71
+ "role": "behaviour"
72
+ },
73
+ {
74
+ "name": "radius",
75
+ "type": {
76
+ "kind": "number"
77
+ },
78
+ "required": false,
79
+ "serializable": true,
80
+ "role": "appearance"
81
+ },
82
+ {
83
+ "name": "src",
84
+ "type": {
85
+ "kind": "string"
86
+ },
87
+ "required": false,
88
+ "serializable": true,
89
+ "role": "behaviour",
90
+ "doc": "The photo drawn over the placeholder (it fades in when loaded)."
91
+ },
92
+ {
93
+ "name": "width",
94
+ "type": {
95
+ "kind": "union",
96
+ "of": [
97
+ {
98
+ "kind": "string"
99
+ },
100
+ {
101
+ "kind": "number"
102
+ }
103
+ ]
104
+ },
105
+ "required": true,
106
+ "serializable": true,
107
+ "role": "behaviour"
108
+ }
109
+ ],
110
+ "anchor": null,
111
+ "accessibility": {
112
+ "labelFrom": [],
113
+ "labelRequired": false
114
+ },
115
+ "targets": {
116
+ "android": "unmeasured",
117
+ "ios": "unmeasured",
118
+ "windows": "unmeasured",
119
+ "macos": "unmeasured",
120
+ "web": "verified"
121
+ },
122
+ "evidence": {
123
+ "ledger": [
124
+ "N-127"
125
+ ]
126
+ },
127
+ "tokens": [
128
+ "Outline",
129
+ "Primary",
130
+ "PrimaryBorder",
131
+ "PrimaryContainer",
132
+ "ScrimLight",
133
+ "Surface",
134
+ "SurfaceContainer",
135
+ "TextPrimary",
136
+ "TextSecondary",
137
+ "TextTertiary"
138
+ ],
139
+ "example": {
140
+ "line": "<G9BlurhashView hash=\"hash\" height={height} width={width} />",
141
+ "from": "generated"
142
+ }
143
+ },
144
+ {
145
+ "id": "media.media.G9DropZone",
146
+ "export": "G9DropZone",
147
+ "from": "@g9tm/lynxcontrols-media",
148
+ "kind": "component",
149
+ "family": "media",
150
+ "summary": "Two uses: `<G9DropZone label onFiles />` is a tappable area that opens the chooser (the way in on a phone); `<G9DropZone label onFiles>{thread}</G9DropZone>` makes the content the target of files dropped on the window, with a dashed cover while they are dragged over. Without a `files` service the area shows disabled.",
151
+ "since": null,
152
+ "props": [
153
+ {
154
+ "name": "accept",
155
+ "type": {
156
+ "kind": "string"
157
+ },
158
+ "required": false,
159
+ "serializable": true,
160
+ "role": "behaviour"
161
+ },
162
+ {
163
+ "name": "children",
164
+ "type": {
165
+ "kind": "slot",
166
+ "accepts": "any"
167
+ },
168
+ "required": false,
169
+ "serializable": false,
170
+ "role": "slot",
171
+ "doc": "With children: they are the drop target (a chat thread); without: a tappable area."
172
+ },
173
+ {
174
+ "name": "className",
175
+ "type": {
176
+ "kind": "string"
177
+ },
178
+ "required": false,
179
+ "serializable": true,
180
+ "role": "appearance"
181
+ },
182
+ {
183
+ "name": "disabled",
184
+ "type": {
185
+ "kind": "boolean"
186
+ },
187
+ "required": false,
188
+ "serializable": true,
189
+ "role": "state"
190
+ },
191
+ {
192
+ "name": "hint",
193
+ "type": {
194
+ "kind": "string"
195
+ },
196
+ "required": false,
197
+ "serializable": true,
198
+ "role": "content",
199
+ "doc": "A second line in the area."
200
+ },
201
+ {
202
+ "name": "id",
203
+ "type": {
204
+ "kind": "string"
205
+ },
206
+ "required": false,
207
+ "serializable": true,
208
+ "role": "identity"
209
+ },
210
+ {
211
+ "name": "label",
212
+ "type": {
213
+ "kind": "string"
214
+ },
215
+ "required": true,
216
+ "serializable": true,
217
+ "role": "content",
218
+ "doc": "The area's and the cover's text."
219
+ },
220
+ {
221
+ "name": "multiple",
222
+ "type": {
223
+ "kind": "boolean"
224
+ },
225
+ "required": false,
226
+ "default": true,
227
+ "serializable": true,
228
+ "role": "behaviour",
229
+ "doc": "Default true."
230
+ },
231
+ {
232
+ "name": "onFiles",
233
+ "type": {
234
+ "kind": "event",
235
+ "payload": "files: readonly G9FileRef[]"
236
+ },
237
+ "required": true,
238
+ "serializable": false,
239
+ "role": "event"
240
+ },
241
+ {
242
+ "name": "tapToPick",
243
+ "type": {
244
+ "kind": "boolean"
245
+ },
246
+ "required": false,
247
+ "serializable": true,
248
+ "role": "behaviour",
249
+ "doc": "Wrapped content opens the chooser on a tap too."
250
+ }
251
+ ],
252
+ "anchor": null,
253
+ "accessibility": {
254
+ "labelFrom": [
255
+ "label"
256
+ ],
257
+ "labelRequired": false
258
+ },
259
+ "targets": {
260
+ "android": "unmeasured",
261
+ "ios": "unmeasured",
262
+ "windows": "pending",
263
+ "macos": "pending",
264
+ "web": "verified"
265
+ },
266
+ "evidence": {
267
+ "ledger": [
268
+ "N-084",
269
+ "N-127"
270
+ ]
271
+ },
272
+ "tokens": [
273
+ "Outline",
274
+ "Primary",
275
+ "PrimaryBorder",
276
+ "PrimaryContainer",
277
+ "ScrimLight",
278
+ "Surface",
279
+ "SurfaceContainer",
280
+ "TextPrimary",
281
+ "TextSecondary",
282
+ "TextTertiary"
283
+ ],
284
+ "example": {
285
+ "line": "<G9DropZone label=\"Label\" onFiles={() => {}} />",
286
+ "from": "generated"
287
+ }
288
+ },
289
+ {
290
+ "id": "media.media.G9ImageCropper",
291
+ "export": "G9ImageCropper",
292
+ "from": "@g9tm/lynxcontrols-media",
293
+ "kind": "component",
294
+ "family": "media",
295
+ "summary": "Drag to place, − zoom + to scale (a pinch where the host reports it); the crop rectangle in image pixels comes out.",
296
+ "since": null,
297
+ "props": [
298
+ {
299
+ "name": "frame",
300
+ "type": {
301
+ "kind": "object",
302
+ "fields": [
303
+ {
304
+ "name": "width",
305
+ "required": true,
306
+ "type": {
307
+ "kind": "number"
308
+ },
309
+ "serializable": true
310
+ },
311
+ {
312
+ "name": "height",
313
+ "required": true,
314
+ "type": {
315
+ "kind": "number"
316
+ },
317
+ "serializable": true
318
+ }
319
+ ]
320
+ },
321
+ "required": true,
322
+ "serializable": true,
323
+ "role": "behaviour"
324
+ },
325
+ {
326
+ "name": "id",
327
+ "type": {
328
+ "kind": "string"
329
+ },
330
+ "required": false,
331
+ "serializable": true,
332
+ "role": "identity"
333
+ },
334
+ {
335
+ "name": "image",
336
+ "type": {
337
+ "kind": "object",
338
+ "fields": [
339
+ {
340
+ "name": "width",
341
+ "required": true,
342
+ "type": {
343
+ "kind": "number"
344
+ },
345
+ "serializable": true
346
+ },
347
+ {
348
+ "name": "height",
349
+ "required": true,
350
+ "type": {
351
+ "kind": "number"
352
+ },
353
+ "serializable": true
354
+ }
355
+ ]
356
+ },
357
+ "required": true,
358
+ "serializable": true,
359
+ "role": "behaviour"
360
+ },
361
+ {
362
+ "name": "maxZoom",
363
+ "type": {
364
+ "kind": "number"
365
+ },
366
+ "required": false,
367
+ "serializable": true,
368
+ "role": "behaviour"
369
+ },
370
+ {
371
+ "name": "onChange",
372
+ "type": {
373
+ "kind": "event",
374
+ "payload": "crop: { readonly x: number; readonly y: number; readonly width: number; readonly height: number; }, state: G9CropState"
375
+ },
376
+ "required": false,
377
+ "serializable": false,
378
+ "role": "event"
379
+ },
380
+ {
381
+ "name": "round",
382
+ "type": {
383
+ "kind": "boolean"
384
+ },
385
+ "required": false,
386
+ "serializable": true,
387
+ "role": "behaviour",
388
+ "doc": "A round mask (avatars)."
389
+ },
390
+ {
391
+ "name": "src",
392
+ "type": {
393
+ "kind": "string"
394
+ },
395
+ "required": true,
396
+ "serializable": true,
397
+ "role": "behaviour"
398
+ }
399
+ ],
400
+ "anchor": null,
401
+ "accessibility": {
402
+ "labelFrom": [],
403
+ "labelRequired": false
404
+ },
405
+ "targets": {
406
+ "android": "unmeasured",
407
+ "ios": "unmeasured",
408
+ "windows": "unmeasured",
409
+ "macos": "unmeasured",
410
+ "web": "verified"
411
+ },
412
+ "evidence": {
413
+ "ledger": [
414
+ "N-127"
415
+ ]
416
+ },
417
+ "tokens": [
418
+ "Outline",
419
+ "Primary",
420
+ "PrimaryBorder",
421
+ "PrimaryContainer",
422
+ "ScrimLight",
423
+ "Surface",
424
+ "SurfaceContainer",
425
+ "TextPrimary",
426
+ "TextSecondary",
427
+ "TextTertiary"
428
+ ],
429
+ "example": {
430
+ "line": "<G9ImageCropper frame={frame} image={image} src=\"src\" />",
431
+ "from": "generated"
432
+ }
433
+ },
434
+ {
435
+ "id": "media.media.G9Lightbox",
436
+ "export": "G9Lightbox",
437
+ "from": "@g9tm/lynxcontrols-media",
438
+ "kind": "component",
439
+ "family": "media",
440
+ "summary": "The photos full screen on black: swipe between them (Lynx's native `<viewpager>`, snapping), the position «۲ / ۵», a close button; fades in with opacity only. It opens in the host's popups layer (above the tab bar and the page), the system back closes it, and automation sees it as covering the page.",
441
+ "since": null,
442
+ "props": [
443
+ {
444
+ "name": "actions",
445
+ "type": {
446
+ "kind": "slot",
447
+ "accepts": "any"
448
+ },
449
+ "required": false,
450
+ "serializable": false,
451
+ "role": "slot",
452
+ "doc": "Actions in the top bar (share, save)."
453
+ },
454
+ {
455
+ "name": "closeLabel",
456
+ "type": {
457
+ "kind": "string"
458
+ },
459
+ "required": false,
460
+ "serializable": true,
461
+ "role": "content"
462
+ },
463
+ {
464
+ "name": "id",
465
+ "type": {
466
+ "kind": "string"
467
+ },
468
+ "required": false,
469
+ "serializable": true,
470
+ "role": "identity"
471
+ },
472
+ {
473
+ "name": "index",
474
+ "type": {
475
+ "kind": "number"
476
+ },
477
+ "required": true,
478
+ "serializable": true,
479
+ "role": "behaviour"
480
+ },
481
+ {
482
+ "name": "items",
483
+ "type": {
484
+ "kind": "array",
485
+ "items": {
486
+ "kind": "object",
487
+ "fields": [
488
+ {
489
+ "name": "id",
490
+ "required": true,
491
+ "type": {
492
+ "kind": "string"
493
+ },
494
+ "serializable": true
495
+ },
496
+ {
497
+ "name": "src",
498
+ "required": true,
499
+ "type": {
500
+ "kind": "string"
501
+ },
502
+ "serializable": true
503
+ },
504
+ {
505
+ "name": "blurhash",
506
+ "required": false,
507
+ "type": {
508
+ "kind": "string"
509
+ },
510
+ "serializable": true
511
+ },
512
+ {
513
+ "name": "alt",
514
+ "required": false,
515
+ "type": {
516
+ "kind": "string"
517
+ },
518
+ "serializable": true
519
+ }
520
+ ]
521
+ }
522
+ },
523
+ "required": true,
524
+ "serializable": true,
525
+ "role": "state"
526
+ },
527
+ {
528
+ "name": "onClose",
529
+ "type": {
530
+ "kind": "event",
531
+ "payload": null
532
+ },
533
+ "required": true,
534
+ "serializable": false,
535
+ "role": "event"
536
+ },
537
+ {
538
+ "name": "onIndexChange",
539
+ "type": {
540
+ "kind": "event",
541
+ "payload": "index: number"
542
+ },
543
+ "required": false,
544
+ "serializable": false,
545
+ "role": "event"
546
+ },
547
+ {
548
+ "name": "open",
549
+ "type": {
550
+ "kind": "boolean"
551
+ },
552
+ "required": true,
553
+ "serializable": true,
554
+ "role": "state"
555
+ }
556
+ ],
557
+ "anchor": null,
558
+ "accessibility": {
559
+ "labelFrom": [],
560
+ "labelRequired": false
561
+ },
562
+ "targets": {
563
+ "android": "verified",
564
+ "ios": "pending",
565
+ "windows": "unmeasured",
566
+ "macos": "unmeasured",
567
+ "web": "verified"
568
+ },
569
+ "evidence": {
570
+ "ledger": [
571
+ "N-077",
572
+ "N-127"
573
+ ]
574
+ },
575
+ "tokens": [
576
+ "Outline",
577
+ "Primary",
578
+ "PrimaryBorder",
579
+ "PrimaryContainer",
580
+ "ScrimLight",
581
+ "Surface",
582
+ "SurfaceContainer",
583
+ "TextPrimary",
584
+ "TextSecondary",
585
+ "TextTertiary"
586
+ ],
587
+ "example": {
588
+ "line": "<G9Lightbox index={1} items={items} onClose={() => {}} open />",
589
+ "from": "generated"
590
+ }
591
+ },
592
+ {
593
+ "id": "media.media.G9MediaGrid",
594
+ "export": "G9MediaGrid",
595
+ "from": "@g9tm/lynxcontrols-media",
596
+ "kind": "component",
597
+ "family": "media",
598
+ "summary": "1–4 tiles (and «+k» on the fourth) in a chat or feed post; a tap opens the photo.",
599
+ "since": null,
600
+ "props": [
601
+ {
602
+ "name": "gap",
603
+ "type": {
604
+ "kind": "number"
605
+ },
606
+ "required": false,
607
+ "serializable": true,
608
+ "role": "behaviour"
609
+ },
610
+ {
611
+ "name": "height",
612
+ "type": {
613
+ "kind": "number"
614
+ },
615
+ "required": false,
616
+ "serializable": true,
617
+ "role": "behaviour"
618
+ },
619
+ {
620
+ "name": "id",
621
+ "type": {
622
+ "kind": "string"
623
+ },
624
+ "required": false,
625
+ "serializable": true,
626
+ "role": "identity"
627
+ },
628
+ {
629
+ "name": "items",
630
+ "type": {
631
+ "kind": "array",
632
+ "items": {
633
+ "kind": "object",
634
+ "fields": [
635
+ {
636
+ "name": "id",
637
+ "required": true,
638
+ "type": {
639
+ "kind": "string"
640
+ },
641
+ "serializable": true
642
+ },
643
+ {
644
+ "name": "src",
645
+ "required": true,
646
+ "type": {
647
+ "kind": "string"
648
+ },
649
+ "serializable": true
650
+ },
651
+ {
652
+ "name": "blurhash",
653
+ "required": false,
654
+ "type": {
655
+ "kind": "string"
656
+ },
657
+ "serializable": true
658
+ },
659
+ {
660
+ "name": "alt",
661
+ "required": false,
662
+ "type": {
663
+ "kind": "string"
664
+ },
665
+ "serializable": true
666
+ }
667
+ ]
668
+ }
669
+ },
670
+ "required": true,
671
+ "serializable": true,
672
+ "role": "state"
673
+ },
674
+ {
675
+ "name": "onOpen",
676
+ "type": {
677
+ "kind": "event",
678
+ "payload": "index: number"
679
+ },
680
+ "required": false,
681
+ "serializable": false,
682
+ "role": "event"
683
+ },
684
+ {
685
+ "name": "radius",
686
+ "type": {
687
+ "kind": "number"
688
+ },
689
+ "required": false,
690
+ "serializable": true,
691
+ "role": "appearance"
692
+ },
693
+ {
694
+ "name": "width",
695
+ "type": {
696
+ "kind": "number"
697
+ },
698
+ "required": true,
699
+ "serializable": true,
700
+ "role": "behaviour"
701
+ }
702
+ ],
703
+ "anchor": null,
704
+ "accessibility": {
705
+ "labelFrom": [],
706
+ "labelRequired": false
707
+ },
708
+ "targets": {
709
+ "android": "unmeasured",
710
+ "ios": "unmeasured",
711
+ "windows": "unmeasured",
712
+ "macos": "unmeasured",
713
+ "web": "verified"
714
+ },
715
+ "evidence": {
716
+ "ledger": [
717
+ "N-127"
718
+ ]
719
+ },
720
+ "tokens": [
721
+ "Outline",
722
+ "Primary",
723
+ "PrimaryBorder",
724
+ "PrimaryContainer",
725
+ "ScrimLight",
726
+ "Surface",
727
+ "SurfaceContainer",
728
+ "TextPrimary",
729
+ "TextSecondary",
730
+ "TextTertiary"
731
+ ],
732
+ "example": {
733
+ "line": "<G9MediaGrid items={items} width={1} />",
734
+ "from": "generated"
735
+ }
736
+ },
737
+ {
738
+ "id": "media.media.G9MediaPager",
739
+ "export": "G9MediaPager",
740
+ "from": "@g9tm/lynxcontrols-media",
741
+ "kind": "component",
742
+ "family": "media",
743
+ "summary": "Pictures one per page, swiped (Lynx's native `<viewpager>`, snapping), each fitted on the page. The order follows the reading direction: a viewpager always lays its pages out left to right, so in RTL the pages are mirrored and the next picture comes from a swipe to the right. Indices in and out stay in `items` order. The pager inside `G9Lightbox`; on its own in a page or sheet that brings its own chrome (a title, a share action, a route).",
744
+ "since": null,
745
+ "props": [
746
+ {
747
+ "name": "className",
748
+ "type": {
749
+ "kind": "string"
750
+ },
751
+ "required": false,
752
+ "serializable": true,
753
+ "role": "appearance"
754
+ },
755
+ {
756
+ "name": "id",
757
+ "type": {
758
+ "kind": "string"
759
+ },
760
+ "required": false,
761
+ "serializable": true,
762
+ "role": "identity"
763
+ },
764
+ {
765
+ "name": "index",
766
+ "type": {
767
+ "kind": "number"
768
+ },
769
+ "required": true,
770
+ "serializable": true,
771
+ "role": "behaviour",
772
+ "doc": "The page shown first (an index into `items`, in reading order)."
773
+ },
774
+ {
775
+ "name": "items",
776
+ "type": {
777
+ "kind": "array",
778
+ "items": {
779
+ "kind": "object",
780
+ "fields": [
781
+ {
782
+ "name": "id",
783
+ "required": true,
784
+ "type": {
785
+ "kind": "string"
786
+ },
787
+ "serializable": true
788
+ },
789
+ {
790
+ "name": "src",
791
+ "required": true,
792
+ "type": {
793
+ "kind": "string"
794
+ },
795
+ "serializable": true
796
+ },
797
+ {
798
+ "name": "blurhash",
799
+ "required": false,
800
+ "type": {
801
+ "kind": "string"
802
+ },
803
+ "serializable": true
804
+ },
805
+ {
806
+ "name": "alt",
807
+ "required": false,
808
+ "type": {
809
+ "kind": "string"
810
+ },
811
+ "serializable": true
812
+ }
813
+ ]
814
+ }
815
+ },
816
+ "required": true,
817
+ "serializable": true,
818
+ "role": "state"
819
+ },
820
+ {
821
+ "name": "onIndexChange",
822
+ "type": {
823
+ "kind": "event",
824
+ "payload": "index: number"
825
+ },
826
+ "required": false,
827
+ "serializable": false,
828
+ "role": "event"
829
+ }
830
+ ],
831
+ "anchor": null,
832
+ "accessibility": {
833
+ "labelFrom": [],
834
+ "labelRequired": false
835
+ },
836
+ "targets": {
837
+ "android": "unmeasured",
838
+ "ios": "unmeasured",
839
+ "windows": "unmeasured",
840
+ "macos": "unmeasured",
841
+ "web": "verified"
842
+ },
843
+ "evidence": {
844
+ "ledger": [
845
+ "N-127"
846
+ ]
847
+ },
848
+ "tokens": [
849
+ "Outline",
850
+ "Primary",
851
+ "PrimaryBorder",
852
+ "PrimaryContainer",
853
+ "ScrimLight",
854
+ "Surface",
855
+ "SurfaceContainer",
856
+ "TextPrimary",
857
+ "TextSecondary",
858
+ "TextTertiary"
859
+ ],
860
+ "example": {
861
+ "line": "<G9MediaPager index={1} items={items} />",
862
+ "from": "generated"
863
+ }
864
+ },
865
+ {
866
+ "id": "media.media.G9VoicePlayer",
867
+ "export": "G9VoicePlayer",
868
+ "from": "@g9tm/lynxcontrols-media",
869
+ "kind": "component",
870
+ "family": "media",
871
+ "summary": "A voice note: play/pause, the waveform filling as it plays, the time left. The app owns the audio.",
872
+ "since": null,
873
+ "props": [
874
+ {
875
+ "name": "bars",
876
+ "type": {
877
+ "kind": "number"
878
+ },
879
+ "required": false,
880
+ "serializable": true,
881
+ "role": "behaviour"
882
+ },
883
+ {
884
+ "name": "duration",
885
+ "type": {
886
+ "kind": "number"
887
+ },
888
+ "required": true,
889
+ "serializable": true,
890
+ "role": "behaviour",
891
+ "doc": "Seconds."
892
+ },
893
+ {
894
+ "name": "id",
895
+ "type": {
896
+ "kind": "string"
897
+ },
898
+ "required": false,
899
+ "serializable": true,
900
+ "role": "identity"
901
+ },
902
+ {
903
+ "name": "mine",
904
+ "type": {
905
+ "kind": "boolean"
906
+ },
907
+ "required": false,
908
+ "serializable": true,
909
+ "role": "behaviour"
910
+ },
911
+ {
912
+ "name": "onSeek",
913
+ "type": {
914
+ "kind": "event",
915
+ "payload": "fraction: number"
916
+ },
917
+ "required": false,
918
+ "serializable": false,
919
+ "role": "event",
920
+ "doc": "Seek to a fraction 0..1 (a tap on the waveform)."
921
+ },
922
+ {
923
+ "name": "onToggle",
924
+ "type": {
925
+ "kind": "event",
926
+ "payload": null
927
+ },
928
+ "required": true,
929
+ "serializable": false,
930
+ "role": "event"
931
+ },
932
+ {
933
+ "name": "pauseLabel",
934
+ "type": {
935
+ "kind": "string"
936
+ },
937
+ "required": false,
938
+ "serializable": true,
939
+ "role": "content"
940
+ },
941
+ {
942
+ "name": "playing",
943
+ "type": {
944
+ "kind": "boolean"
945
+ },
946
+ "required": true,
947
+ "serializable": true,
948
+ "role": "behaviour"
949
+ },
950
+ {
951
+ "name": "playLabel",
952
+ "type": {
953
+ "kind": "string"
954
+ },
955
+ "required": false,
956
+ "serializable": true,
957
+ "role": "content"
958
+ },
959
+ {
960
+ "name": "position",
961
+ "type": {
962
+ "kind": "number"
963
+ },
964
+ "required": true,
965
+ "serializable": true,
966
+ "role": "behaviour",
967
+ "doc": "Seconds played."
968
+ },
969
+ {
970
+ "name": "samples",
971
+ "type": {
972
+ "kind": "array",
973
+ "items": {
974
+ "kind": "number"
975
+ }
976
+ },
977
+ "required": false,
978
+ "serializable": true,
979
+ "role": "behaviour"
980
+ }
981
+ ],
982
+ "anchor": null,
983
+ "accessibility": {
984
+ "labelFrom": [],
985
+ "labelRequired": false
986
+ },
987
+ "targets": {
988
+ "android": "unmeasured",
989
+ "ios": "unmeasured",
990
+ "windows": "unmeasured",
991
+ "macos": "unmeasured",
992
+ "web": "verified"
993
+ },
994
+ "evidence": {
995
+ "ledger": [
996
+ "N-127"
997
+ ]
998
+ },
999
+ "tokens": [
1000
+ "Outline",
1001
+ "Primary",
1002
+ "PrimaryBorder",
1003
+ "PrimaryContainer",
1004
+ "ScrimLight",
1005
+ "Surface",
1006
+ "SurfaceContainer",
1007
+ "TextPrimary",
1008
+ "TextSecondary",
1009
+ "TextTertiary"
1010
+ ],
1011
+ "example": {
1012
+ "line": "<G9VoicePlayer duration={1} onToggle={() => {}} playing position={1} />",
1013
+ "from": "generated"
1014
+ }
1015
+ }
1016
+ ],
1017
+ "exports": [
1018
+ {
1019
+ "id": "media.model.acceptsFile",
1020
+ "export": "acceptsFile",
1021
+ "from": "@g9tm/lynxcontrols-media/model",
1022
+ "kind": "function",
1023
+ "signature": "(file: { readonly name?: string; readonly mime?: string; }, accept?: string | undefined): boolean",
1024
+ "summary": "Whether a file matches an `accept` list (`image/*,.pdf`): the web's rule, on file handles (G9Hub `accepts`)."
1025
+ },
1026
+ {
1027
+ "id": "media.model.blurhashAverage",
1028
+ "export": "blurhashAverage",
1029
+ "from": "@g9tm/lynxcontrols-media/model",
1030
+ "kind": "function",
1031
+ "signature": "(hash: string): string",
1032
+ "summary": "The average colour of a blurhash (its DC component), `#RRGGBB` — a solid placeholder for free."
1033
+ },
1034
+ {
1035
+ "id": "media.model.blurhashBmp",
1036
+ "export": "blurhashBmp",
1037
+ "from": "@g9tm/lynxcontrols-media/model",
1038
+ "kind": "function",
1039
+ "signature": "(hash: string, cols?: number, rows?: number): string",
1040
+ "summary": "The blurhash as a tiny 24-bit BMP data URI (`cols` × `rows` pixels, ~200 bytes): an `<image>` scales it up with bilinear filtering, which is the soft blur a blurhash is meant to look like (the SVG of flat cells shows the grid)."
1041
+ },
1042
+ {
1043
+ "id": "media.model.blurhashSvg",
1044
+ "export": "blurhashSvg",
1045
+ "from": "@g9tm/lynxcontrols-media/model",
1046
+ "kind": "function",
1047
+ "signature": "(hash: string, cols?: number, rows?: number): string",
1048
+ "summary": "A blurhash as a tiny SVG of `cols × rows` cells (no canvas on Lynx). The cells blend at this size because the SVG is scaled up smoothly; 8×6 is 48 rects, built once per hash."
1049
+ },
1050
+ {
1051
+ "id": "media.model.clampCrop",
1052
+ "export": "clampCrop",
1053
+ "from": "@g9tm/lynxcontrols-media/model",
1054
+ "kind": "function",
1055
+ "signature": "(state: G9CropState, image: G9Size, frame: G9Size, maxZoom?: number): G9CropState",
1056
+ "summary": "Keeps the image covering the frame: zoom ≥ 1 (≤ max) and the offset within the overflow."
1057
+ },
1058
+ {
1059
+ "id": "media.model.coverScale",
1060
+ "export": "coverScale",
1061
+ "from": "@g9tm/lynxcontrols-media/model",
1062
+ "kind": "function",
1063
+ "signature": "(image: G9Size, frame: G9Size): number",
1064
+ "summary": "The scale at which `image` just covers `frame`."
1065
+ },
1066
+ {
1067
+ "id": "media.model.cropRect",
1068
+ "export": "cropRect",
1069
+ "from": "@g9tm/lynxcontrols-media/model",
1070
+ "kind": "function",
1071
+ "signature": "(state: G9CropState, image: G9Size, frame: G9Size): { readonly x: number; readonly y: number; readonly width: number; readonly height: number; }",
1072
+ "summary": "The crop in image pixels for a state (what a server or the native side cuts out)."
1073
+ },
1074
+ {
1075
+ "id": "media.model.decodeBlurhash",
1076
+ "export": "decodeBlurhash",
1077
+ "from": "@g9tm/lynxcontrols-media/model",
1078
+ "kind": "function",
1079
+ "signature": "(hash: string, width: number, height: number, punch?: number): Uint8ClampedArray<ArrayBufferLike>",
1080
+ "summary": "Decodes a blurhash to `width × height` RGB pixels (row-major, 3 bytes each)."
1081
+ },
1082
+ {
1083
+ "id": "media.model.formatDuration",
1084
+ "export": "formatDuration",
1085
+ "from": "@g9tm/lynxcontrols-media/model",
1086
+ "kind": "function",
1087
+ "signature": "(seconds: number): string",
1088
+ "summary": "`75` → «1:15»."
1089
+ },
1090
+ {
1091
+ "id": "media.media.G9BlurhashViewProps",
1092
+ "export": "G9BlurhashViewProps",
1093
+ "from": "@g9tm/lynxcontrols-media",
1094
+ "kind": "interface",
1095
+ "signature": "G9BlurhashViewProps",
1096
+ "summary": "Props of `G9BlurhashView`."
1097
+ },
1098
+ {
1099
+ "id": "media.model.G9CropState",
1100
+ "export": "G9CropState",
1101
+ "from": "@g9tm/lynxcontrols-media/model",
1102
+ "kind": "interface",
1103
+ "signature": "G9CropState",
1104
+ "summary": "A cropper's state: zoom (1 = the image covers the frame) and the image's offset from centred, in frame pixels."
1105
+ },
1106
+ {
1107
+ "id": "media.media.g9DropZoneEvent",
1108
+ "export": "g9DropZoneEvent",
1109
+ "from": "@g9tm/lynxcontrols-media",
1110
+ "kind": "function",
1111
+ "signature": "(name: \"g9:drag\" | \"g9:drop\", detail: { readonly active?: boolean; readonly files?: readonly G9FileRef[]; }): void",
1112
+ "summary": "The host's drag-and-drop events (`g9:drag` `{ active }`, `g9:drop` `{ files }`), delivered to the top zone."
1113
+ },
1114
+ {
1115
+ "id": "media.media.G9DropZoneProps",
1116
+ "export": "G9DropZoneProps",
1117
+ "from": "@g9tm/lynxcontrols-media",
1118
+ "kind": "interface",
1119
+ "signature": "G9DropZoneProps",
1120
+ "summary": "Props of `G9DropZone`."
1121
+ },
1122
+ {
1123
+ "id": "media.model.G9GridTile",
1124
+ "export": "G9GridTile",
1125
+ "from": "@g9tm/lynxcontrols-media/model",
1126
+ "kind": "interface",
1127
+ "signature": "G9GridTile",
1128
+ "summary": "One tile of a media grid, in fractions of the grid's width and height."
1129
+ },
1130
+ {
1131
+ "id": "media.media.G9ImageCropperProps",
1132
+ "export": "G9ImageCropperProps",
1133
+ "from": "@g9tm/lynxcontrols-media",
1134
+ "kind": "interface",
1135
+ "signature": "G9ImageCropperProps",
1136
+ "summary": "Props of `G9ImageCropper`."
1137
+ },
1138
+ {
1139
+ "id": "media.media.G9LightboxProps",
1140
+ "export": "G9LightboxProps",
1141
+ "from": "@g9tm/lynxcontrols-media",
1142
+ "kind": "interface",
1143
+ "signature": "G9LightboxProps",
1144
+ "summary": "Props of `G9Lightbox`."
1145
+ },
1146
+ {
1147
+ "id": "media.media.G9MediaGridProps",
1148
+ "export": "G9MediaGridProps",
1149
+ "from": "@g9tm/lynxcontrols-media",
1150
+ "kind": "interface",
1151
+ "signature": "G9MediaGridProps",
1152
+ "summary": "Props of `G9MediaGrid`."
1153
+ },
1154
+ {
1155
+ "id": "media.media.G9MediaItem",
1156
+ "export": "G9MediaItem",
1157
+ "from": "@g9tm/lynxcontrols-media",
1158
+ "kind": "interface",
1159
+ "signature": "G9MediaItem",
1160
+ "summary": "One photo of a grid or lightbox."
1161
+ },
1162
+ {
1163
+ "id": "media.media.G9MediaPagerProps",
1164
+ "export": "G9MediaPagerProps",
1165
+ "from": "@g9tm/lynxcontrols-media",
1166
+ "kind": "interface",
1167
+ "signature": "G9MediaPagerProps",
1168
+ "summary": "Props of `G9MediaPager`."
1169
+ },
1170
+ {
1171
+ "id": "media.media.g9PickFiles",
1172
+ "export": "g9PickFiles",
1173
+ "from": "@g9tm/lynxcontrols-media",
1174
+ "kind": "function",
1175
+ "signature": "(files: G9FilePicker | undefined, options?: G9PickOptions): Promise<readonly G9FileRef[]>",
1176
+ "summary": "Opens the chooser (or the camera) and resolves the files that match `accept` (`[]` when cancelled or without a picker); the ones that do not match are released back to the host."
1177
+ },
1178
+ {
1179
+ "id": "media.media.G9PickOptions",
1180
+ "export": "G9PickOptions",
1181
+ "from": "@g9tm/lynxcontrols-media",
1182
+ "kind": "interface",
1183
+ "signature": "G9PickOptions",
1184
+ "summary": "Options of `g9PickFiles`."
1185
+ },
1186
+ {
1187
+ "id": "media.model.G9Size",
1188
+ "export": "G9Size",
1189
+ "from": "@g9tm/lynxcontrols-media/model",
1190
+ "kind": "interface",
1191
+ "signature": "G9Size",
1192
+ "summary": "A size."
1193
+ },
1194
+ {
1195
+ "id": "media.media.G9VoicePlayerProps",
1196
+ "export": "G9VoicePlayerProps",
1197
+ "from": "@g9tm/lynxcontrols-media",
1198
+ "kind": "interface",
1199
+ "signature": "G9VoicePlayerProps",
1200
+ "summary": "Props of `G9VoicePlayer`."
1201
+ },
1202
+ {
1203
+ "id": "media.model.isBlurhash",
1204
+ "export": "isBlurhash",
1205
+ "from": "@g9tm/lynxcontrols-media/model",
1206
+ "kind": "function",
1207
+ "signature": "(hash: string): boolean",
1208
+ "summary": "True when `hash` is a well-formed blurhash."
1209
+ },
1210
+ {
1211
+ "id": "media.model.mediaGridLayout",
1212
+ "export": "mediaGridLayout",
1213
+ "from": "@g9tm/lynxcontrols-media/model",
1214
+ "kind": "function",
1215
+ "signature": "(n: number): G9GridTile[]",
1216
+ "summary": "The tiles for `n` photos (chat and feed style): one fills; two side by side; three = one large + two stacked; four = 2×2; more = 2×2 with «+k» on the last tile."
1217
+ },
1218
+ {
1219
+ "id": "media.model.pickCategory",
1220
+ "export": "pickCategory",
1221
+ "from": "@g9tm/lynxcontrols-media/model",
1222
+ "kind": "function",
1223
+ "signature": "(accept?: string | undefined): \"image\" | \"media\" | \"video\" | \"audio\" | \"any\"",
1224
+ "summary": "The host chooser's category for an `accept` list (hosts filter by category; `acceptsFile` filters exactly)."
1225
+ },
1226
+ {
1227
+ "id": "media.model.waveformBars",
1228
+ "export": "waveformBars",
1229
+ "from": "@g9tm/lynxcontrols-media/model",
1230
+ "kind": "function",
1231
+ "signature": "(samples: readonly number[], bars: number): number[]",
1232
+ "summary": "A waveform's samples (any count, 0..1 or raw amplitudes) reduced to `bars` heights in 0..1."
1233
+ }
1234
+ ]
1235
+ }