create-octane-xplat 0.14.0 → 0.16.0

package/library-template/README.md

@@ -0,0 +1,84 @@
+# octane-xplat-library
+
+A cross-platform component library for Octane Xplat. The starter includes a
+small `Badge` component and a packed-consumer check so you can build a package
+and check the artifact that will be published.
+
+## Start here
+
+Install this package in an Octane Xplat app:
+
+```sh
+pnpm add octane-xplat-library
+```
+
+Render the example component from your app:
+
+```tsx
+import { Badge } from 'octane-xplat-library'
+
+export function Welcome() {
+	return <Badge label="Ready" />
+}
+```
+
+## Develop and check
+
+Run these commands from the package directory:
+
+```sh
+pnpm typecheck
+pnpm lint
+pnpm lint:fix
+pnpm test
+pnpm typegen
+pnpm test:packed
+```
+
+Linting uses the CLI's bundled framework defaults. Apply safe lint fixes with
+`lint:fix`; use `format` to format source and `fmt --check` to check formatting
+without changing files:
+
+```sh
+pnpm format
+pnpm exec xplat fmt --check
+```
+
+The package publishes authored source for the app's bundler to compile.
+`pnpm typegen` generates `.d.ts` files so consumers' type checkers use
+declarations. `pnpm test:packed` packs the package, places that artifact into
+small web and native TypeScript consumers, and checks both export conditions.
+
+The package sets `nodeLinker: hoisted` in `pnpm-workspace.yaml` because the
+NativeScript bundler expects a flat dependency tree.
+
+Its `catalog:xplat` build dependencies and patches follow one framework
+compatibility set. Update that set together; consumer `peerDependencies`
+ranges are preserved for you to maintain:
+
+```sh
+pnpm dlx @octane-xplat/cli@latest upgrade --check
+pnpm dlx @octane-xplat/cli@latest upgrade
+pnpm xplat doctor
+```
+
+## Platform files
+
+`src/Badge.tsx` is the shared iOS and Android implementation. The
+`src/Badge.web.tsx` sibling supplies the web implementation. Keep their props
+and exports aligned in `src/props.ts` and the two `src/index` barrels. Add
+`.ios.tsx`, `.android.tsx`, or `.mobile.tsx` files only when a behavior needs
+to differ on those targets.
+
+The starter supports web, iOS, and Android. It does not include app shells or
+desktop runtime entries. If the package uses a NativeScript plugin, declare it
+as a runtime dependency and add the plugin's required platform files and
+metadata to this package.
+
+## Prepare to publish
+
+Before publishing, replace the generated package name and repository metadata
+in `package.json`, fill in the year and copyright holder in `LICENSE`, and
+confirm that every runtime import is declared. `pnpm test:packed` checks the
+package tarball's web and native type exports; it does not build or launch a
+consuming app on a device.

package/library-template/gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+types/
+coverage/
+.turbo/

package/library-template/package.json

@@ -0,0 +1,92 @@
+{
+	"name": "octane-xplat-library",
+	"version": "0.1.0",
+	"description": "A cross-platform component library for Octane Xplat",
+	"keywords": [
+		"android",
+		"cross-platform",
+		"ios",
+		"octane",
+		"octane-xplat",
+		"ui",
+		"web"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/your-org/your-library",
+		"directory": "."
+	},
+	"files": [
+		"src",
+		"types",
+		"LICENSE"
+	],
+	"type": "module",
+	"exports": {
+		".": {
+			"macos": null,
+			"linux": null,
+			"windows": null,
+			"web": {
+				"types": "./types/index.web.d.ts",
+				"default": "./src/index.web.ts"
+			},
+			"native": {
+				"types": "./types/index.d.ts",
+				"default": "./src/index.ts"
+			},
+			"types": "./types/index.d.ts",
+			"default": "./src/index.ts"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"typegen": "tsrx-typegen --project tsconfig.types.json",
+		"typecheck": "xplat typecheck",
+		"lint": "xplat lint",
+		"lint:fix": "xplat lint --fix",
+		"test": "vitest run",
+		"test:packed": "node tests/packed-consumer.mjs",
+		"prepack": "pnpm typegen && tsrx-typegen --pack-check",
+		"pack:check": "pnpm test:packed",
+		"format": "xplat fmt"
+	},
+	"devDependencies": {
+		"@nativescript-community/octane": "catalog:xplat",
+		"@nativescript/core": "catalog:xplat",
+		"@nativescript/types": "catalog:xplat",
+		"@octane-xplat/cli": "catalog:xplat",
+		"@octane-xplat/jsx": "catalog:xplat",
+		"@octane-xplat/ui": "catalog:xplat",
+		"@octanejs/vite-plugin": "catalog:xplat",
+		"@tsrx/oxc": "catalog:xplat",
+		"@tsrx/typescript-plugin": "catalog:xplat",
+		"octane": "catalog:xplat",
+		"tsrx-typegen": "catalog:xplat",
+		"typescript": "catalog:xplat",
+		"vite": "catalog:xplat",
+		"vitest": "catalog:xplat"
+	},
+	"peerDependencies": {
+		"@nativescript-community/octane": ">=0.2.1 <1",
+		"@nativescript/core": ">=9.1.0 <10",
+		"@octane-xplat/jsx": "^0.16.0",
+		"@octane-xplat/ui": "^0.16.0",
+		"octane": ">=0.6.3 <1"
+	},
+	"peerDependenciesMeta": {
+		"@nativescript-community/octane": {
+			"optional": true
+		},
+		"@nativescript/core": {
+			"optional": true
+		}
+	},
+	"packageManager": "pnpm@11.24.0",
+	"engines": {
+		"node": ">=22.18.0"
+	}
+}

package/library-template/pnpm-workspace.yaml

@@ -0,0 +1,156 @@
+# NativeScript's bundler resolves dependencies from the flat package tree.
+nodeLinker: hoisted
+allowBuilds:
+  esbuild: true
+  '@parcel/watcher': true
+  '@nativescript/core': false
+catalogs:
+  xplat:
+    "@nativescript-community/octane": 0.2.5
+    "@nativescript/core": 9.1.3
+    "@nativescript/types": 9.1.4
+    "@octane-xplat/cli": 0.16.0
+    "@octane-xplat/jsx": 0.16.0
+    "@octane-xplat/ui": 0.16.0
+    "@octanejs/vite-plugin": 0.1.61
+    "@tsrx/oxc": 0.20.0
+    "@tsrx/typescript-plugin": 0.4.11
+    octane: 0.11.0
+    tsrx-typegen: 0.2.2
+    typescript: 5.9.3
+    vite: 8.3.0
+    vitest: 4.1.11
+overrides:
+  "@nativescript/vite>esbuild": 0.27.7
+  "@nativescript-community/vite-octane>esbuild": 0.27.7
+  vite>esbuild: 0.27.7
+configDependencies:
+  "@octane-xplat/patches": 0.16.0
+allowUnusedPatches: true
+# Framework patches are supplied by the @octane-xplat/patches config dependency and
+# applied via pnpm patchedDependencies. Managed upstream by @octane-xplat/cli (`xplat
+# patches apply` refreshes, `xplat patches check` verifies); do not edit by hand.
+patchedDependencies:
+  # Published 0.11.0 still ships none of the retained fixes: it adds the document guard
+  # context around installDefaultSignalOwner and reflows the compile.js hook-classification
+  # sites, but every patched feature remains absent upstream. Retains renderer-owned
+  # Children.toArray/map with explicit universal-native re-exports for older runtimes,
+  # universal signal-read tracking and local hooks, root event-error forwarding, the
+  # complete universal imperative-ref lifecycle, the Descriptor declaring-owner reader
+  # fallback, and the signal-owner/enclosingOwner chain so child reads reuse instance
+  # declarations. Verified against the registry 0.11.0 tarball; all hunks re-anchored to the
+  # rewritten compile.js and document-owner call sites. Disposes DOM provider descendants
+  # when children become null or undefined, releasing their refs and effects.
+  octane@0.11.0: node_modules/.pnpm-config/@octane-xplat/patches/patches/octane@0.11.0.patch
+  # Published 9.1.3 ships the #11446 nested-tab-frame lifecycle fix and iOS explicit-size
+  # flex alignment, so those hunks are removed. Retains the unshipped parent-padding
+  # measure-spec fix and Android explicit-size flex alignment, iOS continuous corner
+  # clipping, CSS @layer cascade support, custom Android variable-font weight mapping, and
+  # percentage translate parsing, native view, and animation support. Verified against the
+  # registry 9.1.3 tarball; it has no Windows implementation, so the separate Windows
+  # preview patch remains.
+  "@nativescript/core@9.1.3": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript__core@9.1.3.patch
+  # @nativescript/vite serializes bundled CSS and dev app.css through reworkcss `css`@3.0.0,
+  # which mis-parses @layer into garbage selectors — rules die before reaching
+  # _populateRules. Adds atlayer() covering block and statement forms. Applies to a
+  # transitive dep — no app declares it directly.
+  css@3.0.0: node_modules/.pnpm-config/@octane-xplat/patches/patches/css@3.0.0.patch
+  # Dev-server fixes still missing after @nativescript/vite 8.0.17 added percent decoding
+  # for path-style /ns/m and Vue /ns/sfc requests (NativeScript#11483): collect re-export
+  # specifiers in the .vite/deps rewrite, route /@fs paths outside both roots through /ns/m
+  # (linked checkouts bypass the device transform upstream), and probe the non-active
+  # platform + `native` suffix tags in module candidates. The deps-bundle esbuild passes
+  # ignore vite resolve.alias, so a dep importing bare `octane` bundles the DOM runtime
+  # beside the universal one (hooks crash on boot, octane-xplat#3) — an onResolve plugin
+  # redirects `octane` → `octane/universal/native`. tsconfig-paths and the generated
+  # build-time checker moduleSuffixes also need the `.mobile` tier for iOS/Android/visionOS
+  # so `.mobile` leaves resolve under mapped imports and `ns build`. Served `/node_modules/`
+  # tails now also scan pnpm's `.pnpm` store and `link:`/`file:`/`portal:` dep roots — a
+  # linked package's transitive deps (e.g. @iconify/utils under @octane-xplat/icons) resolve
+  # nowhere else and 404 the dev session. findMonorepoWorkspaceRoot no longer treats a lone
+  # turbo.json as a workspace root — Turborepo's per-package task configs marked apps/* as
+  # roots, masking the real pnpm root so served `/node_modules/` tails never reached the
+  # `.pnpm` store scan and non-hoisted transitive deps like source-map-js 404'd dev boot.
+  # Linked dependency fallbacks also discover each linked package's enclosing workspace and
+  # reuse the cached, bounded workspace node_modules scan so transitive workspace siblings
+  # (auth to secure-storage to a private native plugin) resolve without the consumer
+  # supplying that workspace root. Transform candidates now keep root-relative URLs only
+  # when they identify the discovered file; nested linked-dependency and pnpm-store matches
+  # inside the app root use their actual filesystem paths, preserving query suffixes. The
+  # /ns/m import rewriter now resolves `#`-prefixed package `imports` specifiers through the
+  # importer's own package.json — raw-read node_modules files (e.g. octane's
+  # dist/signals/graph.js importing `#octane/dist/signal-actions/graph`) otherwise reach the
+  # device verbatim and the HTTP loader throws `Cannot find module`, deadlocking dev boot
+  # before any boot recording can bundle the dep. NativeScript#11551: preserve user virtual
+  # stylesheet imports while retaining browser-helper filtering, route virtual CSS through
+  # the native inline compiler/registration path before the generic virtual-module shortcut,
+  # and relay Vite virtual stylesheet updates as tagged native CSS updates through the same
+  # adapted-text endpoint. Empty sheets clear previous rules; CSS compilation failures
+  # return HTTP 500 instead of raw CSS.
+  "@nativescript/vite@8.0.17": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript__vite@8.0.17.patch
+  # Retains the workspace's NativeScript driver fixes when upgrading to 0.2.5 for portal
+  # support: a prop dropped from an update's complete prop bag — or set to
+  # `undefined`/`null` — is a removal that restores the documented default
+  # (Property/CssProperty setters get `unsetValue`, plain fields the captured pre-prop
+  # value, `style` keys diff per key); a never-applied `undefined` still skips the write.
+  # Also advertises the implemented visibility capability, carries Octane callback ref
+  # types, and preserves authored Grid row/col/span metadata. Hosts custom-layout containers
+  # (e.g. MasonKit ViewBase) that own child lists via
+  # insertChild/removeChild/getChildrenCount without subclassing LayoutBase. Additionally,
+  # the masonry cutover: masonview resolves to MasonKit View and scrollview to MasonKit
+  # Scroll as the only layout containers, with zero layout props — every former prop name
+  # warns-and-drops and all CSS semantics arrive through the style bag; style keys on a
+  # mason child route to its leaf (stashed pre-attach, replayed at attach) via
+  # Style.fromView.
+  "@nativescript-community/octane@0.2.5": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript-community__octane@0.2.5.patch
+  # octaneServerStrategy's SCRIPT_FILE_RE only covers [jt]sx? — .tsrx edits never emit the
+  # deferred ns:hmr-delta broadcast, so component HMR silently never reaches the device.
+  # Also counts open /ns-hmr sockets so the update summary stops reporting recipients=0 for
+  # delivered updates.
+  "@nativescript-community/vite-octane@0.2.1": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript-community__vite-octane@0.2.1.patch
+  # Enables `resolveHiddenExtensions` on the language plugin's typescript facet so
+  # extensionless specifiers (e.g. './Text') probe `.tsrx` after moduleSuffixes — required
+  # for a single extensionless shared barrel to resolve per-platform leaves under tsrx-tsc
+  # and the IDE plugin.
+  "@tsrx/typescript-plugin@0.4.11": node_modules/.pnpm-config/@octane-xplat/patches/patches/@tsrx__typescript-plugin@0.4.11.patch
+  # linkifyjs declares /\p{L}/u and /\p{Emoji}/u as regex literals at module scope;
+  # NativeScript's embedded V8 builds without ICU, so the literals throw SyntaxError at
+  # parse time and poison the whole bundle (any bundled app importing @tiptap/extension-link
+  # dies on boot). Rewrites them as try/catch new RegExp builds with ASCII-range fallbacks —
+  # same behavior where ICU exists, graceful degradation where it doesn't.
+  linkifyjs@4.3.3: node_modules/.pnpm-config/@octane-xplat/patches/patches/linkifyjs@4.3.3.patch
+  # useEditor.ts reads bare process.env.NODE_ENV — no node global exists in the harness
+  # typecheck program. Adds a module-local process declaration for typecheck. (The
+  # './Context' self-import half of the 0.0.51 patch shipped upstream in 0.0.52 via
+  # octanejs/octane#1502.)
+  "@octanejs/tiptap@0.0.52": node_modules/.pnpm-config/@octane-xplat/patches/patches/@octanejs__tiptap@0.0.52.patch
+  # @lexical/link declares a /\p{L}\p{N}/u URL matcher as a regex literal at module scope;
+  # NativeScript's embedded V8 builds without ICU, so the literal throws SyntaxError at
+  # parse time and poisons the whole bundle (any bundled app importing @lexical/link dies on
+  # boot). Same fix as linkifyjs: try/catch new RegExp with an ASCII-range fallback — the
+  # matcher only feeds autolink, which native doesn't use.
+  "@lexical/link@0.51.0": node_modules/.pnpm-config/@octane-xplat/patches/patches/@lexical__link@0.51.0.patch
+  # ui-image 5.x regressed two iOS prefetch behaviors the 4.x line shipped (still present in
+  # 4.6.20): prefetchToCacheType ignores its cacheType argument — SDWebImagePrefetcher's
+  # default context stores to disk+memory either way, so a 'disk' prefetch also decodes and
+  # warms memory, diverging from Android's bytes-only Glide downloadOnly — and
+  # getContextFromOptions drops PrefetchOptions.headers because it never sets
+  # SDWebImageContextDownloadRequestModifier, so prefetch({headers}) silently sends no
+  # headers on iOS while Android's CustomGlideUrl forwards them. Ports upstream's own 4.x
+  # implementation — SDWebImageContextStoreCacheType on the prefetch context plus the
+  # request-modifier branch in getContextFromOptions — and additionally sets
+  # SDWebImageContextOriginalStoreCacheType so a memory prefetch does not spill original
+  # bytes to disk.
+  "@nativescript-community/ui-image@5.0.17": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript-community__ui-image@5.0.17.patch
+  # @nativescript/doctor's Android runtime check reads the app's raw devDependencies
+  # specifier and npm dist-tag resolves anything that isn't a semver range — a pnpm
+  # `catalog:` pin throws 'The determined Android runtime version ... is not valid' and
+  # kills `ns build android` before toolchain checks. Resolve catalog specifiers through the
+  # installed package's manifest, reusing the existing tgz-branch mechanism.
+  "@nativescript/doctor@2.0.18": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript__doctor@2.0.18.patch
+  # list/index.ios.js assigns `ObjCProtocols = [MasonListDelegate]` at module scope.
+  # MasonListDelegate is declared in Mason-Swift.h, which the app's metadata generation does
+  # not surface as a runtime global — importing masonkit on iOS throws `MasonListDelegate is
+  # not defined` during bundle eval and kills the app at boot. Guard the binding; actual
+  # List delegate conformance when the protocol is absent is a separate gap.
+  "@triniwiz/nativescript-masonkit@1.0.0-beta.110": node_modules/.pnpm-config/@octane-xplat/patches/patches/@triniwiz__nativescript-masonkit@1.0.0-beta.110.patch

package/library-template/src/Badge.tsx

@@ -0,0 +1,21 @@
+/** @jsxImportSource @octane-xplat/jsx */
+import { Text, View } from '@octane-xplat/ui'
+import { normalizeBadgeLabel } from './normalizeBadgeLabel'
+import type { BadgeProps } from './props'
+
+/**
+ * Render a short label using Octane's NativeScript elements.
+ * @example
+ * ```tsx
+ * import { Badge } from 'octane-xplat-library'
+ *
+ * <Badge label="Ready" />
+ * ```
+ */
+export function Badge(props: BadgeProps) {
+	return (
+		<View className={props.className}>
+			<Text>{normalizeBadgeLabel(props.label)}</Text>
+		</View>
+	)
+}

package/library-template/src/Badge.web.tsx

@@ -0,0 +1,21 @@
+/** @jsxImportSource @octane-xplat/jsx/dom */
+import { Text, View } from '@octane-xplat/ui'
+import { normalizeBadgeLabel } from './normalizeBadgeLabel'
+import type { BadgeProps } from './props'
+
+/**
+ * Render a short label using Octane's web elements.
+ * @example
+ * ```tsx
+ * import { Badge } from 'octane-xplat-library'
+ *
+ * <Badge label="Ready" />
+ * ```
+ */
+export function Badge(props: BadgeProps) {
+	return (
+		<View className={props.className}>
+			<Text>{normalizeBadgeLabel(props.label)}</Text>
+		</View>
+	)
+}

package/library-template/src/index.ts

@@ -0,0 +1,3 @@
+export { Badge } from './Badge'
+export { normalizeBadgeLabel } from './normalizeBadgeLabel'
+export type { BadgeProps } from './props'

package/library-template/src/index.web.ts

@@ -0,0 +1,3 @@
+export { Badge } from './Badge'
+export { normalizeBadgeLabel } from './normalizeBadgeLabel'
+export type { BadgeProps } from './props'

package/library-template/src/normalizeBadgeLabel.ts

@@ -0,0 +1,12 @@
+/**
+ * Trim surrounding whitespace from a badge label.
+ * @example
+ * ```ts
+ * import { normalizeBadgeLabel } from 'octane-xplat-library'
+ *
+ * normalizeBadgeLabel('  Ready  ')
+ * ```
+ */
+export function normalizeBadgeLabel(label: string): string {
+	return label.trim()
+}

package/library-template/src/props.ts

@@ -0,0 +1,14 @@
+/** Props for the starter badge component. */
+export interface BadgeProps {
+	/** Text displayed inside the badge.
+	 * @example
+	 * ```tsx
+	 * import { Badge } from 'octane-xplat-library'
+	 *
+	 * <Badge label="Ready" />
+	 * ```
+	 */
+	label: string
+	/** Optional class name forwarded to the outer view. */
+	className?: string
+}

package/library-template/tests/normalizeBadgeLabel.test.ts

@@ -0,0 +1,6 @@
+import { expect, it } from 'vitest'
+import { normalizeBadgeLabel } from '../src/normalizeBadgeLabel'
+
+it('trims surrounding whitespace from a badge label', () => {
+	expect(normalizeBadgeLabel('  Ready  ')).toBe('Ready')
+})

package/library-template/tests/packed-consumer.mjs

@@ -0,0 +1,156 @@
+import assert from 'node:assert/strict'
+import { spawnSync } from 'node:child_process'
+import {
+	cpSync,
+	mkdirSync,
+	mkdtempSync,
+	readdirSync,
+	readFileSync,
+	rmSync,
+	symlinkSync,
+	writeFileSync,
+} from 'node:fs'
+
+import { tmpdir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const sourceManifest = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))
+const temporary = mkdtempSync(join(tmpdir(), 'octane-library-consumer-'))
+
+function run(command, args, cwd) {
+	const result = spawnSync(command, args, { cwd, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 })
+	if (result.stdout) {
+		process.stdout.write(result.stdout)
+	}
+
+	if (result.stderr) {
+		process.stderr.write(result.stderr)
+	}
+
+	if (result.error) {
+		throw result.error
+	}
+
+	assert.equal(result.status, 0, `${command} ${args.join(' ')} failed`)
+}
+
+function installDirectory(root, name, destination) {
+	const segments = name.split('/')
+	const path = join(destination, 'node_modules', ...segments)
+	mkdirSync(dirname(path), { recursive: true })
+	cpSync(root, path, { recursive: true })
+}
+
+try {
+	const pack = join(temporary, 'pack')
+	const extracted = join(temporary, 'extracted')
+	mkdirSync(pack)
+	mkdirSync(extracted)
+	run('pnpm', ['pack', '--pack-destination', pack], packageRoot)
+	const tarball = readdirSync(pack).find((name) => name.endsWith('.tgz'))
+	assert.ok(tarball)
+	run('tar', ['-xzf', join(pack, tarball), '-C', extracted], temporary)
+	const packed = join(extracted, 'package')
+	const manifest = JSON.parse(readFileSync(join(packed, 'package.json'), 'utf8'))
+	assert.ok(manifest.exports['.'].web.default.startsWith('./src/'))
+	assert.ok(manifest.exports['.'].native.default.startsWith('./src/'))
+	assert.ok(manifest.exports['.'].web.types)
+	assert.ok(manifest.exports['.'].native.types)
+
+	for (const target of ['web', 'native']) {
+		for (const mode of ['bundler', 'nodenext']) {
+			const consumer = join(temporary, `${target}-${mode}`)
+			mkdirSync(consumer)
+			mkdirSync(join(consumer, 'node_modules'), { recursive: true })
+			installDirectory(packed, sourceManifest.name, consumer)
+			for (const dependency of [
+				'octane',
+				'@octane-xplat/jsx',
+				'@octane-xplat/ui',
+				...(target === 'native'
+					? ['@nativescript-community/octane', '@nativescript/core', '@nativescript/types']
+					: []),
+			]) {
+				const source = join(packageRoot, 'node_modules', ...dependency.split('/'))
+				const destination = join(consumer, 'node_modules', ...dependency.split('/'))
+				mkdirSync(dirname(destination), { recursive: true })
+				symlinkSync(source, destination, 'dir')
+			}
+
+			writeFileSync(join(consumer, 'package.json'), '{"type":"module"}')
+			writeFileSync(
+				join(consumer, 'consumer.tsx'),
+				`import { Badge, type BadgeProps } from '${sourceManifest.name}'
+const props: BadgeProps = { label: 'Ready' }
+const element = <Badge {...props} />
+// @ts-expect-error label is required
+const missing = <Badge />
+// @ts-expect-error label must be a string
+const invalid = <Badge label={1} />
+void element; void missing; void invalid
+`,
+			)
+
+			writeFileSync(
+				join(consumer, 'tsconfig.json'),
+				JSON.stringify(
+					{
+						compilerOptions: {
+							strict: true,
+							noEmit: true,
+							skipLibCheck: true,
+							target: 'esnext',
+							types: [],
+							module: mode === 'bundler' ? 'esnext' : 'nodenext',
+							moduleResolution: mode,
+							jsx: 'react-jsx',
+							jsxImportSource: target === 'native' ? '@octane-xplat/jsx' : '@octane-xplat/jsx/dom',
+							customConditions: [target],
+							moduleSuffixes: target === 'web' ? ['.web', ''] : ['.mobile', ''],
+						},
+						files: ['consumer.tsx'],
+					},
+					null,
+					'\t',
+				),
+			)
+
+			run(
+				process.execPath,
+				[join(packageRoot, 'node_modules/typescript/bin/tsc'), '-p', 'tsconfig.json'],
+				consumer,
+			)
+
+			const listed = spawnSync(
+				process.execPath,
+				[
+					join(packageRoot, 'node_modules/typescript/bin/tsc'),
+					'-p',
+					'tsconfig.json',
+					'--listFilesOnly',
+				],
+				{ cwd: consumer, encoding: 'utf8' },
+			)
+
+			assert.equal(listed.status, 0, listed.stderr)
+			const implementation = listed.stdout
+				.split('\n')
+				.filter(
+					(file) =>
+						file.includes(`/node_modules/${sourceManifest.name}/src/`) && !file.endsWith('.d.ts'),
+				)
+
+			assert.deepEqual(
+				implementation,
+				[],
+				'consumer types use declarations without package implementation',
+			)
+		}
+	}
+
+	console.log('packed consumer: web/native declarations pass Bundler and NodeNext')
+} finally {
+	rmSync(temporary, { recursive: true, force: true })
+}

package/library-template/tsconfig.envs.json

@@ -0,0 +1,17 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"jsxImportSource": "@octane-xplat/jsx"
+	},
+	"environments": {
+		"web": {
+			"include": ["src/**/*.{ts,tsx,tsrx}"]
+		},
+		"native": {
+			"include": ["src/**/*.{ts,tsx,tsrx}"],
+			"compilerOptions": {
+				"types": ["@nativescript/types"]
+			}
+		}
+	}
+}

package/library-template/tsconfig.json

@@ -0,0 +1,27 @@
+{
+	"compilerOptions": {
+		"strict": true,
+		"target": "es2022",
+		"module": "esnext",
+		"moduleResolution": "bundler",
+		"jsx": "react-jsx",
+		"jsxImportSource": "@octane-xplat/jsx",
+		"moduleSuffixes": [
+			"",
+			".web",
+			".ios",
+			".android",
+			".mobile",
+			".native",
+			".macos",
+			".linux",
+			".windows"
+		],
+		"lib": ["ESNext", "DOM", "DOM.Iterable"],
+		"types": ["@nativescript/types"],
+		"noEmit": true,
+		"skipLibCheck": true
+	},
+	"include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.tsrx"],
+	"exclude": ["dist", "types", "node_modules"]
+}

package/library-template/tsconfig.types.json

@@ -0,0 +1,11 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"declaration": true,
+		"emitDeclarationOnly": true,
+		"noEmit": false,
+		"noEmitOnError": true,
+		"rootDir": "src",
+		"outDir": "types"
+	}
+}

package/library-template/tsrx-typegen.json

@@ -0,0 +1,16 @@
+{
+	"targets": {
+		"octane": {
+			"renderer": "@octane-xplat/jsx",
+			"project": "tsconfig.types.json",
+			"outDir": "types",
+			"entrypoints": {
+				".": {
+					"source": "src/index.ts",
+					"runtime": ["./src/index.ts", "./src/index.web.ts"],
+					"types": ["./types/index.d.ts", "./types/index.web.d.ts"]
+				}
+			}
+		}
+	}
+}