dsh-motion-ui 0.6.0 → 0.7.1
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/CHANGELOG.md +88 -0
- package/README.md +55 -1
- package/VERIFICATION.md +46 -0
- package/client.js +2136 -1095
- package/examples/mechanism-assembly.json +50 -0
- package/examples/mechanism-crank.json +103 -0
- package/examples/mechanism-gears.json +103 -0
- package/index.js +132 -106
- package/lib/assets/standalone-runtime.js +3 -1
- package/lib/assets/visual.js +3 -1
- package/lib/author-expression.js +9 -8
- package/lib/authoring-guide.js +3 -16
- package/lib/build-info.js +1 -1
- package/lib/canvas-design.js +2 -2
- package/lib/canvas-system.js +1 -1
- package/lib/catalog.js +5 -6
- package/lib/components.js +2 -2
- package/lib/delivery.js +1 -1
- package/lib/export-runtime-bundle.js +1 -1
- package/lib/expressive-examples.js +6 -0
- package/lib/fence-feedback.js +8 -2
- package/lib/freeform.js +4 -9
- package/lib/inspection.js +11 -6
- package/lib/mechanism-catalog.js +24 -0
- package/lib/mechanism-css.js +13 -0
- package/lib/mechanism-entry.js +20 -0
- package/lib/mechanism-geometry.js +62 -0
- package/lib/mechanism-render.js +24 -0
- package/lib/mechanism-runtime-bundle.js +2 -0
- package/lib/mechanism-scenes.js +20 -0
- package/lib/motion-library.js +17 -0
- package/lib/normalize-authoring.js +15 -2
- package/lib/prompt-contract.js +22 -0
- package/lib/protocol.js +26 -11
- package/lib/refinement.js +3 -2
- package/lib/sandbox.js +2 -0
- package/lib/scene-entry.js +41 -0
- package/lib/style-system.js +28 -0
- package/lib/text-guide.js +9 -13
- package/lib/third-party/anatomy-LICENSE.txt +21 -0
- package/lib/third-party/anatomy-NOTICE.md +13 -0
- package/lib/third-party/anatomy-iso.mjs +674 -0
- package/lib/third-party/lucian-uxui-LICENSE.txt +21 -0
- package/lib/third-party/lucian-uxui-NOTICE.md +1 -0
- package/lib/third-party/taste-skill-NOTICE.md +10 -0
- package/lib/tool-schema.js +9 -9
- package/lib/ui-intent.js +4 -15
- package/lib/ui-skill.js +19 -25
- package/lib/visual-audit.js +15 -4
- package/lib/visual-styles.js +134 -22
- package/package.json +92 -92
- package/skills/intelligent-ui/SKILL.md +22 -102
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Seokwoooo
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
Motion UI expressive controls adapt visual interaction patterns and selected CSS from Lucian UX/UI Prompt #002, #013, #018, by Seokwoooo, MIT License. Reference: https://github.com/Seokwoooo/lucian-uxui-prompt . Local user-provided copies were reviewed. Host actions, persistence, React controls and truthful result feedback are implemented by Motion UI. No simulated download, clipboard success or glass materials are included.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Taste Skill design guidance reference
|
|
2
|
+
|
|
3
|
+
Motion UI's compact guidance is an original adaptation of general ideas from
|
|
4
|
+
https://github.com/Leonxlnx/taste-skill: content-driven composition, hierarchy,
|
|
5
|
+
substantive simplicity, useful interactions and honest visual review.
|
|
6
|
+
|
|
7
|
+
Reviewed 2026-10-14: skills/taste-skill/SKILL.md and gpt/soft/minimalist variants.
|
|
8
|
+
No upstream scripts or skill text, randomized website workflow, mandatory imagery,
|
|
9
|
+
marketing structure or fixed aesthetic bans are bundled or executed. Motion UI
|
|
10
|
+
retains its own style selection, sandbox contracts and conversation delivery.
|
package/lib/tool-schema.js
CHANGED
|
@@ -4,14 +4,14 @@ import {COMPONENTS} from './components.js';
|
|
|
4
4
|
const dictionary=description=>({type:'object',additionalProperties:true,description});
|
|
5
5
|
export const DOCUMENT_PARAMETER={
|
|
6
6
|
required:true,
|
|
7
|
-
description:'
|
|
7
|
+
description:'Complete v1 {version:1,title,fallback,nodes,state?,derived?} OR extended {title,items:[components]}. No mixed roots, partial patches or serialized JSON. State alone creates no controls.',
|
|
8
8
|
type:'object',additionalProperties:false,
|
|
9
9
|
properties:{
|
|
10
10
|
version:{type:'number',const:1},
|
|
11
11
|
title:{type:'string',required:true},
|
|
12
12
|
fallback:{type:'string',description:'Required for v1 nodes: useful plain-text explanation if UI is unavailable.'},
|
|
13
|
-
items:{type:'array',description:'Extended
|
|
14
|
-
nodes:{type:'array',items:{type:'object',additionalProperties:true,properties:{
|
|
13
|
+
items:{type:'array',description:'Extended fields: ui_catalog topic=visual.',items:{type:'json'}},
|
|
14
|
+
nodes:{type:'array',description:'REQUIRED for version:1: all visible nodes and control nodes, in this same call. Never submit only state/derived.',items:{type:'object',additionalProperties:true,properties:{
|
|
15
15
|
id:{type:'string',required:true,description:'Unique letter/underscore identifier; Chinese supported, max64.'},
|
|
16
16
|
type:{type:'string',required:true,enum:Object.keys(COMPONENTS)},
|
|
17
17
|
spec:{type:'json',description:'visual only: extended {title?,items:[components]} composition.'},stateKey:{type:'string',description:'visual only: optional dedicated json state key, auto-created when omitted.'},warnings:{type:'json'},
|
|
@@ -26,19 +26,19 @@ export const DOCUMENT_PARAMETER={
|
|
|
26
26
|
spans:{type:'json',description:'text/heading: array of {text,size?,weight?,color?}; use instead of text for inline emphasis.'},gap:{type:'number'},
|
|
27
27
|
max:{type:'json',description:'progress only: positive numeric value or binding.'},unit:{type:'string'},decimals:{type:'number'},
|
|
28
28
|
action:{type:'string',description:'button only: a key declared in document.actions.'},
|
|
29
|
-
href:{type:'string',description:'link/button: absolute http/https URL. Choose exactly one href/path/action.'},path:{type:'string',description:'link/button: local file path opened through DSH on user click; never a shell command.'},variant:{type:'string',enum:['primary','secondary','text']},
|
|
29
|
+
href:{type:'string',description:'link/button: absolute http/https URL. Choose exactly one href/path/action.'},path:{type:'string',description:'link/button: local file path opened through DSH on user click; never a shell command.'},variant:{type:'string',enum:['primary','secondary','text','dropdown','segmented']},
|
|
30
30
|
kind:{type:'string',enum:['bar','line']},labelKey:{type:'string'},valueKey:{type:'string'},xScale:{type:'string'},
|
|
31
31
|
html:{type:'string'},css:{type:'string'},script:{type:'string'},fallback:{type:'string'},height:{type:'number'},
|
|
32
|
-
stateKeys:{type:'array',items:{type:'string'}},dataKeys:{type:'array',items:{type:'string'}},derivedKeys:{type:'array',items:{type:'string'}},
|
|
32
|
+
libraries:{type:'array',items:{type:'string',enum:['mechanism']},description:'Optional local mechanism drawing helper; ui_catalog topic=mechanism.'},stateKeys:{type:'array',items:{type:'string'}},dataKeys:{type:'array',items:{type:'string'}},derivedKeys:{type:'array',items:{type:'string'}},
|
|
33
33
|
text:{type:'json',description:'Literal scalar or {ref}/{expr}.'},
|
|
34
34
|
value:{type:'json',description:'metric: number or display string/boolean, or {ref}/{expr}. progress: numeric.'},
|
|
35
|
-
rows:{type:'json',description:'table/chart: inline
|
|
35
|
+
rows:{type:'json',description:'table/chart: inline object rows, including {ref}/{expr} cells, or data/derived rows binding. No map needed for a short breakdown.'},
|
|
36
36
|
columns:{type:'json',description:'table: column object array; row: optional integer 1..4 for equal grid columns.'},
|
|
37
37
|
bind:{type:'string',description:'Controls bind state.key.'},children:{type:'array',description:'row/column/card/details: array of registered nodes using the same fields and type-specific rules. steps uses items instead of children.',items:{type:'json'}}
|
|
38
38
|
}}},
|
|
39
|
-
state:dictionary('
|
|
39
|
+
state:dictionary('Typed states, e.g. {people:{type:"number",default:2,min:1,max:12,step:1}}. Use numeric bounds/defaults, direct options arrays; json stores bounded canvas arrays/objects.'),
|
|
40
40
|
data:dictionary('Static data; Chinese identifier keys supported. Omit if rows are inline.'),
|
|
41
|
-
derived:dictionary('Local formulas, e.g. {food:{expr:"state.people * state.days * 100"}}.
|
|
41
|
+
derived:dictionary('Local formulas, e.g. {food:{expr:"state.people * state.days * 100"}}. round/ceil/floor/abs take one argument. Other expression forms/maps: ui_catalog topic=native. Omit unused derived.'),
|
|
42
42
|
actions:dictionary('Declared agent.followup actions. Omit when unused.'),
|
|
43
43
|
presentation:dictionary('Optional layout/accent/density and preset: reading/brief/comparison/list/callout/scorecard/flow/minimal. Every document owns its own styles.')
|
|
44
44
|
}
|
|
@@ -47,4 +47,4 @@ export const DOCUMENT_PARAMETER={
|
|
|
47
47
|
// Keep the native transport schema shallow. A recursively expanded union of
|
|
48
48
|
// every component makes the lightweight tool harder to call; the shared
|
|
49
49
|
// runtime validator still enforces exact component fields and limits.
|
|
50
|
-
export const TEXT_BLOCKS_PARAMETER={type:'array',required:true,items:{type:'json'},description:'Direct array of
|
|
50
|
+
export const TEXT_BLOCKS_PARAMETER={type:'array',required:true,items:{type:'json'},description:'Direct array of strings/native nodes with optional IDs, e.g. [{type:"text",text:"Answer"}]. steps uses items:[{title,description?}], layouts use children:[nodes]. Copyable text: copyable:true; code:{type:"code",lang,code}. Keep styling/content inside blocks. No JSON string or {item:[...]} wrapper.'};
|
package/lib/ui-intent.js
CHANGED
|
@@ -1,15 +1,4 @@
|
|
|
1
|
-
// Shared behavior,
|
|
2
|
-
export const UI_INTENT_POLICY
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
- 用户明确要求交互界面、图解或动画:交付对应 UI;已要求纯文字、不要界面、只给代码时遵从用户。
|
|
6
|
-
- 用户没提 UI,但问题的关键是参数变化如何影响结果、多个方案的权衡、时间趋势、空间结构或流程关系:当图形或操作比文字明显更易懂时主动使用 UI。不能只因出现数字、多个条目或技术名词就触发。
|
|
7
|
-
- 简单事实、单次数值换算、短定义、普通代码排错:直接文字。一个静态小表格足够时不必创建交互应用;静态图解、方案对比、流程和看板也都是 UI 的正常用途。不确定有无收益时选更简单的表达,不询问“要不要我做个 UI”。
|
|
8
|
-
对照:问“复利是什么,简短解释”→文字;问“5万元按3%、5%、7%存10年,为什么后期差距更大”→可主动给增长曲线与年数调整,配准确数值和简短解释;问“解释七速自行车各档如何影响踏频和行进”→可主动给传动示意与档位选择;问“1 GiB是多少字节”→文字。例子只指导时机,不规定构图或配色。
|
|
9
|
-
每块界面只解决一个核心关系;一轮回复可按讲解顺序生成多块独立界面。立即选择最小完整方案并调用工具,不穷举设计选项,不先写长篇视觉规划,不等待“完美”再提交。每块默认用一幅静态主图、一个短流程、一个对齐对比或一个简洁看板即可;没有明确交互收益时不建 state、不写 script、不加控件和动画。静态可视化本身就是完整交付;只有用户需要操作时才保证对应交互。用户的必要要求不能省略。
|
|
10
|
-
仅数值试算优先原生组件;计算超出 derived 白名单(例如幂、三角函数)时不要臆造算子或堆复杂表达式,改用小画布中的单一计算函数同步图与数值。结构或运动讲解选择一块自由画布,直接使用 render_canvas 的独立源码字段。避免首次创建多页应用、自制组件库或庞大绘图引擎。除非用户或宿主另有要求,对话内的简短交互讲解无需建立项目、编辑文件或制定任务清单。工具提交前检查绑定、初始图可见、改变参数有反馈、标签/单位和 fallback;不为简单任务反复读全部目录。
|
|
11
|
-
必要的布局与排版从首次提交就做好:DSH 以 PC 横屏为主要使用场景,优先保证 1365px/1920px 桌面视口中实际聊天区域的构图与可读性,不假设画布等于整个浏览器宽度。主体突出、文字可读、控件有标签,装饰不挤占内容;手机适配是补充,不为窄屏牺牲桌面主体。Canvas 2D 按实际 CSS 像素布局,不整体缩放到文字难辨;动态数值和关键标签可放 HTML,绘图高度匹配内容,避免大块空白。
|
|
12
|
-
首屏应能看见主要关系、关键操作及当前结果。用户问“为什么变化不同”,优先用能对照变化的图形;发光、粒子或装饰不能代替趋势或关系证据。主图紧邻控件,推导、完整表格和次要说明随后呈现;同一数值不在指标、图注、卡片和正文反复展示。不要把所有可用组件都用一遍,也不为减少滚动而缩小字。比较不同单位的量,分别标轴或明确使用相对同一基准的无量纲倍数,不能把原始数值放在同一未说明尺度上暗示快慢。这些是信息优先级要求,具体图形、构图与风格仍按问题自行设计。
|
|
13
|
-
不把“最小”理解成粗糙或缺功能。交付所有必要内容后简短说明如何操作和假设;针对实际问题再局部修改。主动增强最多一次且确有价值,这是完成用户要求后的额外润色,不限制同一回复的 UI 数量或必要工具次数;用户要求几块不同内容就分别完成,不能第一块成功后提前结束。自动纠错仍最多两轮。无法交付时提供有效解释并如实说明,不声称已展示。
|
|
14
|
-
交付检查:如果决定生成 UI,先实际调用渲染工具并检查成功结果,或写出完整的 UI 源码围栏,然后再结束回复。“现在补上组件”“我会画图”只是承诺,不是交付。工具报错后修正实际参数并重新提交;若无法完成,给出有用的文字答案和真实失败原因,不用另一句承诺收尾。
|
|
15
|
-
这是一项行为要求,不能保证模型推理时长;宿主没有提供真实计时信息时不要虚报交付秒数。`;
|
|
1
|
+
// Shared behavior, without aesthetic rules or provider inference caps.
|
|
2
|
+
export const UI_INTENT_POLICY=`## 表达选择与实际交付
|
|
3
|
+
用户明确要求UI、图解、动画或交互时,实际交付;要求纯文字或只给代码时遵从。无需用户点名UI:参数与结果、方案权衡、趋势、流程或空间关系用图形明显更易懂时主动使用。简单事实、短定义、一次换算、普通代码排错直接 plain text。例:1 GiB的字节数→文字;比较不同利率的长期增长→可视化;外啮合齿轮的方向和速比→机制图解。静态排版和图解也是完整UI,不强行加交互。用户强调“一眼看懂先后顺序”“并排比较”“参数变化看结果”时,这是明确的表达目标:即使没提UI,也优先用轻量界面承载;短流程可直接render_scene,不额外添加交互。普通简短列表不强制UI。
|
|
4
|
+
每块围绕一个核心关系,按要求完成全部内容;一轮可有多块独立UI。先交付最小完整作品,不把“最小”理解成缺功能或粗糙,也不展开冗长设计复盘、穷举方案或为对话界面创建工程。首次工具成功不等于整个任务完成,不能用“准备调用”代替实际交付。外部数据正常用任务工具获取,真实数据与示例/假设分清。`;
|
package/lib/ui-skill.js
CHANGED
|
@@ -1,21 +1,17 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
|
|
8
|
-
import {TEXT_GUIDE,TEXT_INTERFACE} from './text-guide.js';
|
|
9
|
-
import {DEFAULT_VISUAL_STYLE,stylePrompt,styleExamples,visualStyle} from './visual-styles.js';
|
|
10
|
-
import {VISUAL_GUIDE,VISUAL_INTERFACE} from './visual.js';
|
|
11
|
-
|
|
1
|
+
import {MOTION_GUIDE} from './motion-library.js';
|
|
2
|
+
import {readFileSync} from 'node:fs';
|
|
3
|
+
import {MODEL_CONTRACT} from './prompt-contract.js';
|
|
4
|
+
import {FREE_UI_CONTRACT} from './freeform.js';
|
|
5
|
+
import {UI_INTENT_POLICY} from './ui-intent.js';
|
|
6
|
+
import {DEFAULT_VISUAL_STYLE,stylePrompt,visualStyle} from './visual-styles.js';
|
|
7
|
+
|
|
12
8
|
// Authored examples are deliberately small enough to be present in every model's context.
|
|
13
9
|
export const SKILL_EXAMPLES = [
|
|
14
10
|
{
|
|
15
11
|
version: 1, title: '示例 · 数量与费用', fallback: '演示:单价 12 元,数量默认 2,总额 24 元。不是报价。',
|
|
16
12
|
presentation: { layout: 'workbench', accent: 'teal', density: 'comfortable' },
|
|
17
13
|
state: { quantity: { type: 'number', default: 2, min: 1, max: 10, step: 1 } },
|
|
18
|
-
derived: { total: {
|
|
14
|
+
derived: { total: { expr: 'state.quantity * 12' } },
|
|
19
15
|
nodes: [
|
|
20
16
|
{ id: 'quantity', type: 'slider', label: '数量(件)', bind: 'state.quantity' },
|
|
21
17
|
{ id: 'total', type: 'metric', label: '演示总额', value: { ref: 'derived.total' }, unit: '元', decimals: 0 },
|
|
@@ -38,16 +34,14 @@ export const SKILL_EXAMPLES = [
|
|
|
38
34
|
}
|
|
39
35
|
];
|
|
40
36
|
|
|
41
|
-
const
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
|
|
37
|
+
const workedExamples=style=>'Selected visual-style examples (adapt the composition to the task; no obligation to reproduce every module):\n'+JSON.stringify(visualStyle(style).examples[0])+'\n'+JSON.stringify({tool:'render_ui',args:{document:SKILL_EXAMPLES[0]}});
|
|
38
|
+
const skill=readFileSync(new URL('../skills/intelligent-ui/SKILL.md',import.meta.url),'utf8');
|
|
39
|
+
export const UI_SKILL_SECTIONS=Object.freeze([
|
|
40
|
+
{name:'generative-ui:design-skill',order:850,interpolate:false,text:UI_INTENT_POLICY+'\n\n'+skill+'\n\n'+MOTION_GUIDE},
|
|
41
|
+
{name:'generative-ui:protocol',order:851,interpolate:false,text:MODEL_CONTRACT},
|
|
42
|
+
{name:'generative-ui:worked-examples',order:852,interpolate:false,text:workedExamples(DEFAULT_VISUAL_STYLE)}
|
|
43
|
+
]);
|
|
44
|
+
export function promptSections(mode='guided',style=DEFAULT_VISUAL_STYLE){
|
|
45
|
+
if(!['guided','free'].includes(mode))throw Error('DSH UI: designMode must be guided or free');visualStyle(style);
|
|
46
|
+
return UI_SKILL_SECTIONS.map((section,i)=>({...section,text:mode==='free'?(i===0?UI_INTENT_POLICY+'\n\n'+FREE_UI_CONTRACT:''):i===0?section.text+'\n\n'+stylePrompt(style):i===2?workedExamples(style):section.text}));
|
|
47
|
+
}
|
package/lib/visual-audit.js
CHANGED
|
@@ -1,18 +1,29 @@
|
|
|
1
1
|
// Serialized into the opaque frame; it never reads host content.
|
|
2
2
|
export function measureVisual(root, nodeId='') {
|
|
3
3
|
const issues=[],seen=new Set(),coverage={nodeId,elements:0,truncated:false,contrastChecked:0,contrastUncovered:0};
|
|
4
|
-
const
|
|
4
|
+
const styleCache=new WeakMap(),styleOf=el=>{let css=styleCache.get(el);if(!css){css=getComputedStyle(el);styleCache.set(el,css)}return css};
|
|
5
|
+
const target=el=>{if(!el)return undefined;const tag=el.tagName.toLowerCase(),id=el.id;return{selector:id&&id.length<=64?'#'+CSS.escape(id):tag,text:(el.textContent??'').trim().replace(/\s+/g,' ').slice(0,120),tag}};
|
|
6
|
+
const add=(code,value,el)=>{if(issues.length>=40)return;const id=el?.closest('[data-ui-node]')?.getAttribute('data-ui-node')??nodeId;const location=target(el);const k=id+':'+code+':'+(location?.selector??'')+':'+(location?.text??'')+':'+Math.round(value??0);if(!seen.has(k)&&issues.length<40){seen.add(k);issues.push({code,nodeId:id,...(location?{target:location}:{}),...(value===undefined?{}:{value:Number(value.toFixed(2))})});}};
|
|
5
7
|
const color=s=>{let m=s.match(/^rgba?\(([^)]+)\)/);if(m){const a=m[1].split(/[\s,\/]+/).map(Number);return[a[0]/255,a[1]/255,a[2]/255,a[3]??1]}m=s.match(/^color\(srgb ([^)]+)\)/);if(m){const a=m[1].split(/[\s\/]+/).map(Number);return[a[0],a[1],a[2],a[3]??1]}return null;};
|
|
6
8
|
const luminance=c=>c.slice(0,3).map(v=>v<=.04045?v/12.92:((v+.055)/1.055)**2.4).reduce((s,v,i)=>s+v*[.2126,.7152,.0722][i],0);
|
|
9
|
+
const blend=(front,back)=>front.slice(0,3).map((v,i)=>v*front[3]+back[i]*(1-front[3])).concat(1);
|
|
10
|
+
const background=el=>{const layers=[];let n=el;for(let i=0;n&&i<64;i++,n=n.parentElement){const c=styleOf(n);if(c.backgroundImage!=='none')return null;const colorValue=color(c.backgroundColor);if(!colorValue)return null;if(colorValue[3]>0)layers.push(colorValue);if(colorValue[3]===1){let out=layers.pop();while(layers.length)out=blend(layers.pop(),out);return out;}}return null;};
|
|
11
|
+
let contentBottom=root.getBoundingClientRect().top;
|
|
7
12
|
const widthRoot=root.id==='canvas'?document.documentElement:root;if(widthRoot.scrollWidth>widthRoot.clientWidth+2)add('overflow',widthRoot.scrollWidth-widthRoot.clientWidth);
|
|
8
13
|
const walker=document.createTreeWalker(root,NodeFilter.SHOW_ELEMENT);let el;while((el=walker.nextNode())){if(coverage.elements>=2000){coverage.truncated=true;break}coverage.elements++;if(el.matches('[data-canvas-phase=error]'))add('runtimeError',undefined,el);
|
|
9
|
-
const css=
|
|
14
|
+
const css=styleOf(el),box=el.getBoundingClientRect();if(!box.width||!box.height||css.visibility==='hidden'||css.display==='none')continue;
|
|
10
15
|
const text=[...el.childNodes].some(n=>n.nodeType===3&&n.textContent.trim());
|
|
11
16
|
if(text){let size=parseFloat(css.fontSize);if(el instanceof SVGElement&&el.getScreenCTM){const m=el.getScreenCTM();if(m)size*=Math.hypot(m.c,m.d)}if(size<11.9)add('smallText',size,el);
|
|
12
|
-
|
|
13
|
-
|
|
17
|
+
if(!(el instanceof SVGElement)){
|
|
18
|
+
const fg=color(css.color),bg=background(el);let opacitySafe=true,opacityDepth=0;for(let a=el;a;a=a.parentElement){if(++opacityDepth>64||parseFloat(styleOf(a).opacity)<1){opacitySafe=false;break}}
|
|
19
|
+
if(fg&&bg&&opacitySafe){coverage.contrastChecked++;const a=luminance(blend(fg,bg)),b=luminance(bg),ratio=(Math.max(a,b)+.05)/(Math.min(a,b)+.05);if(ratio<(size>=24||(size>=18.66&&parseFloat(css.fontWeight)>=700)?3:4.5))add('contrast',ratio,el);}else coverage.contrastUncovered++;
|
|
20
|
+
const range=document.createRange();range.selectNodeContents(el);const bounds=range.getBoundingClientRect();let a=el,depth=0;while(a&&a!==root.parentElement&&depth++<24){const c=styleOf(a),clip=a.getBoundingClientRect();if((['hidden','clip'].includes(c.overflowX)&&(bounds.left<clip.left-2||bounds.right>clip.right+2))||(['hidden','clip'].includes(c.overflowY)&&(bounds.top<clip.top-2||bounds.bottom>clip.bottom+2))){add('clippedText',undefined,el);break}a=a.parentElement}
|
|
21
|
+
}else coverage.contrastUncovered++;
|
|
22
|
+
|
|
14
23
|
}
|
|
24
|
+
if(text||el.matches('svg,canvas,img,video,input,select,textarea,button'))contentBottom=Math.max(contentBottom,box.bottom);
|
|
15
25
|
if(el.matches('input:not([type=hidden]),select,textarea,button,[role=button]')&&!el.getAttribute('aria-label')&&!el.getAttribute('aria-labelledby')&&!el.labels?.length&&!el.textContent.trim()&&!el.getAttribute('title'))add('missingLabel',undefined,el);
|
|
16
26
|
}
|
|
27
|
+
const rect=root.getBoundingClientRect(),gap=rect.bottom-contentBottom;if(!coverage.truncated&&root.id==='canvas'&&rect.height>320&&gap>Math.max(96,rect.height*.25))add('bottomWhitespace',gap,root);
|
|
17
28
|
Object.defineProperty(issues,'coverage',{value:coverage});return issues;
|
|
18
29
|
}
|
package/lib/visual-styles.js
CHANGED
|
@@ -1,30 +1,142 @@
|
|
|
1
|
-
|
|
2
|
-
//
|
|
3
|
-
|
|
4
|
-
const canvas=(title,html,css)=>({tool:'render_canvas',args:{title,fallback:title+',静态排版示例。',html,css}});
|
|
1
|
+
import {STYLE_SYSTEM,grammarPrompt,grammarExample} from './style-system.js';
|
|
2
|
+
// Stable user-facing IDs and palettes. Grammar and component tokens live together
|
|
3
|
+
// in style-system.js; the second example remains a small authored HTML/SVG surface.
|
|
5
4
|
export const DEFAULT_VISUAL_STYLE='prismframe';
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
5
|
+
const PALETTES=[
|
|
6
|
+
{
|
|
7
|
+
"id": "editorial",
|
|
8
|
+
"name": "清爽阅读",
|
|
9
|
+
"preview": {
|
|
10
|
+
"bg": "#fff",
|
|
11
|
+
"ink": "#182537",
|
|
12
|
+
"accent": "#3e60d3",
|
|
13
|
+
"soft": "#f4f6fa",
|
|
14
|
+
"line": "#dfe5ed"
|
|
15
|
+
},
|
|
16
|
+
"canvasExample": {
|
|
17
|
+
"tool": "render_canvas",
|
|
18
|
+
"args": {
|
|
19
|
+
"title": "三步发布",
|
|
20
|
+
"fallback": "三步发布,静态排版示例。",
|
|
21
|
+
"html": "<section><h2>把一件事讲清楚</h2><div class=\"steps\"><p><b>01 整理</b><span>补齐说明与许可</span></p><p><b>02 验证</b><span>检查安装与运行</span></p><p><b>03 发布</b><span>记录本次变化</span></p></div></section>",
|
|
22
|
+
"css": "section{padding:20px;border:1px solid var(--canvas-line);border-radius:16px}h2{font-size:24px;margin:0 0 20px}.steps{display:grid;grid-template-columns:repeat(3,1fr);gap:20px}p{margin:0}b,span{display:block}span{color:var(--canvas-muted);margin-top:8px}@media(max-width:520px){.steps{grid-template-columns:1fr}}"
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"id": "soft",
|
|
28
|
+
"name": "柔和彩色",
|
|
29
|
+
"preview": {
|
|
30
|
+
"bg": "#fbf8ff",
|
|
31
|
+
"ink": "#32294c",
|
|
32
|
+
"accent": "#7954bb",
|
|
33
|
+
"soft": "#eee5fa",
|
|
34
|
+
"line": "#e6dcf2"
|
|
35
|
+
},
|
|
36
|
+
"canvasExample": {
|
|
37
|
+
"tool": "render_canvas",
|
|
38
|
+
"args": {
|
|
39
|
+
"title": "本周阅读计划",
|
|
40
|
+
"fallback": "本周阅读计划,静态排版示例。",
|
|
41
|
+
"html": "<section><span class=\"tag\">轻松开始</span><h2>每天一点,稳稳前进</h2><div class=\"plan\"><p><b>20 分钟</b><span>专注阅读</span></p><p><b>1 个收获</b><span>写下自己的理解</span></p></div></section>",
|
|
42
|
+
"css": "section{padding:24px;border-radius:24px;border:1px solid var(--canvas-line);background:linear-gradient(130deg,color-mix(in srgb,#9567d4 12%,var(--canvas-bg)),color-mix(in srgb,#58b7ae 9%,var(--canvas-bg)));color:var(--canvas-ink)}.tag{display:inline-block;border-radius:999px;padding:5px 12px;background:var(--canvas-bg);color:var(--canvas-accent)}h2{font-size:26px;margin:14px 0 20px}.plan{display:flex;flex-wrap:wrap;gap:24px}.plan p{margin:0;flex:1 1 180px;padding:18px;border-radius:18px;background:color-mix(in srgb,var(--canvas-bg) 80%,transparent)}b,span{display:block}b{font-size:22px}.plan span{margin-top:8px;color:var(--canvas-muted)}"
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"id": "technical",
|
|
48
|
+
"name": "技术图解",
|
|
49
|
+
"preview": {
|
|
50
|
+
"bg": "#f8fafb",
|
|
51
|
+
"ink": "#1b3440",
|
|
52
|
+
"accent": "#087e8b",
|
|
53
|
+
"soft": "#e7f1f3",
|
|
54
|
+
"line": "#cedde2"
|
|
55
|
+
},
|
|
56
|
+
"canvasExample": {
|
|
57
|
+
"tool": "render_canvas",
|
|
58
|
+
"args": {
|
|
59
|
+
"title": "请求处理流程",
|
|
60
|
+
"fallback": "请求处理流程,静态排版示例。",
|
|
61
|
+
"html": "<section><header><small>REQUEST FLOW</small><h2>输入 → 处理 → 输出</h2></header><div class=\"flow\"><div><i>01</i><b>输入</b><p>接收需求</p></div><span>→</span><div><i>02</i><b>处理</b><p>校验与计算</p></div><span>→</span><div><i>03</i><b>输出</b><p>返回反馈</p></div></div></section>",
|
|
62
|
+
"css": "section{padding:20px;border:1px solid var(--canvas-line);border-radius:10px}small,i{font:14px ui-monospace,monospace;color:var(--canvas-accent)}h2{font-size:24px;margin:8px 0 20px}.flow{display:flex;gap:12px;align-items:center}.flow div{flex:1;padding:16px;border:1px solid var(--canvas-line);border-radius:10px}.flow b,.flow i{display:block}.flow b{margin-top:10px;font-size:19px}p{margin:6px 0 0;color:var(--canvas-muted)}@media(max-width:520px){.flow{flex-direction:column}.flow div{width:100%}.flow>span{transform:rotate(90deg)}}"
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"id": "expressive",
|
|
68
|
+
"name": "活力展示",
|
|
69
|
+
"preview": {
|
|
70
|
+
"bg": "#fff9f2",
|
|
71
|
+
"ink": "#362820",
|
|
72
|
+
"accent": "#bd4b26",
|
|
73
|
+
"soft": "#ffead8",
|
|
74
|
+
"line": "#edd7c5"
|
|
75
|
+
},
|
|
76
|
+
"canvasExample": {
|
|
77
|
+
"tool": "render_canvas",
|
|
78
|
+
"args": {
|
|
79
|
+
"title": "从第一步开始",
|
|
80
|
+
"fallback": "从第一步开始,静态排版示例。",
|
|
81
|
+
"html": "<section><div class=\"number\">01</div><div class=\"copy\"><span>今天的重点</span><h2>先做出一个<br>能演示的版本</h2><p>只保留一条主线,尽早获得反馈。</p></div></section>",
|
|
82
|
+
"css": "section{display:flex;align-items:center;gap:24px;padding:24px;border:1px solid var(--canvas-line);border-radius:22px;background:color-mix(in srgb,#f0984a 8%,var(--canvas-bg));color:var(--canvas-ink)}.number{font:800 54px/1 system-ui;padding:22px;border-radius:20px;color:var(--canvas-ink);background:color-mix(in srgb,#f0984a 28%,var(--canvas-bg))}.copy>span{font-size:14px;color:var(--canvas-muted)}h2{font-size:28px;line-height:1.3;margin:10px 0}p{margin:0;color:var(--canvas-muted)}@media(max-width:520px){section{align-items:flex-start;flex-direction:column}.number{font-size:36px;padding:16px}}"
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"id": "prismframe",
|
|
88
|
+
"name": "明亮扁平",
|
|
89
|
+
"preview": {
|
|
90
|
+
"bg": "#ecf6ff",
|
|
91
|
+
"ink": "#193858",
|
|
92
|
+
"accent": "#3182d9",
|
|
93
|
+
"soft": "#d3e8fc",
|
|
94
|
+
"line": "#9ec9ef"
|
|
95
|
+
},
|
|
96
|
+
"canvasExample": {
|
|
97
|
+
"tool": "render_canvas",
|
|
98
|
+
"args": {
|
|
99
|
+
"title": "三步让解释更清楚",
|
|
100
|
+
"fallback": "三步让解释更清楚,静态排版示例。",
|
|
101
|
+
"html": "<section><h2>把复杂问题讲清楚</h2><div class=\"cards\"><article><span>01</span><h3>明确目标</h3><p>先回答要解决什么。</p></article><article><span>02</span><h3>解释关系</h3><p>让图形承担说明。</p></article><article><span>03</span><h3>给出行动</h3><p>收成一个可执行步骤。</p></article></div></section>",
|
|
102
|
+
"css": "section{padding:24px 24px 30px;border-radius:26px;background:color-mix(in srgb,#3182d9 9%,var(--canvas-bg));color:var(--canvas-ink);font-family:ui-rounded,system-ui,sans-serif}h2{font-size:26px;line-height:1.35;margin:0 0 20px}.cards{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:18px}article{padding:20px;border:1.5px solid color-mix(in srgb,#3182d9 45%,var(--canvas-line));border-radius:22px;background:var(--canvas-bg);box-shadow:4px 6px 0 color-mix(in srgb,#3182d9 18%,var(--canvas-bg)),0 8px 16px #1637590b}article>span{color:var(--canvas-accent);font-size:14px;font-weight:700}h3{font-size:20px;margin:12px 0 8px}p{margin:0;line-height:1.6;color:var(--canvas-muted)}@media(max-width:580px){.cards{grid-template-columns:1fr}}"
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"id": "aurora",
|
|
108
|
+
"name": "柔光渐彩",
|
|
109
|
+
"preview": {
|
|
110
|
+
"bg": "#f4f2ee",
|
|
111
|
+
"ink": "#16151b",
|
|
112
|
+
"accent": "#6a57f2",
|
|
113
|
+
"soft": "#f5f3ef",
|
|
114
|
+
"line": "#e2dfda"
|
|
115
|
+
},
|
|
116
|
+
"canvasExample": {
|
|
117
|
+
"tool": "render_canvas",
|
|
118
|
+
"args": {
|
|
119
|
+
"title": "选择一个方案",
|
|
120
|
+
"fallback": "点击选择此方案,本地记录选择状态。",
|
|
121
|
+
"state": {
|
|
122
|
+
"selected": {
|
|
123
|
+
"type": "boolean",
|
|
124
|
+
"default": false
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
"html": "<section class=\"choice\"><h2>先选择,再继续</h2><p>渐变扩散和文字换位由实际操作触发。</p><button class=\"action\" type=\"button\" aria-pressed=\"false\"><i aria-hidden=\"true\"></i><span class=\"label\"><b>选择此方案</b><b aria-hidden=\"true\">选择此方案</b></span><span class=\"orb\" aria-hidden=\"true\">→</span></button><p class=\"status\" role=\"status\">尚未选择</p></section>",
|
|
128
|
+
"css": ".choice{padding:24px;border:1px solid var(--canvas-line);border-radius:26px;background:var(--canvas-bg);color:var(--canvas-ink)}h2{font-size:24px;margin:0 0 10px}p{color:var(--canvas-muted);line-height:1.7}.action{position:relative;isolation:isolate;overflow:hidden;display:inline-flex;align-items:center;gap:18px;min-height:54px;padding:8px 8px 8px 24px;border:0;border-radius:999px;background:var(--canvas-ink);color:var(--canvas-bg);translate:var(--x,0px) var(--y,0px);box-shadow:0 16px 28px -22px #54457988;transition:translate .7s cubic-bezier(.34,1.45,.64,1)}.action>i{position:absolute;inset:0;z-index:-1;background:linear-gradient(115deg,#7051ed,#326fce 55%,#188e97);clip-path:circle(21px at calc(100% - 29px) 50%);transition:clip-path .7s cubic-bezier(.2,.8,.2,1)}.action:is(:hover,:focus-visible){color:white}.action:is(:hover,:focus-visible)>i{clip-path:circle(160% at calc(100% - 29px) 50%)}.label{position:relative;overflow:hidden;line-height:1.5}.label b{display:block;transition:transform .55s cubic-bezier(.34,1.45,.64,1),opacity .3s}.label b+b{position:absolute;left:0;top:0;transform:translateY(130%);opacity:0}.action:is(:hover,:focus-visible) b:first-child{transform:translateY(-130%);opacity:0}.action:is(:hover,:focus-visible) b+b{transform:none;opacity:1}.orb{display:grid;place-items:center;width:42px;height:42px;border-radius:50%;background:linear-gradient(135deg,#438eff,#27b6ba);color:white;font-size:22px}.status{margin-bottom:0}@media(prefers-reduced-motion:reduce){.action,.action *{transition:none!important;translate:none!important}}",
|
|
129
|
+
"script": "const root=document.querySelector(\".choice\"),button=root.querySelector(\"button\");button.addEventListener(\"click\",()=>DSHUI.setState({selected:!DSHUI.snapshot.state.selected}));DSHUI.subscribe(({state})=>{button.setAttribute(\"aria-pressed\",String(state.selected));root.querySelectorAll(\"b\").forEach(b=>b.textContent=state.selected?\"取消选择\":\"选择此方案\");root.querySelector(\".status\").textContent=state.selected?\"已选择此方案\":\"尚未选择\"});button.addEventListener(\"pointermove\",e=>{if(matchMedia(\"(prefers-reduced-motion: reduce)\").matches)return;const r=button.getBoundingClientRect();button.style.setProperty(\"--x\",((e.clientX-r.left-r.width/2)*.035)+\"px\");button.style.setProperty(\"--y\",((e.clientY-r.top-r.height/2)*.07)+\"px\")});button.addEventListener(\"pointerleave\",()=>{button.style.setProperty(\"--x\",\"0px\");button.style.setProperty(\"--y\",\"0px\")});"
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
];
|
|
134
|
+
export const VISUAL_STYLES=Object.freeze(PALETTES.map(({canvasExample,...s})=>Object.freeze({...s,description:STYLE_SYSTEM[s.id].description,prompt:grammarPrompt(s.id),examples:[grammarExample(s.id),canvasExample]})));
|
|
23
135
|
export const VISUAL_STYLE_IDS=Object.freeze(VISUAL_STYLES.map(s=>s.id));
|
|
24
136
|
export function visualStyle(id=DEFAULT_VISUAL_STYLE){
|
|
25
137
|
const style=VISUAL_STYLES.find(s=>s.id===id);
|
|
26
138
|
if(!style)throw Error('DSH UI: unknown visualStyle; use '+VISUAL_STYLE_IDS.join('/'));
|
|
27
139
|
return style;
|
|
28
140
|
}
|
|
29
|
-
export function stylePrompt(id){const s=visualStyle(id);return
|
|
141
|
+
export function stylePrompt(id){const s=visualStyle(id);return '## 用户选择的视觉风格:'+s.name+' ('+s.id+')\n采用'+s.name+'风格。\n'+s.prompt+'\n原生组件自动遵循此风格,通常省略size/weight/color和presentation.accent;明确要求或语义强调才覆盖。HTML/SVG与原生内容保持一致层级。通用指导不覆盖这里的配色、材质、圆角或阴影;按任务组织内容,不为展示风格增加画布或工具调用。'}
|
|
30
142
|
export function styleExamples(id){return visualStyle(id).examples.map(example=>JSON.stringify(example)).join('\n')}
|