@microsoft/fast-element 2.0.0-beta.16 → 2.0.0-beta.18

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 (63) hide show
  1. package/CHANGELOG.json +36 -0
  2. package/CHANGELOG.md +18 -1
  3. package/dist/dts/components/element-controller.d.ts +5 -0
  4. package/dist/dts/dom-policy.d.ts +68 -0
  5. package/dist/dts/dom.d.ts +116 -0
  6. package/dist/dts/index.d.ts +3 -2
  7. package/dist/dts/index.rollup.d.ts +0 -1
  8. package/dist/dts/index.rollup.debug.d.ts +0 -1
  9. package/dist/dts/interfaces.d.ts +15 -24
  10. package/dist/dts/polyfills.d.ts +0 -1
  11. package/dist/dts/templating/binding-signal.d.ts +3 -1
  12. package/dist/dts/templating/binding-two-way.d.ts +3 -1
  13. package/dist/dts/templating/binding.d.ts +16 -5
  14. package/dist/dts/templating/compiler.d.ts +11 -13
  15. package/dist/dts/templating/dangerous-html.d.ts +18 -0
  16. package/dist/dts/templating/html-directive.d.ts +54 -118
  17. package/dist/dts/templating/node-observation.d.ts +11 -1
  18. package/dist/dts/templating/ref.d.ts +4 -0
  19. package/dist/dts/templating/render.d.ts +30 -6
  20. package/dist/dts/templating/repeat.d.ts +1 -5
  21. package/dist/dts/templating/template.d.ts +44 -13
  22. package/dist/dts/templating/view.d.ts +8 -3
  23. package/dist/dts/testing/fakes.d.ts +1 -0
  24. package/dist/dts/utilities.d.ts +39 -0
  25. package/dist/esm/components/attributes.js +1 -1
  26. package/dist/esm/components/element-controller.js +6 -1
  27. package/dist/esm/debug.js +4 -1
  28. package/dist/esm/dom-policy.js +337 -0
  29. package/dist/esm/dom.js +117 -0
  30. package/dist/esm/index.js +2 -1
  31. package/dist/esm/index.rollup.debug.js +3 -1
  32. package/dist/esm/index.rollup.js +3 -1
  33. package/dist/esm/observation/observable.js +5 -1
  34. package/dist/esm/platform.js +1 -1
  35. package/dist/esm/polyfills.js +3 -7
  36. package/dist/esm/templating/binding-signal.js +9 -3
  37. package/dist/esm/templating/binding-two-way.js +9 -3
  38. package/dist/esm/templating/binding.js +40 -55
  39. package/dist/esm/templating/children.js +8 -4
  40. package/dist/esm/templating/compiler.js +31 -38
  41. package/dist/esm/templating/dangerous-html.js +23 -0
  42. package/dist/esm/templating/html-directive.js +42 -133
  43. package/dist/esm/templating/node-observation.js +14 -8
  44. package/dist/esm/templating/ref.js +1 -1
  45. package/dist/esm/templating/render.js +17 -6
  46. package/dist/esm/templating/repeat.js +2 -6
  47. package/dist/esm/templating/template.js +86 -56
  48. package/dist/esm/templating/view.js +6 -0
  49. package/dist/esm/testing/fakes.js +2 -0
  50. package/dist/esm/testing/fixture.js +1 -1
  51. package/dist/esm/utilities.js +68 -0
  52. package/dist/fast-element.api.json +1088 -608
  53. package/dist/fast-element.d.ts +194 -147
  54. package/dist/fast-element.debug.js +745 -381
  55. package/dist/fast-element.debug.min.js +1 -1
  56. package/dist/fast-element.js +716 -355
  57. package/dist/fast-element.min.js +1 -1
  58. package/dist/fast-element.untrimmed.d.ts +208 -145
  59. package/docs/api-report.md +74 -56
  60. package/package.json +5 -1
  61. package/yarn-error.log +177 -0
  62. package/dist/dts/templating/dom.d.ts +0 -41
  63. package/dist/esm/templating/dom.js +0 -49
package/dist/fast-element.api.json CHANGED
@@ -628,93 +628,6 @@
628
628
  "endIndex": 3
629
629
  }
630
630
  },
631
- {
632
- "kind": "TypeAlias",
633
- "canonicalReference": "@microsoft/fast-element!Aspect:type",
634
- "docComment": "/**\n * The type of HTML aspect to target.\n *\n * @public\n */\n",
635
- "excerptTokens": [
636
- {
637
- "kind": "Content",
638
- "text": "export declare type Aspect = "
639
- },
640
- {
641
- "kind": "Content",
642
- "text": "typeof "
643
- },
644
- {
645
- "kind": "Reference",
646
- "text": "Aspect",
647
- "canonicalReference": "@microsoft/fast-element!Aspect:var"
648
- },
649
- {
650
- "kind": "Content",
651
- "text": "["
652
- },
653
- {
654
- "kind": "Reference",
655
- "text": "Exclude",
656
- "canonicalReference": "!Exclude:type"
657
- },
658
- {
659
- "kind": "Content",
660
- "text": "<keyof typeof "
661
- },
662
- {
663
- "kind": "Reference",
664
- "text": "Aspect",
665
- "canonicalReference": "@microsoft/fast-element!Aspect:var"
666
- },
667
- {
668
- "kind": "Content",
669
- "text": ", \"assign\" | \"none\">]"
670
- },
671
- {
672
- "kind": "Content",
673
- "text": ";"
674
- }
675
- ],
676
- "releaseTag": "Public",
677
- "name": "Aspect",
678
- "typeTokenRange": {
679
- "startIndex": 1,
680
- "endIndex": 8
681
- }
682
- },
683
- {
684
- "kind": "Variable",
685
- "canonicalReference": "@microsoft/fast-element!Aspect:var",
686
- "docComment": "/**\n * The type of HTML aspect to target.\n *\n * @public\n */\n",
687
- "excerptTokens": [
688
- {
689
- "kind": "Content",
690
- "text": "Aspect: "
691
- },
692
- {
693
- "kind": "Reference",
694
- "text": "Readonly",
695
- "canonicalReference": "!Readonly:type"
696
- },
697
- {
698
- "kind": "Content",
699
- "text": "<{\n readonly none: 0;\n readonly attribute: 1;\n readonly booleanAttribute: 2;\n readonly property: 3;\n readonly content: 4;\n readonly tokenList: 5;\n readonly event: 6;\n readonly assign: (directive: "
700
- },
701
- {
702
- "kind": "Reference",
703
- "text": "Aspected",
704
- "canonicalReference": "@microsoft/fast-element!Aspected:interface"
705
- },
706
- {
707
- "kind": "Content",
708
- "text": ", value?: string) => void;\n}>"
709
- }
710
- ],
711
- "releaseTag": "Public",
712
- "name": "Aspect",
713
- "variableTypeTokenRange": {
714
- "startIndex": 1,
715
- "endIndex": 5
716
- }
717
- },
718
631
  {
719
632
  "kind": "Interface",
720
633
  "canonicalReference": "@microsoft/fast-element!Aspected:interface",
@@ -739,8 +652,8 @@
739
652
  },
740
653
  {
741
654
  "kind": "Reference",
742
- "text": "Aspect",
743
- "canonicalReference": "@microsoft/fast-element!Aspect:type"
655
+ "text": "DOMAspect",
656
+ "canonicalReference": "@microsoft/fast-element!DOMAspect:type"
744
657
  },
745
658
  {
746
659
  "kind": "Content",
@@ -1442,7 +1355,7 @@
1442
1355
  {
1443
1356
  "kind": "Function",
1444
1357
  "canonicalReference": "@microsoft/fast-element!bind:function(1)",
1445
- "docComment": "/**\n * Creates an standard binding.\n *\n * @param expression - The binding to refresh when changed.\n *\n * @param isVolatile - Indicates whether the binding is volatile or not.\n *\n * @returns A binding configuration.\n *\n * @public\n */\n",
1358
+ "docComment": "/**\n * Creates an standard binding.\n *\n * @param expression - The binding to refresh when changed.\n *\n * @param policy - The security policy to associate with th binding.\n *\n * @param isVolatile - Indicates whether the binding is volatile or not.\n *\n * @returns A binding configuration.\n *\n * @public\n */\n",
1446
1359
  "excerptTokens": [
1447
1360
  {
1448
1361
  "kind": "Content",
@@ -1465,6 +1378,15 @@
1465
1378
  "kind": "Content",
1466
1379
  "text": "<T>"
1467
1380
  },
1381
+ {
1382
+ "kind": "Content",
1383
+ "text": ", policy?: "
1384
+ },
1385
+ {
1386
+ "kind": "Reference",
1387
+ "text": "DOMPolicy",
1388
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
1389
+ },
1468
1390
  {
1469
1391
  "kind": "Content",
1470
1392
  "text": ", isVolatile?: "
@@ -1492,8 +1414,8 @@
1492
1414
  }
1493
1415
  ],
1494
1416
  "returnTypeTokenRange": {
1495
- "startIndex": 8,
1496
- "endIndex": 10
1417
+ "startIndex": 10,
1418
+ "endIndex": 12
1497
1419
  },
1498
1420
  "releaseTag": "Public",
1499
1421
  "overloadIndex": 1,
@@ -1507,12 +1429,20 @@
1507
1429
  "isOptional": false
1508
1430
  },
1509
1431
  {
1510
- "parameterName": "isVolatile",
1432
+ "parameterName": "policy",
1511
1433
  "parameterTypeTokenRange": {
1512
1434
  "startIndex": 6,
1513
1435
  "endIndex": 7
1514
1436
  },
1515
1437
  "isOptional": true
1438
+ },
1439
+ {
1440
+ "parameterName": "isVolatile",
1441
+ "parameterTypeTokenRange": {
1442
+ "startIndex": 8,
1443
+ "endIndex": 9
1444
+ },
1445
+ "isOptional": true
1516
1446
  }
1517
1447
  ],
1518
1448
  "typeParameters": [
@@ -1605,7 +1535,7 @@
1605
1535
  {
1606
1536
  "kind": "Constructor",
1607
1537
  "canonicalReference": "@microsoft/fast-element!Binding:constructor(1)",
1608
- "docComment": "/**\n * Creates a binding.\n *\n * @param evaluate - Evaluates the binding.\n *\n * @param isVolatile - Indicates whether the binding is volatile.\n */\n",
1538
+ "docComment": "/**\n * Creates a binding.\n *\n * @param evaluate - Evaluates the binding.\n *\n * @param policy - The security policy to associate with this binding.\n *\n * @param isVolatile - Indicates whether the binding is volatile.\n */\n",
1609
1539
  "excerptTokens": [
1610
1540
  {
1611
1541
  "kind": "Content",
@@ -1620,6 +1550,19 @@
1620
1550
  "kind": "Content",
1621
1551
  "text": "<TSource, TReturn, TParent>"
1622
1552
  },
1553
+ {
1554
+ "kind": "Content",
1555
+ "text": ", policy?: "
1556
+ },
1557
+ {
1558
+ "kind": "Reference",
1559
+ "text": "DOMPolicy",
1560
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
1561
+ },
1562
+ {
1563
+ "kind": "Content",
1564
+ "text": " | undefined"
1565
+ },
1623
1566
  {
1624
1567
  "kind": "Content",
1625
1568
  "text": ", isVolatile?: "
@@ -1645,10 +1588,18 @@
1645
1588
  "isOptional": false
1646
1589
  },
1647
1590
  {
1648
- "parameterName": "isVolatile",
1591
+ "parameterName": "policy",
1649
1592
  "parameterTypeTokenRange": {
1650
1593
  "startIndex": 4,
1651
- "endIndex": 5
1594
+ "endIndex": 6
1595
+ },
1596
+ "isOptional": true
1597
+ },
1598
+ {
1599
+ "parameterName": "isVolatile",
1600
+ "parameterTypeTokenRange": {
1601
+ "startIndex": 7,
1602
+ "endIndex": 8
1652
1603
  },
1653
1604
  "isOptional": true
1654
1605
  }
@@ -1808,6 +1759,38 @@
1808
1759
  "endIndex": 2
1809
1760
  },
1810
1761
  "isStatic": false
1762
+ },
1763
+ {
1764
+ "kind": "Property",
1765
+ "canonicalReference": "@microsoft/fast-element!Binding#policy:member",
1766
+ "docComment": "",
1767
+ "excerptTokens": [
1768
+ {
1769
+ "kind": "Content",
1770
+ "text": "policy?: "
1771
+ },
1772
+ {
1773
+ "kind": "Reference",
1774
+ "text": "DOMPolicy",
1775
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
1776
+ },
1777
+ {
1778
+ "kind": "Content",
1779
+ "text": " | undefined"
1780
+ },
1781
+ {
1782
+ "kind": "Content",
1783
+ "text": ";"
1784
+ }
1785
+ ],
1786
+ "isOptional": true,
1787
+ "releaseTag": "Public",
1788
+ "name": "policy",
1789
+ "propertyTypeTokenRange": {
1790
+ "startIndex": 1,
1791
+ "endIndex": 3
1792
+ },
1793
+ "isStatic": false
1811
1794
  }
1812
1795
  ],
1813
1796
  "implementsTokenRanges": []
@@ -2393,7 +2376,16 @@
2393
2376
  },
2394
2377
  {
2395
2378
  "kind": "Content",
2396
- "text": ">) => "
2379
+ "text": ">, \npolicy: "
2380
+ },
2381
+ {
2382
+ "kind": "Reference",
2383
+ "text": "DOMPolicy",
2384
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
2385
+ },
2386
+ {
2387
+ "kind": "Content",
2388
+ "text": ") => "
2397
2389
  },
2398
2390
  {
2399
2391
  "kind": "Reference",
@@ -2409,30 +2401,60 @@
2409
2401
  "name": "CompilationStrategy",
2410
2402
  "typeTokenRange": {
2411
2403
  "startIndex": 1,
2412
- "endIndex": 9
2404
+ "endIndex": 11
2413
2405
  }
2414
2406
  },
2415
2407
  {
2416
- "kind": "Variable",
2417
- "canonicalReference": "@microsoft/fast-element!Compiler:var",
2418
- "docComment": "/**\n * Common APIs related to compilation.\n *\n * @public\n */\n",
2408
+ "kind": "TypeAlias",
2409
+ "canonicalReference": "@microsoft/fast-element!CompiledViewBehaviorFactory:type",
2410
+ "docComment": "/**\n * Represents a ViewBehaviorFactory after the compilation process has completed.\n *\n * @public\n */\n",
2419
2411
  "excerptTokens": [
2420
2412
  {
2421
2413
  "kind": "Content",
2422
- "text": "Compiler: "
2414
+ "text": "export declare type CompiledViewBehaviorFactory = "
2415
+ },
2416
+ {
2417
+ "kind": "Reference",
2418
+ "text": "Required",
2419
+ "canonicalReference": "!Required:type"
2423
2420
  },
2424
2421
  {
2425
2422
  "kind": "Content",
2426
- "text": "{\n setHTMLPolicy(policy: "
2423
+ "text": "<"
2427
2424
  },
2428
2425
  {
2429
2426
  "kind": "Reference",
2430
- "text": "TrustedTypesPolicy",
2431
- "canonicalReference": "@microsoft/fast-element!TrustedTypesPolicy:type"
2427
+ "text": "ViewBehaviorFactory",
2428
+ "canonicalReference": "@microsoft/fast-element!ViewBehaviorFactory:interface"
2429
+ },
2430
+ {
2431
+ "kind": "Content",
2432
+ "text": ">"
2433
+ },
2434
+ {
2435
+ "kind": "Content",
2436
+ "text": ";"
2437
+ }
2438
+ ],
2439
+ "releaseTag": "Public",
2440
+ "name": "CompiledViewBehaviorFactory",
2441
+ "typeTokenRange": {
2442
+ "startIndex": 1,
2443
+ "endIndex": 5
2444
+ }
2445
+ },
2446
+ {
2447
+ "kind": "Variable",
2448
+ "canonicalReference": "@microsoft/fast-element!Compiler:var",
2449
+ "docComment": "/**\n * Common APIs related to compilation.\n *\n * @public\n */\n",
2450
+ "excerptTokens": [
2451
+ {
2452
+ "kind": "Content",
2453
+ "text": "Compiler: "
2432
2454
  },
2433
2455
  {
2434
2456
  "kind": "Content",
2435
- "text": "): void;\n compile<TSource = any, TParent = any>(html: string | "
2457
+ "text": "{\n compile<TSource = any, TParent = any>(html: string | "
2436
2458
  },
2437
2459
  {
2438
2460
  "kind": "Reference",
@@ -2441,7 +2463,7 @@
2441
2463
  },
2442
2464
  {
2443
2465
  "kind": "Content",
2444
- "text": ", directives: "
2466
+ "text": ", factories: "
2445
2467
  },
2446
2468
  {
2447
2469
  "kind": "Reference",
@@ -2459,7 +2481,16 @@
2459
2481
  },
2460
2482
  {
2461
2483
  "kind": "Content",
2462
- "text": ">): "
2484
+ "text": ">, policy?: "
2485
+ },
2486
+ {
2487
+ "kind": "Reference",
2488
+ "text": "DOMPolicy",
2489
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
2490
+ },
2491
+ {
2492
+ "kind": "Content",
2493
+ "text": "): "
2463
2494
  },
2464
2495
  {
2465
2496
  "kind": "Reference",
@@ -2486,7 +2517,16 @@
2486
2517
  },
2487
2518
  {
2488
2519
  "kind": "Content",
2489
- "text": ")[]): "
2520
+ "text": ")[], policy?: "
2521
+ },
2522
+ {
2523
+ "kind": "Reference",
2524
+ "text": "DOMPolicy",
2525
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
2526
+ },
2527
+ {
2528
+ "kind": "Content",
2529
+ "text": "): "
2490
2530
  },
2491
2531
  {
2492
2532
  "kind": "Reference",
@@ -2502,7 +2542,7 @@
2502
2542
  "name": "Compiler",
2503
2543
  "variableTypeTokenRange": {
2504
2544
  "startIndex": 1,
2505
- "endIndex": 18
2545
+ "endIndex": 20
2506
2546
  }
2507
2547
  },
2508
2548
  {
@@ -3439,53 +3479,232 @@
3439
3479
  "name": "customElement"
3440
3480
  },
3441
3481
  {
3442
- "kind": "TypeAlias",
3443
- "canonicalReference": "@microsoft/fast-element!DecoratorAttributeConfiguration:type",
3444
- "docComment": "/**\n * Metadata used to configure a custom attribute's behavior through a decorator.\n *\n * @public\n */\n",
3482
+ "kind": "Function",
3483
+ "canonicalReference": "@microsoft/fast-element!dangerousHTML:function(1)",
3484
+ "docComment": "/**\n * Injects static HTML without platform protection.\n *\n * @param html - The html to injection.\n *\n * @returns A DangerousHTMLDirective.\n *\n * @public\n */\n",
3445
3485
  "excerptTokens": [
3446
3486
  {
3447
3487
  "kind": "Content",
3448
- "text": "export declare type DecoratorAttributeConfiguration = "
3488
+ "text": "export declare function dangerousHTML<TSource = "
3449
3489
  },
3450
3490
  {
3451
- "kind": "Reference",
3452
- "text": "Omit",
3453
- "canonicalReference": "!Omit:type"
3491
+ "kind": "Content",
3492
+ "text": "any"
3454
3493
  },
3455
3494
  {
3456
3495
  "kind": "Content",
3457
- "text": "<"
3496
+ "text": ", TParent = "
3497
+ },
3498
+ {
3499
+ "kind": "Content",
3500
+ "text": "any"
3501
+ },
3502
+ {
3503
+ "kind": "Content",
3504
+ "text": ">(html: "
3505
+ },
3506
+ {
3507
+ "kind": "Content",
3508
+ "text": "string"
3509
+ },
3510
+ {
3511
+ "kind": "Content",
3512
+ "text": "): "
3458
3513
  },
3459
3514
  {
3460
3515
  "kind": "Reference",
3461
- "text": "AttributeConfiguration",
3462
- "canonicalReference": "@microsoft/fast-element!AttributeConfiguration:type"
3516
+ "text": "CaptureType",
3517
+ "canonicalReference": "@microsoft/fast-element!CaptureType:interface"
3463
3518
  },
3464
3519
  {
3465
3520
  "kind": "Content",
3466
- "text": ", \"property\">"
3521
+ "text": "<TSource, TParent>"
3467
3522
  },
3468
3523
  {
3469
3524
  "kind": "Content",
3470
3525
  "text": ";"
3471
3526
  }
3472
3527
  ],
3528
+ "returnTypeTokenRange": {
3529
+ "startIndex": 7,
3530
+ "endIndex": 9
3531
+ },
3473
3532
  "releaseTag": "Public",
3474
- "name": "DecoratorAttributeConfiguration",
3475
- "typeTokenRange": {
3476
- "startIndex": 1,
3477
- "endIndex": 5
3478
- }
3479
- },
3480
- {
3481
- "kind": "Interface",
3482
- "canonicalReference": "@microsoft/fast-element!Disposable:interface",
3483
- "docComment": "/**\n * Provides a mechanism for releasing resources.\n *\n * @public\n */\n",
3484
- "excerptTokens": [
3533
+ "overloadIndex": 1,
3534
+ "parameters": [
3485
3535
  {
3486
- "kind": "Content",
3487
- "text": "export interface Disposable "
3488
- }
3536
+ "parameterName": "html",
3537
+ "parameterTypeTokenRange": {
3538
+ "startIndex": 5,
3539
+ "endIndex": 6
3540
+ },
3541
+ "isOptional": false
3542
+ }
3543
+ ],
3544
+ "typeParameters": [
3545
+ {
3546
+ "typeParameterName": "TSource",
3547
+ "constraintTokenRange": {
3548
+ "startIndex": 0,
3549
+ "endIndex": 0
3550
+ },
3551
+ "defaultTypeTokenRange": {
3552
+ "startIndex": 1,
3553
+ "endIndex": 2
3554
+ }
3555
+ },
3556
+ {
3557
+ "typeParameterName": "TParent",
3558
+ "constraintTokenRange": {
3559
+ "startIndex": 0,
3560
+ "endIndex": 0
3561
+ },
3562
+ "defaultTypeTokenRange": {
3563
+ "startIndex": 3,
3564
+ "endIndex": 4
3565
+ }
3566
+ }
3567
+ ],
3568
+ "name": "dangerousHTML"
3569
+ },
3570
+ {
3571
+ "kind": "Class",
3572
+ "canonicalReference": "@microsoft/fast-element!DangerousHTMLDirective:class",
3573
+ "docComment": "/**\n * A directive capable of injecting static HTML platform runtime protection.\n *\n * @public\n */\n",
3574
+ "excerptTokens": [
3575
+ {
3576
+ "kind": "Content",
3577
+ "text": "export declare class DangerousHTMLDirective implements "
3578
+ },
3579
+ {
3580
+ "kind": "Reference",
3581
+ "text": "HTMLDirective",
3582
+ "canonicalReference": "@microsoft/fast-element!HTMLDirective:interface"
3583
+ },
3584
+ {
3585
+ "kind": "Content",
3586
+ "text": " "
3587
+ }
3588
+ ],
3589
+ "releaseTag": "Public",
3590
+ "name": "DangerousHTMLDirective",
3591
+ "members": [
3592
+ {
3593
+ "kind": "Constructor",
3594
+ "canonicalReference": "@microsoft/fast-element!DangerousHTMLDirective:constructor(1)",
3595
+ "docComment": "/**\n * Constructs a new instance of the `DangerousHTMLDirective` class\n */\n",
3596
+ "excerptTokens": [
3597
+ {
3598
+ "kind": "Content",
3599
+ "text": "constructor(html: "
3600
+ },
3601
+ {
3602
+ "kind": "Content",
3603
+ "text": "string"
3604
+ },
3605
+ {
3606
+ "kind": "Content",
3607
+ "text": ");"
3608
+ }
3609
+ ],
3610
+ "releaseTag": "Public",
3611
+ "overloadIndex": 1,
3612
+ "parameters": [
3613
+ {
3614
+ "parameterName": "html",
3615
+ "parameterTypeTokenRange": {
3616
+ "startIndex": 1,
3617
+ "endIndex": 2
3618
+ },
3619
+ "isOptional": false
3620
+ }
3621
+ ]
3622
+ },
3623
+ {
3624
+ "kind": "Method",
3625
+ "canonicalReference": "@microsoft/fast-element!DangerousHTMLDirective#createHTML:member(1)",
3626
+ "docComment": "",
3627
+ "excerptTokens": [
3628
+ {
3629
+ "kind": "Content",
3630
+ "text": "createHTML(): "
3631
+ },
3632
+ {
3633
+ "kind": "Content",
3634
+ "text": "string"
3635
+ },
3636
+ {
3637
+ "kind": "Content",
3638
+ "text": ";"
3639
+ }
3640
+ ],
3641
+ "isOptional": false,
3642
+ "isStatic": false,
3643
+ "returnTypeTokenRange": {
3644
+ "startIndex": 1,
3645
+ "endIndex": 2
3646
+ },
3647
+ "releaseTag": "Public",
3648
+ "overloadIndex": 1,
3649
+ "parameters": [],
3650
+ "name": "createHTML"
3651
+ }
3652
+ ],
3653
+ "implementsTokenRanges": [
3654
+ {
3655
+ "startIndex": 1,
3656
+ "endIndex": 2
3657
+ }
3658
+ ]
3659
+ },
3660
+ {
3661
+ "kind": "TypeAlias",
3662
+ "canonicalReference": "@microsoft/fast-element!DecoratorAttributeConfiguration:type",
3663
+ "docComment": "/**\n * Metadata used to configure a custom attribute's behavior through a decorator.\n *\n * @public\n */\n",
3664
+ "excerptTokens": [
3665
+ {
3666
+ "kind": "Content",
3667
+ "text": "export declare type DecoratorAttributeConfiguration = "
3668
+ },
3669
+ {
3670
+ "kind": "Reference",
3671
+ "text": "Omit",
3672
+ "canonicalReference": "!Omit:type"
3673
+ },
3674
+ {
3675
+ "kind": "Content",
3676
+ "text": "<"
3677
+ },
3678
+ {
3679
+ "kind": "Reference",
3680
+ "text": "AttributeConfiguration",
3681
+ "canonicalReference": "@microsoft/fast-element!AttributeConfiguration:type"
3682
+ },
3683
+ {
3684
+ "kind": "Content",
3685
+ "text": ", \"property\">"
3686
+ },
3687
+ {
3688
+ "kind": "Content",
3689
+ "text": ";"
3690
+ }
3691
+ ],
3692
+ "releaseTag": "Public",
3693
+ "name": "DecoratorAttributeConfiguration",
3694
+ "typeTokenRange": {
3695
+ "startIndex": 1,
3696
+ "endIndex": 5
3697
+ }
3698
+ },
3699
+ {
3700
+ "kind": "Interface",
3701
+ "canonicalReference": "@microsoft/fast-element!Disposable:interface",
3702
+ "docComment": "/**\n * Provides a mechanism for releasing resources.\n *\n * @public\n */\n",
3703
+ "excerptTokens": [
3704
+ {
3705
+ "kind": "Content",
3706
+ "text": "export interface Disposable "
3707
+ }
3489
3708
  ],
3490
3709
  "releaseTag": "Public",
3491
3710
  "name": "Disposable",
@@ -3555,7 +3774,25 @@
3555
3774
  },
3556
3775
  {
3557
3776
  "kind": "Content",
3558
- "text": "<void>;\n processUpdates: () => void;\n setAttribute(element: "
3777
+ "text": "<void>;\n processUpdates: () => void;\n readonly policy: "
3778
+ },
3779
+ {
3780
+ "kind": "Reference",
3781
+ "text": "DOMPolicy",
3782
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
3783
+ },
3784
+ {
3785
+ "kind": "Content",
3786
+ "text": ";\n setPolicy(value: "
3787
+ },
3788
+ {
3789
+ "kind": "Reference",
3790
+ "text": "DOMPolicy",
3791
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
3792
+ },
3793
+ {
3794
+ "kind": "Content",
3795
+ "text": "): void;\n setAttribute(element: "
3559
3796
  },
3560
3797
  {
3561
3798
  "kind": "Reference",
@@ -3573,14 +3810,283 @@
3573
3810
  },
3574
3811
  {
3575
3812
  "kind": "Content",
3576
- "text": ", attributeName: string, value: boolean): void;\n}>"
3813
+ "text": ", attributeName: string, value: boolean): void;\n}>"
3814
+ }
3815
+ ],
3816
+ "releaseTag": "Public",
3817
+ "name": "DOM",
3818
+ "variableTypeTokenRange": {
3819
+ "startIndex": 1,
3820
+ "endIndex": 15
3821
+ }
3822
+ },
3823
+ {
3824
+ "kind": "TypeAlias",
3825
+ "canonicalReference": "@microsoft/fast-element!DOMAspect:type",
3826
+ "docComment": "/**\n * The type of HTML aspect to target.\n *\n * @public\n */\n",
3827
+ "excerptTokens": [
3828
+ {
3829
+ "kind": "Content",
3830
+ "text": "export declare type DOMAspect = "
3831
+ },
3832
+ {
3833
+ "kind": "Content",
3834
+ "text": "typeof "
3835
+ },
3836
+ {
3837
+ "kind": "Reference",
3838
+ "text": "DOMAspect",
3839
+ "canonicalReference": "@microsoft/fast-element!DOMAspect:var"
3840
+ },
3841
+ {
3842
+ "kind": "Content",
3843
+ "text": "["
3844
+ },
3845
+ {
3846
+ "kind": "Reference",
3847
+ "text": "Exclude",
3848
+ "canonicalReference": "!Exclude:type"
3849
+ },
3850
+ {
3851
+ "kind": "Content",
3852
+ "text": "<keyof typeof "
3853
+ },
3854
+ {
3855
+ "kind": "Reference",
3856
+ "text": "DOMAspect",
3857
+ "canonicalReference": "@microsoft/fast-element!DOMAspect:var"
3858
+ },
3859
+ {
3860
+ "kind": "Content",
3861
+ "text": ", \"none\">]"
3862
+ },
3863
+ {
3864
+ "kind": "Content",
3865
+ "text": ";"
3866
+ }
3867
+ ],
3868
+ "releaseTag": "Public",
3869
+ "name": "DOMAspect",
3870
+ "typeTokenRange": {
3871
+ "startIndex": 1,
3872
+ "endIndex": 8
3873
+ }
3874
+ },
3875
+ {
3876
+ "kind": "Variable",
3877
+ "canonicalReference": "@microsoft/fast-element!DOMAspect:var",
3878
+ "docComment": "/**\n * The type of HTML aspect to target.\n *\n * @public\n */\n",
3879
+ "excerptTokens": [
3880
+ {
3881
+ "kind": "Content",
3882
+ "text": "DOMAspect: "
3883
+ },
3884
+ {
3885
+ "kind": "Reference",
3886
+ "text": "Readonly",
3887
+ "canonicalReference": "!Readonly:type"
3888
+ },
3889
+ {
3890
+ "kind": "Content",
3891
+ "text": "<{\n readonly none: 0;\n readonly attribute: 1;\n readonly booleanAttribute: 2;\n readonly property: 3;\n readonly content: 4;\n readonly tokenList: 5;\n readonly event: 6;\n}>"
3892
+ }
3893
+ ],
3894
+ "releaseTag": "Public",
3895
+ "name": "DOMAspect",
3896
+ "variableTypeTokenRange": {
3897
+ "startIndex": 1,
3898
+ "endIndex": 3
3899
+ }
3900
+ },
3901
+ {
3902
+ "kind": "Interface",
3903
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface",
3904
+ "docComment": "/**\n * A security policy that FAST can use to interact with the DOM.\n *\n * @public\n */\n",
3905
+ "excerptTokens": [
3906
+ {
3907
+ "kind": "Content",
3908
+ "text": "export interface DOMPolicy "
3909
+ }
3910
+ ],
3911
+ "releaseTag": "Public",
3912
+ "name": "DOMPolicy",
3913
+ "members": [
3914
+ {
3915
+ "kind": "MethodSignature",
3916
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy#createHTML:member(1)",
3917
+ "docComment": "/**\n * Creates safe HTML from the provided value.\n *\n * @param value - The source to convert to safe HTML.\n */\n",
3918
+ "excerptTokens": [
3919
+ {
3920
+ "kind": "Content",
3921
+ "text": "createHTML(value: "
3922
+ },
3923
+ {
3924
+ "kind": "Content",
3925
+ "text": "string"
3926
+ },
3927
+ {
3928
+ "kind": "Content",
3929
+ "text": "): "
3930
+ },
3931
+ {
3932
+ "kind": "Content",
3933
+ "text": "string"
3934
+ },
3935
+ {
3936
+ "kind": "Content",
3937
+ "text": ";"
3938
+ }
3939
+ ],
3940
+ "isOptional": false,
3941
+ "returnTypeTokenRange": {
3942
+ "startIndex": 3,
3943
+ "endIndex": 4
3944
+ },
3945
+ "releaseTag": "Public",
3946
+ "overloadIndex": 1,
3947
+ "parameters": [
3948
+ {
3949
+ "parameterName": "value",
3950
+ "parameterTypeTokenRange": {
3951
+ "startIndex": 1,
3952
+ "endIndex": 2
3953
+ },
3954
+ "isOptional": false
3955
+ }
3956
+ ],
3957
+ "name": "createHTML"
3958
+ },
3959
+ {
3960
+ "kind": "MethodSignature",
3961
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy#protect:member(1)",
3962
+ "docComment": "/**\n * Protects a DOM sink that intends to write to the DOM.\n *\n * @param tagName - The tag name for the element to write to.\n *\n * @param aspect - The aspect of the DOM to write to.\n *\n * @param aspectName - The name of the aspect to write to.\n *\n * @param sink - The sink that is used to write to the DOM.\n */\n",
3963
+ "excerptTokens": [
3964
+ {
3965
+ "kind": "Content",
3966
+ "text": "protect(tagName: "
3967
+ },
3968
+ {
3969
+ "kind": "Content",
3970
+ "text": "string | null"
3971
+ },
3972
+ {
3973
+ "kind": "Content",
3974
+ "text": ", aspect: "
3975
+ },
3976
+ {
3977
+ "kind": "Reference",
3978
+ "text": "DOMAspect",
3979
+ "canonicalReference": "@microsoft/fast-element!DOMAspect:type"
3980
+ },
3981
+ {
3982
+ "kind": "Content",
3983
+ "text": ", aspectName: "
3984
+ },
3985
+ {
3986
+ "kind": "Content",
3987
+ "text": "string"
3988
+ },
3989
+ {
3990
+ "kind": "Content",
3991
+ "text": ", sink: "
3992
+ },
3993
+ {
3994
+ "kind": "Reference",
3995
+ "text": "DOMSink",
3996
+ "canonicalReference": "@microsoft/fast-element!DOMSink:type"
3997
+ },
3998
+ {
3999
+ "kind": "Content",
4000
+ "text": "): "
4001
+ },
4002
+ {
4003
+ "kind": "Reference",
4004
+ "text": "DOMSink",
4005
+ "canonicalReference": "@microsoft/fast-element!DOMSink:type"
4006
+ },
4007
+ {
4008
+ "kind": "Content",
4009
+ "text": ";"
4010
+ }
4011
+ ],
4012
+ "isOptional": false,
4013
+ "returnTypeTokenRange": {
4014
+ "startIndex": 9,
4015
+ "endIndex": 10
4016
+ },
4017
+ "releaseTag": "Public",
4018
+ "overloadIndex": 1,
4019
+ "parameters": [
4020
+ {
4021
+ "parameterName": "tagName",
4022
+ "parameterTypeTokenRange": {
4023
+ "startIndex": 1,
4024
+ "endIndex": 2
4025
+ },
4026
+ "isOptional": false
4027
+ },
4028
+ {
4029
+ "parameterName": "aspect",
4030
+ "parameterTypeTokenRange": {
4031
+ "startIndex": 3,
4032
+ "endIndex": 4
4033
+ },
4034
+ "isOptional": false
4035
+ },
4036
+ {
4037
+ "parameterName": "aspectName",
4038
+ "parameterTypeTokenRange": {
4039
+ "startIndex": 5,
4040
+ "endIndex": 6
4041
+ },
4042
+ "isOptional": false
4043
+ },
4044
+ {
4045
+ "parameterName": "sink",
4046
+ "parameterTypeTokenRange": {
4047
+ "startIndex": 7,
4048
+ "endIndex": 8
4049
+ },
4050
+ "isOptional": false
4051
+ }
4052
+ ],
4053
+ "name": "protect"
4054
+ }
4055
+ ],
4056
+ "extendsTokenRanges": []
4057
+ },
4058
+ {
4059
+ "kind": "TypeAlias",
4060
+ "canonicalReference": "@microsoft/fast-element!DOMSink:type",
4061
+ "docComment": "/**\n * A function used to send values to a DOM sink.\n *\n * @public\n */\n",
4062
+ "excerptTokens": [
4063
+ {
4064
+ "kind": "Content",
4065
+ "text": "export declare type DOMSink = "
4066
+ },
4067
+ {
4068
+ "kind": "Content",
4069
+ "text": "(target: "
4070
+ },
4071
+ {
4072
+ "kind": "Reference",
4073
+ "text": "Node",
4074
+ "canonicalReference": "!Node:interface"
4075
+ },
4076
+ {
4077
+ "kind": "Content",
4078
+ "text": ", aspectName: string, value: any, ...args: any[]) => void"
4079
+ },
4080
+ {
4081
+ "kind": "Content",
4082
+ "text": ";"
3577
4083
  }
3578
4084
  ],
3579
4085
  "releaseTag": "Public",
3580
- "name": "DOM",
3581
- "variableTypeTokenRange": {
4086
+ "name": "DOMSink",
4087
+ "typeTokenRange": {
3582
4088
  "startIndex": 1,
3583
- "endIndex": 11
4089
+ "endIndex": 4
3584
4090
  }
3585
4091
  },
3586
4092
  {
@@ -8326,8 +8832,8 @@
8326
8832
  },
8327
8833
  {
8328
8834
  "kind": "Reference",
8329
- "text": "Aspect",
8330
- "canonicalReference": "@microsoft/fast-element!Aspect:type"
8835
+ "text": "DOMAspect",
8836
+ "canonicalReference": "@microsoft/fast-element!DOMAspect:type"
8331
8837
  },
8332
8838
  {
8333
8839
  "kind": "Content",
@@ -8477,16 +8983,17 @@
8477
8983
  },
8478
8984
  {
8479
8985
  "kind": "Property",
8480
- "canonicalReference": "@microsoft/fast-element!HTMLBindingDirective#nodeId:member",
8481
- "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
8986
+ "canonicalReference": "@microsoft/fast-element!HTMLBindingDirective#policy:member",
8987
+ "docComment": "/**\n * The policy that the created behavior must run under.\n */\n",
8482
8988
  "excerptTokens": [
8483
8989
  {
8484
8990
  "kind": "Content",
8485
- "text": "nodeId: "
8991
+ "text": "policy: "
8486
8992
  },
8487
8993
  {
8488
- "kind": "Content",
8489
- "text": "string"
8994
+ "kind": "Reference",
8995
+ "text": "DOMPolicy",
8996
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
8490
8997
  },
8491
8998
  {
8492
8999
  "kind": "Content",
@@ -8495,7 +9002,7 @@
8495
9002
  ],
8496
9003
  "isOptional": false,
8497
9004
  "releaseTag": "Public",
8498
- "name": "nodeId",
9005
+ "name": "policy",
8499
9006
  "propertyTypeTokenRange": {
8500
9007
  "startIndex": 1,
8501
9008
  "endIndex": 2
@@ -8555,6 +9062,60 @@
8555
9062
  "endIndex": 2
8556
9063
  },
8557
9064
  "isStatic": false
9065
+ },
9066
+ {
9067
+ "kind": "Property",
9068
+ "canonicalReference": "@microsoft/fast-element!HTMLBindingDirective#targetNodeId:member",
9069
+ "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
9070
+ "excerptTokens": [
9071
+ {
9072
+ "kind": "Content",
9073
+ "text": "targetNodeId: "
9074
+ },
9075
+ {
9076
+ "kind": "Content",
9077
+ "text": "string"
9078
+ },
9079
+ {
9080
+ "kind": "Content",
9081
+ "text": ";"
9082
+ }
9083
+ ],
9084
+ "isOptional": false,
9085
+ "releaseTag": "Public",
9086
+ "name": "targetNodeId",
9087
+ "propertyTypeTokenRange": {
9088
+ "startIndex": 1,
9089
+ "endIndex": 2
9090
+ },
9091
+ "isStatic": false
9092
+ },
9093
+ {
9094
+ "kind": "Property",
9095
+ "canonicalReference": "@microsoft/fast-element!HTMLBindingDirective#targetTagName:member",
9096
+ "docComment": "/**\n * The tagname associated with the target node.\n */\n",
9097
+ "excerptTokens": [
9098
+ {
9099
+ "kind": "Content",
9100
+ "text": "targetTagName: "
9101
+ },
9102
+ {
9103
+ "kind": "Content",
9104
+ "text": "string | null"
9105
+ },
9106
+ {
9107
+ "kind": "Content",
9108
+ "text": ";"
9109
+ }
9110
+ ],
9111
+ "isOptional": false,
9112
+ "releaseTag": "Public",
9113
+ "name": "targetTagName",
9114
+ "propertyTypeTokenRange": {
9115
+ "startIndex": 1,
9116
+ "endIndex": 2
9117
+ },
9118
+ "isStatic": false
8558
9119
  }
8559
9120
  ],
8560
9121
  "implementsTokenRanges": [
@@ -8807,14 +9368,23 @@
8807
9368
  },
8808
9369
  {
8809
9370
  "kind": "Content",
8810
- "text": "): TType;\n}>"
9371
+ "text": "): TType;\n assignAspect(directive: "
9372
+ },
9373
+ {
9374
+ "kind": "Reference",
9375
+ "text": "Aspected",
9376
+ "canonicalReference": "@microsoft/fast-element!Aspected:interface"
9377
+ },
9378
+ {
9379
+ "kind": "Content",
9380
+ "text": ", value?: string): void;\n}>"
8811
9381
  }
8812
9382
  ],
8813
9383
  "releaseTag": "Public",
8814
9384
  "name": "HTMLDirective",
8815
9385
  "variableTypeTokenRange": {
8816
9386
  "startIndex": 1,
8817
- "endIndex": 23
9387
+ "endIndex": 25
8818
9388
  }
8819
9389
  },
8820
9390
  {
@@ -9163,8 +9733,8 @@
9163
9733
  },
9164
9734
  {
9165
9735
  "kind": "Reference",
9166
- "text": "ViewBehaviorFactory",
9167
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorFactory:interface"
9736
+ "text": "CompiledViewBehaviorFactory",
9737
+ "canonicalReference": "@microsoft/fast-element!CompiledViewBehaviorFactory:type"
9168
9738
  },
9169
9739
  {
9170
9740
  "kind": "Content",
@@ -10757,6 +11327,37 @@
10757
11327
  ],
10758
11328
  "name": "getSource"
10759
11329
  },
11330
+ {
11331
+ "kind": "Property",
11332
+ "canonicalReference": "@microsoft/fast-element!NodeObservationDirective#id:member",
11333
+ "docComment": "/**\n * The unique id of the factory.\n */\n",
11334
+ "excerptTokens": [
11335
+ {
11336
+ "kind": "Content",
11337
+ "text": "get id(): "
11338
+ },
11339
+ {
11340
+ "kind": "Content",
11341
+ "text": "string"
11342
+ },
11343
+ {
11344
+ "kind": "Content",
11345
+ "text": ";"
11346
+ },
11347
+ {
11348
+ "kind": "Content",
11349
+ "text": "\n\nset id(value: string);"
11350
+ }
11351
+ ],
11352
+ "isOptional": false,
11353
+ "releaseTag": "Public",
11354
+ "name": "id",
11355
+ "propertyTypeTokenRange": {
11356
+ "startIndex": 1,
11357
+ "endIndex": 2
11358
+ },
11359
+ "isStatic": false
11360
+ },
10760
11361
  {
10761
11362
  "kind": "Method",
10762
11363
  "canonicalReference": "@microsoft/fast-element!NodeObservationDirective#observe:member(1)",
@@ -10803,6 +11404,33 @@
10803
11404
  ],
10804
11405
  "name": "observe"
10805
11406
  },
11407
+ {
11408
+ "kind": "Property",
11409
+ "canonicalReference": "@microsoft/fast-element!NodeObservationDirective#targetNodeId:member",
11410
+ "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
11411
+ "excerptTokens": [
11412
+ {
11413
+ "kind": "Content",
11414
+ "text": "targetNodeId: "
11415
+ },
11416
+ {
11417
+ "kind": "Content",
11418
+ "text": "string"
11419
+ },
11420
+ {
11421
+ "kind": "Content",
11422
+ "text": ";"
11423
+ }
11424
+ ],
11425
+ "isOptional": false,
11426
+ "releaseTag": "Public",
11427
+ "name": "targetNodeId",
11428
+ "propertyTypeTokenRange": {
11429
+ "startIndex": 1,
11430
+ "endIndex": 2
11431
+ },
11432
+ "isStatic": false
11433
+ },
10806
11434
  {
10807
11435
  "kind": "Method",
10808
11436
  "canonicalReference": "@microsoft/fast-element!NodeObservationDirective#unbind:member(1)",
@@ -11522,7 +12150,7 @@
11522
12150
  {
11523
12151
  "kind": "Function",
11524
12152
  "canonicalReference": "@microsoft/fast-element!oneTime:function(1)",
11525
- "docComment": "/**\n * Creates a one time binding\n *\n * @param expression - The binding to refresh when signaled.\n *\n * @returns A binding configuration.\n *\n * @public\n */\n",
12153
+ "docComment": "/**\n * Creates a one time binding\n *\n * @param expression - The binding to refresh when signaled.\n *\n * @param policy - The security policy to associate with th binding.\n *\n * @returns A binding configuration.\n *\n * @public\n */\n",
11526
12154
  "excerptTokens": [
11527
12155
  {
11528
12156
  "kind": "Content",
@@ -11545,6 +12173,15 @@
11545
12173
  "kind": "Content",
11546
12174
  "text": "<T>"
11547
12175
  },
12176
+ {
12177
+ "kind": "Content",
12178
+ "text": ", policy?: "
12179
+ },
12180
+ {
12181
+ "kind": "Reference",
12182
+ "text": "DOMPolicy",
12183
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
12184
+ },
11548
12185
  {
11549
12186
  "kind": "Content",
11550
12187
  "text": "): "
@@ -11564,8 +12201,8 @@
11564
12201
  }
11565
12202
  ],
11566
12203
  "returnTypeTokenRange": {
11567
- "startIndex": 6,
11568
- "endIndex": 8
12204
+ "startIndex": 8,
12205
+ "endIndex": 10
11569
12206
  },
11570
12207
  "releaseTag": "Public",
11571
12208
  "overloadIndex": 1,
@@ -11577,6 +12214,14 @@
11577
12214
  "endIndex": 5
11578
12215
  },
11579
12216
  "isOptional": false
12217
+ },
12218
+ {
12219
+ "parameterName": "policy",
12220
+ "parameterTypeTokenRange": {
12221
+ "startIndex": 6,
12222
+ "endIndex": 7
12223
+ },
12224
+ "isOptional": true
11580
12225
  }
11581
12226
  ],
11582
12227
  "typeParameters": [
@@ -12285,6 +12930,33 @@
12285
12930
  }
12286
12931
  ],
12287
12932
  "name": "bind"
12933
+ },
12934
+ {
12935
+ "kind": "Property",
12936
+ "canonicalReference": "@microsoft/fast-element!RefDirective#targetNodeId:member",
12937
+ "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
12938
+ "excerptTokens": [
12939
+ {
12940
+ "kind": "Content",
12941
+ "text": "targetNodeId: "
12942
+ },
12943
+ {
12944
+ "kind": "Content",
12945
+ "text": "string"
12946
+ },
12947
+ {
12948
+ "kind": "Content",
12949
+ "text": ";"
12950
+ }
12951
+ ],
12952
+ "isOptional": false,
12953
+ "releaseTag": "Public",
12954
+ "name": "targetNodeId",
12955
+ "propertyTypeTokenRange": {
12956
+ "startIndex": 1,
12957
+ "endIndex": 2
12958
+ },
12959
+ "isStatic": false
12288
12960
  }
12289
12961
  ],
12290
12962
  "extendsTokenRange": {
@@ -13010,16 +13682,17 @@
13010
13682
  },
13011
13683
  {
13012
13684
  "kind": "Property",
13013
- "canonicalReference": "@microsoft/fast-element!RepeatDirective#id:member",
13014
- "docComment": "/**\n * The unique id of the factory.\n */\n",
13685
+ "canonicalReference": "@microsoft/fast-element!RepeatDirective#options:member",
13686
+ "docComment": "",
13015
13687
  "excerptTokens": [
13016
13688
  {
13017
13689
  "kind": "Content",
13018
- "text": "id: "
13690
+ "text": "readonly options: "
13019
13691
  },
13020
13692
  {
13021
- "kind": "Content",
13022
- "text": "string"
13693
+ "kind": "Reference",
13694
+ "text": "RepeatOptions",
13695
+ "canonicalReference": "@microsoft/fast-element!RepeatOptions:interface"
13023
13696
  },
13024
13697
  {
13025
13698
  "kind": "Content",
@@ -13028,7 +13701,7 @@
13028
13701
  ],
13029
13702
  "isOptional": false,
13030
13703
  "releaseTag": "Public",
13031
- "name": "id",
13704
+ "name": "options",
13032
13705
  "propertyTypeTokenRange": {
13033
13706
  "startIndex": 1,
13034
13707
  "endIndex": 2
@@ -13037,12 +13710,12 @@
13037
13710
  },
13038
13711
  {
13039
13712
  "kind": "Property",
13040
- "canonicalReference": "@microsoft/fast-element!RepeatDirective#nodeId:member",
13713
+ "canonicalReference": "@microsoft/fast-element!RepeatDirective#targetNodeId:member",
13041
13714
  "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
13042
13715
  "excerptTokens": [
13043
13716
  {
13044
13717
  "kind": "Content",
13045
- "text": "nodeId: "
13718
+ "text": "targetNodeId: "
13046
13719
  },
13047
13720
  {
13048
13721
  "kind": "Content",
@@ -13055,35 +13728,7 @@
13055
13728
  ],
13056
13729
  "isOptional": false,
13057
13730
  "releaseTag": "Public",
13058
- "name": "nodeId",
13059
- "propertyTypeTokenRange": {
13060
- "startIndex": 1,
13061
- "endIndex": 2
13062
- },
13063
- "isStatic": false
13064
- },
13065
- {
13066
- "kind": "Property",
13067
- "canonicalReference": "@microsoft/fast-element!RepeatDirective#options:member",
13068
- "docComment": "",
13069
- "excerptTokens": [
13070
- {
13071
- "kind": "Content",
13072
- "text": "readonly options: "
13073
- },
13074
- {
13075
- "kind": "Reference",
13076
- "text": "RepeatOptions",
13077
- "canonicalReference": "@microsoft/fast-element!RepeatOptions:interface"
13078
- },
13079
- {
13080
- "kind": "Content",
13081
- "text": ";"
13082
- }
13083
- ],
13084
- "isOptional": false,
13085
- "releaseTag": "Public",
13086
- "name": "options",
13731
+ "name": "targetNodeId",
13087
13732
  "propertyTypeTokenRange": {
13088
13733
  "startIndex": 1,
13089
13734
  "endIndex": 2
@@ -15052,74 +15697,20 @@
15052
15697
  "returnTypeTokenRange": {
15053
15698
  "startIndex": 3,
15054
15699
  "endIndex": 4
15055
- },
15056
- "releaseTag": "Public",
15057
- "overloadIndex": 1,
15058
- "parameters": [
15059
- {
15060
- "parameterName": "add",
15061
- "parameterTypeTokenRange": {
15062
- "startIndex": 1,
15063
- "endIndex": 2
15064
- },
15065
- "isOptional": false
15066
- }
15067
- ],
15068
- "name": "createHTML"
15069
- },
15070
- {
15071
- "kind": "Property",
15072
- "canonicalReference": "@microsoft/fast-element!StatelessAttachedAttributeDirective#id:member",
15073
- "docComment": "/**\n * The unique id of the factory.\n */\n",
15074
- "excerptTokens": [
15075
- {
15076
- "kind": "Content",
15077
- "text": "id: "
15078
- },
15079
- {
15080
- "kind": "Content",
15081
- "text": "string"
15082
- },
15083
- {
15084
- "kind": "Content",
15085
- "text": ";"
15086
- }
15087
- ],
15088
- "isOptional": false,
15089
- "releaseTag": "Public",
15090
- "name": "id",
15091
- "propertyTypeTokenRange": {
15092
- "startIndex": 1,
15093
- "endIndex": 2
15094
- },
15095
- "isStatic": false
15096
- },
15097
- {
15098
- "kind": "Property",
15099
- "canonicalReference": "@microsoft/fast-element!StatelessAttachedAttributeDirective#nodeId:member",
15100
- "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
15101
- "excerptTokens": [
15102
- {
15103
- "kind": "Content",
15104
- "text": "nodeId: "
15105
- },
15106
- {
15107
- "kind": "Content",
15108
- "text": "string"
15109
- },
15700
+ },
15701
+ "releaseTag": "Public",
15702
+ "overloadIndex": 1,
15703
+ "parameters": [
15110
15704
  {
15111
- "kind": "Content",
15112
- "text": ";"
15705
+ "parameterName": "add",
15706
+ "parameterTypeTokenRange": {
15707
+ "startIndex": 1,
15708
+ "endIndex": 2
15709
+ },
15710
+ "isOptional": false
15113
15711
  }
15114
15712
  ],
15115
- "isOptional": false,
15116
- "releaseTag": "Public",
15117
- "name": "nodeId",
15118
- "propertyTypeTokenRange": {
15119
- "startIndex": 1,
15120
- "endIndex": 2
15121
- },
15122
- "isStatic": false
15713
+ "name": "createHTML"
15123
15714
  },
15124
15715
  {
15125
15716
  "kind": "Property",
@@ -16393,74 +16984,6 @@
16393
16984
  "endIndex": 11
16394
16985
  }
16395
16986
  },
16396
- {
16397
- "kind": "TypeAlias",
16398
- "canonicalReference": "@microsoft/fast-element!TrustedTypes:type",
16399
- "docComment": "/**\n * Enables working with trusted types.\n *\n * @public\n */\n",
16400
- "excerptTokens": [
16401
- {
16402
- "kind": "Content",
16403
- "text": "export declare type TrustedTypes = "
16404
- },
16405
- {
16406
- "kind": "Content",
16407
- "text": "{\n createPolicy(name: string, rules: "
16408
- },
16409
- {
16410
- "kind": "Reference",
16411
- "text": "TrustedTypesPolicy",
16412
- "canonicalReference": "@microsoft/fast-element!TrustedTypesPolicy:type"
16413
- },
16414
- {
16415
- "kind": "Content",
16416
- "text": "): "
16417
- },
16418
- {
16419
- "kind": "Reference",
16420
- "text": "TrustedTypesPolicy",
16421
- "canonicalReference": "@microsoft/fast-element!TrustedTypesPolicy:type"
16422
- },
16423
- {
16424
- "kind": "Content",
16425
- "text": ";\n}"
16426
- },
16427
- {
16428
- "kind": "Content",
16429
- "text": ";"
16430
- }
16431
- ],
16432
- "releaseTag": "Public",
16433
- "name": "TrustedTypes",
16434
- "typeTokenRange": {
16435
- "startIndex": 1,
16436
- "endIndex": 6
16437
- }
16438
- },
16439
- {
16440
- "kind": "TypeAlias",
16441
- "canonicalReference": "@microsoft/fast-element!TrustedTypesPolicy:type",
16442
- "docComment": "/**\n * A policy for use with the standard trustedTypes platform API.\n *\n * @public\n */\n",
16443
- "excerptTokens": [
16444
- {
16445
- "kind": "Content",
16446
- "text": "export declare type TrustedTypesPolicy = "
16447
- },
16448
- {
16449
- "kind": "Content",
16450
- "text": "{\n createHTML(html: string): string;\n}"
16451
- },
16452
- {
16453
- "kind": "Content",
16454
- "text": ";"
16455
- }
16456
- ],
16457
- "releaseTag": "Public",
16458
- "name": "TrustedTypesPolicy",
16459
- "typeTokenRange": {
16460
- "startIndex": 1,
16461
- "endIndex": 2
16462
- }
16463
- },
16464
16987
  {
16465
16988
  "kind": "Interface",
16466
16989
  "canonicalReference": "@microsoft/fast-element!UpdateQueue:interface",
@@ -17133,7 +17656,7 @@
17133
17656
  "excerptTokens": [
17134
17657
  {
17135
17658
  "kind": "Content",
17136
- "text": "id: "
17659
+ "text": "id?: "
17137
17660
  },
17138
17661
  {
17139
17662
  "kind": "Content",
@@ -17144,7 +17667,7 @@
17144
17667
  "text": ";"
17145
17668
  }
17146
17669
  ],
17147
- "isOptional": false,
17670
+ "isOptional": true,
17148
17671
  "releaseTag": "Public",
17149
17672
  "name": "id",
17150
17673
  "propertyTypeTokenRange": {
@@ -17154,225 +17677,39 @@
17154
17677
  },
17155
17678
  {
17156
17679
  "kind": "PropertySignature",
17157
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorFactory#nodeId:member",
17158
- "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
17680
+ "canonicalReference": "@microsoft/fast-element!ViewBehaviorFactory#policy:member",
17681
+ "docComment": "/**\n * The policy that the created behavior must run under.\n */\n",
17159
17682
  "excerptTokens": [
17160
17683
  {
17161
17684
  "kind": "Content",
17162
- "text": "nodeId: "
17685
+ "text": "policy?: "
17163
17686
  },
17164
17687
  {
17165
- "kind": "Content",
17166
- "text": "string"
17688
+ "kind": "Reference",
17689
+ "text": "DOMPolicy",
17690
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
17167
17691
  },
17168
17692
  {
17169
17693
  "kind": "Content",
17170
17694
  "text": ";"
17171
17695
  }
17172
17696
  ],
17173
- "isOptional": false,
17697
+ "isOptional": true,
17174
17698
  "releaseTag": "Public",
17175
- "name": "nodeId",
17699
+ "name": "policy",
17176
17700
  "propertyTypeTokenRange": {
17177
17701
  "startIndex": 1,
17178
17702
  "endIndex": 2
17179
- }
17180
- }
17181
- ],
17182
- "extendsTokenRanges": []
17183
- },
17184
- {
17185
- "kind": "Interface",
17186
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorOrchestrator:interface",
17187
- "docComment": "/**\n * Bridges between ViewBehaviors and HostBehaviors, enabling a host to control ViewBehaviors.\n *\n * @public\n */\n",
17188
- "excerptTokens": [
17189
- {
17190
- "kind": "Content",
17191
- "text": "export interface ViewBehaviorOrchestrator<TSource = "
17192
- },
17193
- {
17194
- "kind": "Content",
17195
- "text": "any"
17196
- },
17197
- {
17198
- "kind": "Content",
17199
- "text": ", TParent = "
17200
- },
17201
- {
17202
- "kind": "Content",
17203
- "text": "any"
17204
- },
17205
- {
17206
- "kind": "Content",
17207
- "text": "> extends "
17208
- },
17209
- {
17210
- "kind": "Reference",
17211
- "text": "ViewController",
17212
- "canonicalReference": "@microsoft/fast-element!ViewController:interface"
17213
- },
17214
- {
17215
- "kind": "Content",
17216
- "text": "<TSource, TParent>"
17217
- },
17218
- {
17219
- "kind": "Content",
17220
- "text": ", "
17221
- },
17222
- {
17223
- "kind": "Reference",
17224
- "text": "HostBehavior",
17225
- "canonicalReference": "@microsoft/fast-element!HostBehavior:interface"
17226
- },
17227
- {
17228
- "kind": "Content",
17229
- "text": "<TSource> "
17230
- }
17231
- ],
17232
- "releaseTag": "Public",
17233
- "typeParameters": [
17234
- {
17235
- "typeParameterName": "TSource",
17236
- "constraintTokenRange": {
17237
- "startIndex": 0,
17238
- "endIndex": 0
17239
- },
17240
- "defaultTypeTokenRange": {
17241
- "startIndex": 1,
17242
- "endIndex": 2
17243
- }
17244
- },
17245
- {
17246
- "typeParameterName": "TParent",
17247
- "constraintTokenRange": {
17248
- "startIndex": 0,
17249
- "endIndex": 0
17250
- },
17251
- "defaultTypeTokenRange": {
17252
- "startIndex": 3,
17253
- "endIndex": 4
17254
- }
17255
- }
17256
- ],
17257
- "name": "ViewBehaviorOrchestrator",
17258
- "members": [
17259
- {
17260
- "kind": "MethodSignature",
17261
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorOrchestrator#addBehavior:member(1)",
17262
- "docComment": "/**\n * Adds a behavior.\n *\n * @param behavior - The behavior to add.\n */\n",
17263
- "excerptTokens": [
17264
- {
17265
- "kind": "Content",
17266
- "text": "addBehavior(behavior: "
17267
- },
17268
- {
17269
- "kind": "Reference",
17270
- "text": "ViewBehavior",
17271
- "canonicalReference": "@microsoft/fast-element!ViewBehavior:interface"
17272
- },
17273
- {
17274
- "kind": "Content",
17275
- "text": "): "
17276
- },
17277
- {
17278
- "kind": "Content",
17279
- "text": "void"
17280
- },
17281
- {
17282
- "kind": "Content",
17283
- "text": ";"
17284
- }
17285
- ],
17286
- "isOptional": false,
17287
- "returnTypeTokenRange": {
17288
- "startIndex": 3,
17289
- "endIndex": 4
17290
- },
17291
- "releaseTag": "Public",
17292
- "overloadIndex": 1,
17293
- "parameters": [
17294
- {
17295
- "parameterName": "behavior",
17296
- "parameterTypeTokenRange": {
17297
- "startIndex": 1,
17298
- "endIndex": 2
17299
- },
17300
- "isOptional": false
17301
- }
17302
- ],
17303
- "name": "addBehavior"
17304
- },
17305
- {
17306
- "kind": "MethodSignature",
17307
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorOrchestrator#addBehaviorFactory:member(1)",
17308
- "docComment": "/**\n * Adds a behavior factory.\n *\n * @param factory - The behavior factory to add.\n *\n * @param target - The target the factory will create behaviors for.\n */\n",
17309
- "excerptTokens": [
17310
- {
17311
- "kind": "Content",
17312
- "text": "addBehaviorFactory(factory: "
17313
- },
17314
- {
17315
- "kind": "Reference",
17316
- "text": "ViewBehaviorFactory",
17317
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorFactory:interface"
17318
- },
17319
- {
17320
- "kind": "Content",
17321
- "text": ", target: "
17322
- },
17323
- {
17324
- "kind": "Reference",
17325
- "text": "Node",
17326
- "canonicalReference": "!Node:interface"
17327
- },
17328
- {
17329
- "kind": "Content",
17330
- "text": "): "
17331
- },
17332
- {
17333
- "kind": "Content",
17334
- "text": "void"
17335
- },
17336
- {
17337
- "kind": "Content",
17338
- "text": ";"
17339
- }
17340
- ],
17341
- "isOptional": false,
17342
- "returnTypeTokenRange": {
17343
- "startIndex": 5,
17344
- "endIndex": 6
17345
- },
17346
- "releaseTag": "Public",
17347
- "overloadIndex": 1,
17348
- "parameters": [
17349
- {
17350
- "parameterName": "factory",
17351
- "parameterTypeTokenRange": {
17352
- "startIndex": 1,
17353
- "endIndex": 2
17354
- },
17355
- "isOptional": false
17356
- },
17357
- {
17358
- "parameterName": "target",
17359
- "parameterTypeTokenRange": {
17360
- "startIndex": 3,
17361
- "endIndex": 4
17362
- },
17363
- "isOptional": false
17364
- }
17365
- ],
17366
- "name": "addBehaviorFactory"
17703
+ }
17367
17704
  },
17368
17705
  {
17369
- "kind": "MethodSignature",
17370
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorOrchestrator#addTarget:member(1)",
17371
- "docComment": "/**\n * @param nodeId - The structural id of the DOM node to which a behavior will apply.\n *\n * @param target - The DOM node associated with the id.\n */\n",
17706
+ "kind": "PropertySignature",
17707
+ "canonicalReference": "@microsoft/fast-element!ViewBehaviorFactory#targetNodeId:member",
17708
+ "docComment": "/**\n * The structural id of the DOM node to which the created behavior will apply.\n */\n",
17372
17709
  "excerptTokens": [
17373
17710
  {
17374
17711
  "kind": "Content",
17375
- "text": "addTarget(nodeId: "
17712
+ "text": "targetNodeId?: "
17376
17713
  },
17377
17714
  {
17378
17715
  "kind": "Content",
@@ -17380,99 +17717,45 @@
17380
17717
  },
17381
17718
  {
17382
17719
  "kind": "Content",
17383
- "text": ", target: "
17384
- },
17385
- {
17386
- "kind": "Reference",
17387
- "text": "Node",
17388
- "canonicalReference": "!Node:interface"
17389
- },
17720
+ "text": ";"
17721
+ }
17722
+ ],
17723
+ "isOptional": true,
17724
+ "releaseTag": "Public",
17725
+ "name": "targetNodeId",
17726
+ "propertyTypeTokenRange": {
17727
+ "startIndex": 1,
17728
+ "endIndex": 2
17729
+ }
17730
+ },
17731
+ {
17732
+ "kind": "PropertySignature",
17733
+ "canonicalReference": "@microsoft/fast-element!ViewBehaviorFactory#targetTagName:member",
17734
+ "docComment": "/**\n * The tag name of the DOM node to which the created behavior will apply.\n */\n",
17735
+ "excerptTokens": [
17390
17736
  {
17391
17737
  "kind": "Content",
17392
- "text": "): "
17738
+ "text": "targetTagName?: "
17393
17739
  },
17394
17740
  {
17395
17741
  "kind": "Content",
17396
- "text": "void"
17742
+ "text": "string | null"
17397
17743
  },
17398
17744
  {
17399
17745
  "kind": "Content",
17400
17746
  "text": ";"
17401
17747
  }
17402
17748
  ],
17403
- "isOptional": false,
17404
- "returnTypeTokenRange": {
17405
- "startIndex": 5,
17406
- "endIndex": 6
17407
- },
17749
+ "isOptional": true,
17408
17750
  "releaseTag": "Public",
17409
- "overloadIndex": 1,
17410
- "parameters": [
17411
- {
17412
- "parameterName": "nodeId",
17413
- "parameterTypeTokenRange": {
17414
- "startIndex": 1,
17415
- "endIndex": 2
17416
- },
17417
- "isOptional": false
17418
- },
17419
- {
17420
- "parameterName": "target",
17421
- "parameterTypeTokenRange": {
17422
- "startIndex": 3,
17423
- "endIndex": 4
17424
- },
17425
- "isOptional": false
17426
- }
17427
- ],
17428
- "name": "addTarget"
17429
- }
17430
- ],
17431
- "extendsTokenRanges": [
17432
- {
17433
- "startIndex": 5,
17434
- "endIndex": 7
17435
- },
17436
- {
17437
- "startIndex": 8,
17438
- "endIndex": 9
17439
- }
17440
- ]
17441
- },
17442
- {
17443
- "kind": "Variable",
17444
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorOrchestrator:var",
17445
- "docComment": "/**\n * Bridges between ViewBehaviors and HostBehaviors, enabling a host to control ViewBehaviors.\n *\n * @public\n */\n",
17446
- "excerptTokens": [
17447
- {
17448
- "kind": "Content",
17449
- "text": "ViewBehaviorOrchestrator: "
17450
- },
17451
- {
17452
- "kind": "Reference",
17453
- "text": "Readonly",
17454
- "canonicalReference": "!Readonly:type"
17455
- },
17456
- {
17457
- "kind": "Content",
17458
- "text": "<{\n create<TSource = any, TParent = any>(source: TSource): "
17459
- },
17460
- {
17461
- "kind": "Reference",
17462
- "text": "ViewBehaviorOrchestrator",
17463
- "canonicalReference": "@microsoft/fast-element!ViewBehaviorOrchestrator:interface"
17464
- },
17465
- {
17466
- "kind": "Content",
17467
- "text": "<TSource, TParent>;\n}>"
17751
+ "name": "targetTagName",
17752
+ "propertyTypeTokenRange": {
17753
+ "startIndex": 1,
17754
+ "endIndex": 2
17755
+ }
17468
17756
  }
17469
17757
  ],
17470
- "releaseTag": "Public",
17471
- "name": "ViewBehaviorOrchestrator",
17472
- "variableTypeTokenRange": {
17473
- "startIndex": 1,
17474
- "endIndex": 5
17475
- }
17758
+ "extendsTokenRanges": []
17476
17759
  },
17477
17760
  {
17478
17761
  "kind": "TypeAlias",
@@ -17683,7 +17966,7 @@
17683
17966
  {
17684
17967
  "kind": "Constructor",
17685
17968
  "canonicalReference": "@microsoft/fast-element!ViewTemplate:constructor(1)",
17686
- "docComment": "/**\n * Creates an instance of ViewTemplate.\n *\n * @param html - The html representing what this template will instantiate, including placeholders for directives.\n *\n * @param factories - The directives that will be connected to placeholders in the html.\n */\n",
17969
+ "docComment": "/**\n * Creates an instance of ViewTemplate.\n *\n * @param html - The html representing what this template will instantiate, including placeholders for directives.\n *\n * @param factories - The directives that will be connected to placeholders in the html.\n *\n * @param policy - The security policy to use when compiling this template.\n */\n",
17687
17970
  "excerptTokens": [
17688
17971
  {
17689
17972
  "kind": "Content",
@@ -17700,7 +17983,7 @@
17700
17983
  },
17701
17984
  {
17702
17985
  "kind": "Content",
17703
- "text": ", factories: "
17986
+ "text": ", factories?: "
17704
17987
  },
17705
17988
  {
17706
17989
  "kind": "Reference",
@@ -17720,6 +18003,19 @@
17720
18003
  "kind": "Content",
17721
18004
  "text": ">"
17722
18005
  },
18006
+ {
18007
+ "kind": "Content",
18008
+ "text": ", policy?: "
18009
+ },
18010
+ {
18011
+ "kind": "Reference",
18012
+ "text": "DOMPolicy",
18013
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
18014
+ },
18015
+ {
18016
+ "kind": "Content",
18017
+ "text": " | undefined"
18018
+ },
17723
18019
  {
17724
18020
  "kind": "Content",
17725
18021
  "text": ");"
@@ -17742,7 +18038,15 @@
17742
18038
  "startIndex": 4,
17743
18039
  "endIndex": 8
17744
18040
  },
17745
- "isOptional": false
18041
+ "isOptional": true
18042
+ },
18043
+ {
18044
+ "parameterName": "policy",
18045
+ "parameterTypeTokenRange": {
18046
+ "startIndex": 9,
18047
+ "endIndex": 11
18048
+ },
18049
+ "isOptional": true
17746
18050
  }
17747
18051
  ]
17748
18052
  },
@@ -17798,6 +18102,135 @@
17798
18102
  ],
17799
18103
  "name": "create"
17800
18104
  },
18105
+ {
18106
+ "kind": "Method",
18107
+ "canonicalReference": "@microsoft/fast-element!ViewTemplate.create:member(1)",
18108
+ "docComment": "/**\n * Creates a template based on a set of static strings and dynamic values.\n *\n * @remarks\n *\n * This API should not be used directly under normal circumstances because constructing a template in this way, if not done properly, can open up the application to XSS attacks. When using this API, provide a strong DOMPolicy that can properly sanitize and also be sure to manually sanitize all static strings particularly if they can come from user input.\n *\n * @param strings - The static strings to create the template with.\n *\n * @param values - The dynamic values to create the template with.\n *\n * @param policy - The DOMPolicy to associated with the template.\n *\n * @returns A ViewTemplate.\n */\n",
18109
+ "excerptTokens": [
18110
+ {
18111
+ "kind": "Content",
18112
+ "text": "static create<TSource = "
18113
+ },
18114
+ {
18115
+ "kind": "Content",
18116
+ "text": "any"
18117
+ },
18118
+ {
18119
+ "kind": "Content",
18120
+ "text": ", TParent = "
18121
+ },
18122
+ {
18123
+ "kind": "Content",
18124
+ "text": "any"
18125
+ },
18126
+ {
18127
+ "kind": "Content",
18128
+ "text": ">(strings: "
18129
+ },
18130
+ {
18131
+ "kind": "Content",
18132
+ "text": "string[]"
18133
+ },
18134
+ {
18135
+ "kind": "Content",
18136
+ "text": ", values: "
18137
+ },
18138
+ {
18139
+ "kind": "Reference",
18140
+ "text": "TemplateValue",
18141
+ "canonicalReference": "@microsoft/fast-element!TemplateValue:type"
18142
+ },
18143
+ {
18144
+ "kind": "Content",
18145
+ "text": "<TSource, TParent>[]"
18146
+ },
18147
+ {
18148
+ "kind": "Content",
18149
+ "text": ", policy?: "
18150
+ },
18151
+ {
18152
+ "kind": "Reference",
18153
+ "text": "DOMPolicy",
18154
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
18155
+ },
18156
+ {
18157
+ "kind": "Content",
18158
+ "text": "): "
18159
+ },
18160
+ {
18161
+ "kind": "Reference",
18162
+ "text": "ViewTemplate",
18163
+ "canonicalReference": "@microsoft/fast-element!ViewTemplate:class"
18164
+ },
18165
+ {
18166
+ "kind": "Content",
18167
+ "text": "<TSource, TParent>"
18168
+ },
18169
+ {
18170
+ "kind": "Content",
18171
+ "text": ";"
18172
+ }
18173
+ ],
18174
+ "isOptional": false,
18175
+ "isStatic": true,
18176
+ "returnTypeTokenRange": {
18177
+ "startIndex": 12,
18178
+ "endIndex": 14
18179
+ },
18180
+ "releaseTag": "Public",
18181
+ "overloadIndex": 1,
18182
+ "parameters": [
18183
+ {
18184
+ "parameterName": "strings",
18185
+ "parameterTypeTokenRange": {
18186
+ "startIndex": 5,
18187
+ "endIndex": 6
18188
+ },
18189
+ "isOptional": false
18190
+ },
18191
+ {
18192
+ "parameterName": "values",
18193
+ "parameterTypeTokenRange": {
18194
+ "startIndex": 7,
18195
+ "endIndex": 9
18196
+ },
18197
+ "isOptional": false
18198
+ },
18199
+ {
18200
+ "parameterName": "policy",
18201
+ "parameterTypeTokenRange": {
18202
+ "startIndex": 10,
18203
+ "endIndex": 11
18204
+ },
18205
+ "isOptional": true
18206
+ }
18207
+ ],
18208
+ "typeParameters": [
18209
+ {
18210
+ "typeParameterName": "TSource",
18211
+ "constraintTokenRange": {
18212
+ "startIndex": 0,
18213
+ "endIndex": 0
18214
+ },
18215
+ "defaultTypeTokenRange": {
18216
+ "startIndex": 1,
18217
+ "endIndex": 2
18218
+ }
18219
+ },
18220
+ {
18221
+ "typeParameterName": "TParent",
18222
+ "constraintTokenRange": {
18223
+ "startIndex": 0,
18224
+ "endIndex": 0
18225
+ },
18226
+ "defaultTypeTokenRange": {
18227
+ "startIndex": 3,
18228
+ "endIndex": 4
18229
+ }
18230
+ }
18231
+ ],
18232
+ "name": "create"
18233
+ },
17801
18234
  {
17802
18235
  "kind": "Property",
17803
18236
  "canonicalReference": "@microsoft/fast-element!ViewTemplate#factories:member",
@@ -17955,6 +18388,53 @@
17955
18388
  }
17956
18389
  ],
17957
18390
  "name": "render"
18391
+ },
18392
+ {
18393
+ "kind": "Method",
18394
+ "canonicalReference": "@microsoft/fast-element!ViewTemplate#withPolicy:member(1)",
18395
+ "docComment": "/**\n * Sets the DOMPolicy for this template.\n *\n * @remarks\n *\n * The DOMPolicy can only be set once for a template and cannot be set after the template is compiled.\n *\n * @param policy - The policy to associated with this template.\n *\n * @returns The modified template instance.\n */\n",
18396
+ "excerptTokens": [
18397
+ {
18398
+ "kind": "Content",
18399
+ "text": "withPolicy(policy: "
18400
+ },
18401
+ {
18402
+ "kind": "Reference",
18403
+ "text": "DOMPolicy",
18404
+ "canonicalReference": "@microsoft/fast-element!DOMPolicy:interface"
18405
+ },
18406
+ {
18407
+ "kind": "Content",
18408
+ "text": "): "
18409
+ },
18410
+ {
18411
+ "kind": "Content",
18412
+ "text": "this"
18413
+ },
18414
+ {
18415
+ "kind": "Content",
18416
+ "text": ";"
18417
+ }
18418
+ ],
18419
+ "isOptional": false,
18420
+ "isStatic": false,
18421
+ "returnTypeTokenRange": {
18422
+ "startIndex": 3,
18423
+ "endIndex": 4
18424
+ },
18425
+ "releaseTag": "Public",
18426
+ "overloadIndex": 1,
18427
+ "parameters": [
18428
+ {
18429
+ "parameterName": "policy",
18430
+ "parameterTypeTokenRange": {
18431
+ "startIndex": 1,
18432
+ "endIndex": 2
18433
+ },
18434
+ "isOptional": false
18435
+ }
18436
+ ],
18437
+ "name": "withPolicy"
17958
18438
  }
17959
18439
  ],
17960
18440
  "implementsTokenRanges": [