Skip to content

docs(frontend): correct statements and document Web Host 1.0.69 - #56

Draft
AndrewKirkovski wants to merge 4 commits into
mainfrom
fix/frontend-docs-verify-1.0.68
Draft

AndrewKirkovski wants to merge 4 commits into
mainfrom
fix/frontend-docs-verify-1.0.68

Conversation

@AndrewKirkovski

@AndrewKirkovski AndrewKirkovski commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

What changed

The English frontend pages were compared with the code of Web Host 1.0.68, @wippy-fe/* 0.0.68, facade 0.6.51 and the views module. This pull request corrects the statements that disagree with the code and moves the release baseline from 1.0.66 to 1.0.69. It also documents the managed-layout chat options that Web Host 1.0.69 added.

Web Host 1.0.69 managed layout (web-host/multi-panel-layout.md, all 8 locales)

  • @HOST/chat-wrapper options closable, emptyState and startToken, with an example, and how a coordinator tells a session pick from a finished start.
  • @HOST/panel-tab modes, including mode: 'auto'.
  • The wippy-host-app class on the managed root, so host-only CSS applies in managed mode.
  • A current but hidden page passes host.startChat(), openSession(), openArtifact() and navigate() to the coordinators.
  • Intent queues: each declared coordinator has its own queue and gets every intent once, in order. The page said the queue served only the first coordinator.
  • A release-map row for 1.0.69.

The source is the Host CHANGELOG.md section 1.0.69 and managed-layout.md at tag webcomponents-1.0.69.

Corrections that change what a reader does

Page Before Now
micro-frontend-app-theming, proxy-api, css-injection, proxy-isolation Set window.__WIPPY_CONFIG_OVERRIDES__ for runtime overrides The Host removed that global. Overrides come from meta.config_overrides or wippy.configOverrides and are merged by the host
css-injection, design-layer, web-component-theming, view-page The PrimeVue stylesheet also delivers Tailwind utilities It holds the .p-* component classes only. A module compiles the utilities it uses
view-page, registry-entries, quickstart title and icon from package.json are registry defaults The navigation list reads meta.title and meta.icon only. The Quickstart entry now sets both
micro-frontend-app-theming, proxy-api Only cssVariables is replaced; axiosDefaults and apiRoutes are deep merged A page customCSS also replaces the facade CSS. axiosDefaults merges one level deep. apiRoutes is replaced
entry-point allowSelectModel, hideSessionSelector, allowAdditionalTags are hostConfig fields They are root fields under the default policy. host_policy_mode is described
debugging css_variables written as a YAML map A JSON string, which is what the facade parameter accepts
registry-entries The <base> tag is <url>/<base_path>/ It also includes the directory of the entry file
view-page An inline page is hidden from all listings An announced inline page stays in the list API with hidden: 1

Corrections to examples and reference details

  • proxy-api: movePanel uses a valid position value. The @history payload shows navId.
  • packages, multi-panel-layout: the WippyElement examples read the typed host with getWippyHost<...>(this), and useEvents takes its event map. The examples now pass a strict type-check against the published packages.
  • view-component: wippy.props is needed by loadWebComponent(). The entry default comes from the top-level browser field.
  • micro-frontend-app-theming: the schema name is wippy-context-2.2.
  • css-injection: the iframe stylesheet order is themeConfig, iframe, primevue, markdown. An omitted proxy block enables every injection.
  • micro-frontend-app: the PrimeVue plugin uses the named import, the same form as the other two recipes.

Baseline

The current-release version mentions now name 1.0.69 and 0.0.69, and the facade pages name facade 0.6.52, which selects Host 1.0.69. The corrections above were checked against 1.0.68; the 1.0.69 changelog changes none of those areas. The pins in scripts/check-frontend-docs.mjs follow. Version mentions that pair with a fixed tested set stay as they are: the facade tutorial (facade 0.6.46 with Host 1.0.66) and attention-quickstart.md (1.0.67).

How to verify

node scripts/check-frontend-docs.mjs
node scripts/check-attention-context-docs.mjs
node scripts/check-markdown-links.mjs

All three pass on this branch.

Evidence for the two largest corrections:

  • window.__WIPPY_CONFIG_OVERRIDES__: the Web Host source at tag webcomponents-1.0.68 has no reference to it, and its changelog records the removal. The merge is in src/shared/app-config/migration.ts (buildChildPayload).
  • Tailwind utilities: https://web-host.wippy.ai/webcomponents-1.0.68/@wippy-fe/assets/tailwind.css has 828 distinct leading class names, and 826 of them start with p-.

Known gaps

  • Other locales. The 1.0.69 managed-layout content is in all 8 locales. The corrections above are in English only. Other locale pages lag behind English (their release maps stop at 1.0.52); only their version numbers moved here, and their other text was not checked again.
  • Left at 1.0.66: cdn-assets.md (not reviewed), statements about what a feature did in 1.0.66 in chat-web-components.md, packages.md and entry-point.md, and the two generated catalogue pages, which need the generator.
  • Open question. A comment in the views module (api/fragment_service.lua) also says the PrimeVue asset carries Tailwind utilities. This pull request documents what the built file contains. If the Host is meant to ship utilities, that point should be fixed in the Host build and reverted here.
  • Not changed: the @message row in proxy-api.md lists four subscription patterns and the code subscribes to three. Which side is wrong is not decided.

The English frontend pages were compared with Web Host 1.0.68,
@wippy-fe/* 0.0.68, facade 0.6.51 and the views module. This change
corrects the statements that disagree with the code and moves the
release baseline from 1.0.66 to 1.0.68.

Corrections that changed behavior for a reader who follows the docs:
- window.__WIPPY_CONFIG_OVERRIDES__ is removed from four pages. The Host
  merges page overrides before it sends config to the page and no longer
  reads that global.
- The PrimeVue stylesheet holds the .p-* component classes only. It does
  not deliver Tailwind utilities; a module compiles its own.
- The navigation list reads title and icon from the registry entry only.
  The Quickstart entry now sets both.
- A page customCSS replaces the facade CSS for that page. axiosDefaults
  is merged one level deep and apiRoutes is replaced.
- allowSelectModel, hideSessionSelector and allowAdditionalTags are root
  fields of the facade response under the default policy.
- css_variables in the debugging page is a JSON string, not a YAML map.
- The base tag includes the directory of the entry file.
- An announced inline page stays in the list API with hidden: 1.

Corrections to examples and reference details:
- movePanel uses a valid position value.
- WippyElement examples read the typed host with getWippyHost, and
  useEvents takes its event map, so the examples pass a type-check.
- wippy.props is needed by loadWebComponent; the component entry default
  comes from the top-level browser field.
- Schema name 2.2, iframe injection order, the @history payload, and one
  PrimeVue plugin import form.

Baseline: version statements that were checked again at 1.0.68 now name
1.0.68 and 0.0.68. The checker pins follow. Because the checker pins
packages.md and web-host/overview.md in every locale, the version numbers
on those two pages move in all locales; no other text in other locales
changes.

Left as they are: statements about what a feature did in 1.0.66 that were
not checked again, the cdn-assets page, and the two generated catalogue
pages, which still say they were generated from theme 0.0.66.
Multi-panel layout (all locales):
- Add the @HOST/chat-wrapper options closable, emptyState and startToken, including how a coordinator tells a selector pick from a finished start.
- Add the @HOST/panel-tab mode 'auto'.
- Document the wippy-host-app class on the managed root.
- State that a current but hidden page's startChat/openSession/openArtifact/navigate calls reach the coordinators, and that chat-wrapper is not visible for attention while its column is collapsed.
- Add a 1.0.69 row to the release map.

Move current-release mentions from 1.0.68 to 1.0.69 and from 0.0.68 to 0.0.69 (and the 1.0.66 pins in the non-English build-system, host-less-mode and multi-panel-layout pages). Update the facade default Host URL and the current facade version (0.6.52) in framework/facade.md and cdn-assets.md, and the version pins in scripts/check-frontend-docs.mjs.
Since Web Host 1.0.69 each declared coordinator has its own bounded queue (32 intents) and receives every intent once, in the order raised. A coordinator that subscribes first does not use up the intents of the others, a coordinator that never mounts blocks no one, an intent whose page was replaced while it waited is discarded, and a declaration with no coordinators entry queues nothing.

Replace the "held until the first coordinator subscribes" statements in the multi-panel layout page, in all locales.
@AndrewKirkovski AndrewKirkovski changed the title docs(frontend): correct statements against Web Host 1.0.68 docs(frontend): correct statements and document Web Host 1.0.69 Nov 13, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant