@leejungkiin/awkit 1.7.0 → 1.7.4

package/skills/video-edit/scripts/video_edit.py

@@ -0,0 +1,324 @@
+import argparse
+import json
+import subprocess
+from dataclasses import dataclass
+from pathlib import Path
+
+from PIL import Image, ImageDraw, ImageFont
+
+
+@dataclass(frozen=True)
+class Caption:
+    start: float
+    end: float
+    text: str
+    placement: str
+
+
+def _wrap_text(text: str, font: ImageFont.FreeTypeFont, max_width: int) -> list[str]:
+    words = text.split(" ")
+    lines: list[str] = []
+    cur = ""
+    for w in words:
+        test = (cur + " " + w).strip()
+        if not cur or font.getlength(test) <= max_width:
+            cur = test
+        else:
+            lines.append(cur)
+            cur = w
+    if cur:
+        lines.append(cur)
+    return lines
+
+
+def _pick_font(project_root: Path) -> str:
+    candidates = [
+        project_root / "assets" / "fonts" / "BeVietnamPro-Regular.ttf",
+        project_root / "assets" / "fonts" / "Inter-Regular.ttf",
+        Path("/System/Library/Fonts/Supplemental/Arial.ttf"),
+    ]
+    for p in candidates:
+        if p.exists():
+            return str(p)
+    raise FileNotFoundError("No font found. Expected assets/fonts/*.ttf or system Arial.")
+
+
+def _make_caption_overlay(
+    *,
+    width: int,
+    height: int,
+    font_path: str,
+    text: str,
+    placement: str,
+    out_path: Path,
+) -> None:
+    img = Image.new("RGBA", (width, height), (0, 0, 0, 0))
+    draw = ImageDraw.Draw(img)
+
+    is_top = placement == "top"
+    font_size = 64 if is_top else 54
+    font = ImageFont.truetype(font_path, font_size)
+
+    max_w = int(width * (0.82 if is_top else 0.78))
+    lines = _wrap_text(text, font, max_w)
+    if not lines:
+        img.save(out_path)
+        return
+
+    line_h = int(font_size * 1.25)
+    text_h = line_h * len(lines)
+    text_w = int(max(font.getlength(line) for line in lines))
+
+    pad_x = 44 if is_top else 36
+    pad_y = 24 if is_top else 22
+    box_w = min(width - 120, text_w + pad_x * 2)
+    box_h = min(height - 120, text_h + pad_y * 2)
+
+    cx = width // 2
+    box_x0 = cx - box_w // 2
+    box_y0 = int(height * 0.10) if is_top else int(height * 0.76)
+    box_y0 = min(box_y0, height - box_h - 40)
+
+    draw.rounded_rectangle(
+        [box_x0, box_y0, box_x0 + box_w, box_y0 + box_h],
+        radius=26,
+        fill=(0, 0, 0, 165),
+    )
+
+    cur_y = box_y0 + pad_y
+    for line in lines:
+        lw = font.getlength(line)
+        x = cx - lw / 2
+        draw.text((x, cur_y), line, font=font, fill=(255, 255, 255, 255))
+        cur_y += line_h
+
+    img.save(out_path)
+
+
+def _load_captions(cfg: dict) -> list[Caption]:
+    raw = cfg.get("captions") or []
+    caps: list[Caption] = []
+    for item in raw:
+        start = float(item.get("timelineStart", 0))
+        duration = float(item.get("duration", 0))
+        text = (item.get("text") or "").strip()
+        placement = (item.get("placement") or "bottom").strip().lower()
+        if duration <= 0 or not text:
+            continue
+        caps.append(Caption(start=start, end=start + duration, text=text, placement=placement))
+    return caps
+
+
+def _build_ffmpeg_command(
+    *,
+    project_root: Path,
+    cfg: dict,
+    out_mp4: Path,
+    preset: str,
+    include_captions: bool,
+    include_decor: bool,
+    crf: int,
+    badge: str | None,
+    badge_start: float,
+    badge_duration: float,
+) -> list[str]:
+    project = cfg["project"]
+    width = int(project.get("width", 1080))
+    height = int(project.get("height", 1920))
+    fps = int(project.get("fps", 30))
+
+    shots = cfg.get("shots") or []
+    if not shots:
+        raise ValueError("EDL has no shots")
+
+    total_duration = float(project.get("duration") or 0)
+    if total_duration <= 0:
+        total_duration = sum(float(s["duration"]) for s in shots)
+
+    args: list[str] = ["ffmpeg", "-hide_banner", "-y"]
+
+    for s in shots:
+        args += [
+            "-ss",
+            f'{float(s.get("sourceStart", 0)):.3f}',
+            "-t",
+            f'{float(s["duration"]):.3f}',
+            "-i",
+            str(s["source"]),
+        ]
+
+    music = cfg.get("music") or {}
+    if not music.get("path"):
+        raise ValueError("EDL is missing music.path")
+
+    args += [
+        "-ss",
+        f'{float(music.get("start", 0)):.3f}',
+        "-t",
+        f"{total_duration:.3f}",
+        "-i",
+        str(music["path"]),
+    ]
+
+    overlays: list[dict] = []
+    overlays_dir = out_mp4.parent / "overlays"
+    overlays_dir.mkdir(parents=True, exist_ok=True)
+
+    if include_decor and preset in ("cinematic", "clean"):
+        decor_files = []
+        if preset == "cinematic":
+            decor_files = [
+                project_root / "assets" / "overlays" / "vignette_1080x1920.png",
+                project_root / "assets" / "overlays" / "grain_1080x1920.png",
+            ]
+        if preset == "clean":
+            decor_files = [
+                project_root / "assets" / "overlays" / "bottom_fade_1080x1920.png",
+                project_root / "assets" / "overlays" / "top_fade_1080x1920.png",
+            ]
+        for p in decor_files:
+            if p.exists():
+                overlays.append({"file": str(p), "start": 0.0, "end": total_duration})
+
+    if include_decor and badge and badge != "none" and badge_duration > 0:
+        badge_file = project_root / "assets" / "overlays" / f"badge_{badge}_1080x1920.png"
+        if badge_file.exists():
+            overlays.append(
+                {
+                    "file": str(badge_file),
+                    "start": max(0.0, badge_start),
+                    "end": min(total_duration, max(0.0, badge_start + badge_duration)),
+                }
+            )
+
+    if include_captions:
+        font_path = _pick_font(project_root)
+        for i, cap in enumerate(_load_captions(cfg), start=1):
+            p = overlays_dir / f"cap_{i:02d}.png"
+            _make_caption_overlay(
+                width=width,
+                height=height,
+                font_path=font_path,
+                text=cap.text,
+                placement=cap.placement,
+                out_path=p,
+            )
+            overlays.append({"file": str(p), "start": cap.start, "end": cap.end})
+
+    for ov in overlays:
+        args += ["-loop", "1", "-t", f"{total_duration:.3f}", "-i", ov["file"]]
+
+    audio_input_index = len(shots)
+    first_overlay_idx = audio_input_index + 1
+
+    vf_parts: list[str] = []
+    for i in range(len(shots)):
+        vf_parts.append(
+            f"[{i}:v]"
+            f"scale={width}:{height}:force_original_aspect_ratio=increase,"
+            f"crop={width}:{height},fps={fps},format=yuv420p,setpts=PTS-STARTPTS[v{i}]"
+        )
+
+    concat_in = "".join([f"[v{i}]" for i in range(len(shots))])
+    vf_parts.append(f"{concat_in}concat=n={len(shots)}:v=1:a=0[vcat]")
+
+    v_prev = "[vcat]"
+    for j, ov in enumerate(overlays):
+        img_idx = first_overlay_idx + j
+        v_next = f"[vo{j}]" if j < len(overlays) - 1 else "[vpre]"
+        vf_parts.append(
+            f"{v_prev}[{img_idx}:v]overlay=0:0:format=auto:shortest=1:"
+            f"enable=between(t\\,{ov['start']:.3f}\\,{ov['end']:.3f}){v_next}"
+        )
+        v_prev = v_next
+
+    vf_parts.append(f"[vpre]trim=duration={total_duration:.3f},setpts=PTS-STARTPTS[vout]")
+
+    volume = float(music.get("volume", 0.55))
+    fade_in = float(music.get("fadeIn", 0.4))
+    fade_out = float(music.get("fadeOut", 1.0))
+    fade_out_start = max(0.0, total_duration - fade_out)
+
+    vf_parts.append(
+        f"[{audio_input_index}:a]atrim=0:{total_duration:.3f},asetpts=PTS-STARTPTS,"
+        f"volume={volume},"
+        f"afade=t=in:st=0:d={fade_in:.3f},"
+        f"afade=t=out:st={fade_out_start:.3f}:d={fade_out:.3f},"
+        "aformat=sample_fmts=fltp:sample_rates=48000:channel_layouts=stereo[aout]"
+    )
+
+    out_mp4.parent.mkdir(parents=True, exist_ok=True)
+
+    args += [
+        "-filter_complex",
+        ";".join(vf_parts),
+        "-map",
+        "[vout]",
+        "-map",
+        "[aout]",
+        "-shortest",
+        "-c:v",
+        "libx264",
+        "-preset",
+        "veryfast",
+        "-crf",
+        str(crf),
+        "-pix_fmt",
+        "yuv420p",
+        "-c:a",
+        "aac",
+        "-b:a",
+        "192k",
+        "-movflags",
+        "+faststart",
+        str(out_mp4),
+    ]
+    return args
+
+
+def cmd_render(args: argparse.Namespace) -> int:
+    project_root = Path(args.project_root).resolve()
+    edl_path = Path(args.edl).resolve()
+    cfg = json.loads(edl_path.read_text("utf-8"))
+
+    out_mp4 = Path(args.out).resolve() if args.out else (edl_path.parent / "_render" / "final.mp4")
+    cmd = _build_ffmpeg_command(
+        project_root=project_root,
+        cfg=cfg,
+        out_mp4=out_mp4,
+        preset=args.preset,
+        include_captions=not args.no_captions,
+        include_decor=not args.no_decor,
+        crf=args.crf,
+        badge=args.badge,
+        badge_start=args.badge_start,
+        badge_duration=args.badge_duration,
+    )
+
+    subprocess.run(cmd, cwd=str(project_root), check=True)
+    return 0
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(prog="video_edit")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_render = sub.add_parser("render")
+    p_render.add_argument("--edl", required=True)
+    p_render.add_argument("--out", default=None)
+    p_render.add_argument("--preset", default="cinematic", choices=["cinematic", "clean", "none"])
+    p_render.add_argument("--crf", type=int, default=22)
+    p_render.add_argument("--badge", default="none", choices=["none", "tip", "warn", "new", "ok"])
+    p_render.add_argument("--badge-start", type=float, default=0.3)
+    p_render.add_argument("--badge-duration", type=float, default=2.6)
+    p_render.add_argument("--project-root", default=str(Path.cwd()))
+    p_render.add_argument("--no-captions", action="store_true")
+    p_render.add_argument("--no-decor", action="store_true")
+    p_render.set_defaults(func=cmd_render)
+
+    ns = parser.parse_args()
+    return int(ns.func(ns))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/templates/setup-mapping.json

@@ -0,0 +1,48 @@
+{
+  "tech_mappings": {
+    "react": {
+      "skills": ["visual-design-gate", "animal-island-ui-style"],
+      "mcps": ["playwright"],
+      "hooks": ["auto-lint"]
+    },
+    "nextjs": {
+      "skills": ["firebase-app-hosting-basics", "visual-design-gate"],
+      "mcps": ["playwright"],
+      "hooks": ["auto-lint", "pre-build-check"]
+    },
+    "expo": {
+      "skills": ["expo-build-optimizer", "visual-design-gate"],
+      "mcps": ["maestro"],
+      "hooks": ["auto-lint"]
+    },
+    "react-native": {
+      "skills": ["expo-build-optimizer", "visual-design-gate"],
+      "mcps": ["maestro"],
+      "hooks": ["auto-lint"]
+    },
+    "firebase": {
+      "skills": ["firebase-basics", "firebase-firestore", "firebase-auth-basics", "firebase-security-rules-auditor"],
+      "mcps": ["firebase-mcp-server"]
+    },
+    "android": {
+      "skills": ["android-cli", "android-aso", "android-re-analyzer"],
+      "mcps": ["maestro"]
+    },
+    "ios": {
+      "skills": ["ios-engineer", "ios-expert-coder", "swiftui-pro", "xcode-project-setup"],
+      "mcps": ["maestro", "ios-simulator"]
+    },
+    "swift": {
+      "skills": ["ios-engineer", "ios-expert-coder", "swiftui-pro"],
+      "mcps": ["ios-simulator"]
+    },
+    "flutter": {
+      "skills": ["flutter", "flutter-project-creater"],
+      "mcps": ["maestro"]
+    }
+  },
+  "default_hooks": {
+    "auto_commit": true,
+    "build_preflight": "awkit build"
+  }
+}

package/templates/specs/design-template.md

@@ -1,76 +1,166 @@
-# UI/Visual Design Document — [Tính Năng/Giao Diện]
-> "[Slogan hoặc Nguyên tắc chủ đạo của giao diện: "Ví dụ: Mỗi tab một sứ mệnh – không overlap"]"
-
-[⚠️ AI INSTRUCTION: BẮT BUỘC KHÔNG THIẾT KẾ DATA MODELS TẠI ĐÂY. Tập trung 100% vào Đồ Họa, Thông số UI (Hex, Padding), UX (Tap, Hover) và Component UI hierarchy.]
-
-## 1. Tổng Quan & Metadata
-* **Phiên bản:** [Ví dụ: 1.0]
-* **Ngày tạo:** [YYYY-MM-DD]
-* **Mục tiêu đồ họa:** [Lý do thay đổi/Kết quả UI mong muốn]
-
-## 2. Nguyên Tắc Thiết Kế (Design Principles)
-[Danh sách quy tắc bất biến về mặt đồ họa và trải nghiệm người dùng]
-1. [Nguyên tắc 1: Không overlap chức năng giữa các khu vực].
-2. [Nguyên tắc 2: Tình trạng hiển thị (Visibility) của các thành phần chính].
-3. [Nguyên tắc 3: Hệ thống thông báo/Badge thông minh].
-4. [Nguyên tắc 4: Phân cấp Animation theo tiers (Subtle, Satisfying, v.v.)].
-
-## 3. Đặc Tả Hình Ảnh (Component Specs)
-### 3.1 Thông số kỹ thuật (Thẩm mỹ & Layout)
-* **Kích thước:** [Ví dụ: Height: 60px + SafeArea].
-* **Màu sắc & Shadow:** 
-  - Nền/Border: [Mã màu Background, Border cụ thể].
-  - Shadow: [Elevation, Offset, Radius].
-* **Trạng thái (States):** 
-  - Active: [Màu sắc, font weight, opacity].
-  - Inactive: [Màu sắc, font weight, opacity].
-
-### 3.2 Danh sách Element
-[Bảng liệt kê các thành phần hiển thị]:
-| # | Tên Item | Mức độ ưu tiên | Icon/Graphic (Màu sắc) | Điều kiện nháy/hiển thị |
-|---|----------|----------------|------------------------|-------------------------|
-| 1 | [Item A] | [Primary]      | [Mã Hex / Vector]      | [Condition]             |
-
-## 4. Chi Tiết Các Màn Hình (Screen Breakdown)
-### 4.1 Layout: [Tên Màn Hình]
-* **Vai trò hiển thị:** [Dashboard / Modal / Popup]
-* **Cấu trúc đồ họa (Từ trên xuống):**
-    - **Header:** [Nút back, Tiêu đề, Badge]
-    - **Hero Section:** [Ảnh chụp, Thông điệp to]
-    - **Content Grid:** [Spacing dọc ngang, Padding 2 bên]
-    - **CTA Button:** [Stick bottom, Shadow layer]
-
-### 4.2 Component Hierarchy (Cấu trúc giao diện)
-[AI: Bắt buộc vẽ sơ đồ Text Tree cho cấu trúc Component React/UI UI-only]
-```text
-FeatureView (Root)
-│
-├── HeaderComponent
-│   └── BackButton
-│
-├── ContentSection
-│   ├── ItemCard
-│   └── ProgressBar
-│
-└── ActionButtons
-    └── PrimaryCTA
+# [Feature Name] Design Document
+
+## Overview
+
+[High-level description of the feature architecture - describe the overall approach, key design decisions, and how it fits into the larger system]
+
+## Architecture
+
+[Description of architectural approach and patterns used]
+
+### Component Hierarchy
+
+```
+[FeatureName]View (Root)
+├── [HeaderComponent] (Navigation and context)
+├── [MainContainer] (Primary content)
+│   ├── [ContentSection1]
+│   │   ├── [SubComponent1]
+│   │   └── [SubComponent2]
+│   ├── [ContentSection2]
+│   │   └── [SubComponent3]
+│   └── [ActionSection]
+│       └── [ActionButtons]
+├── [FloatingElements] (Overlays, FABs)
+└── [ModalComponents] (Sheets, Dialogs)
+```
+
+## Components and Interfaces
+
+### [MainComponent]
+- **Purpose**: [What this component does and why]
+- **Platform-Specific Design**:
+  - iOS: [Apple HIG considerations, SF Symbols, native patterns]
+  - Android: [Material Design 3 components, patterns]
+- **Key Features**:
+  - [Feature 1 with implementation detail]
+  - [Feature 2 with implementation detail]
+  - [Animations and transitions]
+
+### [SubComponent1]
+- **Purpose**: [Component purpose]
+- **Visual Design**:
+  - [Layout specifications]
+  - [Color and typography]
+  - [Spacing and sizing]
+- **Interaction Design**:
+  - [Touch/click behavior]
+  - [Hover states (if applicable)]
+  - [Animation specs]
+
+## Data Models
+
+### [PrimaryModel]
+```swift
+// iOS
+struct [ModelName]: Codable, Identifiable {
+    let id: UUID
+    let property1: String
+    let property2: Int
+    let optionalProperty: String?
+    let nestedObject: [NestedType]
+    let createdAt: Date
+    let updatedAt: Date
+    
+    enum CodingKeys: String, CodingKey {
+        case id
+        case property1 = "property_1"
+        // ... mapping for API compatibility
+    }
+}
+```
+
+```kotlin
+// Android
+data class [ModelName](
+    val id: String,
+    val property1: String,
+    val property2: Int,
+    val optionalProperty: String?,
+    val nestedObject: List<NestedType>,
+    val createdAt: Instant,
+    val updatedAt: Instant
+)
 ```
 
-## 5. Đặc Tả Chuyển Động (Animation & Graphic Logic)
-* **Logic thông báo (Badge Status):** [Quy định dấu chấm đỏ nổi lên lúc nào, hiệu ứng thở "breathing" ra sao].
-* **Đặc tả chuyển động (Animation Spec):**
-    - **Kiểu:** [Spring / Linear / Bounce].
-    - **Thông số:** [Duration: X ms, Damping: Y, Stiffness: Z].
-* **Hiệu ứng Haptic (Rung):** [Gõ phím -> Light Haptic; Thành công -> Success Haptic].
+### [StateModel]
+```swift
+// iOS - ViewModel State
+enum [Feature]ViewState {
+    case idle
+    case loading
+    case loaded([DataModel])
+    case error(Error)
+    case empty
+}
+```
+
+```kotlin
+// Android - UI State
+sealed interface [Feature]UiState {
+    data object Loading : [Feature]UiState
+    data class Success(val data: List<DataModel>) : [Feature]UiState
+    data class Error(val message: String) : [Feature]UiState
+    data object Empty : [Feature]UiState
+}
+```
+
+## Correctness Properties
+
+*Properties serve as the bridge between requirements and verifiable correctness guarantees.*
+
+**Property 1: [Property Name]**
+*For any* [scenario/input], the system should [expected behavior across all conditions]
+**Validates: Requirements 1.1, 1.2, 1.3**
+
+**Property 2: [Property Name]**
+*For any* [scenario/input], the system should [expected behavior]
+**Validates: Requirements 2.1, 2.2**
+
+**Property 3: Error Handling Correctness**
+*For any* error condition, the system should [graceful handling, user feedback, recovery options]
+**Validates: Requirements 3.1, 3.2, 3.3**
+
+## UI/UX Design Specifications
+
+### Visual Design System
+
+**Colors:**
+| Token | Light Mode | Dark Mode | Usage |
+|-------|------------|-----------|-------|
+| Primary | #[hex] | #[hex] | [usage] |
+| Secondary | #[hex] | #[hex] | [usage] |
+| Background | #[hex] | #[hex] | [usage] |
+
+**Typography:**
+| Style | Font | Size | Weight | Usage |
+|-------|------|------|--------|-------|
+| Title | [font] | 24pt | Bold | [usage] |
+| Body | [font] | 16pt | Regular | [usage] |
+
+**Spacing:**
+| Token | Value | Usage |
+|-------|-------|-------|
+| xs | 4pt | [usage] |
+| sm | 8pt | [usage] |
+| md | 16pt | [usage] |
+
+### Animation Specifications
+
+| Animation | Duration | Easing | Description |
+|-----------|----------|--------|-------------|
+| Appear | 300ms | easeOut | [description] |
+| Disappear | 200ms | easeIn | [description] |
+| Spring | 0.5s/0.7 | spring | [response/damping] |
+
+## Performance Considerations
 
-## 6. Sơ Đồ Routing (Đứng từ góc độ UI)
-* **Cấu trúc Thư mục Màn Hình:** [app/(tabs)/home.tsx]
-* **Component tái sử dụng:** [Ví dụ: Dùng chung thẻ UserCard từ design-system sẵn có].
+- **Lazy Loading**: [What should be lazy loaded]
+- **Caching Strategy**: [How data should be cached]
+- **Memory Management**: [Memory considerations]
 
-## 7. Lộ Trình Triển Khai (Dành riêng cho Frontend/UI)
-* **Giai đoạn 1:** Lên layout tĩnh (CSS + HTML/JSX). Gắn Mock Text.
-* **Giai đoạn 2:** Apply Animations & Haptics.
-* **Giai đoạn 3:** Bọc Component ghép vào Data thật bên ngoài.
+## Security Considerations
 
----
-*Tài liệu Đặc Tả Giao Diện (Visual & Graphic Design Only).*
+- **Data Encryption**: [What needs encryption]
+- **Input Validation**: [Validation requirements]
+- **Authentication**: [Auth requirements]