- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
5.8 KiB
Executable File
markup, title, description, import
| markup | title | description | import | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| occlusion | ext/web/client | Browser Runtime helpers (WASM bridge). Prefer lib/browser for effect tables (ADR 0007). |
|
Browser helpers describe the official Marqdo WASM bridge and small effects. They construct text/maps without a native server. Keep initial page layout in layout components, and use lib/browser for client logic.
marqdo call ext/web/client/index.mq.md embed --json
marqdo call ext/web/client/index.mq.md text_patch 'sel="#status"' 'text="Ready"' --json
The bridge and WASM assets must actually be hosted at the chosen URLs. embed returns a loading descriptor; it does not install assets or implement business JavaScript. Native HTML snippets here are runtime integration, not an invitation to put complete navigation/footer markup in authored content. Changes require browser bridge tests and matching Chinese entry points.
embed
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| bridge | text | "/static/marqdo-bridge.js" | bridge script URL |
| wasm | text | "/static/marqdo_wasm.wasm" | wasm URL |
| source | text | "" | optional source URL |
| boot | bool | True | auto boot |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | HTML script tag |
Use bridge="/static/marqdo-bridge.js", wasm="/static/marqdo_wasm.wasm", source="", boot=True as the inputs for this operation.
HTML snippet that loads the official browser Marqdo bridge (route C/D). Defaults:
bridge="/static/marqdo-bridge.js", wasm="/static/marqdo_wasm.wasm",
source="", boot=True . With boot and non-empty source, auto-mounts. No author
JS. Not a substitute for file-partitioned Document layout.
We bridge = Escape the bridge URL as an attribute value and wasm = Escape the WASM URL as an attribute value and source = Escape the client source URL as an attribute value.
bootsource!= "" Return "<script type="module" src="" + bridge + "" data-mq-wasm="" + wasm + "" data-mq-source-url="" + source + ""></script>".-
-
text_patch
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| sel | text | required | CSS selector |
| text | text | required | text content |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | effects map |
Use sel, text as the inputs for this operation.
Build a set_text effects map for selector sel with string text. Prefer
lib/browser in client .mq.md programs; this helper is for call-side sketches.
We retain m = [Return the updated structured value](table.put(in=None, at=sel, value=text)).
Return [Set the set_text field in the new record](table.put(in=None, at="set_text", value=m)).
dom_patch
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| sel | text | required | CSS selector |
| html | text | "" | optional HTML |
| attrs | any | None | optional attrs map |
| remove | bool | False | remove node |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | effects map |
Use sel, html="", attrs=None, remove=False as the inputs for this operation.
Build a dom effects map for selector sel. Optional html="", attrs=None,
remove=False . Prefer View/Markdown over raw html patches for page shells.
We retain spec = [Set the html field in the new record](table.put(in=None, at="html", value=html)).
attrsWe retainspec= [Set the attrs field in the new record](table.put(in=spec, at="attrs", value=attrs)).-
_ = 1
removeWe retainspec= [Set the remove field in the new record](table.put(in=spec, at="remove", value=True)).-
_ = 1
We retain m = [Return the updated structured value](table.put(in=None, at=sel, value=spec)).
Return [Set the dom field in the new record](table.put(in=None, at="dom", value=m)).
nodes
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| bridge | text | "/static/marqdo-bridge.js" | URL of the official browser bridge |
| wasm | text | "/static/marqdo_wasm.wasm" | URL of the built WASM artifact |
| source | text | "" | Optional Marqdo client program URL |
| boot | bool | True | Whether the bridge automatically mounts the client |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | list | Structured script Resource rows for a component Document |
Use bridge="/static/marqdo-bridge.js", wasm="/static/marqdo_wasm.wasm", source="" and boot=True in a component tree. The resource references the official bridge as a module and retains the WASM and source addresses as typed attributes. Boot with a nonempty source mounts that Marqdo program; boot=False declares the bridge without automatic mounting. This pure tool creates no server, downloads nothing and writes no JavaScript or HTML. Build the current WASM artifact and mount the actual static directory before serving the page. Prefer these rows to embed when a Document already returns View nodes; embed remains a compatibility string adapter.
attributes =
| type | data-mq-wasm |
|---|---|
| module | wasm |
bootandsource!= "" We attributes = [Declare the client program to mount](table.put(in=attributes, at="data-mq-source-url", value=source)).- not
bootWe attributes = [Keep automatic mounting disabled](table.put(in=attributes, at="data-mq-no-boot", value="1")). Return [Declare the official bridge as a structured resource](component.asset(url=bridge, attrs=attributes, slot="marqdo-runtime")).