@octane-xplat/workshop 0.15.0 → 0.16.1

package/dist/build/vite.js

@@ -0,0 +1,230 @@
+import { discoverStories, normalizeInclude } from "./discover.js";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/build/vite.ts
+/**
+* xplatWorkshop — the workshop dev-server plugin.
+*
+* Emits a virtual catalog module whose metadata comes from static discovery
+* (never module evaluation), a virtual entry that boots the adaptive shell,
+* and a virtual index.html. Story modules stay lazily imported per selection;
+* loaders exist only for stories applicable to the build target, so a
+* platform-specific leaf is never imported into an incompatible bundle.
+*/
+var CATALOG_ID = "\0xplat-workshop-catalog";
+var ENTRY_ID = "\0xplat-workshop-entry";
+var STORY_FILE_RE = /\.stories(?:\.(?:web|mobile|ios|android|macos|windows|linux))?\.(?:[cm]?[jt]s|[jt]sx|[jt]srx)$/;
+var TARGET_RESOLUTION = {
+	web: {
+		conditions: ["web"],
+		extensions: [
+			".web.tsrx",
+			".tsrx",
+			".web.tsx",
+			".tsx",
+			".web.ts",
+			".ts",
+			".mts",
+			".ts",
+			".jsx",
+			".js",
+			".json"
+		]
+	},
+	linux: {
+		conditions: ["linux", "web"],
+		extensions: [
+			".linux.tsrx",
+			".web.tsrx",
+			".tsrx",
+			".linux.tsx",
+			".web.tsx",
+			".tsx",
+			".linux.ts",
+			".web.ts",
+			".ts",
+			".mts",
+			".ts",
+			".jsx",
+			".js",
+			".json"
+		]
+	}
+};
+var fsUrl = (file) => `/@fs/${file.split(sep).join("/")}`;
+function catalogCode(root, config, target) {
+	const storiesConfig = config?.stories ?? {};
+	const { entries, diagnostics } = discoverStories(root, {
+		include: storiesConfig.include,
+		exclude: storiesConfig.exclude,
+		target
+	});
+	const include = JSON.stringify(normalizeInclude(storiesConfig.include));
+	const loaders = entries.filter((entry) => entry.applicable && diagnostics.length === 0).map((entry) => `\t${JSON.stringify(entry.id)}: (stamp) => stamp === undefined
+\t\t? import(${JSON.stringify(fsUrl(entry.file))})
+\t\t: import(/* @vite-ignore */ ${JSON.stringify(fsUrl(entry.file))} + '?t=' + encodeURIComponent(String(stamp))),`).join("\n");
+	return `import { catalogDidUpdate } from '@octane-xplat/workshop/web'
+
+export const catalogMeta = ${JSON.stringify(entries)}
+export const diagnostics = ${JSON.stringify(diagnostics)}
+export const includePatterns = ${include}
+
+const loaders = {
+${loaders}
+}
+
+export const catalog = catalogMeta.map((entry) =>
+	loaders[entry.id] ? { ...entry, load: loaders[entry.id] } : entry,
+)
+
+export function loadStory(id, stamp) {
+	const entry = catalog.find((item) => item.id === id)
+	if (!entry?.load) {
+		return Promise.reject(
+			new Error(
+				entry
+					? 'story "' + id + '" is not supported on this target'
+					: 'story "' + id + '" is not in the catalog',
+			),
+		)
+	}
+	return entry.load(stamp)
+}
+
+catalogDidUpdate(catalog, diagnostics)
+if (import.meta.hot) {
+	import.meta.hot.accept((next) => catalogDidUpdate(next?.catalog ?? catalog, next?.diagnostics ?? diagnostics))
+}
+`;
+}
+function entryCode(config, target, story, packageDir, root) {
+	const providerModules = config?.providerModules ?? [];
+	const imports = providerModules.map((specifier, index) => {
+		const abs = resolve(root, specifier);
+		return `import * as __workshopPreset${index} from ${JSON.stringify(fsUrl(abs))}`;
+	}).join("\n");
+	const providers = providerModules.map((_, index) => `...(__workshopPreset${index}.providers ?? __workshopPreset${index}.default ?? [])`).join(", ");
+	const shellCss = fsUrl(join(packageDir, "web", "shell.css"));
+	return `import { catalog, loadStory, diagnostics } from ${JSON.stringify(CATALOG_ID)}
+import { startWorkshop } from '@octane-xplat/workshop/web'
+import '@octane-xplat/ui/theme/tokens.css'
+import ${JSON.stringify(shellCss)}
+${imports}
+
+startWorkshop({
+	catalog,
+	diagnostics,
+	loadStory,
+	target: ${JSON.stringify(target)},
+	initialStoryId: ${JSON.stringify(story ?? null)},
+	globalProviders: [${providers}],
+	hot: import.meta.hot,
+})
+`;
+}
+var WORKSHOP_HTML = `<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		<title>octane-xplat workshop</title>
+		<style>html,body{margin:0;height:100%}#workshop-root{height:100%}</style>
+	</head>
+	<body>
+		<div id="workshop-root"></div>
+		<script type="module" src="/@id/__x00__xplat-workshop-entry"><\/script>
+	</body>
+</html>
+`;
+/**
+* @param {object} [options]
+* @param {string} options.cwd - consumer project root
+* @param {object} [options.config] - resolved workshop.config.* contents
+* @param {string} [options.target] - launch target (DOM hosts: 'web' | 'linux')
+* @param {string} [options.story] - initial stable story id
+*/
+function xplatWorkshop(options = {}) {
+	const target = options.target ?? "web";
+	const story = options.story ?? null;
+	const resolution = TARGET_RESOLUTION[target] ?? TARGET_RESOLUTION.web;
+	let root = options.cwd ?? process.cwd();
+	let config = options.config ?? {};
+	return [{
+		name: "xplat-workshop-virtual",
+		configResolved(resolved) {
+			root = options.cwd ?? resolved.root;
+		},
+		resolveId(id) {
+			if (id === CATALOG_ID || id === ENTRY_ID) return id;
+			return null;
+		},
+		load(id) {
+			if (id === CATALOG_ID) return catalogCode(root, config, target);
+			if (id === ENTRY_ID) return entryCode(config, target, story, dirname(fileURLToPath(import.meta.url)), root);
+			return null;
+		}
+	}, {
+		name: "xplat-workshop-shell",
+		config() {
+			return {
+				optimizeDeps: {
+					exclude: ["@octane-xplat/workshop"],
+					include: ["@octane-xplat/workshop > storybook/preview-api"]
+				},
+				resolve: { conditions: [...resolution.conditions] }
+			};
+		},
+		configResolved(resolved) {
+			const apply = (scope) => {
+				scope.resolve.extensions = [...resolution.extensions, ...scope.resolve.extensions.filter((ext) => !resolution.extensions.includes(ext))];
+				scope.resolve.conditions = [...resolution.conditions, ...scope.resolve.conditions.filter((cond) => !resolution.conditions.includes(cond))];
+			};
+			apply(resolved);
+			for (const env of Object.values(resolved.environments ?? {})) apply(env);
+		},
+		hotUpdate: {
+			order: "pre",
+			handler(ctx) {
+				if (this.environment.name !== "client" || !STORY_FILE_RE.test(ctx.file)) return;
+				const catalog = this.environment.moduleGraph.getModuleById(CATALOG_ID);
+				if (!catalog) return;
+				this.environment.moduleGraph.invalidateModule(catalog);
+				return [catalog];
+			}
+		},
+		configureServer(s) {
+			s.middlewares.use((req, res, next) => {
+				const url = (req.url ?? "").split("?")[0];
+				if (url === "/" || url === "/index.html") {
+					res.statusCode = 200;
+					res.setHeader("content-type", "text/html; charset=utf-8");
+					res.end(WORKSHOP_HTML);
+					return;
+				}
+				if (url.startsWith("/@workshop-assets/")) return serveAsset(config, root, url, res, next);
+				next();
+			});
+		}
+	}];
+}
+function serveAsset(config, root, url, res, next) {
+	const assets = config?.assets ?? {};
+	const rest = url.slice(18);
+	const name = rest.split("/")[0];
+	const dir = assets[name] ? resolve(root, assets[name]) : null;
+	if (!dir) {
+		next();
+		return;
+	}
+	const file = resolve(dir, rest.slice(name.length + 1));
+	if (!(file === dir || file.startsWith(dir + sep)) || !existsSync(file) || !statSync(file).isFile()) {
+		res.statusCode = 404;
+		res.end("not found");
+		return;
+	}
+	res.statusCode = 200;
+	res.end(readFileSync(file));
+}
+//#endregion
+export { xplatWorkshop };

package/dist/build/windows/preflight.js

@@ -0,0 +1,83 @@
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { execFileSync } from "node:child_process";
+//#region src/build/windows/preflight.ts
+/** Read-only Windows setup evidence. Prerequisites never qualify a host. */
+function commandOutput(command, args) {
+	try {
+		return execFileSync(command, args, {
+			encoding: "utf8",
+			timeout: 5e3,
+			maxBuffer: 65536,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			windowsHide: true
+		}).trim();
+	} catch {
+		return null;
+	}
+}
+function windowsPreflight(root, { platform = process.platform, run = commandOutput } = {}) {
+	const manifest = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+	const require = createRequire(join(root, "package.json"));
+	const installed = (name) => {
+		for (const specifier of [`${name}/package.json`, name]) try {
+			require.resolve(specifier);
+			return true;
+		} catch {}
+		return false;
+	};
+	const runtime = manifest.devDependencies?.["@nativescript/windows"] ?? manifest.dependencies?.["@nativescript/windows"];
+	const requirements = {
+		"Windows host": platform === "win32",
+		"nativescript.config": [
+			"ts",
+			"mts",
+			"js",
+			"mjs"
+		].some((ext) => existsSync(join(root, `nativescript.config.${ext}`))),
+		"App_Resources/Windows/Package.appxmanifest": existsSync(join(root, "App_Resources/Windows/Package.appxmanifest")),
+		"@nativescript/windows exact version": typeof runtime === "string" && /^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/.test(runtime)
+	};
+	for (const name of [
+		"@nativescript/windows",
+		"@nativescript/core",
+		"@nativescript-community/octane",
+		"@nativescript/vite",
+		"nativescript",
+		"vite"
+	]) requirements[name] = installed(name);
+	if (platform === "win32") {
+		const sdk = run("dotnet", ["--version"]);
+		requirements[".NET SDK >= 10"] = typeof sdk === "string" && /^\d+\.\d+\.\d+/.test(sdk) && Number(sdk.split(".")[0]) >= 10;
+		requirements["Developer Mode (development launch)"] = run("powershell", [
+			"-NoProfile",
+			"-NonInteractive",
+			"-Command",
+			"(Get-ItemProperty \"HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\AppModelUnlock\" -Name AllowDevelopmentWithoutDevLicense -ErrorAction SilentlyContinue).AllowDevelopmentWithoutDevLicense"
+		])?.trim() === "1";
+	}
+	return {
+		backend: "experimental nativescript/winui",
+		executionHost: {
+			required: "win32",
+			current: platform,
+			reachable: platform === "win32"
+		},
+		qualification: "unverified",
+		requirements,
+		status: platform !== "win32" ? "remote-host-required" : Object.values(requirements).every(Boolean) ? "unqualified-backend" : "missing-prerequisites",
+		note: "Windows workshop mounting, shell and reload are not implemented or host-qualified. " + (platform !== "win32" ? "Run these commands in a Windows checkout; SDK and Developer Mode checks were not run. " : "") + "Prerequisites do not prove renderer compatibility, input, accessibility or lifecycle support. No web fallback is used."
+	};
+}
+function windowsLaunchBlocker(report) {
+	if (report.status === "remote-host-required") return "Windows workshop requires a real Windows host. Run `xplat workshop doctor` in that host’s checkout. No web fallback is used.";
+	const missing = Object.entries(report.requirements).filter(([, ok]) => !ok).map(([name]) => name);
+	return (missing.length ? `Windows prerequisites missing: ${missing.join(", ")}. ` : "") + "Windows workshop mounting, shell and reload remain unimplemented and unqualified; launch is blocked. Run `xplat workshop doctor` for setup evidence.";
+}
+//#endregion
+export { windowsLaunchBlocker, windowsPreflight };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { WORKSHOP_CONTRACT_VERSION, WORKSHOP_TARGETS, defineStory, defineWorkshopConfig } from "./contract.js";
+export { WORKSHOP_CONTRACT_VERSION, WORKSHOP_TARGETS, defineStory, defineWorkshopConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octane-xplat/workshop",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "Development-only component workshop for Octane Xplat — typed stories, metadata discovery, adaptive shell, lifecycle and warm reload",
   "keywords": [
     "components",
@@ -21,7 +21,7 @@
   },
   "files": [
     "types",
-    "dist/node",
+    "dist",
     "src",
     "MOBILE.md",
     "!src/**/*.test.*",
@@ -31,7 +31,7 @@
   "exports": {
     ".": {
       "types": "./types/generated/index.d.ts",
-      "node": "./dist/node/index.js",
+      "node": "./dist/index.js",
       "default": "./src/index.ts"
     },
     "./web": {
@@ -39,12 +39,12 @@
       "default": "./src/web/index.web.ts"
     },
     "./vite": {
-      "types": "./src/vite.d.ts",
-      "default": "./src/vite.mjs"
+      "types": "./src/build/vite.d.ts",
+      "default": "./dist/build/vite.js"
     },
     "./node": {
-      "types": "./src/node.d.ts",
-      "default": "./src/node.mjs"
+      "types": "./src/build/node.d.ts",
+      "default": "./dist/build/node.js"
     },
     "./package.json": "./package.json",
     "./mobile": {
@@ -52,8 +52,8 @@
       "default": "./src/mobile/index.mobile.ts"
     },
     "./vite-mobile": {
-      "types": "./src/vite-mobile.d.ts",
-      "default": "./src/vite-mobile.mjs"
+      "types": "./src/build/vite-mobile.d.ts",
+      "default": "./dist/build/vite-mobile.js"
     },
     "./macos": {
       "types": "./types/generated/macos/index.macos.d.ts",
@@ -66,9 +66,9 @@
   "dependencies": {
     "@babel/core": "7.29.7",
     "@babel/plugin-transform-unicode-property-regex": "7.29.7",
-    "@octane-xplat/cli": "0.15.0",
-    "@octane-xplat/platform": "0.15.0",
-    "@octane-xplat/ui": "0.15.0",
+    "@octane-xplat/cli": "0.16.1",
+    "@octane-xplat/platform": "0.16.1",
+    "@octane-xplat/ui": "0.16.1",
     "storybook": "10.6.1",
     "tinyglobby": "0.2.17"
   },
@@ -77,10 +77,10 @@
     "@nativescript/core": "9.1.3",
     "@nativescript/macos-node-api": "0.4.4-next.2026-08-09-31292056208",
     "@nativescript/types": "9.1.4",
-    "@octane-xplat/macos-renderer": "0.15.0",
+    "@octane-xplat/macos-renderer": "0.16.1",
     "@octanejs/vite-plugin": "0.1.61",
     "octane": "0.11.0",
-    "tsrx-typegen": "0.3.0",
+    "tsrx-typegen": "0.3.1",
     "typescript": "5.9.3",
     "vite": "8.3.0"
   },
@@ -112,7 +112,7 @@
   },
   "scripts": {
     "typegen": "tsrx-typegen --target workshop",
-    "typecheck": "node ../../scripts/typecheck.mjs",
+    "typecheck": "node ../../scripts/typecheck.ts",
     "test": "vitest run && tsrx-tsc --noEmit -p tsconfig.test.json",
     "test:e2e": "pnpm --filter @xplat/workshop-demo test:e2e",
     "test:packed": "pnpm build && node tests/packed-consumer.web.mjs",

package/src/{discover.mjs → build/discover.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — .mjs→.ts port: annotations pending (transitional)
 /**
  * Node-side story discovery — static, metadata-only.
  *

package/src/{macos/shell.macos.mjs → build/macos/shell.macos.ts}

@@ -1,12 +1,13 @@
+// @ts-nocheck — .mjs→.ts port: annotations pending (transitional)
 import '@nativescript/macos-node-api'
 import * as native from 'octane/universal/native'
 import * as signals from 'octane/signals'
 import * as signalsClient from 'octane/signals/client'
 import * as internal from 'octane/internal/client'
 import * as renderer from '@octane-xplat/macos-renderer'
-import { createMacOSStageHost } from './stage.macos'
-import { MacOSWorkshopController } from './controller'
-import { UNSET, isUnsettable } from '../controls'
+import { createMacOSStageHost } from '../../macos/stage.macos.ts'
+import { MacOSWorkshopController } from '../../macos/controller.ts'
+import { UNSET, isUnsettable } from '../../controls.ts'
 
 // The compiled story bundle requires these exact instances after each edit.
 // Never bundle a second renderer/core runtime into the story revision.

package/src/{macos-node.mjs → build/macos-node.ts}

@@ -29,19 +29,22 @@ export async function workshopMacOSDev({ root, config, story }) {
 	const cache = join(root, 'node_modules/.cache/xplat/workshop-macos')
 	await mkdir(cache, { recursive: true })
 	const directory = await mkdtemp(join(cache, 'session-'))
-	const source = dirname(fileURLToPath(import.meta.url))
-	const catalogPlugin = join(source, 'macos-vite.mjs')
-	const shell = join(source, 'macos/shell.macos.mjs')
+	// Payload sources (fed to the consumer's vite as file paths) ship under
+	// src/ only — resolve through src/ whether this module runs from src/ or
+	// dist/build/.
+	const source = dirname(fileURLToPath(import.meta.url)).replace('/dist/', '/src/')
+	const catalogPlugin = join(source, 'macos-vite.ts')
+	const shell = join(source, 'macos/shell.macos.ts')
 	const bundle = join(directory, 'stories.cjs')
 	const shellBundle = join(directory, 'shell.cjs')
-	const catalogFile = join(directory, 'catalog.gen.mjs')
+	const catalogFile = join(directory, 'catalog.gen.ts')
 	const common = `import { xplatMacOS } from '@octane-xplat/cli/macos/vite'
 import { macOSCatalogPlugin } from ${JSON.stringify(catalogPlugin)}
 const root = ${JSON.stringify(root)}
 `
 
 	await writeFile(
-		join(directory, 'stories.config.mjs'),
+		join(directory, 'stories.config.ts'),
 		common +
 			`
 export default async ({ mode }) => {
@@ -54,7 +57,7 @@ export default async ({ mode }) => {
 	)
 
 	await writeFile(
-		join(directory, 'entry.mjs'),
+		join(directory, 'entry.ts'),
 		`import { startMacOSWorkshop } from ${JSON.stringify(shell)}
 startMacOSWorkshop({ bundleFile: ${JSON.stringify(bundle)}, initialStoryId: ${JSON.stringify(story ?? null)},
  offscreen: process.env.OCTANE_WORKSHOP_OFFSCREEN === '1' })
@@ -62,13 +65,13 @@ startMacOSWorkshop({ bundleFile: ${JSON.stringify(bundle)}, initialStoryId: ${JS
 	)
 
 	await writeFile(
-		join(directory, 'shell.config.mjs'),
+		join(directory, 'shell.config.ts'),
 		common +
 			`
 export default async ({ mode }) => {
- const settings = await xplatMacOS(mode, { root, packaged: true, entry: ${JSON.stringify(join(directory, 'entry.mjs'))} })
+ const settings = await xplatMacOS(mode, { root, packaged: true, entry: ${JSON.stringify(join(directory, 'entry.ts'))} })
  return { ...settings, build: { ...settings.build, outDir: ${JSON.stringify(directory)}, emptyOutDir: false,
-  lib: { entry: ${JSON.stringify(join(directory, 'entry.mjs'))}, formats: ['cjs'], fileName: () => 'shell.cjs' } } }
+  lib: { entry: ${JSON.stringify(join(directory, 'entry.ts'))}, formats: ['cjs'], fileName: () => 'shell.cjs' } } }
 }
 `,
 	)
@@ -82,9 +85,9 @@ export default async ({ mode }) => {
 				renderer: 'appkit',
 				dev: {
 					productName: 'Octane component workshop',
-					viteConfig: relative(root, join(directory, 'stories.config.mjs')),
+					viteConfig: relative(root, join(directory, 'stories.config.ts')),
 					bundleFile: relative(root, bundle),
-					shellViteConfig: relative(root, join(directory, 'shell.config.mjs')),
+					shellViteConfig: relative(root, join(directory, 'shell.config.ts')),
 					shellBundleFile: relative(root, shellBundle),
 				},
 			},

package/src/{macos-vite.mjs → build/macos-vite.ts}

@@ -1,6 +1,7 @@
+// @ts-nocheck — .mjs→.ts port: annotations pending (transitional)
 import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { resolve } from 'node:path'
-import { discoverStories } from './discover.mjs'
+import { discoverStories } from './discover.ts'
 
 /**
  * Regenerates the real catalog module on every (re)build. Static applicability

package/src/{mobile-node.mjs → build/mobile-node.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — .mjs→.ts port: annotations pending (transitional)
 import { createRequire } from 'node:module'
 import { existsSync, readFileSync } from 'node:fs'
 import { dirname, join, resolve } from 'node:path'
@@ -8,7 +9,7 @@ const CONFIGS = [
 	'vite.config.native.ts',
 	'vite.config.mts',
 	'vite.config.ts',
-	'vite.config.mjs',
+	'vite.config.ts',
 ]
 
 export function mobilePrerequisites(root, target, host = process.platform, env = process.env) {

package/src/{mobile-regex.mjs → build/mobile-regex.ts}

@@ -3,7 +3,7 @@ import unicodeProperties from '@babel/plugin-transform-unicode-property-regex'
 
 // Compatibility approach shared with apps/mobile/visual-regex.mjs; no testing-host dependency.
 /** Compile Unicode properties for the pinned iOS runtime without changing globals. */
-export function transformMobileRegex(code, filename = 'workshop-host.mjs') {
+export function transformMobileRegex(code, filename = 'workshop-host.ts') {
 	return transformAsync(code, {
 		filename,
 		configFile: false,

package/src/{node.mjs → build/node.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — .mjs→.ts port: annotations pending (transitional)
 /**
  * Node backend for `xplat workshop …` — the CLI resolves this module from
  * the consumer's installed @octane-xplat/workshop and delegates.
@@ -9,16 +10,16 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { dirname, join, relative, resolve } from 'node:path'
 import { pathToFileURL } from 'node:url'
 import { realpathSync } from 'node:fs'
-import { discoverStories } from './discover.mjs'
-import { windowsPreflight, windowsLaunchBlocker } from './windows/preflight.mjs'
-import { xplatWorkshop } from './vite.mjs'
-import { launchMobile, mobilePrerequisites } from './mobile-node.mjs'
+import { discoverStories } from './discover.ts'
+import { windowsPreflight, windowsLaunchBlocker } from './windows/preflight.ts'
+import { xplatWorkshop } from './vite.ts'
+import { launchMobile, mobilePrerequisites } from './mobile-node.ts'
 import { xplatBoundary, xplatDevBridge, xplatNodeEnvDefine } from '@octane-xplat/cli/vite'
 
 const CONFIG_NAMES = [
 	'workshop.config.ts',
 	'workshop.config.mts',
-	'workshop.config.mjs',
+	'workshop.config.ts',
 	'workshop.config.js',
 ]
 
@@ -409,7 +410,7 @@ export async function workshopDev({ cwd, target = 'web', story, port, device } =
 	const root = consumerRoot(cwd)
 	if (target === 'macos') {
 		const { config } = await loadWorkshopConfig(root)
-		const { workshopMacOSDev } = await import('./macos-node.mjs')
+		const { workshopMacOSDev } = await import('./macos-node.ts')
 		return workshopMacOSDev({ root, config, story })
 	}
 

package/src/{vite-mobile.d.ts → build/vite-mobile.d.ts}

@@ -1,5 +1,5 @@
 import type { UserConfig } from 'vite'
-import type { WorkshopConfig } from '../types/generated/contract.js'
+import type { WorkshopConfig } from '../../types/generated/contract.js'
 /** Preserves the consumer config and prepends the native workshop's pre HMR hook. */
 export declare function withWorkshopMobile(
 	config: UserConfig,

package/src/{vite-mobile.mjs → build/vite-mobile.ts}

@@ -1,7 +1,8 @@
+// @ts-nocheck — .mjs→.ts port: annotations pending (transitional)
 import { readFileSync } from 'node:fs'
 import { resolve } from 'node:path'
-import { mobileRegexPlugin } from './mobile-regex.mjs'
-import { discoverStories } from './discover.mjs'
+import { mobileRegexPlugin } from './mobile-regex.ts'
+import { discoverStories } from './discover.ts'
 
 export const MOBILE_CATALOG_ID = '\0xplat-workshop-mobile-catalog'
 const fsUrl = (file) => `/@fs/${file.replaceAll('\\', '/')}`

package/src/{vite.d.ts → build/vite.d.ts}

@@ -1,5 +1,5 @@
 import type { Plugin } from 'vite'
-import type { WorkshopConfig } from '../types/generated/contract.js'
+import type { WorkshopConfig } from '../../types/generated/contract.js'
 
 export interface XplatWorkshopOptions {
 	cwd?: string

package/src/{vite.mjs → build/vite.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — .mjs→.ts port: annotations pending (transitional)
 /**
  * xplatWorkshop — the workshop dev-server plugin.
  *
@@ -10,7 +11,7 @@
 import { existsSync, readFileSync, statSync } from 'node:fs'
 import { dirname, join, resolve, sep } from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { discoverStories, normalizeInclude } from './discover.mjs'
+import { discoverStories, normalizeInclude } from './discover.ts'
 
 const CATALOG_ID = '\0xplat-workshop-catalog'
 const ENTRY_ID = '\0xplat-workshop-entry'
@@ -23,7 +24,7 @@ const WEB_EXTENSIONS = [
 	'.web.tsx',
 	'.tsx',
 	'.web.ts',
-	'.mjs',
+	'.ts',
 	'.mts',
 	'.ts',
 	'.jsx',
@@ -48,7 +49,7 @@ const TARGET_RESOLUTION = {
 			'.tsx',
 			'.linux.ts',
 			'.web.ts',
-			'.mjs',
+			'.ts',
 			'.mts',
 			'.ts',
 			'.jsx',