create-octane-xplat 0.7.2 → 0.9.0

package/README.md

@@ -3,13 +3,14 @@
 > Get a TypeScript app running, then build its first useful flow with your
 > coding agent.
 
-xplat's target direction spans web, iOS, Android, macOS, and Windows. This
-starter configures **web, iOS, and Android**. macOS is a separate experiment;
-Windows has a separate experimental scaffold with runtime verification pending. See
+Xplat's target direction spans web, iOS, Android, macOS, Windows, and Linux.
+This starter configures **web, iOS, and Android**. macOS, Windows, and Linux
+are separate experiments — an AppKit host, a WinUI 3 scaffold with runtime
+verification pending, and a WebKitGTK webview host. See
 [target support](https://octane-xplat.goddardai.org/spec#choose-your-targets).
 The framework is `0.x` and its API surface is still changing.
 
-With Node.js and pnpm installed:
+With Node.js and pnpm 11.24.0 installed:
 
 ```sh
 pnpm create octane-xplat my-app
@@ -25,6 +26,10 @@ clear the list in this in-memory version. The
 [first-flow guide](https://octane-xplat.goddardai.org/toolchain#build-and-check-your-first-flow)
 includes the full prompt and failure checks.
 
+The generated app pins pnpm 11.24.0. Its `pnpm-workspace.yaml` loads
+`@octane-xplat/patches` as a `configDependencies` package, making the
+framework patches available during the first install.
+
 Leave the server running while you edit. After stopping it, restart from the
 app directory:
 
@@ -45,6 +50,6 @@ pnpm build          # web production bundle
 
 [Get a working app and iterate](https://octane-xplat.goddardai.org/toolchain)
 provides prerequisites, live-update boundaries, and version guidance. The
-starter's xplat skill is included; NativeScript's official skills are optional
+starter's Xplat skill is included; NativeScript's official skills are optional
 and installed separately. Ask your agent to report checks and targets actually
 run. [llms.txt](https://octane-xplat.goddardai.org/llms.txt) indexes the docs.

package/index.mjs

@@ -4,7 +4,9 @@ import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { spawnSync } from 'node:child_process'
 
-const dir = resolve(process.argv[2] ?? 'octane-xplat-app')
+const positional = process.argv.slice(2).filter((arg) => !arg.startsWith('-'))
+const noInstall = process.argv.includes('--no-install')
+const dir = resolve(positional[0] ?? 'octane-xplat-app')
 
 if (existsSync(dir) && readdirSync(dir).length > 0) {
 	console.error(`✗ ${dir} exists and is not empty`)
@@ -20,6 +22,12 @@ try {
 
 console.log(`\n✓ scaffolded ${dir}`)
 
+if (noInstall) {
+	console.log('\nSkipped install (--no-install). To run manually:')
+	console.log(`  cd ${dir}\n  pnpm install\n  pnpm dev`)
+	process.exit(0)
+}
+
 const install = spawnSync('pnpm', ['install'], { cwd: dir, stdio: 'inherit' })
 if (install.status !== 0) {
 	console.log(`\nInstall didn't finish (pnpm missing?). To run manually:`)

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "create-octane-xplat",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "Scaffold a minimal @octane-xplat/ui app — one Octane codebase for web + iOS + Android",
   "keywords": [
-    "octane",
-    "xplat",
-    "cross-platform",
     "create",
+    "cross-platform",
+    "init",
+    "octane",
+    "project-generator",
     "scaffolding",
     "starter-template",
-    "project-generator",
-    "init"
+    "xplat"
   ],
-  "license": "MIT",
   "homepage": "https://github.com/octane-xplat/octane-xplat/tree/main/packages/create",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/octane-xplat/octane-xplat.git",
+    "url": "https://github.com/octane-xplat/octane-xplat",
     "directory": "packages/create"
   },
   "bin": {

package/template/.agents/skills/xplat/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: xplat
-description: Build and review code in an Octane xplat app — one TypeScript codebase targeting web (DOM) and iOS/Android (NativeScript). Use when writing components, styles, routes, platform leaves, or device-service calls, and when a feature works on one target but not another.
+description: Build and review code in an Octane Xplat app — one TypeScript codebase targeting web (DOM) and iOS/Android (NativeScript). Use when writing components, styles, routes, platform leaves, or device-service calls, and when a feature works on one target but not another.
 ---
 
-# Octane xplat app
+# Octane Xplat app
 
 Every `src/*.tsrx` file compiles twice: once to the DOM renderer, once to
 NativeScript views. The common failure mode is **silent divergence** — code

package/template/.agents/skills/xplat/references/platform.md

@@ -7,8 +7,12 @@ native default, `.web` is the browser implementation, and `.mobile` or an OS
 suffix narrows behavior when needed. Surface: `device`, `appInfo`, `locale`,
 `connectivity`, `useWindowSize`, `useAppState`, `useSafeAreaInsets`, deep
 links, clipboard, `secureStorage`, haptics, notifications, `announce`,
-`systemBars`, geolocation, permissions, media, files, share, `openUrl`,
-`openSettings`, biometrics.
+`systemBars`, permissions, `openUrl`, `openSettings`. Services that need a
+NativeScript plugin ship as leaf packages: `@octane-xplat/share`,
+`@octane-xplat/files`, `@octane-xplat/media`, `@octane-xplat/biometrics`,
+`@octane-xplat/geolocation`, `@octane-xplat/notifications`,
+`@octane-xplat/secure-storage`, and `haptics` in `@octane-xplat/haptics` —
+each leaf owns its plugin as a real dependency.
 
 Services report honestly — `biometrics` returns `unsupported` on web rather
 than faking a result. Handle the tier your app can fall back to instead of

package/template/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-Octane xplat app — one TypeScript codebase for web + iOS + Android (Octane
+Octane Xplat app — one TypeScript codebase for web + iOS + Android (Octane
 
 - NativeScript).
 

package/template/package.json

@@ -2,7 +2,7 @@
 	"name": "octane-xplat-app",
 	"private": true,
 	"type": "module",
-	"main": "src/index.ts",
+	"main": "src/main.ts",
 	"scripts": {
 		"xplat": "xplat",
 		"dev": "vite",
@@ -17,11 +17,12 @@
 	},
 	"dependencies": {
 		"@nativescript-community/gesturehandler": "2.0.45",
-		"@nativescript-community/octane": "0.2.1",
+		"@nativescript-community/octane": "0.2.4",
 		"@nativescript-community/ui-drawer": "0.1.32",
 		"@nativescript/core": "9.1.2",
-		"@octane-xplat/effects": "^0.7.2",
-		"@octane-xplat/ui": "^0.7.2",
+		"@octane-xplat/effects": "^0.9.0",
+		"@octane-xplat/platform": "^0.9.0",
+		"@octane-xplat/ui": "^0.9.0",
 		"@valor/nativescript-websockets": "2.0.3",
 		"octane": "0.6.3"
 	},
@@ -30,14 +31,15 @@
 		"@nativescript/android": "9.1.1",
 		"@nativescript/ios": "9.1.0",
 		"@nativescript/types": "9.0.0",
-		"@nativescript/vite": "8.0.11",
-		"@octane-xplat/cli": "^0.7.2",
-		"@octane-xplat/lint": "^0.7.2",
+		"@nativescript/vite": "8.0.17",
+		"@octane-xplat/cli": "^0.9.0",
+		"@octane-xplat/lint": "^0.9.0",
 		"@octanejs/vite-plugin": "0.1.61",
-		"@tsrx/typescript-plugin": "0.4.7",
+		"@tsrx/typescript-plugin": "0.4.11",
 		"nativescript": "9.1.1",
 		"oxlint": "^1.74.0",
 		"typescript": "5.9.3",
 		"vite": "8.3.0"
-	}
+	},
+	"packageManager": "pnpm@11.24.0"
 }

package/template/pnpm-workspace.yaml

@@ -14,14 +14,21 @@ allowBuilds:
   '@parcel/watcher': true
   nativescript: true
   '@nativescript/core': false
-# Framework patch set required by the octane-xplat toolchain — applied via pnpm
-# patchedDependencies. Managed upstream by @octane-xplat/cli (`xplat patches apply`
-# refreshes, `xplat patches check` verifies); do not edit by hand.
+# The patch set covers optional leaf deps (tiptap, linkifyjs, …) the starter
+# doesn't install — tolerate entries that apply to nothing.
+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 octane 0.6.3 lacks live signal reads under universal renderers. Adds signal
   # ownership, read tracking, and local signal hooks; JSX prop lowering and __methodDep
-  # already ship upstream.
-  octane@0.6.3: patches/octane@0.6.3.patch
+  # already ship upstream. Routes uncaught universal event-handler errors to onUncaughtError
+  # when configured. Pins instance signal/query declarations to their declaring owner so
+  # child reads and event handlers share one request. Also allows async and generator
+  # helpers that are not components in universal compiler modules, while preserving errors
+  # when those functions are used as components (octanejs/octane#1469).
+  octane@0.6.3: node_modules/.pnpm-config/@octane-xplat/patches/patches/octane@0.6.3.patch
   # FlexboxLayout getChildMeasureSpec subtracts the child's own padding where AOSP subtracts
   # parent padding + child margins — a column-stretched row re-measurement clamps padded
   # children (37→17 dip, squished controls). Adds squircle (continuous) corner clipping for
@@ -33,44 +40,59 @@ patchedDependencies:
   # on iOS and detached from their tab fragment on Android), iOS items writes load the
   # selected item's view once controllers exist, and Frame._pushInFrameStack only promotes
   # frames whose ancestors present them (Frame.topmost stops returning hidden preloaded tab
-  # frames).
-  "@nativescript/core@9.1.2": patches/@nativescript__core@9.1.2.patch
+  # frames). Also maps CSS font-weight to the OpenType wght axis for custom Android fonts on
+  # API 26+, preserves explicit variation settings, and falls back to the prior file load
+  # when the axis is unsupported. Carries NativeScript PR #11481: preserves percentage
+  # translate values through parsing and resolves each axis against the view's own
+  # dimensions, including native views and animations.
+  "@nativescript/core@9.1.2": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript__core@9.1.2.patch
+  # @nativescript/types@9.0.0 omits ambient declarations for the native URL and
+  # URLSearchParams globals, so projects without DOM libraries cannot typecheck valid native
+  # URL code. Adds runtime-aligned declarations that merge with DOM declarations when both
+  # libraries are present.
+  "@nativescript/types@9.0.0": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript__types@9.0.0.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: patches/css@3.0.0.patch
-  # Dev-server /ns/m fixes: resolve pnpm-isolated transitive deps and platform-suffixed
-  # entries, inline workspace CSS through /@fs, route vendor-excluded plugins through HTTP,
-  # decode bracketed paths, and ignore comments during export-star expansion. Deps-bundle
-  # alias: the dev payload's esbuild passes never see 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 resolver also probes the .mobile suffix tier (ios/android) between the os
-  # qualifier and unsuffixed default — .mobile-only modules behind paths-mapped imports
-  # failed bundle-mode resolution.
-  "@nativescript/vite@8.0.11": patches/@nativescript__vite@8.0.11.patch
+  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`.
+  "@nativescript/vite@8.0.17": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript__vite@8.0.17.patch
   # Driver setProp skips `undefined` writes — NativeScript native setters coerce it (e.g.
   # editable → ios.userInteractionEnabled = NO), leaving dead UI that still has its JS
-  # listeners.
-  "@nativescript-community/octane@0.2.1": patches/@nativescript-community__octane@0.2.1.patch
+  # listeners. Advertises the implemented visibility capability so committed suspense bodies
+  # can be retained while pending.
+  "@nativescript-community/octane@0.2.4": node_modules/.pnpm-config/@octane-xplat/patches/patches/@nativescript-community__octane@0.2.4.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": patches/@nativescript-community__vite-octane@0.2.1.patch
-  # Same dev-server fixes as the 8.0.11 patch, ported to the @11468 pkg.pr.new preview the
-  # windows target uses (apps/windows): /ns/m re-export records, vendor-manifest gating for
-  # plugin-patterned packages, percent-decoded specifiers, and the .mobile-aware
-  # tsconfig-paths probing.
-  "@nativescript/vite@8.0.13": patches/@nativescript__vite@8.0.13.patch
-  # Windows spike: the shared-file subset of the 9.1.2 patch — @layer cascade machinery
-  # (css-tree parser, css-selector, style-scope), the #11446 frame/tab-view common fixes,
-  # and the flexbox common measure-spec — applied to the @11468 preview. iOS/Android
-  # impl-file hunks are dead code on windows and were dropped.
-  "@nativescript/core@9.1.3-next.2": patches/@nativescript__core@9.1.3-next.2.patch
+  "@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": patches/@tsrx__typescript-plugin@0.4.11.patch
+  "@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
+  # Two bundler-visible issues: useEditor.ts reads bare process.env.NODE_ENV (no node global
+  # in the harness typecheck program) and './Context' resolves to Context.tsrx — a
+  # self-import — under suffix-first resolution, so EditorContext/useCurrentEditor were
+  # unreachable. Adds a module-local process declaration for typecheck and merges the
+  # Context.ts definitions into Context.tsrx.
+  "@octanejs/tiptap@0.0.51": node_modules/.pnpm-config/@octane-xplat/patches/patches/@octanejs__tiptap@0.0.51.patch
+configDependencies:
+  "@octane-xplat/patches": 0.9.0

package/template/src/App.tsrx

@@ -1,5 +1,6 @@
 import { useState } from 'octane';
 import { View, Row, Text, Pressable, ScrollView, useColorScheme } from '@octane-xplat/ui';
+import { storage } from '@octane-xplat/platform';
 
 const FEATURES = [
 	'shared components',
@@ -13,8 +14,12 @@ const FEATURES = [
  *  (.web.tsrx / .mobile.tsrx), never inside a component. */
 export function App() @{
 	const [count, setCount] = useState(0);
-	// null = follow the system; the toggle overrides it for this session.
-	const [override, setOverride] = useState<boolean | null>(null);
+	// null = follow the system until the user chooses a mode.
+	const [override, setOverride] = useState<boolean | null>(() => {
+		const saved = storage.getString('theme-preference');
+		return saved === 'light' ? false : saved === 'dark' ? true : null;
+	});
+
 	const scheme = useColorScheme();
 	const dark = override ?? scheme === 'dark';
 
@@ -32,7 +37,11 @@ export function App() @{
 			{FEATURES.map((f) => <Text className="chip">{f}</Text>)}
 		</ScrollView>
 
-		<Pressable className="link" onPress={() => setOverride(!dark)}>
+		<Pressable className="link" onPress={() => {
+			const next = !dark;
+			storage.setString('theme-preference', next ? 'dark' : 'light');
+			setOverride(next);
+		}}>
 			<Text>{dark ? 'light' : 'dark'} mode (system: {scheme})</Text>
 		</Pressable>
 	</View>

package/template/src/process.d.ts

@@ -0,0 +1,7 @@
+// npm deps (upstream octane packages included) read `process.env.NODE_ENV`
+// bare — the npm convention where the consumer bundler statically replaces
+// the member expression (vite `define`; see xplatNodeEnvDefine). tsc still
+// needs the name declared in a program with no Node types. Kept narrow on
+// purpose: `process.env.FOO` reads stay type errors because the bundler
+// define cannot rewrite them either.
+declare const process: { env: { NODE_ENV?: string } }

package/template/tsconfig.json

@@ -14,5 +14,5 @@
 		"skipLibCheck": true
 	},
 	"include": ["src/**/*"],
-	"exclude": ["node_modules", "src/index.ts"]
+	"exclude": ["node_modules", "src/main.ts"]
 }

package/template/vite.config.ts

@@ -1,12 +1,14 @@
 import { defineConfig } from 'vite'
 import { octane } from '@octanejs/vite-plugin'
+import { xplatBoundary, xplatNodeEnvDefine } from '@octane-xplat/cli/vite'
 
 // The web build. For native (iOS/Android), the same source runs through
 // @nativescript-community/vite-octane with `conditions: ['native']`, the
 // .ios/.android/.mobile suffix chain, and the unsuffixed native default — see
 // the octane-xplat repo's apps/mobile/vite.config.mts.
-export default defineConfig({
-	plugins: [...octane()],
+export default defineConfig(({ mode }) => ({
+	plugins: [...octane(), xplatBoundary('web')],
+	define: xplatNodeEnvDefine(mode),
 	server: { port: 5200 },
 	resolve: {
 		conditions: ['web'],
@@ -25,4 +27,4 @@ export default defineConfig({
 			'.json',
 		],
 	},
-})
+}))

package/template/App_Resources/iOS/src/OctaneShaders.metal

@@ -1,128 +0,0 @@
-#include <metal_stdlib>
-#include <SwiftUI/SwiftUI_Metal.h>
-using namespace metal;
-
-// Stitchable shaders for SwiftUI's `.distortionEffect` / `.colorEffect` (iOS 17+).
-// SwiftUI supplies the leading parameters — `position` for a distortion, plus
-// `color` for a colour effect — and appends the arguments passed at the call
-// site in `OctaneLogo.swift`.
-
-/// Rising heat haze.
-///
-/// A distortion shader maps a destination pixel back to the source pixel it
-/// should sample, so the returned offset reads as the image bending. Amplitude
-/// is weighted by `base^2` (1 at the bottom, 0 at the top) so the mark shimmers
-/// like air over hot metal instead of wobbling as a rigid block, and the two
-/// waves use incommensurate frequencies so the pattern never visibly repeats.
-[[ stitchable ]] float2 octaneHeatHaze(float2 position, float time, float2 size, float intensity) {
-	float2 uv = position / size;
-	float base = 1.0 - uv.y;
-	float wave = sin(uv.y * 26.0 - time * 3.1) * 0.6
-	           + sin(uv.y * 11.0 - time * 1.9 + uv.x * 4.0) * 0.4;
-	float amp = 2.4 * base * base * intensity;
-	return position + float2(wave * amp, 0.0);
-}
-
-/// Ember sheen sweeping diagonally across the ink.
-///
-/// SwiftUI hands colour effects premultiplied alpha, so the colour has to be
-/// un-premultiplied before mixing and re-premultiplied on the way out —
-/// blending straight into premultiplied RGB would bleed the highlight into the
-/// transparent surround and halo the glyph edges.
-[[ stitchable ]] half4 octaneSheen(float2 position, half4 color, float time, float2 size, float intensity) {
-	if (color.a < 0.004h) {
-		return color;
-	}
-	half3 rgb = color.rgb / color.a;
-
-	float2 uv = position / size;
-	float sweep = fract(time * 0.22);
-	float d = (uv.x * 0.85 + (1.0 - uv.y) * 0.35) - (sweep * 1.8 - 0.4);
-	float band = exp(-(d * d) * 42.0);
-
-	half3 ember = half3(1.0h, 0.255h, 0.353h); // the logo's #FF415A accent
-	half3 gold = half3(1.0h, 0.72h, 0.36h);
-	half3 hot = mix(ember, gold, half(band));
-
-	half glow = half(band) * half(intensity);
-	rgb = mix(rgb, hot, glow * 0.9h);
-	rgb += half3(glow * 0.25h);
-
-	return half4(saturate(rgb) * color.a, color.a);
-}
-
-/// Per-shard pseudo-random pair. Deterministic in the cell index, so a shard
-/// keeps the same trajectory for the whole burst instead of jittering per frame.
-static inline float2 shardNoise(float2 cell) {
-	float3 a = fract(float3(cell.xyx) * float3(0.1031, 0.1030, 0.0973));
-	a += dot(a, a.yzx + 33.33);
-	return fract(float2((a.x + a.y) * a.z, (a.x + a.z) * a.y));
-}
-
-/// Ignition burst: the mark shatters outward and reassembles.
-///
-/// A layer effect (rather than a distortion) because each shard has to read
-/// from somewhere else in the image: sampling `position - offset` with an
-/// offset that is constant across a grid cell translates that whole cell as a
-/// rigid chip, which is what reads as breaking apart. A distortion shader can
-/// only nudge its own pixel, so it smears instead of shattering.
-///
-/// `progress` runs 0 -> 1 once per burst and the displacement rides
-/// `sin(p * pi)`, so the shards fly out and land back exactly where they
-/// started — no separate reassembly pass, and the mark cannot get stranded
-/// mid-explosion if a frame is dropped.
-[[ stitchable ]] half4 octaneShatter(float2 position, SwiftUI::Layer layer, float2 size, float progress) {
-	if (progress <= 0.0001) {
-		return layer.sample(position);
-	}
-
-	float p = clamp(progress, 0.0, 1.0);
-	float fly = sin(p * M_PI_F);
-	float ease = fly * fly;
-
-	float2 cells = float2(22.0, 5.0);
-	float2 cellSize = size / cells;
-	float2 rnd = shardNoise(floor(position / cellSize));
-
-	float2 centre = size * 0.5;
-	float2 radial = (position - centre) / max(size.x * 0.5, 1.0);
-	float2 dir = radial + (rnd - 0.5) * 0.9;
-	float len = max(length(dir), 0.0001);
-	dir /= len;
-
-	// Capped so the outermost shards stay inside the host view; anything
-	// travelling further is clipped by its bounds rather than fading out.
-	float2 offset = dir * mix(22.0, 70.0, rnd.x) * ease;
-	offset.y += (rnd.y - 0.5) * 42.0 * ease;
-	float2 src = position - offset;
-
-	// Chromatic split along the flight path — the shards read as moving fast
-	// rather than merely being displaced.
-	float split = ease * 3.5;
-	half4 cr = layer.sample(src + dir * split);
-	half4 cg = layer.sample(src);
-	half4 cb = layer.sample(src - dir * split);
-	half alpha = max(max(cr.a, cg.a), cb.a);
-	if (alpha < 0.004h) {
-		return half4(0.0h);
-	}
-	half3 rgb = half3(cr.r, cg.g, cb.b) / alpha;
-
-	// Expanding shockwave ring, brightest just after the tap.
-	float ring = exp(-pow((length(radial) - p * 1.5) * 5.0, 2.0)) * (1.0 - p);
-
-	half3 ember = half3(1.0h, 0.255h, 0.353h);
-	half3 gold = half3(1.0h, 0.78h, 0.35h);
-	half heat = half(ease);
-	// Ember-leaning, and only a partial mix: pushing all the way to `hot` turns
-	// every shard the same flat gold and the mark stops being recognisable
-	// mid-flight. Holding some ink back keeps them reading as burning pieces
-	// of the logo.
-	half3 hot = mix(ember, gold, heat * 0.75h);
-
-	rgb = mix(rgb, hot, heat * 0.6h);
-	rgb += half3(heat * 0.18h * half(rnd.x) + half(ring) * 0.45h);
-
-	alpha *= 1.0h - heat * 0.2h;
-	return half4(saturate(rgb) * alpha, alpha);
-}

package/template/App_Resources/iOS/src/ShaderEffectRegistration.swift

@@ -1,31 +0,0 @@
-import SwiftUI
-
-// Registers the app's stitchable shaders (OctaneShaders.metal) by name for
-// @octane-xplat/effects' <ShaderEffect>. Names are runtime strings because
-// ShaderLibrary lookups are compile-time — registration is the dispatch
-// table. Call `OctaneShaderEffects.install()` from JS before rendering a
-// ShaderEffect (`declare const OctaneShaderEffects: any`).
-//
-// Pair-bound: this file + OctaneShaders.metal + the @octane-xplat/effects
-// dependency go together — delete all three if you don't want shader
-// effects.
-@objc(OctaneShaderEffects)
-public final class OctaneShaderEffects: NSObject {
-	@objc public static func install() {
-		XplatShaderEffectRegistry.register("heatHaze", kind: .distortion) { args in
-			ShaderLibrary.octaneHeatHaze(
-				.float(args.f("time")), .float2(args.size), .float(args.f("intensity"))
-			)
-		}
-		XplatShaderEffectRegistry.register("sheen", kind: .color) { args in
-			ShaderLibrary.octaneSheen(
-				.float(args.f("time")), .float2(args.size), .float(args.f("intensity"))
-			)
-		}
-		XplatShaderEffectRegistry.register("shatter", kind: .layer) { args in
-			ShaderLibrary.octaneShatter(
-				.float2(args.size), .float(args.f("progress"))
-			)
-		}
-	}
-}

package/template/patches/@nativescript-community__octane@0.2.1.patch

@@ -1,16 +0,0 @@
-diff --git a/dist/driver.js b/dist/driver.js
-index f485f992282c05c58fed810458303be3141f51c0..9b5a654cf0c32be5fc6da4ae5fec04a58560925f 100644
---- a/dist/driver.js
-+++ b/dist/driver.js
-@@ -83,6 +83,11 @@ function setProp(node, view, name, value) {
-         setRenderItem(view, value ?? null, createNativeScriptRoot);
-         return;
-     }
-+    // `undefined` means "prop not supplied" — skip the write. NativeScript
-+    // native setters coerce it (e.g. editable → ios.userInteractionEnabled =
-+    // NO) leaving dead UI that still has its JS listeners.
-+    if (value === undefined)
-+        return;
-     // Core raises `<name>Change` for a script write exactly as for a user
-     // edit; a controlled input must not see its own value come back as one.
-     const echo = `${name}Change`;

package/template/patches/@nativescript-community__vite-octane@0.2.1.patch

@@ -1,41 +0,0 @@
-diff --git a/dist/server/strategy.js b/dist/server/strategy.js
-index 7d84b37e2ed3a026da5b31c8a11027e0580877b2..f6594a913ba64837135e994cb183add13c6a0530 100644
---- a/dist/server/strategy.js
-+++ b/dist/server/strategy.js
-@@ -14,7 +14,9 @@ import { purgeTransformCachesForHotUpdate, runHotUpdatePrologue, typescriptServe
-  * otherwise the re-fetch can be served from the previous save's transform and
-  * the screen ends up one save behind.
-  */
--const SCRIPT_FILE_RE = /\.(?:[mc]?[jt]sx?)$/i;
-+// `.tsrx` is Octane's component extension — without it the deferred delta is
-+// never emitted and component edits silently never reach the device.
-+const SCRIPT_FILE_RE = /\.(?:[mc]?[jt]sx?|tsrx)$/i;
- export const octaneServerStrategy = {
-     ...typescriptServerStrategy,
-     flavor: 'octane',
-@@ -24,7 +26,7 @@ export const octaneServerStrategy = {
-         if (!state)
-             return;
-         const { root, metrics, emitSummary } = state;
--        const { moduleGraph, verbose, sharedTransformRequest } = deps;
-+        const { moduleGraph, verbose, sharedTransformRequest, wss, isSocketClientOpen } = deps;
-         const { file, server } = ctx;
-         if (!SCRIPT_FILE_RE.test(file)) {
-             emitSummary();
-@@ -71,6 +73,16 @@ export const octaneServerStrategy = {
-             const gm = moduleGraph.get(normalizedId);
-             if (gm)
-                 moduleGraph.emitDelta([gm], []);
-+            // The ns:hmr-delta broadcast IS the update delivery for this flavor —
-+            // count open sockets so the always-on summary reflects reality
-+            // instead of reporting recipients=0 for a delivered update.
-+            try {
-+                wss?.clients?.forEach((client) => {
-+                    if (isSocketClientOpen?.(client))
-+                        metrics.recipients += 1;
-+                });
-+            }
-+            catch { }
-         }
-         catch (e) {
-             if (verbose)