uniweb 1.26.2 → 1.26.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "uniweb",
3
- "version": "1.26.2",
3
+ "version": "1.26.3",
4
4
  "description": "Create structured Vite + React sites with content/code separation",
5
5
  "type": "module",
6
6
  "bin": {
@@ -41,15 +41,15 @@
41
41
  "js-yaml": "^4.3.2",
42
42
  "prompts": "^2.4.2",
43
43
  "tar": "^7.5.21",
44
- "@uniweb/core": "~1.6.2",
44
+ "@uniweb/content-writer": "~1.3.1",
45
+ "@uniweb/core": "~1.6.3",
45
46
  "@uniweb/semantic-parser": "~1.13.2",
46
- "@uniweb/schemas": "~1.6.7",
47
- "@uniweb/content-writer": "~1.3.1"
47
+ "@uniweb/schemas": "~1.6.7"
48
48
  },
49
49
  "peerDependencies": {
50
+ "@uniweb/build": "~1.15.2",
50
51
  "@uniweb/content-reader": "~1.5.8",
51
- "@uniweb/semantic-parser": "~1.13.2",
52
- "@uniweb/build": "~1.15.1"
52
+ "@uniweb/semantic-parser": "~1.13.2"
53
53
  },
54
54
  "peerDependenciesMeta": {
55
55
  "@uniweb/build": {
@@ -248,7 +248,7 @@ content = { title, pretitle, subtitle, paragraphs, links, images, icons, videos,
248
248
 
249
249
  **Backgrounds and theme are frontmatter.** `background:` takes an image, video, gradient, quoted color or palette token, or an object (`image`, `video`, `overlay`); `theme: light | medium | dark`, or a map with token overrides (`section: neutral-100`).
250
250
 
251
- **Pages.** `pages/<name>/` → `/<name>`. `page.yml`: `title`, `description`, `id`, `order`, `sections: [a, b, ...]`, `pages: [...]`, `nest`, `redirect`, `slug: { fr: … }`, `hidden` (draft; takes the pages below it), `hideIn` (nav only), `knowledge` (agent-only, never rendered — not a security control), `query` / `fetch`, `seo`, `layout`. `folder.yml` for a folder *of pages*. Numeric prefixes order sections; `2.5-x.md` slots between. Config cascades `page.yml → folder.yml → site.yml → foundation`. `layout/header.md`, `footer.md` render on every page — a markdown list is the nav, a standalone link the CTA, `yaml:nav` for richer menus. Child sections: `@child.md` + `nest: { parent: [child] }`.
251
+ **Pages.** `pages/<name>/` → `/<name>`; a name or `slug:` holding `?`, `#` or `%` stops the build. `page.yml`: `title`, `description`, `id`, `order`, `sections: [a, b, ...]`, `pages: [...]`, `nest`, `redirect`, `slug: { fr: … }`, `hidden` (draft; takes the pages below it), `hideIn` (nav only), `knowledge` (agent-only, never rendered — not a security control), `query` / `fetch`, `seo`, `layout`. `folder.yml` for a folder *of pages*. Numeric prefixes order sections; `2.5-x.md` slots between. Config cascades `page.yml → folder.yml → site.yml → foundation`. `layout/header.md`, `footer.md` render on every page — a markdown list is the nav, a standalone link the CTA, `yaml:nav` for richer menus. Child sections: `@child.md` + `nest: { parent: [child] }`.
252
252
 
253
253
  **`site.yml`.** `index`, `pages`, `foundation`, `extensions`, `paths`, `placeholders`, `languages`, `services`, `agents`, `seo` (`origin`: scheme + host, `image`: 1200×630), `favicon`, `touchIcon`. Everything in `site.yml` and `queries.yml` ships to the browser — **never a secret**.
254
254
 
@@ -137,15 +137,18 @@ A Tag Manager container needs nothing more, so don't present what follows as lim
137
137
  | `conversion` | a phone or email tap (`name: phone`, `email`); a link or page listed in `services.tracking.conversions`; a form accepted by a provider of the site's own through `useFormSubmit`; a sign-up through `@uniweb/api` |
138
138
  | `engagement` | a sign-in through `@uniweb/api` (`name: sign_in`) |
139
139
 
140
- A `services.tracking.conversions` list is public (it is in every page's data), so a listed link must not carry a token. **Don't write your own listener for any of these, and don't report a sign-up, sign-in or accepted form that goes through kit or `@uniweb/api`** — a second report double-counts.
140
+ A `services.tracking.conversions` list is public (it is in every page's data), so a listed link must not carry a token. `services.tracking.landing: [utm_source, utm_campaign, …]` makes every `conversion` carry those keys of the address the visitor arrived at, as `landing: { … }`, read once at arrival; name only what the collector needs, since a query can hold a search term or a token. **Don't write your own listener for any of these, and don't report a sign-up, sign-in or accepted form that goes through kit or `@uniweb/api`** — a second report double-counts.
141
141
 
142
142
  ```jsx
143
143
  block.track('video_milestone', { milestone: 50 }) // in a section type — attaches page path and section type
144
144
  block.track('conversion', { name: 'quote_requested' }) // what only your foundation can see that a site counts
145
+ trackAction(block, 'command_copied', params.copyConverts) // kit: a conversion if the author says so, else an engagement
145
146
  const { track } = useTracker() // elsewhere
146
147
  track('brochure_download', { file: 'specs.pdf' })
147
148
  ```
148
149
 
150
+ **Let the author choose what counts.** For each act a section can report that isn't a link (a copy, a video watched past halfway, a quote worked out), declare a boolean param in `meta.js` (`copyConverts: { type: 'boolean', label: 'Copying the command is a conversion', default: true }`), on by default only for what the section is for, and report the act with kit's `trackAction`. It sends each name once per page load, and the author names nothing. Name the act, the same in every section offering it (`command_copied`). Never add a param for a link: its address in `conversions` counts it wherever it appears, and both would count one click twice.
151
+
149
152
  Event names are yours; nine are already in use — the five above, `video_milestone` (kit's `<Media>`), `read_depth` (below), and `section_click` and `time_on_page` under `emit: all`. Put the varying part in a field, never in the name. Never guard a `track()` call: with no destination it does nothing and never throws.
150
153
 
151
154
  **`emit`** chooses what the site sends: `minimal` (`page_view`), `standard` (the default with your own endpoint: `page_view`, `outbound_click`, `section_view`), `all` (a standing yes, future events included), or a list of names. So with your own endpoint, `conversion` and `engagement` take `emit: all` or a list naming them; a `conversions` list turns on what it lists by itself. Needs no endpoint of its own — on a host-supplied collector, saying nothing sends whatever the host declares it collects, and naming `emit` pins it. `emit` never limits your own `track()` calls. **`flushIntervalMs`** widens the batching window (default 5000; `30` is thirty milliseconds).
@@ -194,8 +194,9 @@ export function serviceNotes({ siteYml, supports = null, warn = () => {} }) {
194
194
  }
195
195
  if (!Array.isArray(supports)) return notes
196
196
  // None of these is something a foundation renders: `google` and `tracking` load or report
197
- // whatever the foundation is, and `records` is invisible to it.
198
- const ignored = new Set(['tracking', 'records', 'google'])
197
+ // whatever the foundation is, `meta` and `x` hear its conversions from the host, and `records`
198
+ // is invisible to it.
199
+ const ignored = new Set(['tracking', 'records', 'google', 'meta', 'x'])
199
200
  const has = (ask) => ask.enabled !== false || typeof ask.config?.endpoint === 'string'
200
201
  const unrendered = asks.filter((a) => has(a) && !ignored.has(a.name) && !supports.includes(a.name)).map((a) => a.name)
201
202
  if (unrendered.length) {
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "generatedAt": "2026-11-03T03:27:46.780Z",
3
+ "generatedAt": "2026-11-03T21:24:25.282Z",
4
4
  "packages": {
5
5
  "@uniweb/api": {
6
6
  "version": "1.6.9"
7
7
  },
8
8
  "@uniweb/build": {
9
- "version": "1.15.1"
9
+ "version": "1.15.2"
10
10
  },
11
11
  "@uniweb/content-reader": {
12
12
  "version": "1.5.8"
@@ -15,7 +15,7 @@
15
15
  "version": "1.3.1"
16
16
  },
17
17
  "@uniweb/core": {
18
- "version": "1.6.2"
18
+ "version": "1.6.3"
19
19
  },
20
20
  "@uniweb/frame-bridge": {
21
21
  "version": "1.0.3"
@@ -24,7 +24,7 @@
24
24
  "version": "1.0.8"
25
25
  },
26
26
  "@uniweb/kit": {
27
- "version": "1.7.7"
27
+ "version": "1.7.8"
28
28
  },
29
29
  "@uniweb/loom": {
30
30
  "version": "1.1.3"
@@ -36,7 +36,7 @@
36
36
  "version": "1.2.11"
37
37
  },
38
38
  "@uniweb/runtime": {
39
- "version": "1.4.1"
39
+ "version": "1.4.2"
40
40
  },
41
41
  "@uniweb/scene": {
42
42
  "version": "1.0.1"