@fusion.dev/helix-templates 0.25.1 → 0.30.0

package/README.md

@@ -28,12 +28,14 @@ the graph, which wants the packages public first.
 ## Reading it yourself
 
 ```js
-import { findTemplate, PROJECT_NAME, templates } from '@fusion.dev/helix-templates'
+import { findTemplate, HELIX_VERSION, PROJECT_NAME, templates } from '@fusion.dev/helix-templates'
 ```
 
 `templates` is the register, in the order a chooser should offer them. Each entry
-names the files whose contents carry `PROJECT_NAME`, which a scaffolder replaces
-with the project's own. The payloads sit under `templates/<id>/` in this package.
+names the files a scaffolder substitutes in: `PROJECT_NAME` becomes the project's
+own name, and `HELIX_VERSION` becomes this package's version, which is the Helix
+the templates were published with. The payloads sit under `templates/<id>/` in
+this package.
 
 **The named files are named rather than discovered.** Scanning every file for the
 placeholder would rewrite a template that merely mentions it in prose, and a

package/dist/index.d.ts

@@ -40,8 +40,8 @@ export interface Template {
  *
  * **There is no build-free HTML template, and that is a fact about the packages
  * rather than an omission.** `@fusion.dev/helix`'s published entry re-exports
- * bare specifiers — `@fusion.dev/helix-core`, ninety-odd
- * `@fusion.dev/helix-headless/*` subpaths, `lit` and its own graph — which a
+ * bare specifiers (`@fusion.dev/helix-core`, ninety-odd
+ * `@fusion.dev/helix-headless/*` subpaths, `lit` and its own graph), which a
  * browser cannot resolve without an import map covering all of it. An import map
  * that large is a build artifact wearing a template's clothes. The honest
  * build-free story is a CDN that rewrites the graph, which wants the packages
@@ -50,5 +50,15 @@ export interface Template {
 export declare const templates: readonly Template[];
 /** The placeholder a scaffolder replaces with the project's name. */
 export declare const PROJECT_NAME = "__PROJECT_NAME__";
+/**
+ * The placeholder a scaffolder replaces with this package's own version.
+ *
+ * **Which is the Helix a template was published with**, every Helix package
+ * sharing one version, so a template asks for the components it shipped beside
+ * and no release has to remember to update it. Written by hand, both templates
+ * asked for `^0.0.9`, which under a zero major admits `0.0.9` alone, and a new
+ * project installed that release while 0.25.0 was current.
+ */
+export declare const HELIX_VERSION = "__HELIX_VERSION__";
 /** The one template with this id, or `undefined` where there is none. */
 export declare const findTemplate: (id: string) => Template | undefined;

package/dist/index.js

@@ -13,4 +13,5 @@ export const templates = [
     },
 ];
 export const PROJECT_NAME = '__PROJECT_NAME__';
+export const HELIX_VERSION = '__HELIX_VERSION__';
 export const findTemplate = (id) => templates.find((one) => one.id === id);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-templates",
   "description": "Starter templates for Helix, as data. Read by `helix new` and by `npm create @fusion.dev/helix-app`.",
-  "version": "0.25.1",
+  "version": "0.30.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -26,11 +26,16 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "build": "bun run register && tsc -p tsconfig.build.json && tsc -p tsconfig.types.json",
+    "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.types.json",
     "register": "bun scripts/build-register.mjs",
-    "typecheck": "bun run register && tsc -p tsconfig.json --noEmit"
+    "test": "bun run test:pure",
+    "test:pure": "bun test pure.spec",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
+  "devDependencies": {
+    "@fusion.dev/scripts": "0.0.0-dev"
+  },
   "homepage": "https://fusion.dev",
   "keywords": [
     "helix",

package/templates/react-nextjs/app/layout.tsx

@@ -5,7 +5,11 @@ import type { ReactNode } from 'react'
    `:not(:defined)` rules that keep a tag from arriving unstyled. */
 import '@fusion.dev/helix-styles/helix.css'
 
-import { HelixElements } from './helix-elements.js'
+/* Extensionless, unlike the libraries this imports. Turbopack does not map a
+   `.js` specifier back to the `.tsx` beside it, which is webpack's
+   `extensionAlias` and has no equivalent there, so `./helix-elements.js` fails
+   the first `next build` with "Module not found". */
+import { HelixElements } from './helix-elements'
 
 export const metadata: Metadata = { title: '__PROJECT_NAME__' }
 export const viewport: Viewport = { initialScale: 1, width: 'device-width' }

package/templates/react-nextjs/app/page.tsx

@@ -3,7 +3,7 @@
  *
  * Helix events are props: `onhelix-before-change` reaches `helix-before-change`.
  * Anything needing a handler is a client component, the same as any other React
- * app — this page needs none.
+ * app: this page needs none.
  */
 export default function Page() {
   return (

package/templates/react-nextjs/package.json

@@ -9,13 +9,16 @@
     "start": "next start"
   },
   "dependencies": {
-    "@fusion.dev/helix": "^0.0.9",
-    "@fusion.dev/helix-styles": "^0.4.1",
-    "next": "^16.0.0",
+    "@fusion.dev/helix": "^__HELIX_VERSION__",
+    "@fusion.dev/helix-styles": "^__HELIX_VERSION__",
+    "next": "^16.3.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
   },
   "devDependencies": {
-    "typescript": "^5.9.0"
+    "@types/node": "^22.10.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "typescript": "^7.0.2"
   }
 }

package/templates/react-vite/package.json

@@ -9,14 +9,16 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fusion.dev/helix": "^0.0.9",
-    "@fusion.dev/helix-styles": "^0.4.1",
+    "@fusion.dev/helix": "^__HELIX_VERSION__",
+    "@fusion.dev/helix-styles": "^__HELIX_VERSION__",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
   },
   "devDependencies": {
-    "@vitejs/plugin-react": "^5.0.0",
-    "typescript": "^5.9.0",
-    "vite": "^7.0.0"
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^6.1.1",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.0"
   }
 }

package/templates/react-vite/tsconfig.json

@@ -8,11 +8,14 @@
     ],
     "module": "ESNext",
     "moduleResolution": "bundler",
+    "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
     "target": "ES2023",
-    "verbatimModuleSyntax": true,
-    "noEmit": true
+    "types": [
+      "vite/client"
+    ],
+    "verbatimModuleSyntax": true
   },
   "include": [
     "src",

package/templates.json

@@ -21,5 +21,6 @@
       ],
       "title": "React (Next.js)"
     }
-  ]
+  ],
+  "version": "__HELIX_VERSION__"
 }