How izhanruaif/flam-adaptive-layout-engine-assignment works
Flam is a declarative ad-layout engine demonstrated through an interactive React app. Users choose a predefined surface or enter custom dimensions; the app resolves the ad specification into positioned elements and displays that result through either the DOM or Canvas renderer. The core stages are specification, surface profiles, constraint-based resolution, and rendering. README documents scaling, aspect-ratio strategies, and priority degradation as resolver capabilities. The sampled files show the main wiring; other UI details and unexcerpted resolver logic are not asserted beyond documented behavior.
Main entry points: App.tsx Demo controls · resolver.ts Layout resolver · spec.ts Ad specification · render-dom.tsx DOM renderer
Components 9
Interactive Demo
- Demo controls
src/App.tsx - React entry
src/main.tsx
Layout Inputs
- Ad specification
src/spec.ts - Surface profiles
src/surfaces.ts
Resolution Engine
- Layout resolver
src/resolver.ts
Renderers
- DOM renderer
src/render-dom.tsx - Canvas renderer
src/render-canvas.ts
Other components
- Demo user
- Browser display
Connections 14
- Demo user → Demo controls: chooses surface
src/App.tsx - React entry → Demo controls: renders
src/main.tsx - Demo controls → Ad specification: defines ad
src/App.tsx - Demo controls → Surface profiles: selects profiles
src/App.tsx - Demo controls → Layout resolver: resolves layout
src/App.tsx - Layout resolver → Ad specification: reads elements
src/resolver.ts - Layout resolver → Surface profiles: reads constraints
src/resolver.ts - Demo controls → DOM renderer: renders DOM
src/App.tsx - Demo controls → Canvas renderer: renders canvas
src/App.tsx - DOM renderer → Ad specification: reads content
src/render-dom.tsx - DOM renderer → Layout resolver: uses coordinates
src/render-dom.tsx - Canvas renderer → Ad specification: reads content
src/render-canvas.ts - Canvas renderer → Layout resolver: uses coordinates
src/render-canvas.ts - Demo controls → Browser display: displays result