android2harmony 0.1.2 → 0.1.3

package/skills/hmos-incremental-ui-align/references/State_Model_Template.md

@@ -0,0 +1,74 @@
+# State Model Template
+
+Use this template to document multi-state UI components identified in Step 1.5.
+
+---
+
+## Component: {ComponentName}
+
+**Source files**: `{android_source_file}`, `{hmos_source_file}`
+**Parent page**: `{page_name}`
+**State variable**: `{variable_name}` (type: `{enum/sealed class/Int}`)
+
+## States
+
+| State ID | State Name | Entry Trigger | UI Description | Source Ref |
+|----------|-----------|---------------|----------------|-----------|
+| S0 | {name} | {trigger description} | {visible UI in this state} | {File:Line} |
+| S1 | {name} | {trigger description} | {visible UI in this state} | {File:Line} |
+| S2 | {name} | {trigger description} | {visible UI in this state} | {File:Line} |
+
+## Transitions
+
+| From | To | Trigger | Gesture Type | Condition/Threshold | Duration | Source Ref |
+|------|-----|---------|-------------|--------------------|---------|-----------| 
+| S0 | S1 | {event} | {Tap/LongPress/Pan/Swipe/Sensor/Timer} | {condition if any} | {ms or N/A} | {File:Line} |
+| S1 | S2 | {event} | {gesture} | {condition} | {duration} | {File:Line} |
+
+## Per-State UI Properties
+
+### S0: {state_name}
+| Property | Value | Source Ref |
+|----------|-------|-----------|
+| visibility | {VISIBLE/GONE/INVISIBLE} | {File:Line} |
+| background | {color/drawable} | {File:Line} |
+| text_content | "{text}" | {File:Line} |
+| text_color | {#RRGGBB} | {File:Line} |
+| text_size | {value}sp → {value}fp | {File:Line} |
+| animation | {description or "none"} | {File:Line} |
+| corner_radius | {value}dp → {value}vp | {File:Line} |
+| shadow/glow | {description or "none"} | {File:Line} |
+
+### S1: {state_name}
+(repeat same table structure)
+
+## Animations Between States
+
+| Transition | Property | From Value | To Value | Duration | Easing | Source Ref |
+|-----------|----------|-----------|----------|----------|--------|-----------|
+| S0→S1 | opacity | 0 | 1 | 300ms | ease-out | {File:Line} |
+| S0→S1 | translateY | 100vp | 0 | 300ms | spring | {File:Line} |
+
+## Capture Strategy
+
+| State | Auto-capturable? | Method | Notes |
+|-------|-----------------|--------|-------|
+| S0 | Yes | navigate to page, capture idle | — |
+| S1 | No | manual: long press and hold | need burst during hold |
+| S2 | No | manual: long press + drag up | need burst during drag |
+
+## Manual Capture Instructions (if applicable)
+
+For states that cannot be auto-captured, provide step-by-step instructions:
+
+```
+State S1 (recording):
+1. Run: node ./scripts/page_capture_burst.ts --device adb -o {output_dir} --duration 5
+2. On device: long-press the microphone button and HOLD
+3. Wait for burst to complete, then release
+
+State S2 (cancelling):
+1. Run: node ./scripts/page_capture_burst.ts --device adb -o {output_dir} --duration 5
+2. On device: long-press mic → drag finger UP past the cancel threshold
+3. Wait for burst to complete, then release
+```

package/skills/hmos-incremental-ui-align/references/UI_Analysis_Template.md

@@ -0,0 +1,34 @@
+| 类别 | 文本内容 (Content) | 尺寸与布局 (Size & Layout) | 颜色与背景 (Color & Background) | 边框与轮廓 (Border & Outline) | 文本样式 (Typography) | 变换与效果 (Transform & Effect) | 状态与交互反馈 (State & Feedback) |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **具体属性名** | `text` / `content` / `title` | `width`<br>`height`<br>`minWidth` / `maxWidth`<br>`minHeight` / `maxHeight`<br>`padding`<br>`margin`<br>`constraints`<br>`aspectRatio`<br>`alignment` (子控件位置) | `backgroundColor`<br>`background` (drawable/image)<br>`foreground`<br>`color` / `textColor`<br>`tintColor` / `colorFilter`<br>`shadow` (offset, radius, color)<br>`opacity` / `alpha` | `borderWidth`<br>`borderColor`<br>`borderRadius`<br>`borderStyle` (solid, dashed, dotted)<br>`outline` | `fontSize`<br>`fontFamily`<br>`fontWeight`<br>`fontStyle` (normal, italic)<br>`letterSpacing`<br>`lineHeight`<br>`textDecoration` (underline, line-through)<br>`textAlign` / `gravity` (文字位置)<br>`textOverflow` / `maxLines` | `scale` (x, y)<br>`rotation` (z, x, y)<br>`translate` (x, y)<br>`blur`<br>`brightness`<br>`contrast`<br>`saturation`<br>`clip` (circle, path) | `state` (normal, pressed, focused, disabled, selected, error)<br>（所有上述属性均可按状态单独设置） |
+| **具体例子<br>(登录按钮)** | `text = "登录"` | `width = 200vp`<br>`height = 48vp`<br>`padding = 12vp`<br>`margin = 16vp`<br>`alignment = center` (在父容器中居中) | `backgroundColor = #007AFF`<br>`textColor = #FFFFFF`<br>`shadow(offset=0, radius=4, color=#40000000)` | `borderRadius = 24vp`<br>`borderWidth = 0`<br>`borderStyle = solid` | `fontSize = 16fp`<br>`fontWeight = bold`<br>`fontFamily = sans-serif-medium`<br>`textAlign = center` (文字在按钮内居中) | `scale = 0.95` (按下时)<br>`opacity = 0.8` (禁用时) | `normal`: 蓝色背景<br>`pressed`: 深蓝色背景<br>`disabled`: 灰色背景<br>`loading`: 显示进度圈 |
+
+## Dynamic / Transient UI Effects
+
+This section captures UI behaviors that are NOT visible in a static screenshot or view tree: animations, transient messages, and non-touch-triggered UI.
+
+| Effect Type | Trigger | Duration/Timing | Target Component | Parameters | Source Reference |
+|:---|:---|:---|:---|:---|:---|
+| animation | e.g., page enter / button click | e.g., 300ms, ease-out | e.g., title_text | e.g., alpha 0→1, translateY -20→0 | file:line |
+| transient UI | e.g., save success / network error | e.g., 2000ms auto-dismiss | e.g., Toast / Snackbar | e.g., text="保存成功", position=bottom | file:line |
+| voice/sensor | e.g., mic button click / shake | e.g., until recognition ends | e.g., voice_wave_view | e.g., waveform animation + result overlay | file:line |
+
+Fill only rows that exist for this page. Omit this section entirely if no dynamic effects are found.
+
+## Multi-State Component Analysis (Step 1.5 components only)
+
+When a component is identified as multi-state in Step 1.5, expand the "状态与交互反馈" column into a full state breakdown below:
+
+### Component: {ComponentName}
+**State variable**: `{var_name}` — Type: `{enum/sealed class/@State}`  
+**Total states**: {N}
+
+| State | Visibility | Background | Text Content | Text Style | Border | Animation | Trigger to Enter |
+|:------|:-----------|:-----------|:-------------|:-----------|:-------|:----------|:-----------------|
+| idle | VISIBLE | transparent | "问AI或按住说话" | 14fp #666666 | none | none | initial / cancel / recognized complete |
+| recording | VISIBLE | #FFFFFF | "松手发送，上移取消" | 14fp #666666 | none | blue glow pulse | LongPress mic 500ms |
+| cancelling | VISIBLE | #FFE5E5 | "上移取消" | 14fp #FF4444 | 2vp dashed #FF4444 | red border dash animation | Pan.UP > 150vp |
+
+**Source references**: List the source file(s) and line ranges where each state's UI properties are defined.
+
+This section supplements (not replaces) the main component table. The main table should show the component's **default/idle state** properties. This expanded section shows how properties change per state.