uniweb 1.21.19 → 1.21.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "1.21.19",
+  "version": "1.21.21",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,15 +41,15 @@
     "js-yaml": "^4.3.2",
     "prompts": "^2.4.2",
     "tar": "^7.5.21",
+    "@uniweb/content-writer": "~1.3.1",
     "@uniweb/schemas": "~1.6.5",
     "@uniweb/core": "~1.4.12",
-    "@uniweb/semantic-parser": "~1.13.0",
-    "@uniweb/content-writer": "~1.3.1"
+    "@uniweb/semantic-parser": "~1.13.0"
   },
   "peerDependencies": {
-    "@uniweb/semantic-parser": "~1.13.0",
+    "@uniweb/build": "~1.10.13",
     "@uniweb/content-reader": "~1.5.7",
-    "@uniweb/build": "~1.10.12"
+    "@uniweb/semantic-parser": "~1.13.0"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -733,6 +733,8 @@ end the list with `...`.**
 
 **The tab icon:** `favicon: /favicon.svg` in `site.yml`, a file in `public/`. Name it even when the file is `public/favicon.svg`: a static build finds `public/favicon.{svg,ico,png}` on its own, but a site published with `uniweb publish` links only the favicon `site.yml` names (`uniweb doctor --fix favicon-unnamed` writes the line).
 
+**The home-screen icon:** `touchIcon: /touch-icon.png` in `site.yml` — the icon iOS puts on a home screen, which an SVG favicon never is. Make it a 180×180 PNG in `public/` with no transparency: iOS draws a transparent pixel black. Name it even when the file is `public/apple-touch-icon.png`, which iOS finds on a static host by itself: a site published with `uniweb publish` has only the touch icon `site.yml` names. `uniweb doctor` checks the file.
+
 ```yaml
 # site.yml
 keywords: [components, react, cms]

package/src/commands/doctor.js

@@ -1307,6 +1307,92 @@ export async function checkFavicon({ sitePath, siteName, siteYml, issues, should
   log(`    Add ${colors.green}favicon: ${value}${colors.reset} to site.yml — ${colors.dim}uniweb doctor --fix ${id}${colors.reset}`)
 }
 
+// The icon iOS puts on a home screen, from Apple's guidance (the archived Safari Web Content Guide,
+// read 2026-10-27): a PNG — an SVG favicon is not used — 180×180 for the largest iPhone screens,
+// with no transparency, which iOS draws black. A page that links none, iOS asks the site's root for
+// `/apple-touch-icon.png`.
+const TOUCH_ICON_SIZE = 180
+const TOUCH_ICON_FILE = 'apple-touch-icon.png'
+
+/**
+ * The touch icon: `site.yml`'s `touchIcon:`. A static build links the one it names, and a push
+ * sends that file and no other, so a Uniweb host has none the site does not name — not even the
+ * `/apple-touch-icon.png` iOS asks a static host for. A named one is measured: a PNG, square, at
+ * least 180×180, every pixel opaque.
+ */
+export async function checkTouchIcon({ sitePath, siteName, siteYml, issues, shouldFix, fixed: reportFixed }) {
+  const named = typeof siteYml?.touchIcon === 'string' ? siteYml.touchIcon.trim() : ''
+  if (!named) {
+    if (!existsSync(join(sitePath, 'public', TOUCH_ICON_FILE))) {
+      const id = 'touch-icon-none'
+      issues.push({ id, type: 'info', site: siteName, message: 'site.yml names no touch icon, the icon iOS puts on a home screen' })
+      info(`[${id}] site.yml names no touch icon — the icon iOS puts on a home screen and Safari shows on its start page`)
+      log(`    Add a ${TOUCH_ICON_SIZE}×${TOUCH_ICON_SIZE} PNG with no transparency to public/ and name it: ${colors.green}touchIcon: /touch-icon.png${colors.reset}`)
+      return
+    }
+    const id = 'touch-icon-unnamed'
+    const value = `/${TOUCH_ICON_FILE}`
+    const issue = {
+      id,
+      type: 'info',
+      site: siteName,
+      message: `public/${TOUCH_ICON_FILE} is not named in site.yml, so a Uniweb host has no touch icon`,
+      fixable: true
+    }
+    issues.push(issue)
+    info(`[${id}] public/${TOUCH_ICON_FILE} is not named in site.yml — iOS finds it on a static host, but a Uniweb host is never sent it`)
+    if (shouldFix?.(id)) {
+      try {
+        writeSiteConfig(sitePath, { touchIcon: value })
+        issue.fixed = true
+        reportFixed?.(`site.yml now names touchIcon: ${value}`)
+        return
+      } catch (err) {
+        warn(`[${id}] could not write site.yml: ${err.message}`)
+      }
+    }
+    log(`    Add ${colors.green}touchIcon: ${value}${colors.reset} to site.yml — ${colors.dim}uniweb doctor --fix ${id}${colors.reset}`)
+    return
+  }
+
+  if (!isSitePath(named)) return
+  const file = siteFile(sitePath, named)
+  if (!file) {
+    const id = 'touch-icon-missing'
+    issues.push({ id, type: 'warn', site: siteName, message: `touchIcon: ${named} is not in public/ or assets/` })
+    warn(`[${id}] touchIcon: ${named} is not in public/ or assets/ — every page links an icon that is not there`)
+    return
+  }
+  const { readImageSize, isImageOpaque } = await import('@uniweb/build/images')
+  const size = await readImageSize(file)
+  if (!size || size.format !== 'png') {
+    const id = 'touch-icon-format'
+    const what = !size ? 'could not be read as an image' : `is ${size.format.toUpperCase()}, not a PNG`
+    issues.push({ id, type: 'warn', site: siteName, message: `touchIcon: ${named} ${what}` })
+    warn(`[${id}] touchIcon: ${named} ${what} — iOS takes a PNG`)
+    return
+  }
+  if ((await isImageOpaque(file)) === false) {
+    const id = 'touch-icon-transparent'
+    issues.push({ id, type: 'warn', site: siteName, message: `touchIcon: ${named} has transparent pixels, which iOS draws black` })
+    warn(`[${id}] touchIcon: ${named} has transparent pixels — iOS draws them black`)
+    log(`    Give the icon a background of its own.`)
+  }
+  const { width, height } = size
+  const advice =
+    width !== height
+      ? 'not square, as a touch icon is'
+      : width < TOUCH_ICON_SIZE
+        ? `under ${TOUCH_ICON_SIZE}×${TOUCH_ICON_SIZE}, iPhone screens draw it soft`
+        : null
+  if (advice) {
+    const id = 'touch-icon-shape'
+    issues.push({ id, type: 'info', site: siteName, message: `touchIcon: ${named} is ${width}×${height}: ${advice}` })
+    info(`[${id}] touchIcon: ${named} is ${width}×${height}: ${advice}`)
+    log(`    A ${TOUCH_ICON_SIZE}×${TOUCH_ICON_SIZE} PNG is the size iOS asks for.`)
+  }
+}
+
 /** The bare map in `queries.yml`, or `{}` when there is none. */
 function readQueriesYml(sitePath) {
   try {
@@ -1836,9 +1922,10 @@ async function runDoctor(args = []) {
     }
 
     await checkSiteAddress({ sitePath, siteName, siteYml, workspaceDir, issues })
-    // What a link to the site shows, and its tab icon.
+    // What a link to the site shows, its tab icon, and its home-screen icon.
     await checkLinkPreviews({ sitePath, siteName, issues })
     await checkFavicon({ sitePath, siteName, siteYml, issues, shouldFix, fixed })
+    await checkTouchIcon({ sitePath, siteName, siteYml, issues, shouldFix, fixed })
 
     // Forms need a destination, and having none is only visible on the page.
     await checkFormSubmitTarget({ sitePath, siteName, siteYml, issues })

package/src/commands/publish.js

@@ -630,10 +630,16 @@ export async function publish(args = []) {
   // 3. Partition the queries by schema presence (a first emit reads `schemaless`
   //    — the queries with no data schema, whose compiled files 4c uploads; no
   //    ball carries them since 2026-08-18).
+  // ⭐ With the keys this deployment's Sections take (`deploymentFields`), as the push below
+  // is: this emit says which files go up, and a key sent only where it is taken can name one —
+  // `touch_icon` does. ⛔ Until 2026-10-28 it went without them, so a touch icon was sent as the
+  // site path it was written as, and never uploaded.
+  const fields = await deploymentFields({ client, siteDir })
   let probe
   try {
     probe = await emitSyncPackages(siteDir, {
       backend: client.origin,
+      ...fields,
       // Placement identity for the folder — see writeFolderItemUuids.
       folderItemUuids: readFolderItemUuids(siteDir, client.origin),
       ...(foundationDir ? { foundationDir } : {}),
@@ -922,7 +928,6 @@ export async function publish(args = []) {
   // edited since this clone last synced, the push is refused rather than
   // overwriting them, and nothing goes live. `--force` drops the precondition.
   const forced = args.includes('--force')
-  const fields = await deploymentFields({ client, siteDir })
   // A foundation named by catalog ref — a clone's: its kept registered version types a query named
   // for a data key (`ensureRegisteredFoundation`).
   await ensureRegisteredFoundation({

package/src/commands/push.js

@@ -446,6 +446,16 @@ export async function push(args = [], deps = {}) {
     if (!guard.ok) return { exitCode: 1 }
   }
 
+  // The keys this deployment's Sections take (`deploymentFields`) — read before the media probe,
+  // which says which files go up: a key sent only where it is taken can name one (`touch_icon`).
+  // ⛔ Until 2026-10-28 the probe went without them, so a touch icon was sent as the site path it
+  // was written as, and never uploaded.
+  const fields = await deploymentFields({
+    client,
+    siteDir,
+    offline: Boolean(output) || dryRun
+  })
+
   let assetRewrite = null
   let assetIds = null
   if (!output && !dryRun) {
@@ -453,9 +463,10 @@ export async function push(args = [], deps = {}) {
     let refusals = []
     try {
       const probe = await emitSyncPackages(siteDir, {
-      backend: client.origin,
-      // Placement identity for the folder — see writeFolderItemUuids.
-      folderItemUuids: readFolderItemUuids(siteDir, client.origin),
+        backend: client.origin,
+        ...fields,
+        // Placement identity for the folder — see writeFolderItemUuids.
+        folderItemUuids: readFolderItemUuids(siteDir, client.origin),
         ...(foundationDir ? { foundationDir } : {}),
         resolveModel: makeModelResolver({ client, offline: false, siteDir })
       })
@@ -553,11 +564,6 @@ export async function push(args = [], deps = {}) {
     output || dryRun
       ? readItemUuids(siteDir, client.origin)
       : await ensureItemUuids({ client, siteDir, note })
-  const fields = await deploymentFields({
-    client,
-    siteDir,
-    offline: Boolean(output) || dryRun
-  })
   // A foundation named by catalog ref — a clone's: its kept registered version types a query named
   // for a data key (`ensureRegisteredFoundation`). Offline, only what is already kept.
   if (!output && !dryRun) {

package/src/framework-index.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-10-28T03:03:01.883Z",
+  "generatedAt": "2026-10-28T04:08:25.023Z",
   "packages": {
     "@uniweb/api": {
       "version": "1.6.4"
     },
     "@uniweb/build": {
-      "version": "1.10.12"
+      "version": "1.10.13"
     },
     "@uniweb/content-reader": {
       "version": "1.5.7"