Crate cvkg_layout 

CVKG Agentic Development Guidelines (v1.2)

All AI agents contributing to this crate MUST follow ALL seven rules:

── Karpathy Guidelines (1–4) ────────────────────────────────────────────

1. THINK FIRST – State assumptions. Surface ambiguity. Push back on complexity.
2. STAY SIMPLE – Minimum code. No speculative features. No unasked-for abstractions.
3. BE SURGICAL – Touch only what’s required. Own your orphans. Don’t improve neighbors.
4. VERIFY GOALS – Turn tasks into checkable criteria. Loop until they pass. Never commit broken.

── CVKG Extended Protocols (5–7) ──────────────────────────────────────── 5. TRIPLE-PASS – Read the target, its surrounding context, and its full call graph at least THREE TIMES before making any edit or revision. 6. COMMENT ALL – Every major pub fn, unsafe block, and non-trivial algorithm in every .rs/.ts/.h/.wgsl file MUST have a descriptive doc comment. Comments describe WHY and WHAT CONTRACT, not HOW mechanically. 7. MONITOR LOOPS – Check every tool call / command for progress every 30 seconds. After 3 consecutive identical failures, stop, write BLOCKED.md, and move to unblocked work. Never silently accept a broken state.

Sources: Karpathy: https://github.com/multica-ai/andrej-karpathy-skills CVKG Extended: Section 2 of the CVKG Design Specification

Re-exports

pub use taffy_engine::taffy_alignment;

pub use taffy_engine::taffy_distribution;

pub use taffy_engine::taffy_track;

pub use taffy_engine::Flex;

pub use taffy_engine::Grid;

pub use taffy_engine::GridTrack;

pub use taffy_engine::HStack;

pub use taffy_engine::Spacer;

pub use taffy_engine::TaffyLayoutEngine;

pub use taffy_engine::VStack;

pub use taffy_engine::ZStack;

pub use animation::AnimationEngine;

pub use spatial::LayoutSpatialEntry;

pub use spatial::LayoutSpatialIndex;

pub use focus::compute_focus_order;

pub use focus::validate_reading_order;

pub use focus::LayoutModality;

pub use focus::FocusCandidate;

pub use progressive::ProgressiveChild;

pub use progressive::ProgressiveLayoutContext;

pub use primitives::AspectRatio;

pub use primitives::Padding;

pub use primitives::SafeArea;

pub use primitives::SafeAreaEdges;

Modules

animation

focus

primitives

progressive

spatial

taffy_engine

Structs

EdgeInsets

Edge insets for padding, margins, and safe areas

LayoutCapabilities

LayoutCycleGuard

RAII guard that removes the hash from ACTIVE_LAYOUT_NODES on drop.

Functions

layout_capabilities

Returns the layout capabilities supported by this engine.

size_views_parallel

Compute size-that-fits for a batch of independent subviews in parallel when the parallel cargo feature is active.

with_layout_cycle_guard

Helper function to prevent layout calculation cycles in recursive size queries.

with_layout_cycle_guard_void

Helper function to prevent layout calculation cycles in recursive subview placements.