@spark-line/web-framework 0.1.0

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,cAAc,GAAG,YAAY,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB,CAChC,UAAU,SAAS,mBAAmB,GAAG,mBAAmB;IAE5D,QAAQ,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,CAAC;IAC3C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC;CACjC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,CAAC,UAAU,SAAS,mBAAmB,EAC5C,UAAU,EAAE,SAAS,UAAU,EAAE,GAAG,iBAAiB,CAAC,UAAU,CAAC,CA6BlE;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4InB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,170 @@
+export function defineComponentRegistry(components) {
+    const byId = new Map();
+    for (const component of components) {
+        if (byId.has(component.id)) {
+            throw new Error(`Duplicate component id: ${component.id}`);
+        }
+        if (component.scenarios.length === 0) {
+            throw new Error(`Component ${component.id} needs at least one catalog scenario`);
+        }
+        byId.set(component.id, Object.freeze(component));
+    }
+    const frozenComponents = Object.freeze([...components]);
+    return Object.freeze({
+        components: frozenComponents,
+        get(id) {
+            return byId.get(id);
+        },
+        has(id) {
+            return byId.has(id);
+        },
+        require(id) {
+            const component = byId.get(id);
+            if (!component)
+                throw new Error(`Unknown component id: ${id}`);
+            return component;
+        }
+    });
+}
+export const frameworkRegistry = defineComponentRegistry([
+    {
+        id: "page-flow",
+        kind: "primitive",
+        variants: ["main", "div"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "default", label: "Page flow" }]
+    },
+    {
+        id: "section",
+        kind: "primitive",
+        variants: ["default", "inverse", "accent", "quiet"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [
+            { id: "themes", label: "Themes" },
+            { id: "spacing", label: "Spacing edges" }
+        ]
+    },
+    {
+        id: "section-group",
+        kind: "primitive",
+        variants: ["joined", "overlap"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "modes", label: "Grouping modes" }]
+    },
+    {
+        id: "container",
+        kind: "primitive",
+        variants: ["narrow", "content", "wide", "full"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "widths", label: "Container widths" }]
+    },
+    {
+        id: "stack",
+        kind: "primitive",
+        variants: ["none", "xs", "sm", "md", "lg", "xl"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "gaps", label: "Vertical gaps" }]
+    },
+    {
+        id: "cluster",
+        kind: "primitive",
+        variants: ["start", "center", "end", "between"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "alignment", label: "Wrapped alignment" }]
+    },
+    {
+        id: "grid",
+        kind: "primitive",
+        variants: ["fixed", "auto-fit", "auto-fill"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "responsive", label: "Responsive columns" }]
+    },
+    {
+        id: "visual-frame",
+        kind: "primitive",
+        variants: ["aspect-ratio", "reserved-block-size"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "reserved-space", label: "Reserved visual space" }]
+    },
+    {
+        id: "heading",
+        kind: "primitive",
+        variants: ["display", "h1", "h2", "h3", "h4", "h5", "h6"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "scale", label: "Project type scale" }]
+    },
+    {
+        id: "text",
+        kind: "primitive",
+        variants: ["small", "body", "lead", "muted"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "scale", label: "Text roles" }]
+    },
+    {
+        id: "action",
+        kind: "primitive",
+        variants: ["primary", "secondary", "quiet"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "states", label: "Actions and focus states" }]
+    },
+    {
+        id: "card-shell",
+        kind: "primitive",
+        variants: ["default", "quiet", "accent"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "surfaces", label: "Project card surfaces" }]
+    },
+    {
+        id: "disclosure",
+        kind: "primitive",
+        variants: ["closed", "open"],
+        status: "stable",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "native", label: "Native disclosure" }]
+    },
+    {
+        id: "tabs",
+        kind: "island",
+        variants: ["default"],
+        status: "experimental",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "keyboard", label: "Keyboard tabs" }]
+    },
+    {
+        id: "carousel",
+        kind: "island",
+        variants: ["default"],
+        status: "experimental",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "controls", label: "Previous and next controls" }]
+    },
+    {
+        id: "dialog",
+        kind: "island",
+        variants: ["modal"],
+        status: "experimental",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "native", label: "Native modal dialog" }]
+    },
+    {
+        id: "menu",
+        kind: "island",
+        variants: ["links"],
+        status: "experimental",
+        provenance: "@spark-line/web-framework",
+        scenarios: [{ id: "keyboard", label: "Keyboard menu" }]
+    }
+]);
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"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"}

package/dist/sanity/index.d.ts

@@ -0,0 +1,57 @@
+export type SectionTheme = "default" | "inverse" | "accent" | "quiet";
+export type SectionSpace = "none" | "xs" | "sm" | "md" | "lg" | "xl";
+export interface SanitySectionRecord {
+    _type: string;
+    _key?: string;
+    theme?: SectionTheme;
+    spaceTop?: SectionSpace;
+    spaceBottom?: SectionSpace;
+    layout?: string;
+    [field: string]: unknown;
+}
+export interface SectionRegistration {
+    type: string;
+    componentId: string;
+    layouts?: readonly string[];
+    themes?: readonly SectionTheme[];
+    spaces?: readonly SectionSpace[];
+    defaults?: {
+        layout?: string;
+        theme?: SectionTheme;
+        spaceTop?: SectionSpace;
+        spaceBottom?: SectionSpace;
+    };
+}
+export interface SectionRegistry {
+    readonly sections: readonly SectionRegistration[];
+    get(type: string): SectionRegistration | undefined;
+    require(type: string): SectionRegistration;
+}
+export interface NormalizedSection {
+    key: string;
+    type: string;
+    componentId: string | null;
+    props: SanitySectionRecord;
+    source: SanitySectionRecord;
+    known: boolean;
+}
+export type UnknownSectionPolicy = "omit" | "preserve" | "throw";
+export declare function defineSectionRegistry(sections: readonly SectionRegistration[]): SectionRegistry;
+export declare function normalizePageSections(records: readonly SanitySectionRecord[], registry: SectionRegistry, options?: {
+    onUnknown?: UnknownSectionPolicy;
+}): NormalizedSection[];
+export interface SectionSchemaOptions {
+    name: string;
+    title: string;
+    sectionTypes: readonly string[];
+    themes?: readonly SectionTheme[];
+    spaces?: readonly SectionSpace[];
+    layouts?: readonly string[];
+}
+export declare function defineSectionSchema(options: SectionSchemaOptions): {
+    readonly name: string;
+    readonly title: string;
+    readonly type: "object";
+    readonly fields: Record<string, unknown>[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/sanity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sanity/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,YAAY,CAAC;QACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,WAAW,CAAC,EAAE,YAAY,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IACnD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GACvC,eAAe,CAsBjB;AAsBD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,oBAAoB,CAAA;CAAO,GACjD,iBAAiB,EAAE,CA4CrB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB;;;;;EA2ChE"}

package/dist/sanity/index.js

@@ -0,0 +1,117 @@
+export function defineSectionRegistry(sections) {
+    const byType = new Map();
+    for (const section of sections) {
+        if (byType.has(section.type)) {
+            throw new Error(`Duplicate Sanity section type: ${section.type}`);
+        }
+        byType.set(section.type, Object.freeze({ ...section }));
+    }
+    const frozenSections = Object.freeze([...byType.values()]);
+    return Object.freeze({
+        sections: frozenSections,
+        get(type) {
+            return byType.get(type);
+        },
+        require(type) {
+            const section = byType.get(type);
+            if (!section)
+                throw new Error(`Unknown Sanity section type: ${type}`);
+            return section;
+        }
+    });
+}
+function assertAllowed(section, field, value) {
+    if (value === undefined)
+        return;
+    const allowed = field === "layout"
+        ? section.layouts
+        : field === "theme"
+            ? section.themes
+            : section.spaces;
+    if (allowed && !allowed.includes(value)) {
+        throw new Error(`Invalid ${field} "${value}" for ${section.type}; expected ${allowed.join(", ")}`);
+    }
+}
+export function normalizePageSections(records, registry, options = {}) {
+    const policy = options.onUnknown ?? "omit";
+    const normalized = [];
+    records.forEach((record, index) => {
+        const registration = registry.get(record._type);
+        if (!registration) {
+            if (policy === "throw") {
+                throw new Error(`Unknown Sanity section type: ${record._type}`);
+            }
+            if (policy === "preserve") {
+                normalized.push({
+                    key: record._key ?? `${record._type}-${index}`,
+                    type: record._type,
+                    componentId: null,
+                    props: { ...record },
+                    source: record,
+                    known: false
+                });
+            }
+            return;
+        }
+        const props = {
+            ...registration.defaults,
+            ...record
+        };
+        assertAllowed(registration, "layout", props.layout);
+        assertAllowed(registration, "theme", props.theme);
+        assertAllowed(registration, "spaceTop", props.spaceTop);
+        assertAllowed(registration, "spaceBottom", props.spaceBottom);
+        normalized.push({
+            key: record._key ?? `${record._type}-${index}`,
+            type: record._type,
+            componentId: registration.componentId,
+            props,
+            source: record,
+            known: true
+        });
+    });
+    return normalized;
+}
+export function defineSectionSchema(options) {
+    const fields = [
+        {
+            name: "sections",
+            title: "Sections",
+            type: "array",
+            of: options.sectionTypes.map((type) => ({ type }))
+        }
+    ];
+    if (options.themes?.length) {
+        fields.push({
+            name: "theme",
+            title: "Theme",
+            type: "string",
+            options: { list: options.themes }
+        });
+    }
+    if (options.spaces?.length) {
+        for (const edge of ["spaceTop", "spaceBottom"]) {
+            fields.push({
+                name: edge,
+                title: edge === "spaceTop" ? "Space above" : "Space below",
+                type: "string",
+                options: { list: options.spaces }
+            });
+        }
+    }
+    if (options.layouts?.length) {
+        fields.push({
+            name: "layout",
+            title: "Layout",
+            type: "string",
+            options: { list: options.layouts }
+        });
+    }
+    return {
+        name: options.name,
+        title: options.title,
+        type: "object",
+        fields
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/sanity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sanity/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@spark-line/web-framework",
+  "version": "0.1.0",
+  "description": "Structural UI contracts and accessible primitives for Astro, optional React islands, and optional Sanity section data.",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": [
+    "./styles/*.css"
+  ],
+  "files": [
+    "dist/",
+    "src/astro/",
+    "styles/",
+    "starter/",
+    "skills/",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    "./astro": {
+      "types": "./src/astro/index.d.ts",
+      "import": "./dist/astro/index.js",
+      "default": "./dist/astro/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
+    },
+    "./sanity": {
+      "types": "./dist/sanity/index.d.ts",
+      "import": "./dist/sanity/index.js",
+      "default": "./dist/sanity/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "import": "./dist/registry/index.js",
+      "default": "./dist/registry/index.js"
+    },
+    "./styles/foundation.css": "./styles/foundation.css",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/build.mjs",
+    "check": "tsc -p tsconfig.build.json --noEmit && node scripts/validate-package.mjs",
+    "clean": "node scripts/clean.mjs",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "pack:artifact": "node scripts/create-pack.mjs",
+    "test:fixtures": "node scripts/test-packed-fixtures.mjs",
+    "test:browser": "node scripts/test-browser.mjs",
+    "pack:inspect": "node scripts/inspect-pack.mjs",
+    "prepack": "npm run build && npm run check && npm test"
+  },
+  "peerDependencies": {
+    "astro": ">=5 <8",
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20",
+    "sanity": ">=3 <5"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "sanity": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@axe-core/playwright": "^4.10.2",
+    "@playwright/test": "^1.54.2",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "astro": "^7.0.3",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/McTavin/spark-line-web-framework.git"
+  },
+  "bugs": {
+    "url": "https://github.com/McTavin/spark-line-web-framework/issues"
+  },
+  "homepage": "https://github.com/McTavin/spark-line-web-framework#readme"
+}

package/skills/spark-line-web-framework/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: spark-line-web-framework
+description: Inspect, reuse, create, refactor, and verify Spark Line interfaces built with Astro, optional Sanity content, and React islands using the @spark-line/web-framework contracts. Use for page or section design changes, component creation, screenshot or source-faithful implementation, responsive layout corrections, component-gallery work, section adjacency bugs, or frontend architecture decisions in this stack.
+---
+
+# Spark Line Web Framework
+
+Use `@spark-line/web-framework` for structural contracts. Keep project identity,
+content, and approved visual decisions in the project's v14.23 context.
+
+## Start with governed context
+
+1. Read the repository instructions and `v1423.project.json` when present.
+2. Follow the repository's required v14.23 handshake exactly.
+3. Request `context_modules: ["design_authoring", "web_framework"]` for visual
+   or copy work. Request `["web_framework"]` for purely structural frontend work.
+4. Treat framework-version drift as advisory. Never edit dependencies
+   automatically.
+5. If governed context is unavailable, record the repo-visible fallback required
+   by the repository instructions and continue from local evidence.
+
+Do not create a competing design-canon file.
+
+## Inspect before designing
+
+Before editing:
+
+1. Inspect the actual rendered interface, repository implementation, supplied
+   export, and component registry.
+2. Open the component gallery when it exists.
+3. Identify the target section plus its immediate predecessor and successor.
+4. Record the target contract:
+   - theme;
+   - container width;
+   - top and bottom spacing;
+   - layout variant;
+   - reserved visual dimensions;
+   - Astro, Sanity, and React ownership boundaries.
+
+When a reference points to an existing site component, use its real structure
+and approved tokens. Do not approximate it from memory.
+
+## Source components in this order
+
+1. Reuse an exact registered component.
+2. Add a typed variant when structure, semantics, and behavior are unchanged.
+3. Compose registered primitives.
+4. Create a component only for genuinely new structure or behavior.
+5. Register every new component with ID, kind, approved variants, status,
+   provenance, and at least one catalog scenario.
+6. Add every meaningful state to the component gallery.
+
+Read [contracts.md](references/contracts.md) before changing section composition.
+Read [stack-boundaries.md](references/stack-boundaries.md) when Sanity or React
+is involved.
+
+## Implement within ownership boundaries
+
+- Let Astro own page composition, sections, surfaces, containers, spacing, and
+  presentational markup.
+- Let React own interactive state only. Pass serializable data and keep the
+  island inside an Astro-owned frame.
+- Let Sanity store content and controlled variant values. Do not store arbitrary
+  CSS classes or page markup.
+- Use project-supplied semantic tokens. Do not introduce a package palette.
+- Use `VisualFrame` for floating or absolutely positioned visuals and reserve
+  their dimensions before they load.
+- Use `SectionGroup` for intentional joined seams or overlaps.
+- Preserve native semantics, keyboard behavior, visible focus, and reduced
+  motion.
+
+## Verify the changed neighborhood
+
+Run the checklist in [qa-checklist.md](references/qa-checklist.md). At minimum:
+
+1. Inspect the changed section and both adjacent sections at desktop, tablet,
+   and narrow mobile widths.
+2. Check seam, gap, overlap, overflow, theme inheritance, DOM order, anchor
+   behavior, and hydration boundaries.
+3. Confirm the changed section may move its successor in normal flow but does
+   not style or reposition it.
+4. Run existing builds and tests plus the repository's browser checks.
+5. Run `scripts/audit_layout.mjs <paths...>` as an advisory static scan.
+6. Report any deviation; do not silently reinterpret it as an exception.

package/skills/spark-line-web-framework/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Spark Line Web Framework"
+  short_description: "Build and audit Astro, Sanity, and React island interfaces"
+  default_prompt: "Use the Spark Line web framework to inspect, reuse, create, and verify this interface without breaking adjacent sections."

package/skills/spark-line-web-framework/references/contracts.md

@@ -0,0 +1,75 @@
+# Structural contracts
+
+## Component lookup
+
+Use this decision sequence:
+
+1. Exact registry match.
+2. Typed variant of the same semantics and behavior.
+3. Composition from primitives.
+4. New registered component.
+
+A visual resemblance alone does not justify a new component. A new semantic
+role, DOM structure, interaction model, or content contract does.
+
+## Section boundary
+
+`PageFlow` introduces no implicit section gap.
+
+Each `Section` owns:
+
+- its background and semantic theme;
+- its top and bottom internal spacing;
+- its optional contained or full-width presentation;
+- its anchor identifier.
+
+`Container` owns maximum width, centering, and inline gutters. Child layout
+components own internal grid or flex behavior only.
+
+Do not put external block margins on a section root. Do not use sibling
+selectors to reach from one section into another. Do not use ordinary negative
+margins to repair page flow.
+
+Changing a section may change its height and move subsequent content naturally.
+It must not change the next section's theme, spacing, width, grid, or stacking
+order.
+
+## Joined compositions
+
+Use `SectionGroup` when two or more sections deliberately:
+
+- share a background;
+- overlap;
+- visually join without an independent seam;
+- participate in one sticky or pinned composition.
+
+Review every grouped member together. Do not simulate a group by reaching into
+siblings from page-level CSS.
+
+## Floating visuals
+
+Use `VisualFrame` around absolutely positioned, floating, animated, or
+late-loading artwork.
+
+Provide one of:
+
+- an aspect ratio;
+- a minimum reserved block size;
+- a project component that establishes both dimensions.
+
+The frame owns clipping and container-query context. The visual cannot create
+unreserved document height or cover the following section by accident.
+
+## Registry record
+
+Register:
+
+- stable component ID;
+- `primitive`, `section`, `island`, or `pattern` kind;
+- approved variants;
+- `stable`, `experimental`, or `deprecated` status;
+- provenance;
+- at least one component-gallery scenario.
+
+Do not call a component reusable until its relevant responsive, focus, empty,
+loading, error, and reduced-motion states are represented where applicable.