tempo-sdk 0.0.24 → 0.0.25
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/{chunk-GLTGROU6.js → chunk-NGR2MIC6.js} +164 -3
- package/dist/chunk-NGR2MIC6.js.map +1 -0
- package/dist/index.js +204 -14
- package/dist/index.js.map +1 -1
- package/dist/nextjs/plugin.cjs +7 -1
- package/dist/nextjs/plugin.cjs.map +1 -1
- package/dist/nextjs/plugin.js +1 -1
- package/dist/nextjs-loader.cjs +46 -13
- package/dist/nextjs-loader.cjs.map +1 -1
- package/dist/nextjs.cjs +166 -4
- package/dist/nextjs.cjs.map +1 -1
- package/dist/nextjs.d.cts +13 -1
- package/dist/nextjs.d.ts +13 -1
- package/dist/nextjs.js +3 -1
- package/package.json +1 -1
- package/dist/chunk-GLTGROU6.js.map +0 -1
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
|
|
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.25",
|
|
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,
|
|
136
|
-
const parent = (0,
|
|
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 =
|
|
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
|
});
|
package/dist/nextjs.cjs.map
CHANGED
|
@@ -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.25\",\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-
|
|
8
|
+
} from "./chunk-NGR2MIC6.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 +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":[]}
|