Context Vigilance
The why beneath the code
Specs, habits, and reflections that shape how LFM is built. Versioned context, intentionally legible. The full LFM spec lives in astro-knots ; this page collects the LFM-specific notes that ride alongside the package.
general
-
Maintain Heading Anchors And Share Links
A fragment URL is a public contract, and we currently ship two incompatible definitions of it. This moves anchor identity into LFM as data, leaves the share affordance in the render layer, and fixes collisions nobody is handling.
-
Workspace vs JSR for LFM Consumers
Why most consumer sites should pin @lossless-group/lfm to JSR while exactly one acts as the local workspace sandbox — and the boring deploy-host failure mode that forces the discipline.
-
Maintain an Elegant Markdown and Extended Markdown Render Pipeline
-
Render AST in Debug
Exploration of AST structure at each stage of markdown processing to understand how to handle callouts
-
Maintain Figma Object Embeds Using Embed Kit
Embed live Figma files, frames, and prototypes inside markdown via the `:figma-embed` text directive — width, height, and auth-user as attributes.
-
Conditional Component Rendering in Layout Pipelines
Implement flexible layout component rendering with optional parameter controls for InfoSidebar and TableOfContents suppression
-
Maintain Directives In Extended Markdown Render Pipeline
Directives bring MDX like component rendering using special extended markdown syntax.
-
Maintain Embeddable Slides