@microsoft/fast-element 2.10.4 → 3.0.0-rc.2

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 (211) hide show
  1. package/CHANGELOG.md +52 -2
  2. package/README.md +244 -1
  3. package/dist/arrays/arrays.api.json +2621 -0
  4. package/dist/context/context.api.json +13 -13
  5. package/dist/declarative/declarative.api.json +8483 -0
  6. package/dist/di/di.api.json +16 -16
  7. package/dist/dts/__test__/helpers.d.ts +6 -0
  8. package/dist/dts/array-observer.d.ts +2 -0
  9. package/dist/dts/arrays.d.ts +2 -0
  10. package/dist/dts/attr.d.ts +1 -0
  11. package/dist/dts/binding/binding.d.ts +15 -5
  12. package/dist/dts/binding/one-time.d.ts +1 -1
  13. package/dist/dts/binding/one-way.d.ts +1 -1
  14. package/dist/dts/binding/signal.d.ts +6 -6
  15. package/dist/dts/binding/two-way.d.ts +2 -1
  16. package/dist/dts/binding.d.ts +7 -0
  17. package/dist/dts/components/attributes.d.ts +1 -4
  18. package/dist/dts/components/definition-schema-transforms.d.ts +9 -0
  19. package/dist/dts/components/element-controller.d.ts +80 -114
  20. package/dist/dts/components/element-hydration.d.ts +1 -1
  21. package/dist/dts/components/enable-hydration.d.ts +54 -0
  22. package/dist/dts/components/fast-definitions.d.ts +98 -46
  23. package/dist/dts/components/fast-element.d.ts +43 -16
  24. package/dist/dts/components/hydration-tracker.d.ts +83 -0
  25. package/dist/dts/components/hydration.d.ts +23 -53
  26. package/dist/dts/components/schema.d.ts +205 -0
  27. package/dist/dts/context.d.ts +13 -13
  28. package/dist/dts/css.d.ts +3 -0
  29. package/dist/dts/debug.d.ts +5 -1
  30. package/dist/dts/declarative/attribute-map.d.ts +58 -0
  31. package/dist/dts/declarative/debug.d.ts +4 -0
  32. package/dist/dts/declarative/index.d.ts +14 -0
  33. package/dist/dts/declarative/interfaces.d.ts +8 -0
  34. package/dist/dts/declarative/observer-map-utilities.d.ts +58 -0
  35. package/dist/dts/declarative/observer-map.d.ts +89 -0
  36. package/dist/dts/declarative/runtime.d.ts +5 -0
  37. package/dist/dts/declarative/syntax.d.ts +21 -0
  38. package/dist/dts/declarative/template-bridge.d.ts +33 -0
  39. package/dist/dts/declarative/template-parser.d.ts +98 -0
  40. package/dist/dts/declarative/template.d.ts +10 -0
  41. package/dist/dts/declarative/utilities.d.ts +358 -0
  42. package/dist/dts/di/di.d.ts +7 -7
  43. package/dist/dts/directives/children.d.ts +2 -0
  44. package/dist/dts/directives/node-observation.d.ts +2 -0
  45. package/dist/dts/directives/ref.d.ts +2 -0
  46. package/dist/dts/directives/repeat.d.ts +4 -0
  47. package/dist/dts/directives/slotted.d.ts +2 -0
  48. package/dist/dts/directives/when.d.ts +3 -0
  49. package/dist/dts/dom-policy.d.ts +23 -5
  50. package/dist/dts/dom.d.ts +4 -16
  51. package/dist/dts/html.d.ts +5 -0
  52. package/dist/dts/hydration/diagnostics.d.ts +93 -0
  53. package/dist/dts/hydration/hydration-debugger.d.ts +35 -0
  54. package/dist/dts/hydration/messages.d.ts +62 -0
  55. package/dist/dts/hydration/runtime.d.ts +7 -0
  56. package/dist/dts/hydration/target-builder.d.ts +40 -12
  57. package/dist/dts/hydration.d.ts +18 -0
  58. package/dist/dts/index.d.ts +42 -42
  59. package/dist/dts/index.debug.d.ts +0 -1
  60. package/dist/dts/index.rollup.debug.d.ts +0 -1
  61. package/dist/dts/interfaces.d.ts +2 -49
  62. package/dist/dts/observable.d.ts +3 -6
  63. package/dist/dts/observation/arrays.d.ts +1 -1
  64. package/dist/dts/observation/observable.d.ts +3 -3
  65. package/dist/dts/observation/update-queue.d.ts +1 -1
  66. package/dist/dts/platform.d.ts +45 -8
  67. package/dist/dts/registry.d.ts +1 -0
  68. package/dist/dts/render.d.ts +7 -0
  69. package/dist/dts/schema.d.ts +1 -0
  70. package/dist/dts/state/exports.d.ts +1 -1
  71. package/dist/dts/state/state.d.ts +2 -2
  72. package/dist/dts/styles/css-directive.d.ts +5 -12
  73. package/dist/dts/styles/css.d.ts +5 -7
  74. package/dist/dts/styles/element-styles.d.ts +0 -10
  75. package/dist/dts/styles.d.ts +6 -0
  76. package/dist/dts/templating/compiler.d.ts +1 -1
  77. package/dist/dts/templating/html-binding-directive.d.ts +10 -2
  78. package/dist/dts/templating/html-directive.d.ts +19 -1
  79. package/dist/dts/templating/hydration-view.d.ts +130 -0
  80. package/dist/dts/templating/render.d.ts +1 -1
  81. package/dist/dts/templating/repeat.d.ts +1 -1
  82. package/dist/dts/templating/template.d.ts +15 -7
  83. package/dist/dts/templating/view.d.ts +25 -102
  84. package/dist/dts/templating.d.ts +10 -0
  85. package/dist/dts/testing/exports.d.ts +2 -2
  86. package/dist/dts/testing/fakes.d.ts +4 -4
  87. package/dist/dts/updates.d.ts +1 -0
  88. package/dist/dts/volatile.d.ts +2 -0
  89. package/dist/esm/__test__/helpers.js +22 -0
  90. package/dist/esm/__test__/setup-node.js +18 -0
  91. package/dist/esm/array-observer.js +1 -0
  92. package/dist/esm/arrays.js +1 -0
  93. package/dist/esm/attr.js +1 -0
  94. package/dist/esm/binding/normalize.js +1 -1
  95. package/dist/esm/binding/signal.js +4 -4
  96. package/dist/esm/binding/two-way.js +3 -3
  97. package/dist/esm/binding.js +4 -0
  98. package/dist/esm/components/attributes.js +18 -11
  99. package/dist/esm/components/definition-schema-transforms.js +23 -0
  100. package/dist/esm/components/element-controller.js +206 -270
  101. package/dist/esm/components/element-hydration.js +1 -1
  102. package/dist/esm/components/enable-hydration.js +124 -0
  103. package/dist/esm/components/fast-definitions.js +219 -56
  104. package/dist/esm/components/fast-element.js +18 -27
  105. package/dist/esm/components/hydration-tracker.js +122 -0
  106. package/dist/esm/components/hydration.js +137 -140
  107. package/dist/esm/components/schema.js +253 -0
  108. package/dist/esm/context.js +6 -6
  109. package/dist/esm/css.js +3 -0
  110. package/dist/esm/debug.js +27 -26
  111. package/dist/esm/declarative/attribute-map.js +122 -0
  112. package/dist/esm/declarative/debug.js +4 -0
  113. package/dist/esm/declarative/index.js +4 -0
  114. package/dist/esm/declarative/interfaces.js +9 -0
  115. package/dist/esm/declarative/observer-map-utilities.js +565 -0
  116. package/dist/esm/declarative/observer-map.js +216 -0
  117. package/dist/esm/declarative/runtime.js +14 -0
  118. package/dist/esm/declarative/syntax.js +36 -0
  119. package/dist/esm/declarative/template-bridge.js +160 -0
  120. package/dist/esm/declarative/template-parser.js +306 -0
  121. package/dist/esm/declarative/template.js +143 -0
  122. package/dist/esm/declarative/utilities.js +1069 -0
  123. package/dist/esm/di/di.js +8 -9
  124. package/dist/esm/directives/children.js +1 -0
  125. package/dist/esm/directives/node-observation.js +1 -0
  126. package/dist/esm/directives/ref.js +1 -0
  127. package/dist/esm/directives/repeat.js +1 -0
  128. package/dist/esm/directives/slotted.js +1 -0
  129. package/dist/esm/directives/when.js +1 -0
  130. package/dist/esm/dom-policy.js +35 -6
  131. package/dist/esm/dom.js +1 -1
  132. package/dist/esm/html.js +2 -0
  133. package/dist/esm/hydration/diagnostics.js +50 -0
  134. package/dist/esm/hydration/hydration-debugger.js +112 -0
  135. package/dist/esm/hydration/messages.js +84 -0
  136. package/dist/esm/hydration/runtime.js +33 -0
  137. package/dist/esm/hydration/target-builder.js +144 -91
  138. package/dist/esm/hydration.js +6 -0
  139. package/dist/esm/index.debug.js +2 -1
  140. package/dist/esm/index.js +38 -29
  141. package/dist/esm/index.rollup.debug.js +3 -2
  142. package/dist/esm/index.rollup.js +1 -1
  143. package/dist/esm/interfaces.js +2 -45
  144. package/dist/esm/metadata.js +2 -8
  145. package/dist/esm/observable.js +1 -4
  146. package/dist/esm/observation/arrays.js +1 -1
  147. package/dist/esm/observation/notifier.js +2 -4
  148. package/dist/esm/observation/observable.js +5 -5
  149. package/dist/esm/observation/update-queue.js +47 -58
  150. package/dist/esm/platform.js +31 -30
  151. package/dist/esm/registry.js +1 -0
  152. package/dist/esm/render.js +1 -0
  153. package/dist/esm/schema.js +1 -0
  154. package/dist/esm/state/exports.js +1 -1
  155. package/dist/esm/styles/css-directive.js +1 -2
  156. package/dist/esm/styles/css.js +15 -56
  157. package/dist/esm/styles/element-styles.js +69 -15
  158. package/dist/esm/styles.js +2 -0
  159. package/dist/esm/templating/html-binding-directive.js +11 -9
  160. package/dist/esm/templating/hydration-view.js +228 -0
  161. package/dist/esm/templating/render.js +39 -18
  162. package/dist/esm/templating/repeat.js +69 -33
  163. package/dist/esm/templating/template.js +7 -7
  164. package/dist/esm/templating/view.js +25 -234
  165. package/dist/esm/templating.js +7 -0
  166. package/dist/esm/testing/exports.js +2 -2
  167. package/dist/esm/testing/fixture.js +2 -2
  168. package/dist/esm/testing/timeout.js +2 -2
  169. package/dist/esm/updates.js +1 -0
  170. package/dist/esm/volatile.js +1 -0
  171. package/dist/fast-element.api.json +14389 -11138
  172. package/dist/fast-element.d.ts +3651 -809
  173. package/dist/fast-element.debug.js +5666 -4722
  174. package/dist/fast-element.debug.min.js +2 -2
  175. package/dist/fast-element.js +5394 -4381
  176. package/dist/fast-element.min.js +2 -2
  177. package/dist/fast-element.untrimmed.d.ts +923 -472
  178. package/dist/hydration/hydration.api.json +6460 -0
  179. package/dist/styles/styles.api.json +2672 -0
  180. package/package.json +165 -45
  181. package/ARCHITECTURE_FASTELEMENT.md +0 -63
  182. package/ARCHITECTURE_HTML_TAGGED_TEMPLATE_LITERAL.md +0 -36
  183. package/ARCHITECTURE_INTRO.md +0 -10
  184. package/ARCHITECTURE_OVERVIEW.md +0 -52
  185. package/ARCHITECTURE_UPDATES.md +0 -11
  186. package/CHANGELOG.json +0 -2275
  187. package/DESIGN.md +0 -510
  188. package/api-extractor.context.json +0 -14
  189. package/api-extractor.di.json +0 -14
  190. package/biome.json +0 -4
  191. package/dist/dts/components/install-hydration.d.ts +0 -1
  192. package/dist/dts/pending-task.d.ts +0 -32
  193. package/dist/dts/styles/css-binding-directive.d.ts +0 -60
  194. package/dist/dts/templating/install-hydratable-view-templates.d.ts +0 -1
  195. package/dist/esm/components/install-hydration.js +0 -3
  196. package/dist/esm/pending-task.js +0 -28
  197. package/dist/esm/polyfills.js +0 -60
  198. package/dist/esm/styles/css-binding-directive.js +0 -76
  199. package/dist/esm/templating/install-hydratable-view-templates.js +0 -23
  200. package/docs/ACKNOWLEDGEMENTS.md +0 -12
  201. package/docs/api-report.api.md +0 -1122
  202. package/docs/context/api-report.api.md +0 -69
  203. package/docs/di/api-report.api.md +0 -315
  204. package/docs/fast-element-2-changes.md +0 -15
  205. package/playwright.config.ts +0 -26
  206. package/scripts/run-api-extractor.js +0 -51
  207. package/test/index.html +0 -11
  208. package/test/main.ts +0 -104
  209. package/test/vite.config.ts +0 -19
  210. package/tsconfig.api-extractor.json +0 -6
  211. /package/dist/dts/{polyfills.d.ts → __test__/setup-node.d.ts} +0 -0
@@ -1,69 +0,0 @@
1
- ## API Report File for "@microsoft/fast-element"
2
-
3
- > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
4
-
5
- ```ts
6
-
7
- // @public
8
- export type Context<T> = {
9
- readonly name: string;
10
- readonly initialValue?: T;
11
- };
12
-
13
- // @public
14
- export const Context: Readonly<{
15
- eventType: "context-request";
16
- for<T = unknown>(name: string): FASTContext<T>;
17
- create<T_1 = unknown>(name: string, initialValue?: T_1 | undefined): FASTContext<T_1>;
18
- setDefaultRequestStrategy(strategy: FASTContextRequestStrategy): void;
19
- get<T_2 extends UnknownContext>(target: EventTarget, context: T_2): ContextType<T_2>;
20
- request<T_3 extends UnknownContext>(target: EventTarget, context: T_3, callback: ContextCallback<ContextType<T_3>>, multiple?: boolean): void;
21
- dispatch<T_4 extends UnknownContext>(target: EventTarget, context: T_4, callback: ContextCallback<ContextType<T_4>>, multiple?: boolean): void;
22
- provide<T_5 extends UnknownContext>(target: EventTarget, context: T_5, value: ContextType<T_5>): void;
23
- handle<T_6 extends UnknownContext>(target: EventTarget, callback: (event: ContextEvent<T_6>) => void, context?: T_6 | undefined): void;
24
- defineProperty<T_7 extends UnknownContext>(target: Constructable<EventTarget> | EventTarget, propertyName: string, context: T_7): void;
25
- }>;
26
-
27
- // @public
28
- export type ContextCallback<ValueType> = (value: ValueType, dispose?: () => void) => void;
29
-
30
- // Warning: (ae-forgotten-export) The symbol "ParameterDecorator_2" needs to be exported by the entry point context.d.ts
31
- //
32
- // @public
33
- export type ContextDecorator<T = any> = Readonly<Context<T>> & PropertyDecorator & ParameterDecorator_2;
34
-
35
- // @public
36
- export class ContextEvent<T extends UnknownContext> extends Event {
37
- constructor(context: T, callback: ContextCallback<ContextType<T>>, multiple?: boolean | undefined);
38
- // (undocumented)
39
- readonly callback: ContextCallback<ContextType<T>>;
40
- // (undocumented)
41
- readonly context: T;
42
- // (undocumented)
43
- readonly multiple?: boolean | undefined;
44
- }
45
-
46
- // @public
47
- export type ContextType<T extends UnknownContext> = T extends Context<infer Y> ? Y : never;
48
-
49
- // @public
50
- export type FASTContext<T> = ContextDecorator<T> & {
51
- get(target: EventTarget): T;
52
- provide(target: EventTarget, value: T): void;
53
- request(target: EventTarget, callback: ContextCallback<T>, multiple?: boolean): void;
54
- handle(target: EventTarget, callback: (event: ContextEvent<FASTContext<T>>) => void): void;
55
- };
56
-
57
- // @public
58
- export type FASTContextRequestStrategy = <T extends UnknownContext>(target: EventTarget, context: T, callback: ContextCallback<ContextType<T>>, multiple: any) => void;
59
-
60
- // @public
61
- export type UnknownContext = Context<unknown>;
62
-
63
- // Warnings were encountered during analysis:
64
- //
65
- // dist/dts/context.d.ts:127:5 - (ae-forgotten-export) The symbol "Constructable" needs to be exported by the entry point context.d.ts
66
-
67
- // (No @packageDocumentation comment for this package)
68
-
69
- ```
@@ -1,315 +0,0 @@
1
- ## API Report File for "@microsoft/fast-element"
2
-
3
- > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
4
-
5
- ```ts
6
-
7
- // @public
8
- export const all: (key: any, searchAncestors?: boolean) => ReturnType<typeof DI.inject>;
9
-
10
- // @public
11
- export type AsyncRegistrationLocator = (key: Key) => Promise<Registration | null>;
12
-
13
- // @public
14
- export interface Container extends ServiceLocator {
15
- createChild(config?: Partial<Omit<ContainerConfiguration, "parentLocator">>): Container;
16
- getFactory<T extends Constructable>(key: T): Factory<T>;
17
- getResolver<K extends Key, T = K>(key: K | Key, autoRegister?: boolean): Resolver<T> | null;
18
- register(...params: any[]): Container;
19
- // Warning: (ae-forgotten-export) The symbol "Constructable" needs to be exported by the entry point di.d.ts
20
- registerFactory<T extends Constructable>(key: T, factory: Factory<T>): void;
21
- registerResolver<K extends Key, T = K>(key: K, resolver: Resolver<T>): Resolver<T>;
22
- registerTransformer<K extends Key, T = K>(key: K, transformer: Transformer_2<T>): boolean;
23
- }
24
-
25
- // Warning: (ae-forgotten-export) The symbol "ContextDecorator" needs to be exported by the entry point di.d.ts
26
- //
27
- // @public
28
- export const Container: ContextDecorator<Container>;
29
-
30
- // @public
31
- export interface ContainerConfiguration {
32
- asyncRegistrationLocator: AsyncRegistrationLocator;
33
- defaultResolver(key: Key, handler: Container): Resolver;
34
- parentLocator: ParentLocator;
35
- responsibleForOwnerRequests: boolean;
36
- }
37
-
38
- // @public
39
- export const ContainerConfiguration: Readonly<{
40
- default: Readonly<ContainerConfiguration>;
41
- }>;
42
-
43
- // Warning: (ae-internal-missing-underscore) The name "ContainerImpl" should be prefixed with an underscore because the declaration is marked as @internal
44
- //
45
- // @internal (undocumented)
46
- export class ContainerImpl implements DOMContainer {
47
- constructor(owner: any, config: ContainerConfiguration);
48
- // (undocumented)
49
- protected config: ContainerConfiguration;
50
- // (undocumented)
51
- createChild(config?: Partial<Omit<ContainerConfiguration, "parentLocator">>): Container;
52
- // (undocumented)
53
- get depth(): number;
54
- // (undocumented)
55
- get<K extends Key>(key: K): Resolved<K>;
56
- // (undocumented)
57
- getAll<K extends Key>(key: K, searchAncestors?: boolean): readonly Resolved<K>[];
58
- // (undocumented)
59
- getAsync<K extends Key>(key: K): Promise<Resolved<K>>;
60
- // (undocumented)
61
- getFactory<K extends Constructable>(Type: K): Factory<K>;
62
- // (undocumented)
63
- getResolver<K extends Key, T = K>(key: K | Key, autoRegister?: boolean): Resolver<T> | null;
64
- // (undocumented)
65
- handleContextRequests(enable: boolean): void;
66
- // (undocumented)
67
- has<K extends Key>(key: K, searchAncestors?: boolean): boolean;
68
- // (undocumented)
69
- protected owner: any;
70
- // (undocumented)
71
- get parent(): ContainerImpl | null;
72
- // (undocumented)
73
- register(...params: any[]): Container;
74
- // (undocumented)
75
- registerFactory<K extends Constructable>(key: K, factory: Factory<K>): void;
76
- // (undocumented)
77
- registerResolver<K extends Key, T = K>(key: K, resolver: Resolver<T>): Resolver<T>;
78
- // (undocumented)
79
- registerTransformer<K extends Key, T = K>(key: K, transformer: Transformer_2<T>): boolean;
80
- // (undocumented)
81
- get responsibleForOwnerRequests(): boolean;
82
- }
83
-
84
- // @public
85
- export const DefaultResolver: Readonly<{
86
- none(key: Key): Resolver;
87
- singleton(key: Key): Resolver;
88
- transient(key: Key): Resolver;
89
- }>;
90
-
91
- // @public
92
- export const DI: Readonly<{
93
- installAsContextRequestStrategy(fallback?: () => DOMContainer): void;
94
- createContainer(config?: Partial<ContainerConfiguration>): Container;
95
- findResponsibleContainer(target: EventTarget, fallback?: () => DOMContainer): DOMContainer;
96
- findParentContainer(target: EventTarget, fallback?: () => DOMContainer): DOMContainer;
97
- getOrCreateDOMContainer(target?: EventTarget, config?: Partial<Omit<ContainerConfiguration, "parentLocator">>): DOMContainer;
98
- getDependencies(Type: Constructable | Injectable): Key[];
99
- defineProperty(target: {}, propertyName: string, key: Key, respectConnection?: boolean): void;
100
- createContext: typeof createContext;
101
- inject(...dependencies: Key[]): (target: any, key?: string | number, descriptor?: PropertyDescriptor | number) => void;
102
- transient<T extends Constructable>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
103
- singleton<T_1 extends Constructable>(target: T_1 & Partial<RegisterSelf<T_1>>, options?: SingletonOptions): T_1 & RegisterSelf<T_1>;
104
- }>;
105
-
106
- // @public
107
- export interface DOMContainer extends Container {
108
- // @beta
109
- handleContextRequests(enable: boolean): void;
110
- }
111
-
112
- // @public
113
- export const DOMContainer: ContextDecorator<DOMContainer>;
114
-
115
- // @public
116
- export interface Factory<T extends Constructable = any> {
117
- construct(container: Container, dynamicDependencies?: Key[]): Resolved<T>;
118
- constructAsync(container: Container, dynamicDependencies?: Key[]): Promise<Resolved<T>>;
119
- registerTransformer(transformer: Transformer_2<T>): void;
120
- readonly Type: T;
121
- }
122
-
123
- // Warning: (ae-internal-missing-underscore) The name "FactoryImpl" should be prefixed with an underscore because the declaration is marked as @internal
124
- //
125
- // @internal (undocumented)
126
- export class FactoryImpl<T extends Constructable = any> implements Factory<T> {
127
- constructor(Type: T, dependencies: Key[]);
128
- // (undocumented)
129
- construct(container: Container, dynamicDependencies?: Key[]): Resolved<T>;
130
- // (undocumented)
131
- constructAsync(container: Container, dynamicDependencies?: Key[]): Promise<Resolved<T>>;
132
- // (undocumented)
133
- registerTransformer(transformer: (instance: any) => any): void;
134
- // (undocumented)
135
- Type: T;
136
- }
137
-
138
- // @public
139
- export function ignore(target: Injectable, property?: string | number, descriptor?: PropertyDescriptor | number): void;
140
-
141
- // @public
142
- export const inject: (...dependencies: Key[]) => (target: any, key?: string | number, descriptor?: PropertyDescriptor | number) => void;
143
-
144
- // @public
145
- export type Injectable<T = {}> = Constructable<T> & {
146
- inject?: Key[];
147
- };
148
-
149
- // @public
150
- export interface InterfaceConfiguration {
151
- friendlyName?: string;
152
- respectConnection?: boolean;
153
- }
154
-
155
- // @public
156
- export type Key = PropertyKey | object | ContextDecorator | Constructable | Resolver;
157
-
158
- // @public
159
- export const lazy: (key: any) => any;
160
-
161
- // @public
162
- export const newInstanceForScope: (key: any) => any;
163
-
164
- // @public
165
- export const newInstanceOf: (key: any) => any;
166
-
167
- // @public
168
- export const optional: (key: any) => any;
169
-
170
- // @public
171
- export type ParentLocator = (owner: any) => Container | null;
172
-
173
- // @public
174
- export type RegisterSelf<T extends Constructable> = {
175
- register(container: Container): Resolver<InstanceType<T>>;
176
- registerInRequestor: boolean;
177
- };
178
-
179
- // @public
180
- export interface Registration<K = any> {
181
- register(container: Container): Resolver<K>;
182
- }
183
-
184
- // @public
185
- export const Registration: Readonly<{
186
- instance<T>(key: Key, value: T): Registration<T>;
187
- singleton<T_1 extends Constructable>(key: Key, value: T_1): Registration<InstanceType<T_1>>;
188
- transient<T_2 extends Constructable>(key: Key, value: T_2): Registration<InstanceType<T_2>>;
189
- callback<T_3>(key: Key, callback: ResolveCallback<T_3>): Registration<Resolved<T_3>>;
190
- cachedCallback<T_4>(key: Key, callback: ResolveCallback<T_4>): Registration<Resolved<T_4>>;
191
- aliasTo<T_5>(originalKey: T_5, aliasKey: Key): Registration<Resolved<T_5>>;
192
- }>;
193
-
194
- // @public
195
- export interface Registry {
196
- register(container: Container, ...params: unknown[]): void | Resolver;
197
- }
198
-
199
- // @public
200
- export type ResolveCallback<T = any> = (handler: Container, requestor: Container, resolver: Resolver<T>) => T;
201
-
202
- // Warning: (ae-forgotten-export) The symbol "ResolverLike" needs to be exported by the entry point di.d.ts
203
- //
204
- // @public
205
- export type Resolved<K> = K extends ContextDecorator<infer T> ? T : K extends Constructable ? InstanceType<K> : K extends ResolverLike<any, infer T1> ? T1 extends Constructable ? InstanceType<T1> : T1 : K;
206
-
207
- // @public
208
- export interface Resolver<K = any> extends ResolverLike<Container, K> {
209
- }
210
-
211
- // @public
212
- export class ResolverBuilder<K> {
213
- constructor(container: Container, key: Key);
214
- aliasTo(destinationKey: Key): Resolver<K>;
215
- cachedCallback(value: ResolveCallback<K>): Resolver<K>;
216
- callback(value: ResolveCallback<K>): Resolver<K>;
217
- instance(value: K): Resolver<K>;
218
- singleton(value: Constructable): Resolver<K>;
219
- transient(value: Constructable): Resolver<K>;
220
- }
221
-
222
- // Warning: (ae-internal-missing-underscore) The name "ResolverImpl" should be prefixed with an underscore because the declaration is marked as @internal
223
- //
224
- // @internal (undocumented)
225
- export class ResolverImpl implements Resolver, Registration {
226
- // (undocumented)
227
- get $isResolver(): true;
228
- constructor(key: Key, strategy: ResolverStrategy, state: any);
229
- // (undocumented)
230
- getFactory(container: Container): Factory | null;
231
- // (undocumented)
232
- key: Key;
233
- // (undocumented)
234
- register(container: Container): Resolver;
235
- // (undocumented)
236
- resolve(handler: Container, requestor: Container): any;
237
- // (undocumented)
238
- resolveAsync(handler: Container, requestor: Container): Promise<any>;
239
- // (undocumented)
240
- state: any;
241
- // (undocumented)
242
- strategy: ResolverStrategy;
243
- }
244
-
245
- // Warning: (ae-internal-missing-underscore) The name "ResolverStrategy" should be prefixed with an underscore because the declaration is marked as @internal
246
- //
247
- // @internal (undocumented)
248
- export const enum ResolverStrategy {
249
- // (undocumented)
250
- alias = 5,
251
- // (undocumented)
252
- array = 4,
253
- // (undocumented)
254
- callback = 3,
255
- // (undocumented)
256
- instance = 0,
257
- // (undocumented)
258
- singleton = 1,
259
- // (undocumented)
260
- transient = 2
261
- }
262
-
263
- // @public
264
- export interface ServiceLocator {
265
- get<K extends Key>(key: K): Resolved<K>;
266
- get<K extends Key>(key: Key): Resolved<K>;
267
- get<K extends Key>(key: K | Key): Resolved<K>;
268
- getAll<K extends Key>(key: K, searchAncestors?: boolean): readonly Resolved<K>[];
269
- getAll<K extends Key>(key: Key, searchAncestors?: boolean): readonly Resolved<K>[];
270
- getAll<K extends Key>(key: K | Key, searchAncestors?: boolean): readonly Resolved<K>[];
271
- getAsync<K extends Key>(key: K): Promise<Resolved<K>>;
272
- getAsync<K extends Key>(key: Key): Promise<Resolved<K>>;
273
- getAsync<K extends Key>(key: K | Key): Promise<Resolved<K>>;
274
- has<K extends Key>(key: K | Key, searchAncestors: boolean): boolean;
275
- }
276
-
277
- // @public
278
- export const ServiceLocator: ContextDecorator<ServiceLocator>;
279
-
280
- // Warning: (ae-forgotten-export) The symbol "singletonDecorator" needs to be exported by the entry point di.d.ts
281
- //
282
- // @public
283
- export function singleton<T extends Constructable>(): typeof singletonDecorator;
284
-
285
- // @public (undocumented)
286
- export function singleton<T extends Constructable>(options?: SingletonOptions): typeof singletonDecorator;
287
-
288
- // @public
289
- export function singleton<T extends Constructable>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
290
-
291
- // @public
292
- type Transformer_2<K> = (instance: Resolved<K>) => Resolved<K>;
293
- export { Transformer_2 as Transformer }
294
-
295
- // Warning: (ae-forgotten-export) The symbol "transientDecorator" needs to be exported by the entry point di.d.ts
296
- //
297
- // @public
298
- export function transient<T extends Constructable>(): typeof transientDecorator;
299
-
300
- // @public
301
- export function transient<T extends Constructable>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
302
-
303
- // Warning: (ae-internal-missing-underscore) The name "validateKey" should be prefixed with an underscore because the declaration is marked as @internal
304
- //
305
- // @internal (undocumented)
306
- export function validateKey(key: any): void;
307
-
308
- // Warnings were encountered during analysis:
309
- //
310
- // dist/dts/di/di.d.ts:479:5 - (ae-forgotten-export) The symbol "createContext" needs to be exported by the entry point di.d.ts
311
- // dist/dts/di/di.d.ts:540:5 - (ae-forgotten-export) The symbol "SingletonOptions" needs to be exported by the entry point di.d.ts
312
-
313
- // (No @packageDocumentation comment for this package)
314
-
315
- ```
@@ -1,15 +0,0 @@
1
- # Changes in FASTElement 2.0
2
-
3
- ## Breaking Changes
4
-
5
- * `HTMLDirective` - The `targetIndex: number` property has been replaced by a `targetId: string` property. The `createBehavior` method no longer takes a target `Node` but instead takes a `BehaviorTargets` instance. The actual target can be looked up on the `BehaviorTargets` instance by indexing with the `targetId` property.
6
- * `compileTemplate()` - Internals have been significantly changed. The implementation no longer uses a TreeWalker. The return type has change to an `HTMLTemplateCompilationResult` with different properties.
7
- * `View` and `HTMLView` - Type parameters added to enable strongly typed views based on their data source. The constructor of `HTMLView` has a new signature based on changes to the compiler's output. Internals have been cleaned up and no longer rely on the Range type.
8
- * `ElementViewTemplate`, `SyntheticViewTemplate`, and `ViewTemplate` - Added type parameters throughout. Logic to instantiate and apply behaviors moved out of the template and into the view where it can be lazily executed. Removed the ability of the `render` method to take a string id of the node to render to. You must provide a node.
9
- * `DOM` - Tree Walker methods are no longer used and are thus removed. The API for removing child nodes has been removed as well since it was only used in one place and could be inlined. The helper `createCustomAttributePlaceholder()` no longer requires an attribute name. It will be uniquely generated internally.
10
- * `class` - Bindings to `class` are now more nuanced. Binding directly to `class` will simply set the `className` property. If you need to bind to `class` knowing that manual JS will also manipulate the `classList` in addition to the binding, then you should now bind to `:classList` instead. This allows for performance optimizations in the simple, most common case.
11
- * `Behavior` and `ViewBehavior` - `Behavior` now requires an `ExecutionContext` for `unbind`. Behaviors can be used for elements or views. `ViewBehavior` has been introduced for use exclusively with views, and provides some optimization opportunities.
12
- * `RefBehavior` has been replaced with `RefDirective`. The directive also implements `ViewBehavior` allowing a single directive instance to be shared across all template instances that use the ref.
13
- * Removed `SlottedBehavior` and `ChildrenBehavior` have been replaced with `SlottedDirective` and `ChildrenDirective`. These directives allow a single directive instance to be shared across all template instances that use the ref.
14
- * Removed `AttachedBehaviorHTMLDirective` and `AttachedBehaviorType` since they are no longer used in the new directive/behavior architecture for ref, slotted, and children.
15
- * Renamed `Notifier#source` to `Notifier#subject` to align with other observable terminology and prevent name clashes with `BindingObserver` properties.
@@ -1,26 +0,0 @@
1
- import { defineConfig, devices } from "@playwright/test";
2
-
3
- export default defineConfig({
4
- testDir: ".",
5
- testMatch: "**/*.pw.spec.ts",
6
- retries: 3,
7
- projects: [
8
- {
9
- name: "chromium",
10
- use: { ...devices["Desktop Chrome"] },
11
- },
12
- {
13
- name: "firefox",
14
- use: { ...devices["Desktop Firefox"] },
15
- },
16
- {
17
- name: "webkit",
18
- use: { ...devices["Desktop Safari"] },
19
- },
20
- ],
21
- webServer: {
22
- command: "npm run test-server",
23
- port: 5173,
24
- reuseExistingServer: true,
25
- },
26
- });
@@ -1,51 +0,0 @@
1
- import path from "path";
2
- import fs from "fs";
3
- import { fileURLToPath } from 'url';
4
- import { Extractor, ExtractorConfig } from '@microsoft/api-extractor';
5
-
6
- const __filename = fileURLToPath(import.meta.url);
7
- const __dirname = path.dirname(__filename);
8
-
9
- export const exportPaths = [
10
- {
11
- path: "./context.js",
12
- docsFolder: "context",
13
- configPath: path.resolve(__dirname, "../api-extractor.context.json")
14
- },
15
- {
16
- path: "./di.js",
17
- docsFolder: "di",
18
- configPath: path.resolve(__dirname, "../api-extractor.di.json")
19
- }
20
- ];
21
-
22
- (function() {
23
- exportPaths.forEach((exportPath) => {
24
- const docsFolder = path.resolve(__dirname, `../docs/${exportPath.docsFolder}`);
25
- // Create folders in the docs directory
26
- if (!fs.existsSync(docsFolder)) {
27
- fs.mkdirSync(docsFolder);
28
- }
29
-
30
- // Load and parse the api-extractor.json file
31
- const extractorConfig = ExtractorConfig.loadFileAndPrepare(exportPath.configPath);
32
-
33
- // Invoke API Extractor
34
- const extractorResult = Extractor.invoke(
35
- extractorConfig,
36
- {
37
- // Equivalent to the "--local" command-line parameter
38
- localBuild: process.argv[2] !== "ci",
39
- }
40
- );
41
-
42
- if (extractorResult.succeeded) {
43
- console.log(`API Extractor completed successfully for ${exportPath.configPath}`);
44
- } else {
45
- console.error(
46
- `API Extractor completed with ${extractorResult.errorCount} errors` +
47
- ` and ${extractorResult.warningCount} warnings for ${exportPath.configPath}`
48
- );
49
- }
50
- });
51
- })();
package/test/index.html DELETED
@@ -1,11 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>FAST Element tests</title>
7
- </head>
8
- <body>
9
- <script type="module" src="main.ts"></script>
10
- </body>
11
- </html>
package/test/main.ts DELETED
@@ -1,104 +0,0 @@
1
- import "../src/debug.js";
2
-
3
- export { customElement, FASTElement } from "../src/components/fast-element.js";
4
- export {
5
- attr,
6
- AttributeConfiguration,
7
- AttributeDefinition,
8
- } from "../src/components/attributes.js";
9
- export {
10
- ElementController,
11
- HydratableElementController,
12
- AdoptedStyleSheetsStrategy,
13
- StyleElementStrategy,
14
- needsHydrationAttribute,
15
- deferHydrationAttribute,
16
- } from "../src/components/element-controller.js";
17
- export { FASTElementDefinition } from "../src/components/fast-definitions.js";
18
- export { HydrationMarkup } from "../src/components/hydration.js";
19
- export { Context } from "../src/context.js";
20
- export {
21
- Container,
22
- ContainerConfiguration,
23
- ContainerImpl,
24
- DefaultResolver,
25
- DI,
26
- FactoryImpl,
27
- all,
28
- inject,
29
- lazy,
30
- optional,
31
- Registration,
32
- ResolverImpl,
33
- ResolverStrategy,
34
- singleton,
35
- transient,
36
- } from "../src/di/di.js";
37
- export { DOM, DOMAspect } from "../src/dom.js";
38
- export { DOMPolicy } from "../src/dom-policy.js";
39
- export { Observable, observable, volatile } from "../src/observation/observable.js";
40
- export { Updates } from "../src/observation/update-queue.js";
41
- export { css } from "../src/styles/css.js";
42
- export { ElementStyles } from "../src/styles/element-styles.js";
43
- export { ref } from "../src/templating/ref.js";
44
- export { html } from "../src/templating/template.js";
45
- export { uniqueElementName } from "../src/testing/fixture.js";
46
- export { ChildModel, DerivedModel, Model } from "../src/testing/models.js";
47
- export { Fake } from "../src/testing/fakes.js";
48
- export { composedContains, composedParent } from "../src/utilities.js";
49
- export const conditionalTimeout = function (
50
- condition: boolean,
51
- iteration = 0
52
- ): Promise<boolean> {
53
- return new Promise(function (resolve) {
54
- setTimeout(() => {
55
- if (iteration === 10 || condition) {
56
- resolve(true);
57
- }
58
-
59
- conditionalTimeout(condition, iteration + 1);
60
- }, 5);
61
- });
62
- };
63
- export { ArrayObserver, lengthOf, Splice } from "../src/observation/arrays.js";
64
- export { ownedState, reactive, state, watch } from "../src/state/exports.js";
65
- export { fixture } from "../src/testing/fixture.js";
66
- export { CSSBindingDirective } from "../src/styles/css-binding-directive.js";
67
- export { cssDirective, CSSDirective } from "../src/styles/css-directive.js";
68
- export { ExecutionContext } from "../src/observation/observable.js";
69
- export { Binding } from "../src/binding/binding.js";
70
- export { oneTime } from "../src/binding/one-time.js";
71
- export { oneWay, listener } from "../src/binding/one-way.js";
72
- export { Signal, signal } from "../src/binding/signal.js";
73
- export { twoWay } from "../src/binding/two-way.js";
74
- export { HTMLBindingDirective } from "../src/templating/html-binding-directive.js";
75
- export { ViewTemplate } from "../src/templating/template.js";
76
- export { HTMLView } from "../src/templating/view.js";
77
- export { HTMLDirective, htmlDirective } from "../src/templating/html-directive.js";
78
- export { nextId } from "../src/templating/markup.js";
79
- export { createTrackableDOMPolicy, toHTML } from "../src/__test__/helpers.js";
80
- export { children, ChildrenDirective } from "../src/templating/children.js";
81
- export { elements } from "../src/templating/node-observation.js";
82
- export { Compiler } from "../src/templating/compiler.js";
83
- export { Markup, Parser } from "../src/templating/markup.js";
84
- export { when } from "../src/templating/when.js";
85
- export {
86
- render,
87
- RenderBehavior,
88
- RenderDirective,
89
- RenderInstruction,
90
- NodeTemplate,
91
- renderWith,
92
- } from "../src/templating/render.js";
93
- export { repeat, RepeatBehavior, RepeatDirective } from "../src/templating/repeat.js";
94
- export { slotted, SlottedDirective } from "../src/templating/slotted.js";
95
- export { isString } from "../src/interfaces.js";
96
- export { FAST, emptyArray } from "../src/platform.js";
97
- export { Metadata } from "../src/metadata.js";
98
- export function removeWhitespace(str: string): string {
99
- return str
100
- .trim()
101
- .split("\n")
102
- .map(s => s.trim())
103
- .join("");
104
- }
@@ -1,19 +0,0 @@
1
- import { defineConfig } from "vite";
2
-
3
- export default defineConfig({
4
- clearScreen: false,
5
- resolve: {
6
- conditions: ["test"],
7
- },
8
- server: {
9
- strictPort: true,
10
- },
11
- build: {
12
- outDir: "./dist",
13
- minify: false,
14
- sourcemap: true,
15
- },
16
- preview: {
17
- port: 5173,
18
- },
19
- });
@@ -1,6 +0,0 @@
1
- {
2
- "extends": "./tsconfig.json",
3
- "compilerOptions": {
4
- "types": []
5
- }
6
- }