@amplitude/amp-semantic 0.0.0-stage → 0.2.0-codexsemantic-review-integration.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +245 -2
  3. package/lib/cjs/capture.d.ts +13 -0
  4. package/lib/cjs/capture.d.ts.map +1 -0
  5. package/lib/cjs/capture.js +229 -0
  6. package/lib/cjs/capture.js.map +1 -0
  7. package/lib/cjs/helpers.d.ts +9 -0
  8. package/lib/cjs/helpers.d.ts.map +1 -0
  9. package/lib/cjs/helpers.js +469 -0
  10. package/lib/cjs/helpers.js.map +1 -0
  11. package/lib/cjs/identity.d.ts +4 -0
  12. package/lib/cjs/identity.d.ts.map +1 -0
  13. package/lib/cjs/identity.js +27 -0
  14. package/lib/cjs/identity.js.map +1 -0
  15. package/lib/cjs/index.d.ts +17 -0
  16. package/lib/cjs/index.d.ts.map +1 -0
  17. package/lib/cjs/index.js +43 -0
  18. package/lib/cjs/index.js.map +1 -0
  19. package/lib/cjs/recorders/analytics.d.ts +7 -0
  20. package/lib/cjs/recorders/analytics.d.ts.map +1 -0
  21. package/lib/cjs/recorders/analytics.js +95 -0
  22. package/lib/cjs/recorders/analytics.js.map +1 -0
  23. package/lib/cjs/recorders/feedback.d.ts +4 -0
  24. package/lib/cjs/recorders/feedback.d.ts.map +1 -0
  25. package/lib/cjs/recorders/feedback.js +611 -0
  26. package/lib/cjs/recorders/feedback.js.map +1 -0
  27. package/lib/cjs/recorders/interactions.d.ts +4 -0
  28. package/lib/cjs/recorders/interactions.d.ts.map +1 -0
  29. package/lib/cjs/recorders/interactions.js +320 -0
  30. package/lib/cjs/recorders/interactions.js.map +1 -0
  31. package/lib/cjs/recorders/keys.d.ts +4 -0
  32. package/lib/cjs/recorders/keys.d.ts.map +1 -0
  33. package/lib/cjs/recorders/keys.js +64 -0
  34. package/lib/cjs/recorders/keys.js.map +1 -0
  35. package/lib/cjs/recorders/lifecycle.d.ts +4 -0
  36. package/lib/cjs/recorders/lifecycle.d.ts.map +1 -0
  37. package/lib/cjs/recorders/lifecycle.js +86 -0
  38. package/lib/cjs/recorders/lifecycle.js.map +1 -0
  39. package/lib/cjs/recorders/navigation.d.ts +4 -0
  40. package/lib/cjs/recorders/navigation.d.ts.map +1 -0
  41. package/lib/cjs/recorders/navigation.js +18 -0
  42. package/lib/cjs/recorders/navigation.js.map +1 -0
  43. package/lib/cjs/recorders/resource-error.d.ts +4 -0
  44. package/lib/cjs/recorders/resource-error.d.ts.map +1 -0
  45. package/lib/cjs/recorders/resource-error.js +159 -0
  46. package/lib/cjs/recorders/resource-error.js.map +1 -0
  47. package/lib/cjs/types.d.ts +263 -0
  48. package/lib/cjs/types.d.ts.map +1 -0
  49. package/lib/cjs/types.js +5 -0
  50. package/lib/cjs/types.js.map +1 -0
  51. package/lib/esm/capture.d.ts +13 -0
  52. package/lib/esm/capture.d.ts.map +1 -0
  53. package/lib/esm/capture.js +225 -0
  54. package/lib/esm/capture.js.map +1 -0
  55. package/lib/esm/helpers.d.ts +9 -0
  56. package/lib/esm/helpers.d.ts.map +1 -0
  57. package/lib/esm/helpers.js +461 -0
  58. package/lib/esm/helpers.js.map +1 -0
  59. package/lib/esm/identity.d.ts +4 -0
  60. package/lib/esm/identity.d.ts.map +1 -0
  61. package/lib/esm/identity.js +23 -0
  62. package/lib/esm/identity.js.map +1 -0
  63. package/lib/esm/index.d.ts +17 -0
  64. package/lib/esm/index.d.ts.map +1 -0
  65. package/lib/esm/index.js +27 -0
  66. package/lib/esm/index.js.map +1 -0
  67. package/lib/esm/recorders/analytics.d.ts +7 -0
  68. package/lib/esm/recorders/analytics.d.ts.map +1 -0
  69. package/lib/esm/recorders/analytics.js +92 -0
  70. package/lib/esm/recorders/analytics.js.map +1 -0
  71. package/lib/esm/recorders/feedback.d.ts +4 -0
  72. package/lib/esm/recorders/feedback.d.ts.map +1 -0
  73. package/lib/esm/recorders/feedback.js +608 -0
  74. package/lib/esm/recorders/feedback.js.map +1 -0
  75. package/lib/esm/recorders/interactions.d.ts +4 -0
  76. package/lib/esm/recorders/interactions.d.ts.map +1 -0
  77. package/lib/esm/recorders/interactions.js +317 -0
  78. package/lib/esm/recorders/interactions.js.map +1 -0
  79. package/lib/esm/recorders/keys.d.ts +4 -0
  80. package/lib/esm/recorders/keys.d.ts.map +1 -0
  81. package/lib/esm/recorders/keys.js +61 -0
  82. package/lib/esm/recorders/keys.js.map +1 -0
  83. package/lib/esm/recorders/lifecycle.d.ts +4 -0
  84. package/lib/esm/recorders/lifecycle.d.ts.map +1 -0
  85. package/lib/esm/recorders/lifecycle.js +83 -0
  86. package/lib/esm/recorders/lifecycle.js.map +1 -0
  87. package/lib/esm/recorders/navigation.d.ts +4 -0
  88. package/lib/esm/recorders/navigation.d.ts.map +1 -0
  89. package/lib/esm/recorders/navigation.js +15 -0
  90. package/lib/esm/recorders/navigation.js.map +1 -0
  91. package/lib/esm/recorders/resource-error.d.ts +4 -0
  92. package/lib/esm/recorders/resource-error.d.ts.map +1 -0
  93. package/lib/esm/recorders/resource-error.js +156 -0
  94. package/lib/esm/recorders/resource-error.js.map +1 -0
  95. package/lib/esm/types.d.ts +263 -0
  96. package/lib/esm/types.d.ts.map +1 -0
  97. package/lib/esm/types.js +2 -0
  98. package/lib/esm/types.js.map +1 -0
  99. package/package.json +35 -3
  100. package/schema.json +1110 -0
@@ -0,0 +1,13 @@
1
+ import { HostSignals, SemanticCaptureConfig, SemanticFamily, SemanticHost, SemanticRecorder } from './types';
2
+ export declare const SEMANTIC_CAPS: Record<SemanticFamily, number>;
3
+ export interface SemanticCapture {
4
+ isActive: () => boolean;
5
+ start: () => void;
6
+ stop: () => void;
7
+ updateConfig: (config: SemanticCaptureConfig) => void;
8
+ resetSession: () => void;
9
+ notify: <K extends keyof HostSignals>(signal: K, value: HostSignals[K]) => void;
10
+ }
11
+ /** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
12
+ export declare function createCapture(config: SemanticCaptureConfig, host: SemanticHost, recorders: readonly SemanticRecorder[]): SemanticCapture;
13
+ //# sourceMappingURL=capture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EAErB,cAAc,EACd,YAAY,EAEZ,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAcxD,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,YAAY,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACjF;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAC3B,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,eAAe,CAyKjB"}
@@ -0,0 +1,225 @@
1
+ import { __assign, __values } from "tslib";
2
+ import { createHelpers } from './helpers';
3
+ import { getDocumentIdentity } from './identity';
4
+ export var SEMANTIC_CAPS = {
5
+ click: 2000,
6
+ keys: 1000,
7
+ 'resource-error': 200,
8
+ field: 1000,
9
+ submit: 300,
10
+ notice: 300,
11
+ dialog: 300,
12
+ 'amp-event': 500,
13
+ context: 200,
14
+ recording: 200,
15
+ navigation: 200,
16
+ visibility: 200,
17
+ lifecycle: 200,
18
+ };
19
+ /** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
20
+ export function createCapture(config, host, recorders) {
21
+ var _a;
22
+ var settings = copyConfig(config);
23
+ var active = false;
24
+ var requested = false;
25
+ var snapshotSeen = false;
26
+ var sample;
27
+ var cleanups = [];
28
+ var counts = {};
29
+ var dropped = {};
30
+ var signals = new Map();
31
+ var subscribers = new Set();
32
+ var now = (_a = host.now) !== null && _a !== void 0 ? _a : Date.now;
33
+ var report = function (error) {
34
+ var _a;
35
+ try {
36
+ (_a = host.onError) === null || _a === void 0 ? void 0 : _a.call(host, error);
37
+ }
38
+ catch (_b) {
39
+ /* Diagnostics must not affect the host. */
40
+ }
41
+ };
42
+ var safely = function (fn) {
43
+ try {
44
+ fn();
45
+ }
46
+ catch (error) {
47
+ report(error);
48
+ }
49
+ };
50
+ var enabled = function (family) { var _a; return active && ((_a = settings.families) === null || _a === void 0 ? void 0 : _a[family]) !== false; };
51
+ var hasCapacity = function (family) { var _a; return enabled(family) && ((_a = counts[family]) !== null && _a !== void 0 ? _a : 0) < SEMANTIC_CAPS[family]; };
52
+ var canEmit = function (family) {
53
+ var _a;
54
+ if (!enabled(family))
55
+ return false;
56
+ if (hasCapacity(family))
57
+ return true;
58
+ dropped[family] = ((_a = dropped[family]) !== null && _a !== void 0 ? _a : 0) + 1;
59
+ return false;
60
+ };
61
+ var context = {
62
+ host: host,
63
+ helpers: createHelpers(host),
64
+ now: now,
65
+ enabled: enabled,
66
+ canEmit: canEmit,
67
+ hasCapacity: hasCapacity,
68
+ dropped: function () { return (__assign({}, dropped)); },
69
+ hasSnapshot: function () { return snapshotSeen; },
70
+ emit: function (family, payload, timestamp) {
71
+ var _a, _b;
72
+ if (timestamp === void 0) { timestamp = now(); }
73
+ if (!canEmit(family))
74
+ return false;
75
+ var identity;
76
+ try {
77
+ identity = (_a = host.getIdentity) === null || _a === void 0 ? void 0 : _a.call(host);
78
+ }
79
+ catch (error) {
80
+ report(error);
81
+ }
82
+ identity !== null && identity !== void 0 ? identity : (identity = getDocumentIdentity(host.document, host.window));
83
+ var event = {
84
+ name: family,
85
+ payload: __assign(__assign({}, payload), { v: 1, tab_id: identity.tab_id, document_id: identity.document_id }),
86
+ timestamp: timestamp,
87
+ };
88
+ counts[family] = ((_b = counts[family]) !== null && _b !== void 0 ? _b : 0) + 1;
89
+ try {
90
+ host.emit(event);
91
+ }
92
+ catch (error) {
93
+ report(error);
94
+ return false;
95
+ }
96
+ if (family === 'context')
97
+ dropped = {};
98
+ subscribers.forEach(function (subscriber) { return safely(function () { return subscriber(event); }); });
99
+ return true;
100
+ },
101
+ on: function (signal, callback) {
102
+ var listeners = signals.get(signal);
103
+ if (!listeners) {
104
+ listeners = new Set();
105
+ signals.set(signal, listeners);
106
+ }
107
+ var listener = function (value) { return safely(function () { return callback(value); }); };
108
+ listeners.add(listener);
109
+ var registered = listeners;
110
+ return function () {
111
+ registered.delete(listener);
112
+ };
113
+ },
114
+ subscribe: function (callback) {
115
+ subscribers.add(callback);
116
+ return function () {
117
+ subscribers.delete(callback);
118
+ };
119
+ },
120
+ };
121
+ var detach = function () {
122
+ active = false;
123
+ var previous = cleanups;
124
+ cleanups = [];
125
+ previous.reverse().forEach(function (cleanup) { return safely(cleanup); });
126
+ signals.clear();
127
+ subscribers.clear();
128
+ };
129
+ var attach = function () {
130
+ var e_1, _a;
131
+ var _b, _c;
132
+ if (active || !requested || !settings.enabled)
133
+ return;
134
+ var rate = (_b = settings.sampleRate) !== null && _b !== void 0 ? _b : 1;
135
+ if (!Number.isFinite(rate) || rate <= 0 || rate > 1)
136
+ return;
137
+ if (sample === undefined)
138
+ sample = ((_c = host.random) !== null && _c !== void 0 ? _c : Math.random)();
139
+ if (sample >= rate)
140
+ return;
141
+ active = true;
142
+ var _loop_1 = function (recorder) {
143
+ if (recorder.families.some(enabled)) {
144
+ var acquired_1 = [];
145
+ var scoped = __assign(__assign({}, context), { onCleanup: function (cleanup) {
146
+ acquired_1.push(cleanup);
147
+ }, on: function (signal, callback) {
148
+ var cleanup = context.on(signal, callback);
149
+ acquired_1.push(cleanup);
150
+ return cleanup;
151
+ }, subscribe: function (callback) {
152
+ var cleanup = context.subscribe(callback);
153
+ acquired_1.push(cleanup);
154
+ return cleanup;
155
+ } });
156
+ var rollback = function () {
157
+ acquired_1
158
+ .splice(0)
159
+ .reverse()
160
+ .forEach(function (cleanup) { return safely(cleanup); });
161
+ };
162
+ try {
163
+ acquired_1.push(recorder.setup(scoped));
164
+ cleanups.push(rollback);
165
+ }
166
+ catch (error) {
167
+ rollback();
168
+ report(error);
169
+ }
170
+ }
171
+ };
172
+ try {
173
+ for (var recorders_1 = __values(recorders), recorders_1_1 = recorders_1.next(); !recorders_1_1.done; recorders_1_1 = recorders_1.next()) {
174
+ var recorder = recorders_1_1.value;
175
+ _loop_1(recorder);
176
+ }
177
+ }
178
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
179
+ finally {
180
+ try {
181
+ if (recorders_1_1 && !recorders_1_1.done && (_a = recorders_1.return)) _a.call(recorders_1);
182
+ }
183
+ finally { if (e_1) throw e_1.error; }
184
+ }
185
+ };
186
+ return {
187
+ isActive: function () { return active; },
188
+ start: function () {
189
+ requested = true;
190
+ attach();
191
+ },
192
+ stop: function () {
193
+ requested = false;
194
+ snapshotSeen = false;
195
+ detach();
196
+ },
197
+ updateConfig: function (next) {
198
+ detach();
199
+ settings = copyConfig(next);
200
+ attach();
201
+ },
202
+ resetSession: function () {
203
+ detach();
204
+ sample = undefined;
205
+ snapshotSeen = false;
206
+ counts = {};
207
+ dropped = {};
208
+ attach();
209
+ },
210
+ notify: function (signal, value) {
211
+ var _a, _b, _c;
212
+ if (signal === 'snapshot')
213
+ snapshotSeen = true;
214
+ if (signal === 'snapshot' || signal === 'navigation' || signal === 'url')
215
+ (_b = (_a = context.helpers).invalidateHeading) === null || _b === void 0 ? void 0 : _b.call(_a);
216
+ if (!active)
217
+ return;
218
+ (_c = signals.get(signal)) === null || _c === void 0 ? void 0 : _c.forEach(function (callback) { return callback(value); });
219
+ },
220
+ };
221
+ }
222
+ function copyConfig(config) {
223
+ return __assign(__assign({}, config), { families: config.families ? __assign({}, config.families) : undefined });
224
+ }
225
+ //# sourceMappingURL=capture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHelpers } from './helpers';\nimport { getDocumentIdentity } from './identity';\nimport {\n Cleanup,\n HostSignals,\n RecorderContext,\n SemanticCaptureConfig,\n SemanticEvent,\n SemanticFamily,\n SemanticHost,\n SemanticPayloads,\n SemanticRecorder,\n} from './types';\n\nexport const SEMANTIC_CAPS: Record<SemanticFamily, number> = {\n click: 2000,\n keys: 1000,\n 'resource-error': 200,\n field: 1000,\n submit: 300,\n notice: 300,\n dialog: 300,\n 'amp-event': 500,\n context: 200,\n recording: 200,\n navigation: 200,\n visibility: 200,\n lifecycle: 200,\n};\n\nexport interface SemanticCapture {\n isActive: () => boolean;\n start: () => void;\n stop: () => void;\n updateConfig: (config: SemanticCaptureConfig) => void;\n resetSession: () => void;\n notify: <K extends keyof HostSignals>(signal: K, value: HostSignals[K]) => void;\n}\n\n/** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */\nexport function createCapture(\n config: SemanticCaptureConfig,\n host: SemanticHost,\n recorders: readonly SemanticRecorder[],\n): SemanticCapture {\n let settings = copyConfig(config);\n let active = false;\n let requested = false;\n let snapshotSeen = false;\n let sample: number | undefined;\n let cleanups: Cleanup[] = [];\n let counts: Partial<Record<SemanticFamily, number>> = {};\n let dropped: Partial<Record<SemanticFamily, number>> = {};\n const signals = new Map<keyof HostSignals, Set<(value: never) => void>>();\n const subscribers = new Set<(event: SemanticEvent) => void>();\n const now = host.now ?? Date.now;\n const report = (error: unknown) => {\n try {\n host.onError?.(error);\n } catch {\n /* Diagnostics must not affect the host. */\n }\n };\n const safely = (fn: () => void) => {\n try {\n fn();\n } catch (error) {\n report(error);\n }\n };\n const enabled = (family: SemanticFamily) => active && settings.families?.[family] !== false;\n const hasCapacity = (family: SemanticFamily) => enabled(family) && (counts[family] ?? 0) < SEMANTIC_CAPS[family];\n const canEmit = (family: SemanticFamily): boolean => {\n if (!enabled(family)) return false;\n if (hasCapacity(family)) return true;\n dropped[family] = (dropped[family] ?? 0) + 1;\n return false;\n };\n const context: Omit<RecorderContext, 'onCleanup'> = {\n host,\n helpers: createHelpers(host),\n now,\n enabled,\n canEmit,\n hasCapacity,\n dropped: () => ({ ...dropped }),\n hasSnapshot: () => snapshotSeen,\n emit: <K extends SemanticFamily>(family: K, payload: SemanticPayloads[K], timestamp = now()): boolean => {\n if (!canEmit(family)) return false;\n let identity;\n try {\n identity = host.getIdentity?.();\n } catch (error) {\n report(error);\n }\n identity ??= getDocumentIdentity(host.document, host.window);\n const event = {\n name: family,\n payload: { ...payload, v: 1, tab_id: identity.tab_id, document_id: identity.document_id },\n timestamp,\n } as SemanticEvent;\n counts[family] = (counts[family] ?? 0) + 1;\n try {\n host.emit(event);\n } catch (error) {\n report(error);\n return false;\n }\n if (family === 'context') dropped = {};\n subscribers.forEach((subscriber) => safely(() => subscriber(event)));\n return true;\n },\n on: (signal, callback) => {\n let listeners = signals.get(signal);\n if (!listeners) {\n listeners = new Set();\n signals.set(signal, listeners);\n }\n const listener = (value: never) => safely(() => callback(value));\n listeners.add(listener);\n const registered = listeners;\n return () => {\n registered.delete(listener);\n };\n },\n subscribe: (callback) => {\n subscribers.add(callback);\n return () => {\n subscribers.delete(callback);\n };\n },\n };\n const detach = () => {\n active = false;\n const previous = cleanups;\n cleanups = [];\n previous.reverse().forEach((cleanup) => safely(cleanup));\n signals.clear();\n subscribers.clear();\n };\n const attach = () => {\n if (active || !requested || !settings.enabled) return;\n const rate = settings.sampleRate ?? 1;\n if (!Number.isFinite(rate) || rate <= 0 || rate > 1) return;\n if (sample === undefined) sample = (host.random ?? Math.random)();\n if (sample >= rate) return;\n active = true;\n for (const recorder of recorders) {\n if (recorder.families.some(enabled)) {\n const acquired: Cleanup[] = [];\n const scoped: RecorderContext = {\n ...context,\n onCleanup: (cleanup) => {\n acquired.push(cleanup);\n },\n on: (signal, callback) => {\n const cleanup = context.on(signal, callback);\n acquired.push(cleanup);\n return cleanup;\n },\n subscribe: (callback) => {\n const cleanup = context.subscribe(callback);\n acquired.push(cleanup);\n return cleanup;\n },\n };\n const rollback = () => {\n acquired\n .splice(0)\n .reverse()\n .forEach((cleanup) => safely(cleanup));\n };\n try {\n acquired.push(recorder.setup(scoped));\n cleanups.push(rollback);\n } catch (error) {\n rollback();\n report(error);\n }\n }\n }\n };\n return {\n isActive: () => active,\n start: () => {\n requested = true;\n attach();\n },\n stop: () => {\n requested = false;\n snapshotSeen = false;\n detach();\n },\n updateConfig: (next) => {\n detach();\n settings = copyConfig(next);\n attach();\n },\n resetSession: () => {\n detach();\n sample = undefined;\n snapshotSeen = false;\n counts = {};\n dropped = {};\n attach();\n },\n notify: (signal, value) => {\n if (signal === 'snapshot') snapshotSeen = true;\n if (signal === 'snapshot' || signal === 'navigation' || signal === 'url') context.helpers.invalidateHeading?.();\n if (!active) return;\n signals.get(signal)?.forEach((callback) => callback(value as never));\n },\n };\n}\n\nfunction copyConfig(config: SemanticCaptureConfig): SemanticCaptureConfig {\n return { ...config, families: config.families ? { ...config.families } : undefined };\n}\n"]}
@@ -0,0 +1,9 @@
1
+ import { SemanticHelpers, SemanticHost } from './types';
2
+ export declare function truncate(value: string, limit: number): string;
3
+ /** Only path-shaped information leaves the browser, including hash router paths. */
4
+ export declare function urlTemplate(value: string, base?: string): string;
5
+ export declare function roleOf(element: Element): string;
6
+ /** ARIA treats unknown nonempty tokens as true, alongside grammar and spelling. */
7
+ export declare function isAriaInvalid(element: Element): boolean;
8
+ export declare function createHelpers(host: SemanticHost): SemanticHelpers;
9
+ //# sourceMappingURL=helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA+DpE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAA8B,GAAG,MAAM,CA2BrF;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAuD/C;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAyPjE"}