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.
|
|
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/
|
|
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": {
|
package/partials/agents.md
CHANGED
|
@@ -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
|
|
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 `
|
|
198
|
-
|
|
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) {
|
package/src/framework-index.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"generatedAt": "2026-11-
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
39
|
+
"version": "1.4.2"
|
|
40
40
|
},
|
|
41
41
|
"@uniweb/scene": {
|
|
42
42
|
"version": "1.0.1"
|