PencilKit Collaborative Canvas Architecture Specification

Role: Principal iOS Graphics and UI Systems Engineer specializing in iPadOS PencilKit and Metal rendering.

Context

• Academic Discipline: {{faculty_discipline}}
• Target Hardware Baseline: {{target_device_profile}}
• Required Tool Set: {{drawing_tool_set}}
• Serialization Standard: {{stroke_serialization_format}}
• Inclusivity Tier: {{accessibility_support_level}}
• Target Draw Latency: {{latency_threshold_ms}}

Task

Develop an architectural technical specification for an iPadOS educational canvas feature utilizing PencilKit to enable high-fidelity lecture annotation, real-time stroke handling, and mathematical drawing tailored to {{faculty_discipline}}.

Method

1. Architect the PKCanvasView and PKToolPicker customization pipeline supporting {{drawing_tool_set}}.
2. Define stroke capture lifecycle events, capturing tilt, force, and azimuth data from Apple Pencil.
3. Design the binary serialization and deserialization engine using {{stroke_serialization_format}} for low-overhead persistence.
4. Specify ink rendering optimizations to guarantee touch-to-display latency remains strictly under {{latency_threshold_ms}} on {{target_device_profile}}.
5. Build the state management layer for multi-page document pagination, undo/redo stacks, and stroke indexation.
6. Detail integration hooks for Apple Pencil hover, double-tap gestures, and squeeze interactions.
7. Define the accessibility adaptation layer compliant with {{accessibility_support_level}}, including VoiceOver stroke descriptions.

Constraints

• MUST maintain continuous 120Hz ProMotion rendering during active multi-finger touch and Pencil input.
• MUST NOT block the main actor during stroke serialization or background autosave routines.
• All custom PKCustomTool implementations must fall back gracefully on devices lacking Metal 3 support.
• Implementation examples must be written in modern Swift using UIKit and SwiftUI integration wrappers.

Output format

Deliver the specification under four clearly bounded headings:

1. Canvas & View Hierarchy Architecture (PKCanvasView containment and hosting strategy)
2. Stroke Serialization & State Engine (exact data layout for {{stroke_serialization_format}} and memory caching rules)
3. Custom Tool & Interaction Specification (Pencil squeeze/hover handling and {{drawing_tool_set}} configuration)
4. Accessibility & Performance Verification (latency profiling targets under {{latency_threshold_ms}} and VoiceOver mapping)

Self-review

• Check that latency constraints are directly addressed with concrete Metal and PencilKit configurations.
• Ensure stroke serialization handles backward compatibility across app versions.
• Validate that custom Apple Pencil gestures do not conflict with system-level iPadOS controls.