uniweb 0.12.21 → 0.12.22

package/src/utils/scaffold.js

@@ -94,13 +94,24 @@ export async function scaffoldFoundation(targetDir, context, options = {}) {
 /**
  * Scaffold a site from the site package template
  *
+ * Two shapes, by whether a local foundation is wired:
+ *  - Local foundation (the default for `create`/`add site`): pass
+ *    `foundationName` + `foundationPath` (a `file:` spec) and the site's
+ *    package.json gets that dependency.
+ *  - Referenced foundation (no local sibling — what `uniweb clone` uses):
+ *    OMIT `foundationName`/`foundationPath` and set `foundationRef` to a
+ *    registry ref (`@ns/name@ver`) or URL. No `file:` dependency is written;
+ *    `site.yml::foundation` carries the ref and the runtime loads it as a
+ *    federated module (runtime mode). Deps still pin to the CLI version
+ *    matrix via the template's `{{version}}` helper.
+ *
  * @param {string} targetDir - Target directory for the site
  * @param {Object} context - Template context
  * @param {string} context.name - Package name
  * @param {string} context.projectName - Workspace name
- * @param {string} context.foundationName - Foundation package name
- * @param {string} context.foundationPath - Relative file: path to foundation
- * @param {string} [context.foundationRef] - Foundation ref for site.yml (when multiple foundations)
+ * @param {string} [context.foundationName] - Local foundation package name (omit for a referenced foundation)
+ * @param {string} [context.foundationPath] - Relative file: path to a local foundation (omit for a referenced foundation)
+ * @param {string} [context.foundationRef] - Foundation ref written to site.yml (a local package name, a registry ref, or a URL)
  * @param {Object} [options] - Processing options
  */
 export async function scaffoldSite(targetDir, context, options = {}) {

package/src/utils/site-content-refs.js

@@ -0,0 +1,21 @@
+/**
+ * Dep-free reader for the foundation ref the backend populates on a site-content
+ * document.
+ *
+ * Kept free of `@uniweb/build` so it's importable from `clone` (global, runs before a
+ * project exists) — the same constraint that keeps utils/placement.js dependency-free.
+ *
+ * The site-content `$`-document carries, on its `info` brief, the `foundation` ref the
+ * backend fills in when it wires a site. The reader is tolerant — a backend field
+ * rename should degrade, not crash — and is the single adjust-point if the wire field
+ * name settles differently. (The site's `@uniweb/folder` is NOT read here: the backend
+ * resolves it from the site-content uuid, so the framework never holds a folder uuid.)
+ */
+
+/**
+ * The site's foundation ref — a URL or our `@ns/name@ver`. Written verbatim into
+ * site.yml; the runtime loads it as a federated module.
+ */
+export function extractFoundationRef(info = {}, document = {}) {
+  return info?.foundation ?? info?.foundation_name ?? document?.foundation ?? null
+}

package/templates/foundation/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+_entry.generated.js
+.DS_Store
+*.local

package/templates/site/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+.uniweb/
+.DS_Store
+*.local

package/templates/site/package.json.hbs

@@ -10,8 +10,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@uniweb/runtime": "{{version "@uniweb/runtime"}}",
-    "{{foundationName}}": "{{foundationPath}}"
+    "@uniweb/runtime": "{{version "@uniweb/runtime"}}"{{#if foundationPath}},
+    "{{foundationName}}": "{{foundationPath}}"{{/if}}
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.0.0",

package/templates/workspace/_gitignore

@@ -0,0 +1,33 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+.uniweb/
+
+# Generated entry (regenerated by `uniweb build`; never committed)
+_entry.generated.js
+
+# Local mock-cloud state (when running `uniweb publish --local` or
+# the unicloud dev server inside this workspace)
+.unicloud/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*