skybridge 0.0.0-dev.e4c9359 → 0.0.0-dev.e9705ff

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 (75) hide show
  1. package/README.md +102 -10
  2. package/dist/src/server/index.d.ts +1 -1
  3. package/dist/src/server/inferUtilityTypes.d.ts +12 -6
  4. package/dist/src/server/server.d.ts +14 -1
  5. package/dist/src/server/server.js.map +1 -1
  6. package/dist/src/web/create-store.d.ts +3 -0
  7. package/dist/src/web/create-store.js +25 -0
  8. package/dist/src/web/create-store.js.map +1 -0
  9. package/dist/src/web/create-store.test.js +70 -0
  10. package/dist/src/web/create-store.test.js.map +1 -0
  11. package/dist/src/web/data-llm.d.ts +14 -0
  12. package/dist/src/web/data-llm.js +68 -0
  13. package/dist/src/web/data-llm.js.map +1 -0
  14. package/dist/src/web/data-llm.test.js +76 -0
  15. package/dist/src/web/data-llm.test.js.map +1 -0
  16. package/dist/src/web/{typed-hooks.d.ts → generate-helpers.d.ts} +17 -16
  17. package/dist/src/web/{typed-hooks.js → generate-helpers.js} +10 -8
  18. package/dist/src/web/generate-helpers.js.map +1 -0
  19. package/dist/src/web/generate-helpers.test-d.d.ts +1 -0
  20. package/dist/src/web/generate-helpers.test-d.js +153 -0
  21. package/dist/src/web/generate-helpers.test-d.js.map +1 -0
  22. package/dist/src/web/generate-helpers.test.d.ts +1 -0
  23. package/dist/src/web/{typed-hooks.test.js → generate-helpers.test.js} +5 -5
  24. package/dist/src/web/generate-helpers.test.js.map +1 -0
  25. package/dist/src/web/helpers/state.d.ts +7 -0
  26. package/dist/src/web/helpers/state.js +40 -0
  27. package/dist/src/web/helpers/state.js.map +1 -0
  28. package/dist/src/web/helpers/state.test.d.ts +1 -0
  29. package/dist/src/web/helpers/state.test.js +46 -0
  30. package/dist/src/web/helpers/state.test.js.map +1 -0
  31. package/dist/src/web/hooks/index.d.ts +1 -3
  32. package/dist/src/web/hooks/index.js +1 -3
  33. package/dist/src/web/hooks/index.js.map +1 -1
  34. package/dist/src/web/hooks/use-call-tool.d.ts +20 -19
  35. package/dist/src/web/hooks/use-call-tool.js +7 -15
  36. package/dist/src/web/hooks/use-call-tool.js.map +1 -1
  37. package/dist/src/web/hooks/use-call-tool.test-d.d.ts +1 -0
  38. package/dist/src/web/hooks/use-call-tool.test-d.js +104 -0
  39. package/dist/src/web/hooks/use-call-tool.test-d.js.map +1 -0
  40. package/dist/src/web/hooks/use-call-tool.test.js +17 -9
  41. package/dist/src/web/hooks/use-call-tool.test.js.map +1 -1
  42. package/dist/src/web/hooks/use-widget-state.js +8 -6
  43. package/dist/src/web/hooks/use-widget-state.js.map +1 -1
  44. package/dist/src/web/index.d.ts +4 -2
  45. package/dist/src/web/index.js +4 -2
  46. package/dist/src/web/index.js.map +1 -1
  47. package/dist/src/web/plugin/data-llm.test.d.ts +1 -0
  48. package/dist/src/web/plugin/data-llm.test.js +81 -0
  49. package/dist/src/web/plugin/data-llm.test.js.map +1 -0
  50. package/dist/src/web/{plugin.js → plugin/plugin.js} +5 -0
  51. package/dist/src/web/plugin/plugin.js.map +1 -0
  52. package/dist/src/web/plugin/transform-data-llm.d.ts +12 -0
  53. package/dist/src/web/plugin/transform-data-llm.js +93 -0
  54. package/dist/src/web/plugin/transform-data-llm.js.map +1 -0
  55. package/dist/src/web/plugin/transform-data-llm.test.d.ts +1 -0
  56. package/dist/src/web/plugin/transform-data-llm.test.js +81 -0
  57. package/dist/src/web/plugin/transform-data-llm.test.js.map +1 -0
  58. package/dist/src/web/types.d.ts +10 -0
  59. package/dist/src/web/types.js +1 -0
  60. package/dist/src/web/types.js.map +1 -1
  61. package/package.json +7 -3
  62. package/dist/src/web/hooks/use-tool-output.d.ts +0 -4
  63. package/dist/src/web/hooks/use-tool-output.js +0 -9
  64. package/dist/src/web/hooks/use-tool-output.js.map +0 -1
  65. package/dist/src/web/hooks/use-tool-response-metadata.d.ts +0 -4
  66. package/dist/src/web/hooks/use-tool-response-metadata.js +0 -8
  67. package/dist/src/web/hooks/use-tool-response-metadata.js.map +0 -1
  68. package/dist/src/web/plugin.js.map +0 -1
  69. package/dist/src/web/typed-hooks.js.map +0 -1
  70. package/dist/src/web/typed-hooks.test-d.js +0 -90
  71. package/dist/src/web/typed-hooks.test-d.js.map +0 -1
  72. package/dist/src/web/typed-hooks.test.js.map +0 -1
  73. /package/dist/src/web/{typed-hooks.test-d.d.ts → create-store.test.d.ts} +0 -0
  74. /package/dist/src/web/{typed-hooks.test.d.ts → data-llm.test.d.ts} +0 -0
  75. /package/dist/src/web/{plugin.d.ts → plugin/plugin.d.ts} +0 -0
@@ -1,4 +1,4 @@
1
- import { useCallTool } from "./hooks/use-call-tool.js";
1
+ import { useCallTool, } from "./hooks/use-call-tool.js";
2
2
  import { useToolInfo } from "./hooks/use-tool-info.js";
3
3
  /**
4
4
  * Creates typed versions of skybridge hooks with full type inference
@@ -7,7 +7,9 @@ import { useToolInfo } from "./hooks/use-tool-info.js";
7
7
  * This is the recommended way to use skybridge hooks in your widgets.
8
8
  * Set this up once in a dedicated file and export the typed hooks for use across your app.
9
9
  *
10
- * @typeParam T - The type of your McpServer instance. Use `typeof server`.
10
+ * @typeParam ServerType - The type of your McpServer instance (use `typeof server`).
11
+ * Must be a server instance created with method chaining.
12
+ * TypeScript will validate that tools can be inferred from this type.
11
13
  *
12
14
  * @example
13
15
  * ```typescript
@@ -27,9 +29,9 @@ import { useToolInfo } from "./hooks/use-tool-info.js";
27
29
  * ```typescript
28
30
  * // web/src/skybridge.ts (one-time setup)
29
31
  * import type { AppType } from "../server";
30
- * import { createTypedHooks } from "skybridge/web";
32
+ * import { generateHelpers } from "skybridge/web";
31
33
  *
32
- * export const { useCallTool, useToolInfo } = createTypedHooks<AppType>();
34
+ * export const { useCallTool, useToolInfo } = generateHelpers<AppType>();
33
35
  * ```
34
36
  *
35
37
  * @example
@@ -46,11 +48,11 @@ import { useToolInfo } from "./hooks/use-tool-info.js";
46
48
  * const toolInfo = useToolInfo<"search-voyage">();
47
49
  * // ^ autocomplete for widget names
48
50
  * // toolInfo.input is typed based on widget input schema
49
- * // toolInfo.output is typed based on widget output schema
51
+ * // toolInfo.output.structuredContent is typed based on widget output schema
50
52
  * }
51
53
  * ```
52
54
  */
53
- export function createTypedHooks() {
55
+ export function generateHelpers() {
54
56
  return {
55
57
  /**
56
58
  * Typed version of `useCallTool` that provides autocomplete for tool names
@@ -85,7 +87,7 @@ export function createTypedHooks() {
85
87
  * ```typescript
86
88
  * const toolInfo = useToolInfo<"search-voyage">();
87
89
  * // toolInfo.input is typed as { destination: string; ... }
88
- * // toolInfo.output is typed as { results: Array<...>; ... } | undefined
90
+ * // toolInfo.output is typed as { results: Array<...>; ... }
89
91
  * // toolInfo.status narrows correctly: "pending" | "success"
90
92
  *
91
93
  * if (toolInfo.isPending) {
@@ -104,4 +106,4 @@ export function createTypedHooks() {
104
106
  },
105
107
  };
106
108
  }
107
- //# sourceMappingURL=typed-hooks.js.map
109
+ //# sourceMappingURL=generate-helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-helpers.js","sourceRoot":"","sources":["../../../src/web/generate-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAIZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAkB,MAAM,0BAA0B,CAAC;AAmBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,UAAU,eAAe;IAI7B,OAAO;QACL;;;;;;;;;;;;;;;;;;WAkBG;QACH,WAAW,EAAE,CACX,IAAc,EAC0E,EAAE;YAC1F,OAAO,WAAW,CAAC,IAAI,CAGtB,CAAC;QACJ,CAAC;QAED;;;;;;;;;;;;;;;;;;;;;;;;WAwBG;QACH,WAAW,EAAE,GAGX,EAAE;YACF,OAAO,WAAW,EAGjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,153 @@
1
+ import { expectTypeOf, test } from "vitest";
2
+ import { generateHelpers } from "./generate-helpers.js";
3
+ import { createTestServer } from "../test/utils.js";
4
+ const server = createTestServer();
5
+ test("InferTools extracts the tool registry type (widgets + registerTool)", () => {
6
+ expectTypeOf().toHaveProperty("search-voyage");
7
+ expectTypeOf().toHaveProperty("get-trip-details");
8
+ expectTypeOf().toHaveProperty("no-input-widget");
9
+ expectTypeOf().toHaveProperty("calculate-price");
10
+ expectTypeOf().toHaveProperty("inferred-output-widget");
11
+ expectTypeOf().toHaveProperty("inferred-tool");
12
+ });
13
+ test("ToolNames returns a union of tool name literals (widgets + registerTool)", () => {
14
+ expectTypeOf().toEqualTypeOf();
15
+ });
16
+ test("ToolInput extracts the correct input type from Zod schema", () => {
17
+ expectTypeOf().toEqualTypeOf();
18
+ expectTypeOf().toEqualTypeOf();
19
+ expectTypeOf().toEqualTypeOf();
20
+ });
21
+ test("ToolOutput extracts the correct output type from callback's structuredContent", () => {
22
+ expectTypeOf().toEqualTypeOf();
23
+ expectTypeOf().toEqualTypeOf();
24
+ expectTypeOf().toEqualTypeOf();
25
+ expectTypeOf().toEqualTypeOf();
26
+ });
27
+ test("ToolOutput extracts the correct output type from callback (inferred)", () => {
28
+ expectTypeOf().toEqualTypeOf();
29
+ expectTypeOf().toEqualTypeOf();
30
+ });
31
+ test("generateHelpers provides autocomplete for tool names (widgets + registerTool)", () => {
32
+ const { useCallTool } = generateHelpers();
33
+ useCallTool("search-voyage");
34
+ useCallTool("get-trip-details");
35
+ useCallTool("no-input-widget");
36
+ useCallTool("calculate-price");
37
+ useCallTool("inferred-output-widget");
38
+ useCallTool("inferred-tool");
39
+ // @ts-expect-error - "invalid-name" is not a valid tool name
40
+ useCallTool("invalid-name");
41
+ });
42
+ test("useCallTool returns correctly typed callTool function", () => {
43
+ const { useCallTool } = generateHelpers();
44
+ const { callTool } = useCallTool("search-voyage");
45
+ callTool({ destination: "Spain" });
46
+ callTool({ destination: "France", departureDate: "2024-06-01" });
47
+ callTool({ destination: "Italy", maxPrice: 1000 });
48
+ const { callTool: calculateTool } = useCallTool("calculate-price");
49
+ calculateTool({ tripId: "123", passengers: 2 });
50
+ });
51
+ test("callTool can be called without args for tools with no required inputs", () => {
52
+ const { useCallTool } = generateHelpers();
53
+ const { callTool, callToolAsync } = useCallTool("no-input-widget");
54
+ callTool();
55
+ callTool({});
56
+ callToolAsync();
57
+ callToolAsync({});
58
+ });
59
+ test("callTool requires args for tools with required inputs", () => {
60
+ const { useCallTool } = generateHelpers();
61
+ const { callTool } = useCallTool("search-voyage");
62
+ // @ts-expect-error - "destination" is required
63
+ callTool();
64
+ // @ts-expect-error - "destination" is required
65
+ callTool({});
66
+ // This should work
67
+ callTool({ destination: "Spain" });
68
+ });
69
+ test("callTool supports sideEffects for tools with required inputs", () => {
70
+ const { useCallTool } = generateHelpers();
71
+ const { callTool, data } = useCallTool("search-voyage");
72
+ callTool({ destination: "Spain" }, {
73
+ onSuccess: (response, args) => {
74
+ expectTypeOf(response.structuredContent.results).toBeArray();
75
+ expectTypeOf(args.destination).toBeString();
76
+ },
77
+ onError: (error, args) => {
78
+ expectTypeOf(error).toBeUnknown();
79
+ expectTypeOf(args.destination).toBeString();
80
+ },
81
+ onSettled: (response, error, args) => {
82
+ if (response) {
83
+ expectTypeOf(response.structuredContent.totalCount).toBeNumber();
84
+ }
85
+ expectTypeOf(args.destination).toBeString();
86
+ },
87
+ });
88
+ });
89
+ test("callTool supports sideEffects for tools with no required inputs", () => {
90
+ const { useCallTool } = generateHelpers();
91
+ const { callTool } = useCallTool("no-input-widget");
92
+ callTool({
93
+ onSuccess: (response) => {
94
+ expectTypeOf(response).toHaveProperty("structuredContent");
95
+ },
96
+ });
97
+ callTool({}, {
98
+ onSuccess: (response) => {
99
+ expectTypeOf(response).toHaveProperty("structuredContent");
100
+ },
101
+ });
102
+ });
103
+ test("callToolAsync returns correctly typed promise", () => {
104
+ const { useCallTool } = generateHelpers();
105
+ const { callToolAsync: searchAsync } = useCallTool("search-voyage");
106
+ const searchPromise = searchAsync({ destination: "Spain" });
107
+ expectTypeOf(searchPromise).resolves.toHaveProperty("structuredContent");
108
+ const { callToolAsync: noInputAsync } = useCallTool("no-input-widget");
109
+ const noInputPromise = noInputAsync();
110
+ expectTypeOf(noInputPromise).resolves.toHaveProperty("structuredContent");
111
+ });
112
+ test("useCallTool returns correctly typed data", () => {
113
+ const { useCallTool } = generateHelpers();
114
+ const { data } = useCallTool("search-voyage");
115
+ if (data) {
116
+ expectTypeOf(data.structuredContent).toExtend();
117
+ expectTypeOf(data.structuredContent.results).toBeArray();
118
+ expectTypeOf(data.structuredContent.totalCount).toBeNumber();
119
+ }
120
+ });
121
+ test("useCallTool returns correctly typed data for callback-inferred outputs", () => {
122
+ const { useCallTool } = generateHelpers();
123
+ const { data: widgetData } = useCallTool("inferred-output-widget");
124
+ if (widgetData) {
125
+ expectTypeOf(widgetData.structuredContent).toExtend();
126
+ }
127
+ const { data: toolData } = useCallTool("inferred-tool");
128
+ if (toolData) {
129
+ expectTypeOf(toolData.structuredContent).toExtend();
130
+ }
131
+ });
132
+ test("generateHelpers provides autocomplete for tool names in useToolInfo (widgets + registerTool)", () => {
133
+ const { useToolInfo } = generateHelpers();
134
+ useToolInfo();
135
+ useToolInfo();
136
+ useToolInfo();
137
+ useToolInfo();
138
+ useToolInfo();
139
+ useToolInfo();
140
+ // @ts-expect-error - "invalid-name" is not a valid tool name
141
+ useToolInfo();
142
+ });
143
+ test("useToolInfo infers input and output types", () => {
144
+ const { useToolInfo } = generateHelpers();
145
+ const toolInfo = useToolInfo();
146
+ expectTypeOf(toolInfo.input).toExtend();
147
+ if (toolInfo.status === "success") {
148
+ expectTypeOf(toolInfo.output).toExtend();
149
+ expectTypeOf(toolInfo.output.results).toBeArray();
150
+ expectTypeOf(toolInfo.output.totalCount).toBeNumber();
151
+ }
152
+ });
153
+ //# sourceMappingURL=generate-helpers.test-d.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-helpers.test-d.js","sourceRoot":"","sources":["../../../src/web/generate-helpers.test-d.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -1,17 +1,17 @@
1
1
  import { describe, expect, it } from "vitest";
2
- import { createTypedHooks } from "./typed-hooks.js";
2
+ import { generateHelpers } from "./generate-helpers.js";
3
3
  import { createMinimalTestServer } from "../test/utils.js";
4
4
  const server = createMinimalTestServer();
5
- describe("createTypedHooks", () => {
5
+ describe("generateHelpers", () => {
6
6
  it("should return an object with useCallTool hook", () => {
7
- const hooks = createTypedHooks();
7
+ const hooks = generateHelpers();
8
8
  expect(hooks).toHaveProperty("useCallTool");
9
9
  expect(typeof hooks.useCallTool).toBe("function");
10
10
  });
11
11
  it("should return an object with useToolInfo hook", () => {
12
- const hooks = createTypedHooks();
12
+ const hooks = generateHelpers();
13
13
  expect(hooks).toHaveProperty("useToolInfo");
14
14
  expect(typeof hooks.useToolInfo).toBe("function");
15
15
  });
16
16
  });
17
- //# sourceMappingURL=typed-hooks.test.js.map
17
+ //# sourceMappingURL=generate-helpers.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-helpers.test.js","sourceRoot":"","sources":["../../../src/web/generate-helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;AAGzC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,eAAe,EAAc,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,eAAe,EAAc,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { type SuperJSONResult } from "superjson";
2
+ import type { UnknownObject } from "../types.js";
3
+ export declare function filterWidgetContext<T extends UnknownObject>(state?: T | null): T | null;
4
+ export declare function injectWidgetContext<T extends UnknownObject>(newState: T | null): T | null;
5
+ export declare function serializeState(value: UnknownObject): unknown;
6
+ export declare function deserializeState(value: SuperJSONResult): unknown;
7
+ export declare function getInitialState<State extends UnknownObject>(defaultState?: State | (() => State)): State | null;
@@ -0,0 +1,40 @@
1
+ import superjson, {} from "superjson";
2
+ import { WIDGET_CONTEXT_KEY } from "../data-llm.js";
3
+ export function filterWidgetContext(state) {
4
+ if (state === null || state === undefined) {
5
+ return null;
6
+ }
7
+ const { [WIDGET_CONTEXT_KEY]: _, ...filteredState } = state;
8
+ return filteredState;
9
+ }
10
+ export function injectWidgetContext(newState) {
11
+ if (newState === null) {
12
+ return null;
13
+ }
14
+ const currentWindowState = window.openai?.widgetState;
15
+ if (currentWindowState !== null &&
16
+ currentWindowState !== undefined &&
17
+ WIDGET_CONTEXT_KEY in currentWindowState) {
18
+ return {
19
+ ...newState,
20
+ [WIDGET_CONTEXT_KEY]: currentWindowState[WIDGET_CONTEXT_KEY],
21
+ };
22
+ }
23
+ return newState;
24
+ }
25
+ export function serializeState(value) {
26
+ return superjson.parse(superjson.stringify(value)); // Strips functions
27
+ }
28
+ export function deserializeState(value) {
29
+ return superjson.deserialize(value);
30
+ }
31
+ export function getInitialState(defaultState) {
32
+ const widgetStateFromWindow = window.openai?.widgetState;
33
+ if (widgetStateFromWindow !== null && widgetStateFromWindow !== undefined) {
34
+ return filterWidgetContext(widgetStateFromWindow);
35
+ }
36
+ return typeof defaultState === "function"
37
+ ? defaultState()
38
+ : defaultState ?? null;
39
+ }
40
+ //# sourceMappingURL=state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../src/web/helpers/state.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAwB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,MAAM,UAAU,mBAAmB,CACjC,KAAgB;IAEhB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,KAErD,CAAC;IAEF,OAAO,aAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAkB;IAElB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,WAG7B,CAAC;IAEd,IACE,kBAAkB,KAAK,IAAI;QAC3B,kBAAkB,KAAK,SAAS;QAChC,kBAAkB,IAAI,kBAAkB,EACxC,CAAC;QACD,OAAO;YACL,GAAG,QAAQ;YACX,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,CAAC;SACxD,CAAC;IACT,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,OAAO,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB;AACzE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,OAAO,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,YAAoC;IAEpC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,WAGhC,CAAC;IAEd,IAAI,qBAAqB,KAAK,IAAI,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QAC1E,OAAO,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,OAAO,YAAY,KAAK,UAAU;QACvC,CAAC,CAAC,YAAY,EAAE;QAChB,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC;AAC3B,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,46 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach, } from "vitest";
2
+ import { filterWidgetContext, injectWidgetContext, serializeState, getInitialState, } from "./state.js";
3
+ import { WIDGET_CONTEXT_KEY } from "../data-llm.js";
4
+ describe("state helpers", () => {
5
+ describe("filterWidgetContext", () => {
6
+ it("should return null when state is null", () => {
7
+ expect(filterWidgetContext(null)).toBe(null);
8
+ });
9
+ it("should return null when state is undefined", () => {
10
+ expect(filterWidgetContext(undefined)).toBe(null);
11
+ });
12
+ it("should correctly filter WIDGET_CONTEXT_KEY and preserve other properties", () => {
13
+ const stateWithCtxAndOthers = {
14
+ a: 1,
15
+ b: "two",
16
+ c: { nested: true },
17
+ [WIDGET_CONTEXT_KEY]: "context",
18
+ };
19
+ const filteredWithCtxAndOthers = filterWidgetContext(stateWithCtxAndOthers);
20
+ expect(filteredWithCtxAndOthers).toEqual({
21
+ a: 1,
22
+ b: "two",
23
+ c: { nested: true },
24
+ });
25
+ const stateNoCtx = { count: 5, name: "test" };
26
+ const filteredNoCtx = filterWidgetContext(stateNoCtx);
27
+ expect(filteredNoCtx).toEqual(stateNoCtx);
28
+ });
29
+ });
30
+ describe("serializeState", () => {
31
+ it("should serialize plain objects", () => {
32
+ const arr = [1, "two", { three: 3 }];
33
+ const date = new Date("2023-01-01T00:00:00Z");
34
+ const obj = { a: 1, b: "test", c: true, arr, date, fn: () => "test" };
35
+ const result = serializeState(obj);
36
+ expect(result).toEqual({
37
+ a: 1,
38
+ b: "test",
39
+ c: true,
40
+ arr: [1, "two", { three: 3 }],
41
+ date: new Date("2023-01-01T00:00:00.000Z"),
42
+ });
43
+ });
44
+ });
45
+ });
46
+ //# sourceMappingURL=state.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.test.js","sourceRoot":"","sources":["../../../../src/web/helpers/state.test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,EAAE,EACF,MAAM,EACN,EAAE,EACF,UAAU,EACV,SAAS,GAEV,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;YAClF,MAAM,qBAAqB,GAAG;gBAC5B,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,KAAK;gBACR,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;gBACnB,CAAC,kBAAkB,CAAC,EAAE,SAAS;aAChC,CAAC;YACF,MAAM,wBAAwB,GAAG,mBAAmB,CAClD,qBAAqB,CACtB,CAAC;YACF,MAAM,CAAC,wBAAwB,CAAC,CAAC,OAAO,CAAC;gBACvC,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,KAAK;gBACR,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;aACpB,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC9C,MAAM,aAAa,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACtD,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;YACtE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YAEnC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,MAAM;gBACT,CAAC,EAAE,IAAI;gBACP,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC7B,IAAI,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -1,4 +1,4 @@
1
- export { useCallTool } from "./use-call-tool.js";
1
+ export { useCallTool, type CallToolState, type SideEffects, type CallToolFn, type CallToolAsyncFn, } from "./use-call-tool.js";
2
2
  export { useDisplayMode } from "./use-display-mode.js";
3
3
  export { useFiles } from "./use-files.js";
4
4
  export { useLocale } from "./use-locale.js";
@@ -8,7 +8,5 @@ export { useRequestModal } from "./use-request-modal.js";
8
8
  export { useSendFollowUpMessage } from "./use-send-follow-up-message.js";
9
9
  export { useTheme } from "./use-theme.js";
10
10
  export { useToolInfo } from "./use-tool-info.js";
11
- export { useToolOutput } from "./use-tool-output.js";
12
- export { useToolResponseMetadata } from "./use-tool-response-metadata.js";
13
11
  export { useUserAgent } from "./use-user-agent.js";
14
12
  export { useWidgetState } from "./use-widget-state.js";
@@ -1,4 +1,4 @@
1
- export { useCallTool } from "./use-call-tool.js";
1
+ export { useCallTool, } from "./use-call-tool.js";
2
2
  export { useDisplayMode } from "./use-display-mode.js";
3
3
  export { useFiles } from "./use-files.js";
4
4
  export { useLocale } from "./use-locale.js";
@@ -8,8 +8,6 @@ export { useRequestModal } from "./use-request-modal.js";
8
8
  export { useSendFollowUpMessage } from "./use-send-follow-up-message.js";
9
9
  export { useTheme } from "./use-theme.js";
10
10
  export { useToolInfo } from "./use-tool-info.js";
11
- export { useToolOutput } from "./use-tool-output.js";
12
- export { useToolResponseMetadata } from "./use-tool-response-metadata.js";
13
11
  export { useUserAgent } from "./use-user-agent.js";
14
12
  export { useWidgetState } from "./use-widget-state.js";
15
13
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAKZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
@@ -1,4 +1,4 @@
1
- import type { CallToolArgs, CallToolResponse } from "../types.js";
1
+ import type { CallToolArgs, CallToolResponse, HasRequiredKeys } from "../types.js";
2
2
  type CallToolIdleState = {
3
3
  status: "idle";
4
4
  isIdle: true;
@@ -36,18 +36,28 @@ type CallToolErrorState = {
36
36
  error: unknown;
37
37
  };
38
38
  export type CallToolState<TData extends CallToolResponse = CallToolResponse> = CallToolIdleState | CallToolPendingState | CallToolSuccessState<TData> | CallToolErrorState;
39
- type SideEffects<ToolArgs, ToolResponse> = {
39
+ export type SideEffects<ToolArgs, ToolResponse> = {
40
40
  onSuccess?: (data: ToolResponse, toolArgs: ToolArgs) => void;
41
41
  onError?: (error: unknown, toolArgs: ToolArgs) => void;
42
42
  onSettled?: (data: ToolResponse | undefined, error: unknown | undefined, toolArgs: ToolArgs) => void;
43
43
  };
44
- type CallToolAsyncFn<ToolArgs, ToolResponse> = ToolArgs extends null ? () => Promise<ToolResponse> : (toolArgs: ToolArgs) => Promise<ToolResponse>;
44
+ type IsArgsOptional<T> = [T] extends [null] ? true : HasRequiredKeys<T> extends false ? true : false;
45
+ export type CallToolFn<TArgs, TResponse> = IsArgsOptional<TArgs> extends true ? {
46
+ (): void;
47
+ (sideEffects: SideEffects<TArgs, TResponse>): void;
48
+ (args: TArgs): void;
49
+ (args: TArgs, sideEffects: SideEffects<TArgs, TResponse>): void;
50
+ } : {
51
+ (args: TArgs): void;
52
+ (args: TArgs, sideEffects: SideEffects<TArgs, TResponse>): void;
53
+ };
54
+ export type CallToolAsyncFn<TArgs, TResponse> = IsArgsOptional<TArgs> extends true ? {
55
+ (): Promise<TResponse>;
56
+ (args: TArgs): Promise<TResponse>;
57
+ } : (args: TArgs) => Promise<TResponse>;
45
58
  type ToolResponseSignature = Pick<CallToolResponse, "structuredContent" | "meta">;
46
59
  export declare const useCallTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends Partial<ToolResponseSignature> = {}>(name: string) => {
47
- callTool: {
48
- (sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
49
- (toolArgs: ToolArgs, sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
50
- };
60
+ callTool: CallToolFn<ToolArgs, CallToolResponse & ToolResponse>;
51
61
  callToolAsync: CallToolAsyncFn<ToolArgs, CallToolResponse & ToolResponse>;
52
62
  status: "idle";
53
63
  isIdle: true;
@@ -57,10 +67,7 @@ export declare const useCallTool: <ToolArgs extends CallToolArgs = null, ToolRes
57
67
  data: undefined;
58
68
  error: undefined;
59
69
  } | {
60
- callTool: {
61
- (sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
62
- (toolArgs: ToolArgs, sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
63
- };
70
+ callTool: CallToolFn<ToolArgs, CallToolResponse & ToolResponse>;
64
71
  callToolAsync: CallToolAsyncFn<ToolArgs, CallToolResponse & ToolResponse>;
65
72
  status: "pending";
66
73
  isIdle: false;
@@ -70,10 +77,7 @@ export declare const useCallTool: <ToolArgs extends CallToolArgs = null, ToolRes
70
77
  data: undefined;
71
78
  error: undefined;
72
79
  } | {
73
- callTool: {
74
- (sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
75
- (toolArgs: ToolArgs, sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
76
- };
80
+ callTool: CallToolFn<ToolArgs, CallToolResponse & ToolResponse>;
77
81
  callToolAsync: CallToolAsyncFn<ToolArgs, CallToolResponse & ToolResponse>;
78
82
  status: "error";
79
83
  isIdle: false;
@@ -83,10 +87,7 @@ export declare const useCallTool: <ToolArgs extends CallToolArgs = null, ToolRes
83
87
  data: undefined;
84
88
  error: unknown;
85
89
  } | {
86
- callTool: {
87
- (sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
88
- (toolArgs: ToolArgs, sideEffects?: SideEffects<ToolArgs, CallToolResponse & ToolResponse>): void;
89
- };
90
+ callTool: CallToolFn<ToolArgs, CallToolResponse & ToolResponse>;
90
91
  callToolAsync: CallToolAsyncFn<ToolArgs, CallToolResponse & ToolResponse>;
91
92
  status: "success";
92
93
  isIdle: false;
@@ -13,13 +13,13 @@ export const useCallTool = (name) => {
13
13
  throw error;
14
14
  }
15
15
  };
16
- const callToolAsync = (async (toolArgs) => {
16
+ const callToolAsync = ((toolArgs) => {
17
17
  if (toolArgs === undefined) {
18
18
  return execute(null);
19
19
  }
20
20
  return execute(toolArgs);
21
21
  });
22
- function callTool(firstArg, sideEffects) {
22
+ const callTool = ((firstArg, sideEffects) => {
23
23
  let toolArgs;
24
24
  if (firstArg &&
25
25
  typeof firstArg === "object" &&
@@ -34,22 +34,14 @@ export const useCallTool = (name) => {
34
34
  }
35
35
  execute(toolArgs)
36
36
  .then((data) => {
37
- if (sideEffects?.onSuccess) {
38
- sideEffects.onSuccess(data, toolArgs);
39
- }
40
- if (sideEffects?.onSettled) {
41
- sideEffects.onSettled(data, undefined, toolArgs);
42
- }
37
+ sideEffects?.onSuccess?.(data, toolArgs);
38
+ sideEffects?.onSettled?.(data, undefined, toolArgs);
43
39
  })
44
40
  .catch((error) => {
45
- if (sideEffects?.onError) {
46
- sideEffects.onError(error, toolArgs);
47
- }
48
- if (sideEffects?.onSettled) {
49
- sideEffects.onSettled(undefined, error, toolArgs);
50
- }
41
+ sideEffects?.onError?.(error, toolArgs);
42
+ sideEffects?.onSettled?.(undefined, error, toolArgs);
51
43
  });
52
- }
44
+ });
53
45
  const callToolState = {
54
46
  status,
55
47
  data,
@@ -1 +1 @@
1
- {"version":3,"file":"use-call-tool.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-call-tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"use-call-tool.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-call-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA0FjC,MAAM,CAAC,MAAM,WAAW,GAAG,CAIzB,IAAY,EACZ,EAAE;IAGF,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAK1D,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,KAAK,EACnB,QAAkB,EACiB,EAAE;QACrC,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAGvC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAEhE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,CAAC,QAAmB,EAAE,EAAE;QAC7C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,IAAgB,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC,CAAwD,CAAC;IAE1D,MAAM,QAAQ,GAAG,CAAC,CAChB,QAAqE,EACrE,WAA6D,EAC7D,EAAE;QACF,IAAI,QAAkB,CAAC;QACvB,IACE,QAAQ;YACR,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,WAAW,IAAI,QAAQ;gBACtB,SAAS,IAAI,QAAQ;gBACrB,WAAW,IAAI,QAAQ,CAAC,EAC1B,CAAC;YACD,QAAQ,GAAG,IAAgB,CAAC,CAAC,uBAAuB;YACpD,WAAW,GAAG,QAAQ,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAa,CAAC;QACpE,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC;aACd,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,WAAW,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACzC,WAAW,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,WAAW,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACxC,WAAW,EAAE,SAAS,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACP,CAAC,CAAmD,CAAC;IAErD,MAAM,aAAa,GAAG;QACpB,MAAM;QACN,IAAI;QACJ,KAAK;QACL,MAAM,EAAE,MAAM,KAAK,MAAM;QACzB,SAAS,EAAE,MAAM,KAAK,SAAS;QAC/B,SAAS,EAAE,MAAM,KAAK,SAAS;QAC/B,OAAO,EAAE,MAAM,KAAK,OAAO;KACe,CAAC;IAE7C,OAAO;QACL,GAAG,aAAa;QAChB,QAAQ;QACR,aAAa;KACd,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};