uniweb 0.48.2 → 0.48.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.48.2",
+  "version": "0.48.4",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,15 +41,15 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/core": "^0.24.2",
-    "@uniweb/kit": "^0.18.0",
-    "@uniweb/semantic-parser": "^1.4.0",
-    "@uniweb/runtime": "^0.19.3"
+    "@uniweb/core": "^0.24.3",
+    "@uniweb/kit": "^0.18.1",
+    "@uniweb/runtime": "^0.19.4",
+    "@uniweb/semantic-parser": "^1.4.0"
   },
   "peerDependencies": {
-    "@uniweb/build": "^0.44.1",
     "@uniweb/content-reader": "^1.2.4",
-    "@uniweb/semantic-parser": "^1.4.0"
+    "@uniweb/semantic-parser": "^1.4.0",
+    "@uniweb/build": "^0.44.3"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -716,7 +716,7 @@ Measured on exactly that shape: **the agent corpus holds every page; the public
 - **A static host** (`uniweb export`, `deploy --host`) drops every page — they have no reader there — and you get an empty SPA shell. The build still says *"complete"*, because 0 pages is not an error: it reports `Collected 0 pages` and pre-renders none.
 - **A backend-hosted deployment that does not offer the service.** Whether an agent endpoint exists is the host's to decide, per site — it is not implied by deploying successfully.
 
-⇒ **The way to know is to ask, at render:** `resolveService(website, 'assistant')` returns a `url` only where the host declared one. On a site that is *only* knowledge there is no component to ask — so confirm with your host that the agent is enabled for that site before you build an integration against it. If you meant to build an agent endpoint and got silence, this is where to look.
+⇒ **The way to know is to ask, at render:** `isAssistantEnabled()` from `@uniweb/kit` is true only where an agent endpoint is declared. On a site that is *only* knowledge there is no component to ask — so confirm with your host that the agent is enabled for that site before you build an integration against it. If you meant to build an agent endpoint and got silence, this is where to look.
 
 ### Your site is readable by agents, automatically
 
@@ -1904,7 +1904,26 @@ A form gets its destination from the first of these that applies:
 
 That is the general arrangement, not a forms-only one. A host declares
 everything it offers under `services`, keyed by name, and every service resolves
-by the same rule — your declaration, then the host's, then neither:
+by the same rule — your declaration, then the host's, then neither.
+
+⭐ **Before you render UI for a service, ask whether the site has it** — one predicate per service,
+no arguments: `isSearchEnabled()`, `isSubmitEnabled()`, `isApiEnabled()`, `isAssistantEnabled()`,
+`isTrackingEnabled()`.
+
+```jsx
+import { isSearchEnabled } from '@uniweb/kit'
+
+if (!isSearchEnabled()) return null   // false ⇒ draw nothing
+```
+
+Each answers the same question — *would UI for this service work on this site?* — and `false`
+always means the same thing: **draw nothing.** `isSearchEnabled()` is true whenever *any* provider
+answers, including the prebuilt index a static site ships, so a search box gated on it appears
+wherever search works. The hooks that draw a feature hand you the same answer as a field
+(`useSearch().isEnabled`, `useFormSubmit().canSubmit`), so a component already using one needs
+nothing extra.
+
+When you need the **address** itself, not just whether one exists, ask for it:
 
 ```jsx
 import { resolveService } from '@uniweb/kit'
@@ -1914,7 +1933,8 @@ const { url, source } = resolveService(website, 'assistant')   // or 'search', o
 
 **The name is open**: the framework ships clients for what it implements and
 resolution for anything, so a foundation can define a service the framework has
-never heard of and a host can fill it. Same escalation `fetcher.transports`
+never heard of and a host can fill it — ask for it with
+`website.isServiceEnabled('booking')`. Same escalation `fetcher.transports`
 offers for data.
 
 **Building an "Ask AI" component?** The service name is `assistant`, and a host that runs an agent for a site typically serves it at the conventional path `/_agent`. **You should never need to write that path** — ask the runtime instead:
@@ -1936,7 +1956,7 @@ if (!url) return null          // this site has no agent — render nothing, or
 
 ### Declaring what your foundation supports
 
-`resolveService` is how you ask at render time. The other direction — telling a
+The predicates above, and `resolveService`, are how you ask at render time. The other direction — telling a
 host, *before* anything renders, which services your foundation is built to use —
 is one line in the foundation's `package.json`:
 
@@ -1953,23 +1973,24 @@ against it.** A host that offers search has no way to know whether your sections
 draw a search box, so without this it either offers a site something its code
 will ignore, or withholds something it would have used.
 
-**Three states, and they are three different answers:**
+**What a host receives is one of three answers:**
 
 | | |
 |---|---|
-| the key is **absent** | *unknown* — nobody said. Not a refusal |
-| `"supports": []` | an explicit *none* — this foundation honours no host service |
-| `"supports": ["search"]` | these, and only these |
+| a list — `["search"]` | the services this foundation renders against, and only these |
+| `[]` | none — proven by the build, not assumed |
+| absent | *unknown* — the build could not tell, and nothing was declared |
 
-⛔ **Nothing is assumed on your behalf**, in either direction. An unstated set is
-never read as "all" and never as "none", so the only way a host learns your
-search box exists is that you said so.
+⭐ **The build reads the set off your code.** When the foundation is built, `supports` is derived
+from what the bundle actually reaches — `resolveService(website, 'search')`, or a predicate like
+`isSearchEnabled()` — so a foundation that never writes the key still publishes an accurate set.
+What you write in `package.json` is a **supplement**: the build publishes the union, so a
+declaration can add a service but never remove one the code reaches.
 
-**List what you actually integrate.** `uniweb doctor` warns when your source
-reaches for a service you did not list — but it reads your code with a pattern
-matcher, so it sees `resolveService(website, 'search')` and misses a service
-reached through a variable or a helper. It can tell you that you forgot one; it
-cannot promise it found them all. The declaration is yours to keep accurate.
+**Declare only what the build cannot see.** A service reached through a *computed* name —
+`resolveService(website, name)` where `name` is a variable — is invisible to it, and the build
+warns when that happens. List those. `uniweb doctor` compares what you declared with what the build
+found.
 
 ⚖️ **Baseline behaviour is not yours to declare.** Some services do something for
 a site whether or not a foundation cooperates — the runtime reports page views
@@ -2253,8 +2274,8 @@ happened into a journey.
 Everything above reaches the runtime through `@uniweb/kit` or through something
 handed to your component as a prop. That is the rule, not a stylistic preference:
 
-- ✅ `useWebsite()`, `useTracker()`, `resolveService(website, …)` — kit hooks and
-  utilities.
+- ✅ `useWebsite()`, `useTracker()`, `isSearchEnabled()` and the other service
+  predicates, `resolveService(website, …)` — kit hooks and utilities.
 - ✅ `block.track(…)`, `block.page`, `block.website` — the block **arrives in your
   props**, so calling methods on it is not reaching for a global.
 - ⛔ `globalThis.uniweb`, `window.uniweb` — never, in a foundation.
@@ -2317,9 +2338,10 @@ npm install @uniweb/api      # in the FOUNDATION, beside @uniweb/kit
 ### Ask before you draw
 
 ```jsx
-import { isEnabled, useSession, SignedIn, SignedOut } from '@uniweb/api'
+import { isApiEnabled } from '@uniweb/kit'
+import { useSession, SignedIn, SignedOut } from '@uniweb/api'
 
-if (!isEnabled(website)) return <StaticVersion />   // synchronous — nothing to await
+if (!isApiEnabled()) return <StaticVersion />   // synchronous — nothing to await
 ```
 
 ⛔ **When there is no backend, draw nothing** — not a disabled control, and not an

package/src/commands/doctor.js

@@ -506,13 +506,13 @@ export async function checkFoundationSupports({
  * box that searches nothing, a form whose answers have nowhere to go.
  */
 const SERVICE_GATES = [
-  { hook: 'useFormSubmit', gate: 'canSubmit', draws: 'a form' },
-  { hook: 'useSearch', gate: 'isEnabled', draws: 'a search control' },
-  { hook: 'useSearchIndex', gate: 'isEnabled', draws: 'a search control' },
+  { hook: 'useFormSubmit', gate: 'canSubmit', alt: 'isSubmitEnabled', draws: 'a form' },
+  { hook: 'useSearch', gate: 'isEnabled', alt: 'isSearchEnabled', draws: 'a search control' },
+  { hook: 'useSearchIndex', gate: 'isEnabled', alt: 'isSearchEnabled', draws: 'a search control' },
   // Returns everything `useSearch` does, `isEnabled` included, so it gates the
   // same way. It was missing from this list until the hook was renamed out of
   // `useSearchWithIntent` — the kind of gap a list of names grows quietly.
-  { hook: 'useSearchPrefetch', gate: 'isEnabled', draws: 'a search control' },
+  { hook: 'useSearchPrefetch', gate: 'isEnabled', alt: 'isSearchEnabled', draws: 'a search control' },
 ]
 
 /**
@@ -535,7 +535,12 @@ const SERVICE_GATES = [
  *
  *   - it is **local to one file** — the hook call and its gate are in the same
  *     component, in the developer's own source, with no indirection to follow;
- *   - the gate names are **fixed by kit's API**, not inferred;
+ *   - the gate names are **fixed by kit's API**, not inferred — with one caveat
+ *     that used to be a live false negative: `isEnabled` is a hook's returned
+ *     field AND, until 2026-09-10, an `@uniweb/api` export. A component holding
+ *     both read as gated. `@uniweb/kit`'s `is<Service>Enabled()` predicates are
+ *     unique per subject, so `alt` below is matched instead and the collision
+ *     cannot recur;
  *   - it only ever **warns**, and changes no artifact. A miss costs a missing
  *     warning, which is the safe direction.
  *
@@ -568,11 +573,15 @@ export function checkUngatedServiceControls({ foundationName, folderName, srcDir
 
   forEachSourceFile(srcDir, (raw, file) => {
     const text = stripComments(raw)
-    for (const { hook, gate, draws } of SERVICE_GATES) {
+    for (const { hook, gate, alt, draws } of SERVICE_GATES) {
       // A call, not merely an import: re-exporting a hook is not drawing with it.
       if (!new RegExp(`\\b${hook}\\s*\\(`).test(text)) continue
+      // Either the hook's own returned field, or kit's standalone predicate for
+      // the same service — both are the gate, and a component that reads one
+      // does not need the other.
       if (new RegExp(`\\b${gate}\\b`).test(text)) continue
-      found.push({ file, hook, gate, draws })
+      if (alt && new RegExp(`\\b${alt}\\s*\\(`).test(text)) continue
+      found.push({ file, hook, gate, alt, draws })
     }
   })
 
@@ -592,6 +601,7 @@ export function checkUngatedServiceControls({ foundationName, folderName, srcDir
     log(`    control cannot work. Gate on it instead:`)
     log(`      ${colors.dim}const { ${f.gate} } = ${f.hook}(…)${colors.reset}`)
     log(`      ${colors.dim}if (!${f.gate}) return null${colors.reset}`)
+    if (f.alt) log(`    ${colors.dim}…or ${f.alt}() from @uniweb/kit, which needs no hook.${colors.reset}`)
   }
 }
 

package/src/framework-index.json

@@ -1,16 +1,16 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-09-09T22:45:28.403Z",
+  "generatedAt": "2026-09-10T14:59:00.380Z",
   "packages": {
     "@uniweb/api": {
-      "version": "0.2.13",
+      "version": "0.3.0",
       "path": "framework/api",
       "deps": [
         "@uniweb/core"
       ]
     },
     "@uniweb/build": {
-      "version": "0.44.1",
+      "version": "0.44.3",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -34,7 +34,7 @@
       "deps": []
     },
     "@uniweb/core": {
-      "version": "0.24.2",
+      "version": "0.24.3",
       "path": "framework/core",
       "deps": [
         "@uniweb/semantic-parser",
@@ -54,7 +54,7 @@
       ]
     },
     "@uniweb/kit": {
-      "version": "0.18.0",
+      "version": "0.18.1",
       "path": "framework/kit",
       "deps": [
         "@uniweb/core",
@@ -74,7 +74,7 @@
       "deps": []
     },
     "@uniweb/projections": {
-      "version": "0.5.13",
+      "version": "0.6.0",
       "path": "framework/projections",
       "deps": [
         "@uniweb/content-writer",
@@ -82,7 +82,7 @@
       ]
     },
     "@uniweb/runtime": {
-      "version": "0.19.3",
+      "version": "0.19.4",
       "path": "framework/runtime",
       "deps": [
         "@uniweb/core",
@@ -110,7 +110,7 @@
       "deps": []
     },
     "@uniweb/templates": {
-      "version": "0.12.2",
+      "version": "0.12.3",
       "path": "framework/templates",
       "deps": []
     },