tempo-sdk 0.0.24 → 0.0.26

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.
package/dist/nextjs.cjs CHANGED
@@ -23,13 +23,171 @@ __export(nextjs_exports, {
23
23
  _internal: () => _internal,
24
24
  _resetTempoProjectRoot: () => _resetTempoProjectRoot,
25
25
  default: () => nextjs_default,
26
+ tempoHostIdentity: () => tempoHostIdentity,
26
27
  tempoNextjsPlugin: () => tempoNextjsPlugin,
27
28
  tempoProjectRoot: () => tempoProjectRoot
28
29
  });
29
30
  module.exports = __toCommonJS(nextjs_exports);
30
- var import_node_fs = require("fs");
31
+ var import_node_fs2 = require("fs");
31
32
  var import_node_module = require("module");
33
+ var import_node_path2 = require("path");
34
+
35
+ // host-identity.ts
36
+ var import_node_fs = require("fs");
32
37
  var import_node_path = require("path");
38
+
39
+ // package.json
40
+ var package_default = {
41
+ name: "tempo-sdk",
42
+ version: "0.0.26",
43
+ type: "module",
44
+ description: "Tempo SDK \u2014 Vite, Next.js, and Expo plugins for JSX annotation and shared page/storyboard types",
45
+ exports: {
46
+ ".": {
47
+ types: "./dist/index.d.ts",
48
+ import: "./dist/index.js"
49
+ },
50
+ "./canvas": {
51
+ types: "./dist/canvas/index.d.ts",
52
+ import: "./dist/canvas/index.js"
53
+ },
54
+ "./canvas/interact-projection": {
55
+ types: "./dist/canvas/interact-projection.d.ts",
56
+ import: "./dist/canvas/interact-projection.js"
57
+ },
58
+ "./canvas/parser": {
59
+ types: "./dist/canvas/parser.d.ts",
60
+ import: "./dist/canvas/parser.js"
61
+ },
62
+ "./canvas/editor": {
63
+ types: "./dist/canvas/editor.d.ts",
64
+ import: "./dist/canvas/editor.js"
65
+ },
66
+ "./assets": {
67
+ types: "./dist/assets/index.d.ts",
68
+ import: "./dist/assets/index.js"
69
+ },
70
+ "./assets/parser": {
71
+ types: "./dist/assets/parser.d.ts",
72
+ import: "./dist/assets/parser.js"
73
+ },
74
+ "./assets/editor": {
75
+ types: "./dist/assets/editor.d.ts",
76
+ import: "./dist/assets/editor.js"
77
+ },
78
+ "./nextjs": {
79
+ types: "./dist/nextjs.d.ts",
80
+ import: "./dist/nextjs.js",
81
+ require: "./dist/nextjs.cjs"
82
+ },
83
+ "./nextjs/plugin": {
84
+ types: "./dist/nextjs/plugin.d.ts",
85
+ import: "./dist/nextjs/plugin.js"
86
+ },
87
+ "./expo": {
88
+ types: "./dist/expo-babel-plugin.d.ts",
89
+ import: "./dist/expo-babel-plugin.js",
90
+ require: "./dist/expo-babel-plugin.cjs"
91
+ },
92
+ "./expo/plugin": {
93
+ types: "./dist/expo/plugin.d.ts",
94
+ import: "./dist/expo/plugin.js",
95
+ require: "./dist/expo/plugin.cjs"
96
+ }
97
+ },
98
+ files: [
99
+ "dist"
100
+ ],
101
+ scripts: {
102
+ clean: "rm -rf dist",
103
+ build: "pnpm run clean && tsup",
104
+ "build:if-missing": "test -f dist/index.js || pnpm run build",
105
+ prepare: "pnpm run build",
106
+ prepublishOnly: "pnpm build",
107
+ demo: "TEMPO=true pnpm --filter @tempo-modules/vite-annotate-plugin-demo dev",
108
+ "demo:nextjs": "TEMPO=true pnpm --filter @tempo-modules/tempo-sdk-nextjs-demo dev",
109
+ test: "vitest run",
110
+ "test:browser": "vitest run canvas-host-vite-e2e.test.ts canvas-host-packed-sdk-e2e.test.ts error-tracking-e2e.test.ts",
111
+ "test:watch": "vitest",
112
+ "test:nextjs:unit": "vitest run nextjs-loader.test.ts nextjs-wrapper.test.ts nextjs-fixtures.test.ts nextjs-published.test.ts",
113
+ "test:nextjs:integration": "vitest run nextjs-e2e-correctness.test.ts",
114
+ "test:nextjs:production": "vitest run nextjs-production.test.ts",
115
+ "test:nextjs": "vitest run nextjs-loader.test.ts nextjs-wrapper.test.ts nextjs-fixtures.test.ts nextjs-published.test.ts nextjs-e2e-correctness.test.ts nextjs-production.test.ts"
116
+ },
117
+ dependencies: {
118
+ "@rollup/pluginutils": "^5.1.0",
119
+ "oxc-parser": "^0.110.0"
120
+ },
121
+ peerDependencies: {
122
+ "@babel/core": "^7.0.0",
123
+ next: "^13 || ^14 || ^15 || ^16",
124
+ react: "^18 || ^19",
125
+ vite: "^5 || ^6 || ^7 || ^8"
126
+ },
127
+ peerDependenciesMeta: {
128
+ "@babel/core": {
129
+ optional: true
130
+ },
131
+ next: {
132
+ optional: true
133
+ },
134
+ vite: {
135
+ optional: true
136
+ }
137
+ },
138
+ devDependencies: {
139
+ "@babel/core": "^7.29.0",
140
+ "@babel/types": "^7.29.0",
141
+ "@modules/annotation": "workspace:*",
142
+ "@modules/file-parser": "workspace:*",
143
+ "@types/babel__core": "^7.20.5",
144
+ "@types/node": "^25.0.8",
145
+ "@types/react": "catalog:",
146
+ "@types/react-dom": "catalog:",
147
+ "@vitejs/plugin-react": "catalog:",
148
+ playwright: "^1.58.2",
149
+ "react-dom": "catalog:",
150
+ tsup: "^8.5.1",
151
+ typescript: "catalog:",
152
+ vite: "catalog:",
153
+ vitest: "catalog:"
154
+ }
155
+ };
156
+
157
+ // host-identity.ts
158
+ var TEMPO_HOST_IDENTITY_CONTRACT_VERSION = 1;
159
+ var TEMPO_WORKSPACE_NONCE_ENV = "TEMPO_WORKSPACE_NONCE";
160
+ var WORKSPACE_NONCE_RELATIVE_PATH = ".tempo/workspace-nonce";
161
+ var MAX_WORKSPACE_NONCE_LENGTH = 128;
162
+ function normalizeWorkspaceNonce(value) {
163
+ const nonce = value?.trim() ?? "";
164
+ return nonce.length > 0 && nonce.length <= MAX_WORKSPACE_NONCE_LENGTH ? nonce : "";
165
+ }
166
+ function readTempoWorkspaceNonce(root = process.cwd()) {
167
+ const fromEnvironment = normalizeWorkspaceNonce(
168
+ process.env[TEMPO_WORKSPACE_NONCE_ENV]
169
+ );
170
+ if (fromEnvironment) return fromEnvironment;
171
+ try {
172
+ return normalizeWorkspaceNonce(
173
+ (0, import_node_fs.readFileSync)((0, import_node_path.resolve)(root, WORKSPACE_NONCE_RELATIVE_PATH), "utf-8")
174
+ );
175
+ } catch {
176
+ return "";
177
+ }
178
+ }
179
+ function createTempoHostIdentity(framework, options = {}) {
180
+ return {
181
+ tempoHost: true,
182
+ contractVersion: TEMPO_HOST_IDENTITY_CONTRACT_VERSION,
183
+ workspaceNonce: readTempoWorkspaceNonce(options.root),
184
+ sdkVersion: package_default.version,
185
+ pluginActive: options.pluginActive ?? Boolean(process.env.TEMPO),
186
+ framework
187
+ };
188
+ }
189
+
190
+ // nextjs.ts
33
191
  var import_meta = {};
34
192
  var TURBOPACK_RULE_KEY = "*.{tsx,jsx}";
35
193
  var requireFromHere = (0, import_node_module.createRequire)(
@@ -132,19 +290,22 @@ function tempoProjectRoot() {
132
290
  if (cachedTempoProjectRoot !== null) return cachedTempoProjectRoot;
133
291
  let dir = process.cwd();
134
292
  while (true) {
135
- if ((0, import_node_fs.existsSync)((0, import_node_path.resolve)(dir, "package.json"))) break;
136
- const parent = (0, import_node_path.dirname)(dir);
293
+ if ((0, import_node_fs2.existsSync)((0, import_node_path2.resolve)(dir, "package.json"))) break;
294
+ const parent = (0, import_node_path2.dirname)(dir);
137
295
  if (parent === dir) break;
138
296
  dir = parent;
139
297
  }
140
298
  let canonical = dir;
141
299
  try {
142
- canonical = import_node_fs.realpathSync.native(dir);
300
+ canonical = import_node_fs2.realpathSync.native(dir);
143
301
  } catch {
144
302
  }
145
303
  cachedTempoProjectRoot = canonical;
146
304
  return canonical;
147
305
  }
306
+ function tempoHostIdentity() {
307
+ return createTempoHostIdentity("nextjs");
308
+ }
148
309
  function _resetTempoProjectRoot() {
149
310
  cachedTempoProjectRoot = null;
150
311
  }
@@ -199,6 +360,7 @@ var _internal = {
199
360
  0 && (module.exports = {
200
361
  _internal,
201
362
  _resetTempoProjectRoot,
363
+ tempoHostIdentity,
202
364
  tempoNextjsPlugin,
203
365
  tempoProjectRoot
204
366
  });
@@ -1 +1 @@
1
- {"version":3,"sources":["../nextjs.ts"],"sourcesContent":["/**\n * Next.js plugin that registers the tempo-annotate loader for Webpack and\n * Turbopack. Mirrors the user-facing pattern of `@next/mdx`: a higher-order\n * function that takes plugin options, returns a function that takes the user's\n * `next.config`, and returns a new config with the plugin's loader rules\n * merged in.\n *\n * See SPEC_NEXTJS.md (in this directory) for the full design rationale.\n *\n * @example\n * ```js\n * // next.config.js\n * const tempoNextjsPlugin = require(\"tempo-sdk/nextjs\");\n * module.exports = tempoNextjsPlugin()({ reactStrictMode: true });\n * ```\n */\n\nimport { existsSync, realpathSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, resolve } from \"node:path\";\n\nimport type { ElementInfo, PropValue } from \"@modules/annotation\";\n\n// ---------------------------------------------------------------------------\n// Types. We keep these minimal and self-contained rather than depending on\n// Next.js types — the plugin file is loaded by `next.config.js` evaluation,\n// before `next` itself is fully resolved in some environments.\n// ---------------------------------------------------------------------------\n\nexport type ComputeAnnotatedProps = (\n info: ElementInfo,\n filepath: string,\n modifiedtsMs: number,\n) => Record<string, PropValue>;\n\nexport interface TempoNextjsOptions {\n /** Path to a JS/TS module that default-exports a `ComputeAnnotatedProps`\n * function. Resolved relative to the project root (CWD where the user\n * invokes `next dev` / `next build`). Turbopack does not allow function-\n * valued loader options, so this must be a path. */\n computeAnnotatedPropsModule?: string;\n\n /** File patterns to include. Default: `[\"**\\/*.tsx\", \"**\\/*.jsx\"]`. */\n include?: string | RegExp | Array<string | RegExp>;\n\n /** File patterns to exclude. Default: `[\"**\\/node_modules\\/**\"]`. */\n exclude?: string | RegExp | Array<string | RegExp>;\n\n /** Auto-inject `<meta name=\"tempo-project-root\">` into JSX `<head>`.\n * Default: `true`. */\n autoInjectRootMeta?: boolean;\n\n /** Run the loader during production builds too. Default: `false`. */\n productionBuild?: boolean;\n}\n\ninterface TurbopackRule {\n condition?: unknown;\n loaders?: Array<{ loader: string; options?: unknown } | string>;\n}\n\ninterface TurbopackConfig {\n rules?: Record<string, TurbopackRule | TurbopackRule[]>;\n [key: string]: unknown;\n}\n\ninterface NextConfigLike {\n webpack?:\n | ((\n config: unknown,\n context: { dev: boolean; [k: string]: unknown },\n ) => unknown)\n | null;\n turbopack?: TurbopackConfig;\n experimental?: { turbo?: TurbopackConfig; [k: string]: unknown };\n [key: string]: unknown;\n}\n\ntype NextConfigInput = NextConfigLike | undefined;\n\ninterface WebpackHookContext {\n dev: boolean;\n [key: string]: unknown;\n}\n\ninterface WebpackConfigLike {\n module?: { rules?: unknown[] };\n [key: string]: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst TURBOPACK_RULE_KEY = \"*.{tsx,jsx}\";\n\nconst requireFromHere = createRequire(\n typeof import.meta.url === \"string\" && import.meta.url.length > 0\n ? import.meta.url\n : __filename,\n);\n\nfunction resolveLoaderPath(): string {\n // Production: dist/nextjs.{js,cjs} sits next to dist/nextjs-loader.cjs.\n // Development: source nextjs.ts sits at <pkg>/nextjs.ts; the built\n // loader is at <pkg>/dist/nextjs-loader.cjs. Try both so unit tests\n // running directly against the .ts source file still find the loader.\n for (const candidate of [\"./nextjs-loader.cjs\", \"./dist/nextjs-loader.cjs\"]) {\n try {\n return requireFromHere.resolve(candidate);\n } catch {\n // try next candidate\n }\n }\n throw new Error(\n \"tempo-sdk/nextjs: could not resolve nextjs-loader.cjs. \" +\n \"Run `pnpm build` in the tempo-sdk package to produce the dist/ output.\",\n );\n}\n\ninterface NextVersionInfo {\n major: number;\n minor: number;\n}\n\nfunction detectNextVersion(): NextVersionInfo | null {\n try {\n const pkg = requireFromHere(\"next/package.json\") as { version: string };\n const m = /^(\\d+)\\.(\\d+)/.exec(pkg.version);\n if (!m) return null;\n return { major: Number(m[1]), minor: Number(m[2]) };\n } catch {\n return null;\n }\n}\n\n/** Should the wrapper write to `experimental.turbo` instead of `turbopack`? */\nfunction useExperimentalTurbo(version: NextVersionInfo | null): boolean {\n if (!version) return false;\n if (version.major < 15) return true;\n if (version.major === 15 && version.minor < 3) return true;\n return false;\n}\n\n/** Should the wrapper omit Turbopack registration entirely? Some pre-13 versions\n * error on unknown config keys. */\nfunction shouldOmitTurbopack(version: NextVersionInfo | null): boolean {\n if (!version) return false;\n return version.major < 13;\n}\n\nfunction buildTurbopackRule(\n loaderPath: string,\n options: TempoNextjsOptions,\n): TurbopackRule {\n const loaderOptions: Record<string, unknown> = {};\n if (options.computeAnnotatedPropsModule !== undefined) {\n loaderOptions.computeAnnotatedPropsModule =\n options.computeAnnotatedPropsModule;\n }\n if (options.autoInjectRootMeta !== undefined) {\n loaderOptions.autoInjectRootMeta = options.autoInjectRootMeta;\n }\n\n // {all: [{not: \"foreign\"}, \"development\"]} — exclude node_modules / Next\n // internals AND only run during `next dev`. The \"development\" condition is\n // a Turbopack built-in; it matches both `next dev` and `next build` in dev\n // mode but is inert during a production `next build`.\n const condition = options.productionBuild\n ? { not: \"foreign\" }\n : { all: [{ not: \"foreign\" }, \"development\"] };\n\n return {\n condition,\n loaders: [{ loader: loaderPath, options: loaderOptions }],\n };\n}\n\nfunction mergeTurbopackRules(\n existing: TurbopackConfig | undefined,\n newRule: TurbopackRule,\n): TurbopackConfig {\n const existingRule = existing?.rules?.[TURBOPACK_RULE_KEY];\n let mergedRule: TurbopackRule | TurbopackRule[];\n if (!existingRule) {\n mergedRule = newRule;\n } else if (Array.isArray(existingRule)) {\n mergedRule = [...existingRule, newRule];\n } else {\n mergedRule = [existingRule, newRule];\n }\n return {\n ...existing,\n rules: {\n ...existing?.rules,\n [TURBOPACK_RULE_KEY]: mergedRule,\n },\n };\n}\n\nfunction buildWebpackHook(\n loaderPath: string,\n options: TempoNextjsOptions,\n userWebpack: NextConfigLike[\"webpack\"],\n): NonNullable<NextConfigLike[\"webpack\"]> {\n const loaderOptions: Record<string, unknown> = {};\n if (options.computeAnnotatedPropsModule !== undefined) {\n loaderOptions.computeAnnotatedPropsModule =\n options.computeAnnotatedPropsModule;\n }\n if (options.autoInjectRootMeta !== undefined) {\n loaderOptions.autoInjectRootMeta = options.autoInjectRootMeta;\n }\n\n const allowProduction = options.productionBuild === true;\n\n return (configIn, context) => {\n const config = configIn as WebpackConfigLike;\n const ctx = context as WebpackHookContext;\n if (ctx.dev || allowProduction) {\n config.module ??= {};\n config.module.rules ??= [];\n config.module.rules.push({\n test: /\\.(tsx|jsx)$/,\n exclude: /node_modules/,\n enforce: \"pre\",\n use: [{ loader: loaderPath, options: loaderOptions }],\n });\n }\n if (typeof userWebpack === \"function\") {\n return userWebpack(config, context);\n }\n return config;\n };\n}\n\n// ---------------------------------------------------------------------------\n// tempoProjectRoot — sync helper for Pages Router users (Section 6.4)\n// ---------------------------------------------------------------------------\n\nlet cachedTempoProjectRoot: string | null = null;\n\n/**\n * Returns the canonical project root that the Tempo loader uses to compute\n * `data-tempo-filepath` values. Use this in `pages/_document.tsx` to set the\n * content of `<meta name=\"tempo-project-root\">`, ensuring the manual meta tag\n * value matches what the loader produces.\n */\nexport function tempoProjectRoot(): string {\n if (cachedTempoProjectRoot !== null) return cachedTempoProjectRoot;\n\n // Walk upward from CWD looking for the nearest package.json. CWD is what\n // Next.js itself uses as the project root when the user invokes\n // `next dev` / `next build` — the loader's `rootContext` matches.\n let dir = process.cwd();\n // eslint-disable-next-line no-constant-condition\n while (true) {\n if (existsSync(resolve(dir, \"package.json\"))) break;\n const parent = dirname(dir);\n if (parent === dir) break;\n dir = parent;\n }\n let canonical = dir;\n try {\n canonical = realpathSync.native(dir);\n } catch {\n // Keep `dir` as fallback.\n }\n cachedTempoProjectRoot = canonical;\n return canonical;\n}\n\n/** Reset the cached project root. For tests only. */\nexport function _resetTempoProjectRoot(): void {\n cachedTempoProjectRoot = null;\n}\n\n// ---------------------------------------------------------------------------\n// tempoNextjsPlugin — the wrapper\n// ---------------------------------------------------------------------------\n\n/**\n * Higher-order function that wraps a Next.js config to register the\n * tempo-annotate loader with both Webpack and Turbopack. No-op when\n * `process.env.TEMPO` is not set.\n *\n * @example\n * ```js\n * // next.config.js\n * const tempoNextjsPlugin = require(\"tempo-sdk/nextjs\");\n * module.exports = tempoNextjsPlugin()({ reactStrictMode: true });\n * ```\n */\nexport function tempoNextjsPlugin(\n pluginOptions: TempoNextjsOptions = {},\n): (inputConfig?: NextConfigLike) => NextConfigLike {\n return (inputConfigArg?: NextConfigLike): NextConfigLike => {\n const inputConfig: NextConfigLike = inputConfigArg ?? {};\n\n if (!process.env.TEMPO) return inputConfig;\n\n // Routed through `_internal.*` so unit tests can spy on these helpers\n // without rewiring the imports.\n const loaderPath = _internal.resolveLoaderPath();\n const version = _internal.detectNextVersion();\n const omitTurbopack = _internal.shouldOmitTurbopack(version);\n const useExperimental = _internal.useExperimentalTurbo(version);\n\n const newRule = buildTurbopackRule(loaderPath, pluginOptions);\n\n const existingTurbo = useExperimental\n ? inputConfig.experimental?.turbo\n : inputConfig.turbopack;\n const mergedTurbo = mergeTurbopackRules(existingTurbo, newRule);\n\n const webpackHook = buildWebpackHook(\n loaderPath,\n pluginOptions,\n inputConfig.webpack ?? null,\n );\n\n const next: NextConfigLike = {\n ...inputConfig,\n webpack: webpackHook,\n };\n\n // Dev-lock sidestep: Next.js 16 holds an OS file lock at `<distDir>/lock`\n // while `next dev` runs, and a second launch in the same directory aborts\n // with \"Another next dev server is already running\". When an orphaned\n // canvas host from a dead Tempo session holds that lock and cannot be\n // killed, the supervisor relaunches with TEMPO_NEXT_DIST_DIR pointing at a\n // fresh directory — a lock nobody holds, and a build cache the orphan\n // isn't sharing. Only the Tempo-managed canvas host ever sets this env.\n const distDirOverride = process.env.TEMPO_NEXT_DIST_DIR;\n if (distDirOverride) {\n next.distDir = distDirOverride;\n }\n\n if (!omitTurbopack) {\n if (useExperimental) {\n next.experimental = {\n ...inputConfig.experimental,\n turbo: mergedTurbo,\n };\n } else {\n next.turbopack = mergedTurbo;\n }\n }\n\n return next;\n };\n}\n\nexport default tempoNextjsPlugin;\n\n// ---------------------------------------------------------------------------\n// Type re-exports for users writing custom strategies.\n// ---------------------------------------------------------------------------\n\nexport type { ElementInfo, PropValue } from \"@modules/annotation\";\n\n// Internal exports used by tests.\nexport const _internal = {\n buildTurbopackRule,\n mergeTurbopackRules,\n buildWebpackHook,\n detectNextVersion,\n useExperimentalTurbo,\n shouldOmitTurbopack,\n resolveLoaderPath,\n};\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../nextjs.ts","../host-identity.ts","../package.json"],"sourcesContent":["/**\n * Next.js plugin that registers the tempo-annotate loader for Webpack and\n * Turbopack. Mirrors the user-facing pattern of `@next/mdx`: a higher-order\n * function that takes plugin options, returns a function that takes the user's\n * `next.config`, and returns a new config with the plugin's loader rules\n * merged in.\n *\n * See SPEC_NEXTJS.md (in this directory) for the full design rationale.\n *\n * @example\n * ```js\n * // next.config.js\n * const tempoNextjsPlugin = require(\"tempo-sdk/nextjs\");\n * module.exports = tempoNextjsPlugin()({ reactStrictMode: true });\n * ```\n */\n\nimport { existsSync, realpathSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, resolve } from \"node:path\";\n\nimport type { ElementInfo, PropValue } from \"@modules/annotation\";\nimport {\n createTempoHostIdentity,\n type TempoHostIdentity,\n} from \"./host-identity.ts\";\n\n// ---------------------------------------------------------------------------\n// Types. We keep these minimal and self-contained rather than depending on\n// Next.js types — the plugin file is loaded by `next.config.js` evaluation,\n// before `next` itself is fully resolved in some environments.\n// ---------------------------------------------------------------------------\n\nexport type ComputeAnnotatedProps = (\n info: ElementInfo,\n filepath: string,\n modifiedtsMs: number,\n) => Record<string, PropValue>;\n\nexport interface TempoNextjsOptions {\n /** Path to a JS/TS module that default-exports a `ComputeAnnotatedProps`\n * function. Resolved relative to the project root (CWD where the user\n * invokes `next dev` / `next build`). Turbopack does not allow function-\n * valued loader options, so this must be a path. */\n computeAnnotatedPropsModule?: string;\n\n /** File patterns to include. Default: `[\"**\\/*.tsx\", \"**\\/*.jsx\"]`. */\n include?: string | RegExp | Array<string | RegExp>;\n\n /** File patterns to exclude. Default: `[\"**\\/node_modules\\/**\"]`. */\n exclude?: string | RegExp | Array<string | RegExp>;\n\n /** Auto-inject `<meta name=\"tempo-project-root\">` into JSX `<head>`.\n * Default: `true`. */\n autoInjectRootMeta?: boolean;\n\n /** Run the loader during production builds too. Default: `false`. */\n productionBuild?: boolean;\n}\n\ninterface TurbopackRule {\n condition?: unknown;\n loaders?: Array<{ loader: string; options?: unknown } | string>;\n}\n\ninterface TurbopackConfig {\n rules?: Record<string, TurbopackRule | TurbopackRule[]>;\n [key: string]: unknown;\n}\n\ninterface NextConfigLike {\n webpack?:\n | ((\n config: unknown,\n context: { dev: boolean; [k: string]: unknown },\n ) => unknown)\n | null;\n turbopack?: TurbopackConfig;\n experimental?: { turbo?: TurbopackConfig; [k: string]: unknown };\n [key: string]: unknown;\n}\n\ntype NextConfigInput = NextConfigLike | undefined;\n\ninterface WebpackHookContext {\n dev: boolean;\n [key: string]: unknown;\n}\n\ninterface WebpackConfigLike {\n module?: { rules?: unknown[] };\n [key: string]: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst TURBOPACK_RULE_KEY = \"*.{tsx,jsx}\";\n\nconst requireFromHere = createRequire(\n typeof import.meta.url === \"string\" && import.meta.url.length > 0\n ? import.meta.url\n : __filename,\n);\n\nfunction resolveLoaderPath(): string {\n // Production: dist/nextjs.{js,cjs} sits next to dist/nextjs-loader.cjs.\n // Development: source nextjs.ts sits at <pkg>/nextjs.ts; the built\n // loader is at <pkg>/dist/nextjs-loader.cjs. Try both so unit tests\n // running directly against the .ts source file still find the loader.\n for (const candidate of [\"./nextjs-loader.cjs\", \"./dist/nextjs-loader.cjs\"]) {\n try {\n return requireFromHere.resolve(candidate);\n } catch {\n // try next candidate\n }\n }\n throw new Error(\n \"tempo-sdk/nextjs: could not resolve nextjs-loader.cjs. \" +\n \"Run `pnpm build` in the tempo-sdk package to produce the dist/ output.\",\n );\n}\n\ninterface NextVersionInfo {\n major: number;\n minor: number;\n}\n\nfunction detectNextVersion(): NextVersionInfo | null {\n try {\n const pkg = requireFromHere(\"next/package.json\") as { version: string };\n const m = /^(\\d+)\\.(\\d+)/.exec(pkg.version);\n if (!m) return null;\n return { major: Number(m[1]), minor: Number(m[2]) };\n } catch {\n return null;\n }\n}\n\n/** Should the wrapper write to `experimental.turbo` instead of `turbopack`? */\nfunction useExperimentalTurbo(version: NextVersionInfo | null): boolean {\n if (!version) return false;\n if (version.major < 15) return true;\n if (version.major === 15 && version.minor < 3) return true;\n return false;\n}\n\n/** Should the wrapper omit Turbopack registration entirely? Some pre-13 versions\n * error on unknown config keys. */\nfunction shouldOmitTurbopack(version: NextVersionInfo | null): boolean {\n if (!version) return false;\n return version.major < 13;\n}\n\nfunction buildTurbopackRule(\n loaderPath: string,\n options: TempoNextjsOptions,\n): TurbopackRule {\n const loaderOptions: Record<string, unknown> = {};\n if (options.computeAnnotatedPropsModule !== undefined) {\n loaderOptions.computeAnnotatedPropsModule =\n options.computeAnnotatedPropsModule;\n }\n if (options.autoInjectRootMeta !== undefined) {\n loaderOptions.autoInjectRootMeta = options.autoInjectRootMeta;\n }\n\n // {all: [{not: \"foreign\"}, \"development\"]} — exclude node_modules / Next\n // internals AND only run during `next dev`. The \"development\" condition is\n // a Turbopack built-in; it matches both `next dev` and `next build` in dev\n // mode but is inert during a production `next build`.\n const condition = options.productionBuild\n ? { not: \"foreign\" }\n : { all: [{ not: \"foreign\" }, \"development\"] };\n\n return {\n condition,\n loaders: [{ loader: loaderPath, options: loaderOptions }],\n };\n}\n\nfunction mergeTurbopackRules(\n existing: TurbopackConfig | undefined,\n newRule: TurbopackRule,\n): TurbopackConfig {\n const existingRule = existing?.rules?.[TURBOPACK_RULE_KEY];\n let mergedRule: TurbopackRule | TurbopackRule[];\n if (!existingRule) {\n mergedRule = newRule;\n } else if (Array.isArray(existingRule)) {\n mergedRule = [...existingRule, newRule];\n } else {\n mergedRule = [existingRule, newRule];\n }\n return {\n ...existing,\n rules: {\n ...existing?.rules,\n [TURBOPACK_RULE_KEY]: mergedRule,\n },\n };\n}\n\nfunction buildWebpackHook(\n loaderPath: string,\n options: TempoNextjsOptions,\n userWebpack: NextConfigLike[\"webpack\"],\n): NonNullable<NextConfigLike[\"webpack\"]> {\n const loaderOptions: Record<string, unknown> = {};\n if (options.computeAnnotatedPropsModule !== undefined) {\n loaderOptions.computeAnnotatedPropsModule =\n options.computeAnnotatedPropsModule;\n }\n if (options.autoInjectRootMeta !== undefined) {\n loaderOptions.autoInjectRootMeta = options.autoInjectRootMeta;\n }\n\n const allowProduction = options.productionBuild === true;\n\n return (configIn, context) => {\n const config = configIn as WebpackConfigLike;\n const ctx = context as WebpackHookContext;\n if (ctx.dev || allowProduction) {\n config.module ??= {};\n config.module.rules ??= [];\n config.module.rules.push({\n test: /\\.(tsx|jsx)$/,\n exclude: /node_modules/,\n enforce: \"pre\",\n use: [{ loader: loaderPath, options: loaderOptions }],\n });\n }\n if (typeof userWebpack === \"function\") {\n return userWebpack(config, context);\n }\n return config;\n };\n}\n\n// ---------------------------------------------------------------------------\n// tempoProjectRoot — sync helper for Pages Router users (Section 6.4)\n// ---------------------------------------------------------------------------\n\nlet cachedTempoProjectRoot: string | null = null;\n\n/**\n * Returns the canonical project root that the Tempo loader uses to compute\n * `data-tempo-filepath` values. Use this in `pages/_document.tsx` to set the\n * content of `<meta name=\"tempo-project-root\">`, ensuring the manual meta tag\n * value matches what the loader produces.\n */\nexport function tempoProjectRoot(): string {\n if (cachedTempoProjectRoot !== null) return cachedTempoProjectRoot;\n\n // Walk upward from CWD looking for the nearest package.json. CWD is what\n // Next.js itself uses as the project root when the user invokes\n // `next dev` / `next build` — the loader's `rootContext` matches.\n let dir = process.cwd();\n // eslint-disable-next-line no-constant-condition\n while (true) {\n if (existsSync(resolve(dir, \"package.json\"))) break;\n const parent = dirname(dir);\n if (parent === dir) break;\n dir = parent;\n }\n let canonical = dir;\n try {\n canonical = realpathSync.native(dir);\n } catch {\n // Keep `dir` as fallback.\n }\n cachedTempoProjectRoot = canonical;\n return canonical;\n}\n\n/** Request-time identity for a Next route served by a Tempo-enabled host. */\nexport function tempoHostIdentity(): TempoHostIdentity {\n return createTempoHostIdentity(\"nextjs\");\n}\n\n/** Reset the cached project root. For tests only. */\nexport function _resetTempoProjectRoot(): void {\n cachedTempoProjectRoot = null;\n}\n\n// ---------------------------------------------------------------------------\n// tempoNextjsPlugin — the wrapper\n// ---------------------------------------------------------------------------\n\n/**\n * Higher-order function that wraps a Next.js config to register the\n * tempo-annotate loader with both Webpack and Turbopack. No-op when\n * `process.env.TEMPO` is not set.\n *\n * @example\n * ```js\n * // next.config.js\n * const tempoNextjsPlugin = require(\"tempo-sdk/nextjs\");\n * module.exports = tempoNextjsPlugin()({ reactStrictMode: true });\n * ```\n */\nexport function tempoNextjsPlugin(\n pluginOptions: TempoNextjsOptions = {},\n): (inputConfig?: NextConfigLike) => NextConfigLike {\n return (inputConfigArg?: NextConfigLike): NextConfigLike => {\n const inputConfig: NextConfigLike = inputConfigArg ?? {};\n\n if (!process.env.TEMPO) return inputConfig;\n\n // Routed through `_internal.*` so unit tests can spy on these helpers\n // without rewiring the imports.\n const loaderPath = _internal.resolveLoaderPath();\n const version = _internal.detectNextVersion();\n const omitTurbopack = _internal.shouldOmitTurbopack(version);\n const useExperimental = _internal.useExperimentalTurbo(version);\n\n const newRule = buildTurbopackRule(loaderPath, pluginOptions);\n\n const existingTurbo = useExperimental\n ? inputConfig.experimental?.turbo\n : inputConfig.turbopack;\n const mergedTurbo = mergeTurbopackRules(existingTurbo, newRule);\n\n const webpackHook = buildWebpackHook(\n loaderPath,\n pluginOptions,\n inputConfig.webpack ?? null,\n );\n\n const next: NextConfigLike = {\n ...inputConfig,\n webpack: webpackHook,\n };\n\n // Tempo-owned build cache: the supervisor always points managed Next hosts\n // at `.next/tempo`, isolating them from the user's own `next dev` cache.\n // A suffixed sibling is selected only after Next reports a lock conflict\n // for the stable directory. Runs outside Tempo never receive this variable.\n const distDirOverride = process.env.TEMPO_NEXT_DIST_DIR;\n if (distDirOverride) {\n next.distDir = distDirOverride;\n }\n\n if (!omitTurbopack) {\n if (useExperimental) {\n next.experimental = {\n ...inputConfig.experimental,\n turbo: mergedTurbo,\n };\n } else {\n next.turbopack = mergedTurbo;\n }\n }\n\n return next;\n };\n}\n\nexport default tempoNextjsPlugin;\n\n// ---------------------------------------------------------------------------\n// Type re-exports for users writing custom strategies.\n// ---------------------------------------------------------------------------\n\nexport type { ElementInfo, PropValue } from \"@modules/annotation\";\n\n// Internal exports used by tests.\nexport const _internal = {\n buildTurbopackRule,\n mergeTurbopackRules,\n buildWebpackHook,\n detectNextVersion,\n useExperimentalTurbo,\n shouldOmitTurbopack,\n resolveLoaderPath,\n};\n","import { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport sdkPackage from \"./package.json\" with { type: \"json\" };\n\nexport const TEMPO_HOST_IDENTITY_ENDPOINT = \"/__tempo/identity\";\nexport const TEMPO_HOST_IDENTITY_CAPABILITY_HEADER =\n \"x-tempo-host-identity\";\nexport const TEMPO_HOST_IDENTITY_CONTRACT_VERSION = 1;\nexport const TEMPO_WORKSPACE_NONCE_ENV = \"TEMPO_WORKSPACE_NONCE\";\nexport const TEMPO_WORKSPACE_NONCE_META_NAME = \"tempo-workspace-nonce\";\n\nconst WORKSPACE_NONCE_RELATIVE_PATH = \".tempo/workspace-nonce\";\nconst MAX_WORKSPACE_NONCE_LENGTH = 128;\n\nexport type TempoHostFramework = \"vite\" | \"nextjs\";\n\nexport interface TempoHostIdentity {\n tempoHost: true;\n contractVersion: number;\n workspaceNonce: string;\n sdkVersion: string;\n pluginActive: boolean;\n framework: TempoHostFramework;\n}\n\nfunction normalizeWorkspaceNonce(value: string | undefined): string {\n const nonce = value?.trim() ?? \"\";\n return nonce.length > 0 && nonce.length <= MAX_WORKSPACE_NONCE_LENGTH\n ? nonce\n : \"\";\n}\n\nexport function readTempoWorkspaceNonce(root = process.cwd()): string {\n const fromEnvironment = normalizeWorkspaceNonce(\n process.env[TEMPO_WORKSPACE_NONCE_ENV],\n );\n if (fromEnvironment) return fromEnvironment;\n try {\n return normalizeWorkspaceNonce(\n readFileSync(resolve(root, WORKSPACE_NONCE_RELATIVE_PATH), \"utf-8\"),\n );\n } catch {\n return \"\";\n }\n}\n\nexport function createTempoHostIdentity(\n framework: TempoHostFramework,\n options: { root?: string; pluginActive?: boolean } = {},\n): TempoHostIdentity {\n return {\n tempoHost: true,\n contractVersion: TEMPO_HOST_IDENTITY_CONTRACT_VERSION,\n workspaceNonce: readTempoWorkspaceNonce(options.root),\n sdkVersion: sdkPackage.version,\n pluginActive: options.pluginActive ?? Boolean(process.env.TEMPO),\n framework,\n };\n}\n","{\n \"name\": \"tempo-sdk\",\n \"version\": \"0.0.26\",\n \"type\": \"module\",\n \"description\": \"Tempo SDK — Vite, Next.js, and Expo plugins for JSX annotation and shared page/storyboard types\",\n \"exports\": {\n \".\": {\n \"types\": \"./dist/index.d.ts\",\n \"import\": \"./dist/index.js\"\n },\n \"./canvas\": {\n \"types\": \"./dist/canvas/index.d.ts\",\n \"import\": \"./dist/canvas/index.js\"\n },\n \"./canvas/interact-projection\": {\n \"types\": \"./dist/canvas/interact-projection.d.ts\",\n \"import\": \"./dist/canvas/interact-projection.js\"\n },\n \"./canvas/parser\": {\n \"types\": \"./dist/canvas/parser.d.ts\",\n \"import\": \"./dist/canvas/parser.js\"\n },\n \"./canvas/editor\": {\n \"types\": \"./dist/canvas/editor.d.ts\",\n \"import\": \"./dist/canvas/editor.js\"\n },\n \"./assets\": {\n \"types\": \"./dist/assets/index.d.ts\",\n \"import\": \"./dist/assets/index.js\"\n },\n \"./assets/parser\": {\n \"types\": \"./dist/assets/parser.d.ts\",\n \"import\": \"./dist/assets/parser.js\"\n },\n \"./assets/editor\": {\n \"types\": \"./dist/assets/editor.d.ts\",\n \"import\": \"./dist/assets/editor.js\"\n },\n \"./nextjs\": {\n \"types\": \"./dist/nextjs.d.ts\",\n \"import\": \"./dist/nextjs.js\",\n \"require\": \"./dist/nextjs.cjs\"\n },\n \"./nextjs/plugin\": {\n \"types\": \"./dist/nextjs/plugin.d.ts\",\n \"import\": \"./dist/nextjs/plugin.js\"\n },\n \"./expo\": {\n \"types\": \"./dist/expo-babel-plugin.d.ts\",\n \"import\": \"./dist/expo-babel-plugin.js\",\n \"require\": \"./dist/expo-babel-plugin.cjs\"\n },\n \"./expo/plugin\": {\n \"types\": \"./dist/expo/plugin.d.ts\",\n \"import\": \"./dist/expo/plugin.js\",\n \"require\": \"./dist/expo/plugin.cjs\"\n }\n },\n \"files\": [\n \"dist\"\n ],\n \"scripts\": {\n \"clean\": \"rm -rf dist\",\n \"build\": \"pnpm run clean && tsup\",\n \"build:if-missing\": \"test -f dist/index.js || pnpm run build\",\n \"prepare\": \"pnpm run build\",\n \"prepublishOnly\": \"pnpm build\",\n \"demo\": \"TEMPO=true pnpm --filter @tempo-modules/vite-annotate-plugin-demo dev\",\n \"demo:nextjs\": \"TEMPO=true pnpm --filter @tempo-modules/tempo-sdk-nextjs-demo dev\",\n \"test\": \"vitest run\",\n \"test:browser\": \"vitest run canvas-host-vite-e2e.test.ts canvas-host-packed-sdk-e2e.test.ts error-tracking-e2e.test.ts\",\n \"test:watch\": \"vitest\",\n \"test:nextjs:unit\": \"vitest run nextjs-loader.test.ts nextjs-wrapper.test.ts nextjs-fixtures.test.ts nextjs-published.test.ts\",\n \"test:nextjs:integration\": \"vitest run nextjs-e2e-correctness.test.ts\",\n \"test:nextjs:production\": \"vitest run nextjs-production.test.ts\",\n \"test:nextjs\": \"vitest run nextjs-loader.test.ts nextjs-wrapper.test.ts nextjs-fixtures.test.ts nextjs-published.test.ts nextjs-e2e-correctness.test.ts nextjs-production.test.ts\"\n },\n \"dependencies\": {\n \"@rollup/pluginutils\": \"^5.1.0\",\n \"oxc-parser\": \"^0.110.0\"\n },\n \"peerDependencies\": {\n \"@babel/core\": \"^7.0.0\",\n \"next\": \"^13 || ^14 || ^15 || ^16\",\n \"react\": \"^18 || ^19\",\n \"vite\": \"^5 || ^6 || ^7 || ^8\"\n },\n \"peerDependenciesMeta\": {\n \"@babel/core\": {\n \"optional\": true\n },\n \"next\": {\n \"optional\": true\n },\n \"vite\": {\n \"optional\": true\n }\n },\n \"devDependencies\": {\n \"@babel/core\": \"^7.29.0\",\n \"@babel/types\": \"^7.29.0\",\n \"@modules/annotation\": \"workspace:*\",\n \"@modules/file-parser\": \"workspace:*\",\n \"@types/babel__core\": \"^7.20.5\",\n \"@types/node\": \"^25.0.8\",\n \"@types/react\": \"catalog:\",\n \"@types/react-dom\": \"catalog:\",\n \"@vitejs/plugin-react\": \"catalog:\",\n \"playwright\": \"^1.58.2\",\n \"react-dom\": \"catalog:\",\n \"tsup\": \"^8.5.1\",\n \"typescript\": \"catalog:\",\n \"vite\": \"catalog:\",\n \"vitest\": \"catalog:\"\n }\n}\n"],"mappings":"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","names":["import_node_fs","import_node_path"]}
package/dist/nextjs.d.cts CHANGED
@@ -1,6 +1,16 @@
1
1
  import { ElementInfo, PropValue } from '@modules/annotation';
2
2
  export { ElementInfo, PropValue } from '@modules/annotation';
3
3
 
4
+ type TempoHostFramework = "vite" | "nextjs";
5
+ interface TempoHostIdentity {
6
+ tempoHost: true;
7
+ contractVersion: number;
8
+ workspaceNonce: string;
9
+ sdkVersion: string;
10
+ pluginActive: boolean;
11
+ framework: TempoHostFramework;
12
+ }
13
+
4
14
  /**
5
15
  * Next.js plugin that registers the tempo-annotate loader for Webpack and
6
16
  * Turbopack. Mirrors the user-facing pattern of `@next/mdx`: a higher-order
@@ -79,6 +89,8 @@ declare function buildWebpackHook(loaderPath: string, options: TempoNextjsOption
79
89
  * value matches what the loader produces.
80
90
  */
81
91
  declare function tempoProjectRoot(): string;
92
+ /** Request-time identity for a Next route served by a Tempo-enabled host. */
93
+ declare function tempoHostIdentity(): TempoHostIdentity;
82
94
  /** Reset the cached project root. For tests only. */
83
95
  declare function _resetTempoProjectRoot(): void;
84
96
  /**
@@ -105,4 +117,4 @@ declare const _internal: {
105
117
  resolveLoaderPath: typeof resolveLoaderPath;
106
118
  };
107
119
 
108
- export { type ComputeAnnotatedProps, type TempoNextjsOptions, _internal, _resetTempoProjectRoot, tempoNextjsPlugin as default, tempoNextjsPlugin, tempoProjectRoot };
120
+ export { type ComputeAnnotatedProps, type TempoNextjsOptions, _internal, _resetTempoProjectRoot, tempoNextjsPlugin as default, tempoHostIdentity, tempoNextjsPlugin, tempoProjectRoot };
package/dist/nextjs.d.ts CHANGED
@@ -1,6 +1,16 @@
1
1
  import { ElementInfo, PropValue } from '@modules/annotation';
2
2
  export { ElementInfo, PropValue } from '@modules/annotation';
3
3
 
4
+ type TempoHostFramework = "vite" | "nextjs";
5
+ interface TempoHostIdentity {
6
+ tempoHost: true;
7
+ contractVersion: number;
8
+ workspaceNonce: string;
9
+ sdkVersion: string;
10
+ pluginActive: boolean;
11
+ framework: TempoHostFramework;
12
+ }
13
+
4
14
  /**
5
15
  * Next.js plugin that registers the tempo-annotate loader for Webpack and
6
16
  * Turbopack. Mirrors the user-facing pattern of `@next/mdx`: a higher-order
@@ -79,6 +89,8 @@ declare function buildWebpackHook(loaderPath: string, options: TempoNextjsOption
79
89
  * value matches what the loader produces.
80
90
  */
81
91
  declare function tempoProjectRoot(): string;
92
+ /** Request-time identity for a Next route served by a Tempo-enabled host. */
93
+ declare function tempoHostIdentity(): TempoHostIdentity;
82
94
  /** Reset the cached project root. For tests only. */
83
95
  declare function _resetTempoProjectRoot(): void;
84
96
  /**
@@ -105,4 +117,4 @@ declare const _internal: {
105
117
  resolveLoaderPath: typeof resolveLoaderPath;
106
118
  };
107
119
 
108
- export { type ComputeAnnotatedProps, type TempoNextjsOptions, _internal, _resetTempoProjectRoot, tempoNextjsPlugin as default, tempoNextjsPlugin, tempoProjectRoot };
120
+ export { type ComputeAnnotatedProps, type TempoNextjsOptions, _internal, _resetTempoProjectRoot, tempoNextjsPlugin as default, tempoHostIdentity, tempoNextjsPlugin, tempoProjectRoot };
package/dist/nextjs.js CHANGED
@@ -2,13 +2,15 @@ import {
2
2
  _internal,
3
3
  _resetTempoProjectRoot,
4
4
  nextjs_default,
5
+ tempoHostIdentity,
5
6
  tempoNextjsPlugin,
6
7
  tempoProjectRoot
7
- } from "./chunk-GLTGROU6.js";
8
+ } from "./chunk-QQR7PXSZ.js";
8
9
  export {
9
10
  _internal,
10
11
  _resetTempoProjectRoot,
11
12
  nextjs_default as default,
13
+ tempoHostIdentity,
12
14
  tempoNextjsPlugin,
13
15
  tempoProjectRoot
14
16
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tempo-sdk",
3
- "version": "0.0.24",
3
+ "version": "0.0.26",
4
4
  "type": "module",
5
5
  "description": "Tempo SDK — Vite, Next.js, and Expo plugins for JSX annotation and shared page/storyboard types",
6
6
  "exports": {
@@ -94,8 +94,8 @@
94
94
  "typescript": "^5.9.3",
95
95
  "vite": "^7.3.1",
96
96
  "vitest": "^4.0.18",
97
- "@modules/annotation": "0.0.1",
98
- "@modules/file-parser": "0.0.1"
97
+ "@modules/file-parser": "0.0.1",
98
+ "@modules/annotation": "0.0.1"
99
99
  },
100
100
  "scripts": {
101
101
  "clean": "rm -rf dist",
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../nextjs.ts"],"sourcesContent":["/**\n * Next.js plugin that registers the tempo-annotate loader for Webpack and\n * Turbopack. Mirrors the user-facing pattern of `@next/mdx`: a higher-order\n * function that takes plugin options, returns a function that takes the user's\n * `next.config`, and returns a new config with the plugin's loader rules\n * merged in.\n *\n * See SPEC_NEXTJS.md (in this directory) for the full design rationale.\n *\n * @example\n * ```js\n * // next.config.js\n * const tempoNextjsPlugin = require(\"tempo-sdk/nextjs\");\n * module.exports = tempoNextjsPlugin()({ reactStrictMode: true });\n * ```\n */\n\nimport { existsSync, realpathSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, resolve } from \"node:path\";\n\nimport type { ElementInfo, PropValue } from \"@modules/annotation\";\n\n// ---------------------------------------------------------------------------\n// Types. We keep these minimal and self-contained rather than depending on\n// Next.js types — the plugin file is loaded by `next.config.js` evaluation,\n// before `next` itself is fully resolved in some environments.\n// ---------------------------------------------------------------------------\n\nexport type ComputeAnnotatedProps = (\n info: ElementInfo,\n filepath: string,\n modifiedtsMs: number,\n) => Record<string, PropValue>;\n\nexport interface TempoNextjsOptions {\n /** Path to a JS/TS module that default-exports a `ComputeAnnotatedProps`\n * function. Resolved relative to the project root (CWD where the user\n * invokes `next dev` / `next build`). Turbopack does not allow function-\n * valued loader options, so this must be a path. */\n computeAnnotatedPropsModule?: string;\n\n /** File patterns to include. Default: `[\"**\\/*.tsx\", \"**\\/*.jsx\"]`. */\n include?: string | RegExp | Array<string | RegExp>;\n\n /** File patterns to exclude. Default: `[\"**\\/node_modules\\/**\"]`. */\n exclude?: string | RegExp | Array<string | RegExp>;\n\n /** Auto-inject `<meta name=\"tempo-project-root\">` into JSX `<head>`.\n * Default: `true`. */\n autoInjectRootMeta?: boolean;\n\n /** Run the loader during production builds too. Default: `false`. */\n productionBuild?: boolean;\n}\n\ninterface TurbopackRule {\n condition?: unknown;\n loaders?: Array<{ loader: string; options?: unknown } | string>;\n}\n\ninterface TurbopackConfig {\n rules?: Record<string, TurbopackRule | TurbopackRule[]>;\n [key: string]: unknown;\n}\n\ninterface NextConfigLike {\n webpack?:\n | ((\n config: unknown,\n context: { dev: boolean; [k: string]: unknown },\n ) => unknown)\n | null;\n turbopack?: TurbopackConfig;\n experimental?: { turbo?: TurbopackConfig; [k: string]: unknown };\n [key: string]: unknown;\n}\n\ntype NextConfigInput = NextConfigLike | undefined;\n\ninterface WebpackHookContext {\n dev: boolean;\n [key: string]: unknown;\n}\n\ninterface WebpackConfigLike {\n module?: { rules?: unknown[] };\n [key: string]: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst TURBOPACK_RULE_KEY = \"*.{tsx,jsx}\";\n\nconst requireFromHere = createRequire(\n typeof import.meta.url === \"string\" && import.meta.url.length > 0\n ? import.meta.url\n : __filename,\n);\n\nfunction resolveLoaderPath(): string {\n // Production: dist/nextjs.{js,cjs} sits next to dist/nextjs-loader.cjs.\n // Development: source nextjs.ts sits at <pkg>/nextjs.ts; the built\n // loader is at <pkg>/dist/nextjs-loader.cjs. Try both so unit tests\n // running directly against the .ts source file still find the loader.\n for (const candidate of [\"./nextjs-loader.cjs\", \"./dist/nextjs-loader.cjs\"]) {\n try {\n return requireFromHere.resolve(candidate);\n } catch {\n // try next candidate\n }\n }\n throw new Error(\n \"tempo-sdk/nextjs: could not resolve nextjs-loader.cjs. \" +\n \"Run `pnpm build` in the tempo-sdk package to produce the dist/ output.\",\n );\n}\n\ninterface NextVersionInfo {\n major: number;\n minor: number;\n}\n\nfunction detectNextVersion(): NextVersionInfo | null {\n try {\n const pkg = requireFromHere(\"next/package.json\") as { version: string };\n const m = /^(\\d+)\\.(\\d+)/.exec(pkg.version);\n if (!m) return null;\n return { major: Number(m[1]), minor: Number(m[2]) };\n } catch {\n return null;\n }\n}\n\n/** Should the wrapper write to `experimental.turbo` instead of `turbopack`? */\nfunction useExperimentalTurbo(version: NextVersionInfo | null): boolean {\n if (!version) return false;\n if (version.major < 15) return true;\n if (version.major === 15 && version.minor < 3) return true;\n return false;\n}\n\n/** Should the wrapper omit Turbopack registration entirely? Some pre-13 versions\n * error on unknown config keys. */\nfunction shouldOmitTurbopack(version: NextVersionInfo | null): boolean {\n if (!version) return false;\n return version.major < 13;\n}\n\nfunction buildTurbopackRule(\n loaderPath: string,\n options: TempoNextjsOptions,\n): TurbopackRule {\n const loaderOptions: Record<string, unknown> = {};\n if (options.computeAnnotatedPropsModule !== undefined) {\n loaderOptions.computeAnnotatedPropsModule =\n options.computeAnnotatedPropsModule;\n }\n if (options.autoInjectRootMeta !== undefined) {\n loaderOptions.autoInjectRootMeta = options.autoInjectRootMeta;\n }\n\n // {all: [{not: \"foreign\"}, \"development\"]} — exclude node_modules / Next\n // internals AND only run during `next dev`. The \"development\" condition is\n // a Turbopack built-in; it matches both `next dev` and `next build` in dev\n // mode but is inert during a production `next build`.\n const condition = options.productionBuild\n ? { not: \"foreign\" }\n : { all: [{ not: \"foreign\" }, \"development\"] };\n\n return {\n condition,\n loaders: [{ loader: loaderPath, options: loaderOptions }],\n };\n}\n\nfunction mergeTurbopackRules(\n existing: TurbopackConfig | undefined,\n newRule: TurbopackRule,\n): TurbopackConfig {\n const existingRule = existing?.rules?.[TURBOPACK_RULE_KEY];\n let mergedRule: TurbopackRule | TurbopackRule[];\n if (!existingRule) {\n mergedRule = newRule;\n } else if (Array.isArray(existingRule)) {\n mergedRule = [...existingRule, newRule];\n } else {\n mergedRule = [existingRule, newRule];\n }\n return {\n ...existing,\n rules: {\n ...existing?.rules,\n [TURBOPACK_RULE_KEY]: mergedRule,\n },\n };\n}\n\nfunction buildWebpackHook(\n loaderPath: string,\n options: TempoNextjsOptions,\n userWebpack: NextConfigLike[\"webpack\"],\n): NonNullable<NextConfigLike[\"webpack\"]> {\n const loaderOptions: Record<string, unknown> = {};\n if (options.computeAnnotatedPropsModule !== undefined) {\n loaderOptions.computeAnnotatedPropsModule =\n options.computeAnnotatedPropsModule;\n }\n if (options.autoInjectRootMeta !== undefined) {\n loaderOptions.autoInjectRootMeta = options.autoInjectRootMeta;\n }\n\n const allowProduction = options.productionBuild === true;\n\n return (configIn, context) => {\n const config = configIn as WebpackConfigLike;\n const ctx = context as WebpackHookContext;\n if (ctx.dev || allowProduction) {\n config.module ??= {};\n config.module.rules ??= [];\n config.module.rules.push({\n test: /\\.(tsx|jsx)$/,\n exclude: /node_modules/,\n enforce: \"pre\",\n use: [{ loader: loaderPath, options: loaderOptions }],\n });\n }\n if (typeof userWebpack === \"function\") {\n return userWebpack(config, context);\n }\n return config;\n };\n}\n\n// ---------------------------------------------------------------------------\n// tempoProjectRoot — sync helper for Pages Router users (Section 6.4)\n// ---------------------------------------------------------------------------\n\nlet cachedTempoProjectRoot: string | null = null;\n\n/**\n * Returns the canonical project root that the Tempo loader uses to compute\n * `data-tempo-filepath` values. Use this in `pages/_document.tsx` to set the\n * content of `<meta name=\"tempo-project-root\">`, ensuring the manual meta tag\n * value matches what the loader produces.\n */\nexport function tempoProjectRoot(): string {\n if (cachedTempoProjectRoot !== null) return cachedTempoProjectRoot;\n\n // Walk upward from CWD looking for the nearest package.json. CWD is what\n // Next.js itself uses as the project root when the user invokes\n // `next dev` / `next build` — the loader's `rootContext` matches.\n let dir = process.cwd();\n // eslint-disable-next-line no-constant-condition\n while (true) {\n if (existsSync(resolve(dir, \"package.json\"))) break;\n const parent = dirname(dir);\n if (parent === dir) break;\n dir = parent;\n }\n let canonical = dir;\n try {\n canonical = realpathSync.native(dir);\n } catch {\n // Keep `dir` as fallback.\n }\n cachedTempoProjectRoot = canonical;\n return canonical;\n}\n\n/** Reset the cached project root. For tests only. */\nexport function _resetTempoProjectRoot(): void {\n cachedTempoProjectRoot = null;\n}\n\n// ---------------------------------------------------------------------------\n// tempoNextjsPlugin — the wrapper\n// ---------------------------------------------------------------------------\n\n/**\n * Higher-order function that wraps a Next.js config to register the\n * tempo-annotate loader with both Webpack and Turbopack. No-op when\n * `process.env.TEMPO` is not set.\n *\n * @example\n * ```js\n * // next.config.js\n * const tempoNextjsPlugin = require(\"tempo-sdk/nextjs\");\n * module.exports = tempoNextjsPlugin()({ reactStrictMode: true });\n * ```\n */\nexport function tempoNextjsPlugin(\n pluginOptions: TempoNextjsOptions = {},\n): (inputConfig?: NextConfigLike) => NextConfigLike {\n return (inputConfigArg?: NextConfigLike): NextConfigLike => {\n const inputConfig: NextConfigLike = inputConfigArg ?? {};\n\n if (!process.env.TEMPO) return inputConfig;\n\n // Routed through `_internal.*` so unit tests can spy on these helpers\n // without rewiring the imports.\n const loaderPath = _internal.resolveLoaderPath();\n const version = _internal.detectNextVersion();\n const omitTurbopack = _internal.shouldOmitTurbopack(version);\n const useExperimental = _internal.useExperimentalTurbo(version);\n\n const newRule = buildTurbopackRule(loaderPath, pluginOptions);\n\n const existingTurbo = useExperimental\n ? inputConfig.experimental?.turbo\n : inputConfig.turbopack;\n const mergedTurbo = mergeTurbopackRules(existingTurbo, newRule);\n\n const webpackHook = buildWebpackHook(\n loaderPath,\n pluginOptions,\n inputConfig.webpack ?? null,\n );\n\n const next: NextConfigLike = {\n ...inputConfig,\n webpack: webpackHook,\n };\n\n // Dev-lock sidestep: Next.js 16 holds an OS file lock at `<distDir>/lock`\n // while `next dev` runs, and a second launch in the same directory aborts\n // with \"Another next dev server is already running\". When an orphaned\n // canvas host from a dead Tempo session holds that lock and cannot be\n // killed, the supervisor relaunches with TEMPO_NEXT_DIST_DIR pointing at a\n // fresh directory — a lock nobody holds, and a build cache the orphan\n // isn't sharing. Only the Tempo-managed canvas host ever sets this env.\n const distDirOverride = process.env.TEMPO_NEXT_DIST_DIR;\n if (distDirOverride) {\n next.distDir = distDirOverride;\n }\n\n if (!omitTurbopack) {\n if (useExperimental) {\n next.experimental = {\n ...inputConfig.experimental,\n turbo: mergedTurbo,\n };\n } else {\n next.turbopack = mergedTurbo;\n }\n }\n\n return next;\n };\n}\n\nexport default tempoNextjsPlugin;\n\n// ---------------------------------------------------------------------------\n// Type re-exports for users writing custom strategies.\n// ---------------------------------------------------------------------------\n\nexport type { ElementInfo, PropValue } from \"@modules/annotation\";\n\n// Internal exports used by tests.\nexport const _internal = {\n buildTurbopackRule,\n mergeTurbopackRules,\n buildWebpackHook,\n detectNextVersion,\n useExperimentalTurbo,\n shouldOmitTurbopack,\n resolveLoaderPath,\n};\n"],"mappings":"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","names":[]}