@decocms/blocks 8.10.0 → 8.11.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 (163) hide show
  1. package/dist/v8/cli/index.d.ts +1 -0
  2. package/dist/v8/cli/index.d.ts.map +1 -1
  3. package/dist/v8/cli/index.js +1 -0
  4. package/dist/v8/cli/index.js.map +1 -1
  5. package/dist/v8/cli/run.d.ts +2 -0
  6. package/dist/v8/cli/run.d.ts.map +1 -1
  7. package/dist/v8/cli/run.js +30 -1
  8. package/dist/v8/cli/run.js.map +1 -1
  9. package/dist/v8/cli/skills.d.ts +25 -0
  10. package/dist/v8/cli/skills.d.ts.map +1 -0
  11. package/dist/v8/cli/skills.js +70 -0
  12. package/dist/v8/cli/skills.js.map +1 -0
  13. package/package.json +3 -2
  14. package/skills/deco-apps/SKILL.md +82 -0
  15. package/skills/deco-apps/references/algolia.md +51 -0
  16. package/skills/deco-apps/references/commerce-types.md +132 -0
  17. package/skills/deco-apps/references/instrumented-fetch.md +144 -0
  18. package/skills/deco-apps/references/magento.md +55 -0
  19. package/skills/deco-apps/references/messaging.md +76 -0
  20. package/skills/deco-apps/references/shopify.md +69 -0
  21. package/skills/deco-apps/references/vendored-loaders.md +135 -0
  22. package/skills/deco-apps/references/vtex-cookies-auth.md +146 -0
  23. package/skills/deco-apps/references/vtex.md +150 -0
  24. package/skills/deco-apps/references/wake.md +75 -0
  25. package/skills/deco-cms-schema/SKILL.md +80 -0
  26. package/skills/deco-cms-schema/references/annotations.md +147 -0
  27. package/skills/deco-cms-schema/references/content-hygiene.md +91 -0
  28. package/skills/deco-cms-schema/references/formats-and-widgets.md +112 -0
  29. package/skills/deco-cms-schema/references/shapes-that-break-the-form.md +165 -0
  30. package/skills/deco-cms-schema/references/types-to-fields.md +112 -0
  31. package/skills/deco-go-live/SKILL.md +127 -0
  32. package/skills/deco-go-live/references/content-releases.md +90 -0
  33. package/skills/deco-go-live/references/process.md +106 -0
  34. package/skills/deco-go-live/references/proxy-headers-checkout.md +139 -0
  35. package/skills/deco-go-live/references/qa-checklist-template.md +150 -0
  36. package/skills/deco-go-live/references/qa-inventory.md +120 -0
  37. package/skills/deco-go-live/references/react-spa.md +183 -0
  38. package/skills/deco-go-live/references/seo-analytics.md +114 -0
  39. package/skills/deco-go-live/references/traffic-ramp.md +87 -0
  40. package/skills/deco-go-live/references/worker-runtime.md +93 -0
  41. package/skills/deco-go-live/scripts/preflight.sh +221 -0
  42. package/skills/deco-images-media/SKILL.md +64 -0
  43. package/skills/deco-images-media/references/asset-upload.md +191 -0
  44. package/skills/deco-images-media/references/components-per-binding.md +167 -0
  45. package/skills/deco-images-media/references/providers-and-cdn.md +145 -0
  46. package/skills/deco-images-media/references/quality-and-lcp.md +93 -0
  47. package/skills/deco-images-media/references/troubleshooting.md +147 -0
  48. package/skills/deco-images-media/references/video.md +122 -0
  49. package/skills/deco-make-editable/SKILL.md +94 -0
  50. package/skills/deco-make-editable/references/a11y-and-e2e.md +104 -0
  51. package/skills/deco-make-editable/references/content-shapes.md +198 -0
  52. package/skills/deco-make-editable/references/from-figma.md +110 -0
  53. package/skills/deco-make-editable/references/i18n-fields.md +112 -0
  54. package/skills/deco-make-editable/references/inventory.md +79 -0
  55. package/skills/deco-make-editable/references/pixel-parity.md +175 -0
  56. package/skills/deco-make-editable/references/seeding-content.md +119 -0
  57. package/skills/deco-nextjs-site/SKILL.md +74 -0
  58. package/skills/deco-nextjs-site/references/caching.md +116 -0
  59. package/skills/deco-nextjs-site/references/metadata-seo.md +100 -0
  60. package/skills/deco-nextjs-site/references/proxy-and-drafts.md +177 -0
  61. package/skills/deco-nextjs-site/references/rendering.md +171 -0
  62. package/skills/deco-nextjs-site/references/setup.md +190 -0
  63. package/skills/deco-nextjs-site/references/studio-bridge.md +130 -0
  64. package/skills/deco-site-authoring/SKILL.md +75 -0
  65. package/skills/deco-site-authoring/references/lazy-blocks.md +155 -0
  66. package/skills/deco-site-authoring/references/loaders.md +192 -0
  67. package/skills/deco-site-authoring/references/pages.md +156 -0
  68. package/skills/deco-site-authoring/references/review-before-publish.md +95 -0
  69. package/skills/deco-site-authoring/references/sections.md +158 -0
  70. package/skills/deco-site-authoring/references/seo.md +116 -0
  71. package/skills/deco-site-workflow/SKILL.md +92 -0
  72. package/skills/deco-site-workflow/references/check.md +116 -0
  73. package/skills/deco-site-workflow/references/cli-reference.md +104 -0
  74. package/skills/deco-site-workflow/references/content-layout.md +93 -0
  75. package/skills/deco-site-workflow/references/content-sync.md +146 -0
  76. package/skills/deco-site-workflow/references/delivery.md +51 -0
  77. package/skills/deco-site-workflow/references/deploy.md +87 -0
  78. package/skills/deco-site-workflow/references/schema.md +173 -0
  79. package/skills/deco-site-workflow/references/serve-and-studio.md +138 -0
  80. package/skills/deco-storefront-caching/SKILL.md +67 -0
  81. package/skills/deco-storefront-caching/references/cache-keys.md +129 -0
  82. package/skills/deco-storefront-caching/references/case-study.md +82 -0
  83. package/skills/deco-storefront-caching/references/egress-traps.md +153 -0
  84. package/skills/deco-storefront-caching/references/nextjs.md +60 -0
  85. package/skills/deco-storefront-caching/references/perf-guardrails-e2e.md +123 -0
  86. package/skills/deco-storefront-caching/references/verification.md +136 -0
  87. package/skills/deco-storefront-caching/references/worker-page-cache.md +160 -0
  88. package/skills/deco-storefront-caching/scripts/html-anatomy.mjs +97 -0
  89. package/skills/deco-storefront-performance/SKILL.md +81 -0
  90. package/skills/deco-storefront-performance/references/cls-third-party.md +90 -0
  91. package/skills/deco-storefront-performance/references/hydration.md +116 -0
  92. package/skills/deco-storefront-performance/references/loaders-n-plus-1.md +107 -0
  93. package/skills/deco-storefront-performance/references/navigation-ux.md +130 -0
  94. package/skills/deco-storefront-performance/references/payload-trim.md +163 -0
  95. package/skills/deco-storefront-performance/references/render-location.md +152 -0
  96. package/skills/deco-storefront-performance/references/request-dedupe.md +147 -0
  97. package/skills/deco-storefront-performance/references/trace-reading.md +79 -0
  98. package/skills/deco-storefront-performance/references/worker-memory.md +176 -0
  99. package/skills/deco-tanstack-site/SKILL.md +68 -0
  100. package/skills/deco-tanstack-site/references/document-and-security.md +155 -0
  101. package/skills/deco-tanstack-site/references/router-and-navigation.md +137 -0
  102. package/skills/deco-tanstack-site/references/routes-and-pages.md +183 -0
  103. package/skills/deco-tanstack-site/references/server-functions.md +123 -0
  104. package/skills/deco-tanstack-site/references/setup.md +153 -0
  105. package/skills/deco-tanstack-site/references/worker-entry.md +152 -0
  106. package/skills/deco-v7-to-v8-migration/SKILL.md +122 -0
  107. package/skills/deco-v7-to-v8-migration/references/caching-and-privacy.md +10 -0
  108. package/skills/deco-v7-to-v8-migration/references/content.md +25 -0
  109. package/skills/deco-v7-to-v8-migration/references/editor-forms.md +27 -0
  110. package/skills/deco-v7-to-v8-migration/references/faststore.md +40 -0
  111. package/skills/deco-v7-to-v8-migration/references/framework-code.md +53 -0
  112. package/skills/deco-v7-to-v8-migration/references/hosted-releases.md +16 -0
  113. package/skills/deco-v7-to-v8-migration/references/import-map.md +81 -0
  114. package/skills/deco-v7-to-v8-migration/references/legacy-names.md +33 -0
  115. package/skills/deco-v7-to-v8-migration/references/manual-steps.md +10 -0
  116. package/skills/deco-v7-to-v8-migration/references/native-apps.md +43 -0
  117. package/skills/deco-v7-to-v8-migration/references/nextjs.md +19 -0
  118. package/skills/deco-v7-to-v8-migration/references/parity.md +66 -0
  119. package/skills/deco-v7-to-v8-migration/references/rendering.md +13 -0
  120. package/skills/deco-v7-to-v8-migration/references/running-the-script.md +29 -0
  121. package/skills/deco-v7-to-v8-migration/references/script-steps.md +13 -0
  122. package/skills/deco-v7-to-v8-migration/references/server-functions.md +15 -0
  123. package/skills/deco-v7-to-v8-migration/references/sibling-port.md +11 -0
  124. package/skills/deco-v7-to-v8-migration/references/site-code.md +15 -0
  125. package/skills/deco-v7-to-v8-migration/references/telemetry.md +10 -0
  126. package/skills/deco-v7-to-v8-migration/references/verify.md +20 -0
  127. package/skills/deco-v7-to-v8-migration/scripts/apps.ts +297 -0
  128. package/skills/deco-v7-to-v8-migration/scripts/asyncRendering.ts +73 -0
  129. package/skills/deco-v7-to-v8-migration/scripts/blockMap.ts +584 -0
  130. package/skills/deco-v7-to-v8-migration/scripts/ciSchemaCheck.ts +145 -0
  131. package/skills/deco-v7-to-v8-migration/scripts/compat.ts +357 -0
  132. package/skills/deco-v7-to-v8-migration/scripts/content.ts +121 -0
  133. package/skills/deco-v7-to-v8-migration/scripts/experiments.ts +81 -0
  134. package/skills/deco-v7-to-v8-migration/scripts/framework.ts +61 -0
  135. package/skills/deco-v7-to-v8-migration/scripts/imageCopy.ts +276 -0
  136. package/skills/deco-v7-to-v8-migration/scripts/imageModule.ts +285 -0
  137. package/skills/deco-v7-to-v8-migration/scripts/imports.ts +942 -0
  138. package/skills/deco-v7-to-v8-migration/scripts/invoke.ts +624 -0
  139. package/skills/deco-v7-to-v8-migration/scripts/legacyNames.ts +45 -0
  140. package/skills/deco-v7-to-v8-migration/scripts/main.ts +59 -0
  141. package/skills/deco-v7-to-v8-migration/scripts/matchers.ts +41 -0
  142. package/skills/deco-v7-to-v8-migration/scripts/migrate.ts +176 -0
  143. package/skills/deco-v7-to-v8-migration/scripts/redirects.ts +455 -0
  144. package/skills/deco-v7-to-v8-migration/scripts/report.ts +50 -0
  145. package/skills/deco-v7-to-v8-migration/scripts/scaffold.ts +1119 -0
  146. package/skills/deco-v7-to-v8-migration/scripts/secrets.ts +35 -0
  147. package/skills/deco-v7-to-v8-migration/scripts/sectionLoaders.ts +216 -0
  148. package/skills/deco-v7-to-v8-migration/scripts/siteSettings.ts +261 -0
  149. package/skills/deco-v7-to-v8-migration/scripts/stubs.ts +388 -0
  150. package/skills/deco-v7-to-v8-migration/scripts/tsconfig.json +7 -0
  151. package/skills/deco-v7-to-v8-migration/scripts/vendor.ts +249 -0
  152. package/skills/deco-v7-to-v8-migration/scripts/vtexInvoke.ts +240 -0
  153. package/skills/deco-v7-to-v8-migration/scripts/walk.ts +30 -0
  154. package/skills/deco-variants/SKILL.md +57 -0
  155. package/skills/deco-variants/references/caching-variants.md +63 -0
  156. package/skills/deco-variants/references/custom-matchers.md +83 -0
  157. package/skills/deco-variants/references/draft-preview.md +59 -0
  158. package/skills/deco-variants/references/experiments-and-campaigns.md +104 -0
  159. package/skills/deco-variants/references/multivariate.md +85 -0
  160. package/skills/deco-variants/references/v7-matchers.md +71 -0
  161. package/src/v8/cli/index.ts +1 -0
  162. package/src/v8/cli/run.ts +35 -1
  163. package/src/v8/cli/skills.ts +91 -0
@@ -0,0 +1,285 @@
1
+ /**
2
+ * v7's image URLs on a TanStack Start site, written for it: `src/imageUrl.ts`
3
+ * with the `createImageUrl` that gives the URLs v7's `Image` gave (the
4
+ * release's rules, or the site's own copy of v7's image helper with what the
5
+ * site registers on it), and `createDecoRouter`'s `Wrap` giving it to every
6
+ * `Image`, `Picture` and `Source` through `ImageUrlProvider`.
7
+ */
8
+ import fs from "node:fs";
9
+ import path from "node:path";
10
+ import ts from "typescript";
11
+ import { applyEdits, type Edit, importInsertion, listSources, parse } from "./compat";
12
+ import {
13
+ copyDecoCdnOptions,
14
+ DEFAULT_DOMAIN,
15
+ type ImageCopy,
16
+ type ImageCopyRules,
17
+ } from "./imageCopy";
18
+ import type { Report } from "./report";
19
+
20
+ /** The rules of the `Image` a 7.x release shipped (see `v7ImageUrl` in ./imports.ts); latest 7.x when unknown. */
21
+ export function releaseRules(version: string | undefined): ImageCopyRules {
22
+ const [major, minor, patch] = (version ?? "").split(".").map(Number);
23
+ const at = (m: number, p: number) => major === 7 && (minor > m || (minor === m && patch >= p));
24
+ const base = { vtex: true, shopify: true };
25
+ if (major !== 7 || Number.isNaN(minor)) {
26
+ return {
27
+ ...base,
28
+ domain: DEFAULT_DOMAIN,
29
+ stripAssetHosts: "leading",
30
+ decoims: "cloudflare",
31
+ nuvemshop: true,
32
+ };
33
+ }
34
+ if (!at(71, 0)) {
35
+ return {
36
+ ...base,
37
+ domain: "decoims.com",
38
+ stripAssetHosts: "anywhere",
39
+ decoims: "none",
40
+ nuvemshop: false,
41
+ };
42
+ }
43
+ if (!at(71, 4)) {
44
+ return {
45
+ ...base,
46
+ domain: DEFAULT_DOMAIN,
47
+ stripAssetHosts: "anywhere",
48
+ decoims: "none",
49
+ nuvemshop: false,
50
+ };
51
+ }
52
+ if (!at(71, 5)) {
53
+ return {
54
+ ...base,
55
+ domain: DEFAULT_DOMAIN,
56
+ stripAssetHosts: "leading",
57
+ decoims: "always",
58
+ nuvemshop: false,
59
+ };
60
+ }
61
+ return {
62
+ ...base,
63
+ domain: DEFAULT_DOMAIN,
64
+ stripAssetHosts: "leading",
65
+ decoims: "cloudflare",
66
+ nuvemshop: at(77, 1),
67
+ };
68
+ }
69
+
70
+ export interface ImageModule {
71
+ /** The module's text, or undefined when the script can't write it (`reason`). */
72
+ text?: string;
73
+ reason?: string;
74
+ /** Whether v7 had a Nuvemshop rule no package covers. */
75
+ nuvemshop: boolean;
76
+ }
77
+
78
+ /** `src/imageUrl.ts` for the site: from its readable copy of v7's helper, else its release. */
79
+ export function imageModule(
80
+ version: string | undefined,
81
+ images: { copies: ImageCopy[]; registered: { domain?: string | null; quality?: string | null } },
82
+ ): ImageModule {
83
+ const copy = images.copies.find((c) => c.rules);
84
+ if (images.copies.length > 0 && !copy) {
85
+ return {
86
+ reason: `the site's copy of v7's image helper (${images.copies[0].file}) was edited past what the script reads`,
87
+ nuvemshop: false,
88
+ };
89
+ }
90
+ const { registered } = images;
91
+ if (registered.domain === null || registered.quality === null) {
92
+ return {
93
+ reason:
94
+ "the site passes registerImageCdnDomain or registerImageQuality something other than one string literal",
95
+ nuvemshop: false,
96
+ };
97
+ }
98
+ const rules = copy?.rules ?? releaseRules(version);
99
+ const providers = [
100
+ rules.vtex ? "vtexCatalog()" : "",
101
+ rules.shopify ? "shopifyCdn()" : "",
102
+ `decoCdn({ ${copyDecoCdnOptions(rules, registered)} })`,
103
+ ].filter(Boolean);
104
+ const from = copy
105
+ ? `the site's copy of v7's image helper (${copy.file}), whose rules win over its release's`
106
+ : version
107
+ ? `v7 ${version}'s Image`
108
+ : "the latest 7.x Image";
109
+ const set = [
110
+ registered.domain ? `registerImageCdnDomain("${registered.domain}")` : "",
111
+ registered.quality ? `registerImageQuality("${registered.quality}")` : "",
112
+ ].filter(Boolean);
113
+ const lines = [
114
+ 'import { createImageUrl, decoCdn } from "@decocms/blocks/image";',
115
+ ...(rules.shopify ? ['import { shopifyCdn } from "@decocms/apps-shopify/image";'] : []),
116
+ ...(rules.vtex ? ['import { vtexCatalog } from "@decocms/apps-vtex/image";'] : []),
117
+ "",
118
+ "/**",
119
+ ` * The site's image URLs, byte for byte those of ${from}${set.length > 0 ? `, with the site's ${set.join(" and ")}` : ""}${rules.stripAssetHosts === "anywhere" ? ", except that decoCdn strips only a leading Deco asset host where v7 stripped one anywhere (approved, PO 2026-10-15; the migration report lists the URLs it changes)" : ""}:`,
120
+ ...(rules.vtex || rules.shopify
121
+ ? [
122
+ " * VTEX catalog and Shopify images resized on their platforms' own CDNs (v7 did both on every site),",
123
+ ]
124
+ : []),
125
+ " * every other source through the Deco image CDN. Given to every Image, Picture and Source by the",
126
+ " * ImageUrlProvider in createDecoRouter's Wrap. Generated by the deco-v7-to-v8-migration skill.",
127
+ " */",
128
+ "export const imageUrl = createImageUrl({",
129
+ ` providers: [${providers.join(", ")}],`,
130
+ "});",
131
+ "",
132
+ ];
133
+ return { text: lines.join("\n"), nuvemshop: rules.nuvemshop };
134
+ }
135
+
136
+ const IMAGE_URL_FILES = ["imageUrl.ts", "imageUrl.tsx"];
137
+
138
+ /** Writes `src/imageUrl.ts` (kept when it exists) and wires `ImageUrlProvider` into `createDecoRouter`. */
139
+ export function writeImageUrl(
140
+ root: string,
141
+ report: Report,
142
+ plan: ImageModule,
143
+ /** The note when there's no module to write. */
144
+ fallback: string,
145
+ ): void {
146
+ const existing = IMAGE_URL_FILES.find((f) => fs.existsSync(path.join(root, "src", f)));
147
+ const file = path.join(root, "src", existing ?? "imageUrl.ts");
148
+ if (existing) {
149
+ report.manual.push({
150
+ step: "imports",
151
+ subject: `src/${existing}`,
152
+ message: "already exists, so it was kept: it must export imageUrl, v7's image URLs",
153
+ });
154
+ } else if (plan.text) {
155
+ fs.writeFileSync(file, plan.text);
156
+ report.done.push({
157
+ step: "imports",
158
+ subject: "src/imageUrl.ts",
159
+ message: "imageUrl: v7's image URLs (createImageUrl over the platforms' helpers and decoCdn)",
160
+ });
161
+ } else {
162
+ report.manual.push({ step: "imports", subject: "Image, Picture, Source", message: fallback });
163
+ return;
164
+ }
165
+ if (plan.nuvemshop && !existing) {
166
+ report.manual.push({
167
+ step: "imports",
168
+ subject: "src/imageUrl.ts",
169
+ message:
170
+ "v7 also gave Nuvemshop product images (*.mitiendanube.com) the CDN's fixed sizes, which no @decocms/apps-* package covers: a store with such images lists its own provider before decoCdn (references/framework-code.md)",
171
+ });
172
+ }
173
+ wireImageUrlProvider(root, file, report);
174
+ }
175
+
176
+ /** `<ImageUrlProvider value={imageUrl}>` around every page, through `createDecoRouter`'s `Wrap`. */
177
+ function wireImageUrlProvider(root: string, imageFile: string, report: Report): void {
178
+ const wired: string[] = [];
179
+ const left: string[] = [];
180
+ for (const file of listSources(path.join(root, "src"))) {
181
+ const text = fs.readFileSync(file, "utf8");
182
+ if (!text.includes("createDecoRouter(")) continue;
183
+ const rel = path.relative(root, file).split(path.sep).join("/");
184
+ if (text.includes("ImageUrlProvider")) continue;
185
+ const source = parse(file, text);
186
+ const edits: Edit[] = [];
187
+ let bad = false;
188
+ const visit = (node: ts.Node) => {
189
+ if (
190
+ ts.isCallExpression(node) &&
191
+ ts.isIdentifier(node.expression) &&
192
+ node.expression.text === "createDecoRouter"
193
+ ) {
194
+ const edit = file.endsWith(".tsx") ? wrapEdit(source, node) : undefined;
195
+ if (edit) edits.push(edit);
196
+ else bad = true;
197
+ }
198
+ ts.forEachChild(node, visit);
199
+ };
200
+ visit(source);
201
+ if (bad || edits.length === 0 || /\bimageUrl\b/.test(text)) {
202
+ left.push(rel);
203
+ continue;
204
+ }
205
+ let spec = path.relative(path.dirname(file), imageFile).split(path.sep).join("/");
206
+ spec = spec.replace(/\.tsx?$/, "");
207
+ if (!spec.startsWith(".")) spec = `./${spec}`;
208
+ const at = importInsertion(source);
209
+ const imports = [
210
+ 'import { ImageUrlProvider } from "@decocms/tanstack/react";',
211
+ `import { imageUrl } from "${spec}";`,
212
+ ].join("\n");
213
+ edits.push({ start: at, end: at, text: at === 0 ? `${imports}\n` : `\n${imports}` });
214
+ fs.writeFileSync(file, applyEdits(text, edits));
215
+ wired.push(rel);
216
+ }
217
+ if (wired.length > 0) {
218
+ report.done.push({
219
+ step: "imports",
220
+ subject: wired.join(", "),
221
+ message:
222
+ "createDecoRouter's Wrap gives every Image, Picture and Source the site's imageUrl (ImageUrlProvider from @decocms/tanstack/react)",
223
+ });
224
+ }
225
+ if (wired.length === 0 || left.length > 0) {
226
+ report.manual.push({
227
+ step: "imports",
228
+ subject: left.length > 0 ? left.join(", ") : "ImageUrlProvider",
229
+ message:
230
+ "wrap every page in <ImageUrlProvider value={imageUrl}> (@decocms/tanstack/react, imageUrl from src/imageUrl.ts) through createDecoRouter's Wrap option: without it every source goes through the Deco image CDN, where v7 resized VTEX catalog and Shopify images on their own hosts",
231
+ });
232
+ }
233
+ }
234
+
235
+ const PROVIDER = "<ImageUrlProvider value={imageUrl}>{children}</ImageUrlProvider>";
236
+
237
+ /** The edit that puts `ImageUrlProvider` in one `createDecoRouter({ … })` call's `Wrap`, or undefined. */
238
+ function wrapEdit(source: ts.SourceFile, call: ts.CallExpression): Edit | undefined {
239
+ const [options] = call.arguments;
240
+ if (!options || !ts.isObjectLiteralExpression(options) || call.arguments.length !== 1)
241
+ return undefined;
242
+ const wrap = options.properties.find(
243
+ (p) => p.name && ts.isIdentifier(p.name) && p.name.text === "Wrap",
244
+ );
245
+ if (wrap) {
246
+ // An inline Wrap that renders `{children}` once: wrap that.
247
+ if (!ts.isPropertyAssignment(wrap) || !ts.isArrowFunction(wrap.initializer)) return undefined;
248
+ const slots: ts.JsxExpression[] = [];
249
+ const find = (node: ts.Node) => {
250
+ if (
251
+ ts.isJsxExpression(node) &&
252
+ node.expression &&
253
+ ts.isIdentifier(node.expression) &&
254
+ node.expression.text === "children"
255
+ ) {
256
+ slots.push(node);
257
+ }
258
+ ts.forEachChild(node, find);
259
+ };
260
+ find(wrap.initializer.body);
261
+ if (slots.length !== 1) return undefined;
262
+ return { start: slots[0].getStart(source), end: slots[0].getEnd(), text: PROVIDER };
263
+ }
264
+ const property = `Wrap: ({ children }) => ${PROVIDER}`;
265
+ const last = options.properties.at(-1);
266
+ if (!last) {
267
+ return { start: options.getStart(source), end: options.getEnd(), text: `{ ${property} }` };
268
+ }
269
+ const text = source.getFullText();
270
+ const sameLine =
271
+ source.getLineAndCharacterOfPosition(options.getStart(source)).line ===
272
+ source.getLineAndCharacterOfPosition(last.getEnd()).line;
273
+ const indent = sameLine
274
+ ? ""
275
+ : (/^[ \t]*/.exec(text.slice(text.lastIndexOf("\n", last.getStart(source)) + 1))?.[0] ?? "");
276
+ if (options.properties.hasTrailingComma) {
277
+ const comma = text.indexOf(",", last.getEnd());
278
+ return sameLine
279
+ ? { start: comma + 1, end: comma + 1, text: ` ${property},` }
280
+ : { start: comma + 1, end: comma + 1, text: `\n${indent}${property},` };
281
+ }
282
+ return sameLine
283
+ ? { start: last.getEnd(), end: last.getEnd(), text: `, ${property}` }
284
+ : { start: last.getEnd(), end: last.getEnd(), text: `,\n${indent}${property},` };
285
+ }