@gradial/aci 0.1.52-rc.4 → 0.1.52-rc.6

package/templates/astro/starter-content/src/fixtures/sections.ts

@@ -14,6 +14,7 @@ export const sectionStoryFixtures: SectionStoryFixture[] = [
     storybookId: 'sections-home-hero--default',
     title: 'Home Hero',
     block: {
+      $type: 'component',
       id: 'fixture-home-hero',
       component: 'home_hero',
       props: {
@@ -22,7 +23,7 @@ export const sectionStoryFixtures: SectionStoryFixture[] = [
         description: 'One content model, three renderers. Build once in Next.js, Astro, and SvelteKit—then prove parity with shared fixtures.',
         ctaLabel: 'Get started',
         ctaHref: '/docs',
-          image: {
+        image: {
           $type: 'gradial.image',
           assetId: 'fixture_seattle',
           versionId: 'v0001',

package/templates/common/.agents/skills/authoring/SKILL.md

@@ -98,6 +98,7 @@ The `home` slug is special-cased to route `/`. All other slugs map directly.
 
 ```json
 {
+  "$type": "component",
   "id": "hero-section",
   "component": "home_hero",
   "props": {
@@ -109,6 +110,7 @@ The `home` slug is special-cased to route `/`. All other slugs map directly.
 ```
 
 - `component` must match a contract `id` exactly.
+- Every embedded block must declare `"$type": "component"`.
 - `props` must validate against the contract's Zod schema.
 - `id` is unique within the page.
 
@@ -141,12 +143,14 @@ export const containerContract = defineComponentContract({
 **Content JSON:**
 ```json
 {
+  "$type": "component",
   "id": "cta-section",
   "component": "container",
   "props": {
     "className": "space-y-4",
     "content": [
       {
+        "$type": "component",
         "id": "primary-cta",
         "component": "button",
         "props": {
@@ -156,6 +160,7 @@ export const containerContract = defineComponentContract({
         }
       },
       {
+        "$type": "component",
         "id": "secondary-cta",
         "component": "button",
         "props": {
@@ -182,6 +187,7 @@ The `button` component is a common atomic block:
 
 ```json
 {
+  "$type": "component",
   "id": "cta-button",
   "component": "button",
   "props": {
@@ -482,6 +488,7 @@ framework.
 ```json
 // .content/pages/home/_index.json (inside regions.main)
 {
+  "$type": "component",
   "id": "features",
   "component": "feature_showcase",
   "props": {
@@ -570,9 +577,10 @@ export default [
 ];
 ```
 
-Fragment content lives in `.content/fragments/{id}/_index.json` and has
-a `component` + `props` just like page blocks. Chrome components (Header,
-Footer) are registered in the registry alongside page components.
+Fragment content lives in `.content/fragments/{id}/_index.json` and retains
+the resource envelope `"$type": "fragment"` while declaring `component` +
+`props`. Chrome components (Header, Footer) are registered in the registry
+alongside page components.
 
 The `layout` field in page JSON is **required** — there is no implicit
 default. Every page must declare which layout it uses.

package/templates/common/.agents/skills/authoring/references/block-slots.md

@@ -113,12 +113,14 @@ type RenderChildren<T extends readonly BlockRef[]> = (blocks: T) => Promise<Reac
 
 ```json
 {
+  "$type": "component",
   "id": "cta-section",
   "component": "container",
   "props": {
     "theme": "dark",
     "blocks": [
       {
+        "$type": "component",
         "id": "primary-cta",
         "component": "callout",
         "props": {
@@ -127,6 +129,7 @@ type RenderChildren<T extends readonly BlockRef[]> = (blocks: T) => Promise<Reac
         }
       },
       {
+        "$type": "component",
         "id": "heading",
         "component": "heading",
         "props": {

package/templates/common/.content/pages/home/_index.json

@@ -11,6 +11,7 @@
   "regions": {
     "main": [
       {
+        "$type": "component",
         "id": "hero",
         "component": "home_hero",
         "props": {
@@ -27,6 +28,7 @@
         }
       },
       {
+        "$type": "component",
         "id": "why-meridian",
         "component": "feature_grid",
         "props": {
@@ -34,6 +36,7 @@
           "subtitle": "Engineered for the edges of the world.",
           "features": [
             {
+              "$type": "component",
               "id": "global-coverage",
               "component": "feature_card",
               "props": {
@@ -43,6 +46,7 @@
               }
             },
             {
+              "$type": "component",
               "id": "low-latency",
               "component": "feature_card",
               "props": {
@@ -52,6 +56,7 @@
               }
             },
             {
+              "$type": "component",
               "id": "easy-setup",
               "component": "feature_card",
               "props": {
@@ -64,6 +69,7 @@
         }
       },
       {
+        "$type": "component",
         "id": "personalization-choice",
         "component": "personalization_choice",
         "props": {
@@ -75,6 +81,7 @@
         }
       },
       {
+        "$type": "component",
         "id": "stats",
         "component": "stats_bar",
         "props": {
@@ -87,6 +94,7 @@
         }
       },
       {
+        "$type": "component",
         "id": "cta",
         "component": "container",
         "props": {
@@ -94,6 +102,7 @@
           "className": "items-center justify-center text-center",
           "content": [
             {
+              "$type": "component",
               "id": "cta-primary",
               "component": "button",
               "props": {
@@ -105,6 +114,7 @@
               }
             },
             {
+              "$type": "component",
               "id": "cta-secondary",
               "component": "button",
               "props": {

package/templates/common/starter-content/.content/.rules-baseline.json

@@ -0,0 +1,8 @@
+{
+  "version": 1,
+  "rules": {
+    "no-public-resource-paths": [
+      "/assets/meridian-logo.svg"
+    ]
+  }
+}

package/templates/common/starter-content/.content/content-rules/no-public-resource-paths.json

@@ -0,0 +1,6 @@
+{
+  "kind": "forbid-string-pattern",
+  "pattern": "^/[^\\s]+\\.(png|jpe?g|webp|gif|svg|avif|mp4|webm|ico)$",
+  "appliesTo": "all-string-props",
+  "message": "Content must not reference front-end public/ resources."
+}

package/templates/common/starter-content/.content/fragments/navbar/_index.json

@@ -1,25 +1,28 @@
 {
   "$type": "fragment",
   "fragmentId": "navbar",
-  "component": "site-navigation",
-  "props": {
-    "brandHref": "/",
-    "brandLabel": "Meridian",
-    "brandLogo": {
-      "src": "/assets/meridian-logo.svg",
-      "alt": "Meridian"
-    },
-    "navigation": [
-      { "id": "home", "label": "Home", "href": "/" },
-      { "id": "plans", "label": "Plans", "href": "/plans/" },
-      { "id": "devices", "label": "Devices", "href": "/devices/" },
-      { "id": "business", "label": "Business", "href": "/business/" },
-      { "id": "blog", "label": "Blog", "href": "/blog/" },
-      { "id": "about", "label": "About", "href": "/about/" }
-    ],
-    "utilities": [
-      { "id": "sign-in", "label": "Sign in", "href": "/sign-in/", "variant": "ghost" },
-      { "id": "contact-sales", "label": "Contact sales", "href": "/contact-sales/", "variant": "primary" }
-    ]
+  "block": {
+    "$type": "component",
+    "component": "site-navigation",
+    "props": {
+      "brandHref": "/",
+      "brandLabel": "Meridian",
+      "brandLogo": {
+        "src": "/assets/meridian-logo.svg",
+        "alt": "Meridian"
+      },
+      "navigation": [
+        { "id": "home", "label": "Home", "href": "/" },
+        { "id": "plans", "label": "Plans", "href": "/plans/" },
+        { "id": "devices", "label": "Devices", "href": "/devices/" },
+        { "id": "business", "label": "Business", "href": "/business/" },
+        { "id": "blog", "label": "Blog", "href": "/blog/" },
+        { "id": "about", "label": "About", "href": "/about/" }
+      ],
+      "utilities": [
+        { "id": "sign-in", "label": "Sign in", "href": "/sign-in/", "variant": "ghost" },
+        { "id": "contact-sales", "label": "Contact sales", "href": "/contact-sales/", "variant": "primary" }
+      ]
+    }
   }
 }

package/templates/common/starter-content/.content/fragments/site-footer/_index.json

@@ -1,62 +1,65 @@
 {
   "$type": "fragment",
   "fragmentId": "site-footer",
-  "component": "site-footer",
-  "props": {
-    "brandHref": "/",
-    "brandLabel": "Meridian",
-    "brandLogo": {
-      "src": "/assets/meridian-logo.svg",
-      "alt": "Meridian"
-    },
-    "columns": [
-      {
-        "id": "products",
-        "title": "Products",
-        "links": [
-          { "id": "plans", "label": "Plans", "href": "/plans/" },
-          { "id": "devices", "label": "Devices", "href": "/devices/" },
-          { "id": "coverage", "label": "Coverage", "href": "/coverage/" }
-        ]
+  "block": {
+    "$type": "component",
+    "component": "site-footer",
+    "props": {
+      "brandHref": "/",
+      "brandLabel": "Meridian",
+      "brandLogo": {
+        "src": "/assets/meridian-logo.svg",
+        "alt": "Meridian"
       },
-      {
-        "id": "solutions",
-        "title": "Solutions",
-        "links": [
-          { "id": "business", "label": "Business", "href": "/business/" },
-          { "id": "maritime", "label": "Maritime", "href": "/business/maritime/" },
-          { "id": "aerospace", "label": "Aerospace", "href": "/business/aerospace/" }
-        ]
-      },
-      {
-        "id": "resources",
-        "title": "Resources",
-        "links": [
-          { "id": "blog", "label": "Blog", "href": "/blog/" },
-          { "id": "documentation", "label": "Documentation", "href": "/docs/" },
-          { "id": "support", "label": "Support", "href": "/support/" }
-        ]
-      },
-      {
-        "id": "company",
-        "title": "Company",
-        "links": [
-          { "id": "about", "label": "About us", "href": "/about/" },
-          { "id": "careers", "label": "Careers", "href": "/careers/" },
-          { "id": "contact", "label": "Contact", "href": "/contact/" }
-        ]
-      }
-    ],
-    "social": [
-      { "id": "x", "label": "X", "href": "https://x.com/meridian", "icon": "X" },
-      { "id": "linkedin", "label": "LinkedIn", "href": "https://www.linkedin.com/company/meridian", "icon": "in" },
-      { "id": "youtube", "label": "YouTube", "href": "https://www.youtube.com/meridian", "icon": "YT" }
-    ],
-    "legalLinks": [
-      { "id": "terms", "label": "Terms of Service", "href": "/terms/" },
-      { "id": "privacy", "label": "Privacy Policy", "href": "/privacy/" },
-      { "id": "security", "label": "Security", "href": "/security/" }
-    ],
-    "copyright": "Copyright (c) 2026 Meridian Satellite Networks, Inc. All rights reserved."
+      "columns": [
+        {
+          "id": "products",
+          "title": "Products",
+          "links": [
+            { "id": "plans", "label": "Plans", "href": "/plans/" },
+            { "id": "devices", "label": "Devices", "href": "/devices/" },
+            { "id": "coverage", "label": "Coverage", "href": "/coverage/" }
+          ]
+        },
+        {
+          "id": "solutions",
+          "title": "Solutions",
+          "links": [
+            { "id": "business", "label": "Business", "href": "/business/" },
+            { "id": "maritime", "label": "Maritime", "href": "/business/maritime/" },
+            { "id": "aerospace", "label": "Aerospace", "href": "/business/aerospace/" }
+          ]
+        },
+        {
+          "id": "resources",
+          "title": "Resources",
+          "links": [
+            { "id": "blog", "label": "Blog", "href": "/blog/" },
+            { "id": "documentation", "label": "Documentation", "href": "/docs/" },
+            { "id": "support", "label": "Support", "href": "/support/" }
+          ]
+        },
+        {
+          "id": "company",
+          "title": "Company",
+          "links": [
+            { "id": "about", "label": "About us", "href": "/about/" },
+            { "id": "careers", "label": "Careers", "href": "/careers/" },
+            { "id": "contact", "label": "Contact", "href": "/contact/" }
+          ]
+        }
+      ],
+      "social": [
+        { "id": "x", "label": "X", "href": "https://x.com/meridian", "icon": "X" },
+        { "id": "linkedin", "label": "LinkedIn", "href": "https://www.linkedin.com/company/meridian", "icon": "in" },
+        { "id": "youtube", "label": "YouTube", "href": "https://www.youtube.com/meridian", "icon": "YT" }
+      ],
+      "legalLinks": [
+        { "id": "terms", "label": "Terms of Service", "href": "/terms/" },
+        { "id": "privacy", "label": "Privacy Policy", "href": "/privacy/" },
+        { "id": "security", "label": "Security", "href": "/security/" }
+      ],
+      "copyright": "Copyright (c) 2026 Meridian Satellite Networks, Inc. All rights reserved."
+    }
   }
 }

package/templates/common/starter-content/.content/pages/404/_index.json

@@ -11,6 +11,7 @@
   "regions": {
     "main": [
       {
+        "$type": "component",
         "id": "not-found-hero",
         "component": "home_hero",
         "props": {

package/templates/common/starter-content/.content/pages/about/_index.json

@@ -11,6 +11,7 @@
   "regions": {
     "main": [
       {
+        "$type": "component",
         "id": "about-hero",
         "component": "home_hero",
         "props": {
@@ -27,12 +28,14 @@
         }
       },
       {
+        "$type": "component",
         "id": "about-actions",
         "component": "container",
         "props": {
           "className": "items-center justify-center text-center",
           "content": [
             {
+              "$type": "component",
               "id": "home-link",
               "component": "button",
               "props": {

package/templates/common/starter-content/.content/pages/error/_index.json

@@ -11,6 +11,7 @@
   "regions": {
     "main": [
       {
+        "$type": "component",
         "id": "error-hero",
         "component": "home_hero",
         "props": {

package/templates/common/starter-content/.content/pages/home/_index.json

@@ -11,6 +11,7 @@
   "regions": {
     "main": [
       {
+        "$type": "component",
         "id": "hero",
         "component": "home_hero",
         "props": {
@@ -27,6 +28,7 @@
         }
       },
       {
+        "$type": "component",
         "id": "why-meridian",
         "component": "feature_grid",
         "props": {
@@ -34,6 +36,7 @@
           "subtitle": "Engineered for the edges of the world.",
           "features": [
             {
+              "$type": "component",
               "id": "global-coverage",
               "component": "feature_card",
               "props": {
@@ -43,6 +46,7 @@
               }
             },
             {
+              "$type": "component",
               "id": "low-latency",
               "component": "feature_card",
               "props": {
@@ -52,6 +56,7 @@
               }
             },
             {
+              "$type": "component",
               "id": "easy-setup",
               "component": "feature_card",
               "props": {
@@ -64,6 +69,7 @@
         }
       },
       {
+        "$type": "component",
         "id": "stats",
         "component": "stats_bar",
         "props": {
@@ -92,6 +98,7 @@
         }
       },
       {
+        "$type": "component",
         "id": "cta",
         "component": "container",
         "props": {
@@ -99,6 +106,7 @@
           "className": "items-center justify-center text-center",
           "content": [
             {
+              "$type": "component",
               "id": "cta-primary",
               "component": "button",
               "props": {
@@ -110,6 +118,7 @@
               }
             },
             {
+              "$type": "component",
               "id": "cta-secondary",
               "component": "button",
               "props": {

package/templates/common/starter-content/.content/patterns/components/button.json

@@ -0,0 +1,55 @@
+{
+  "$type": "componentPattern",
+  "buildId": "codebuild_01a01331-b53d-7bab-a900-d3cef26465d6",
+  "codeDigest": "sha256:827b1337ab20e5c054419de4e66f6ffedfc210ca1c34dfdee6c23091edd69d02",
+  "name": "button",
+  "schema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "button",
+    "type": "object",
+    "properties": {
+      "label": {
+        "type": "string",
+        "minLength": 1
+      },
+      "href": {
+        "type": "string",
+        "minLength": 1
+      },
+      "variant": {
+        "type": "string",
+        "enum": [
+          "primary",
+          "secondary",
+          "tertiary",
+          "outline",
+          "ghost"
+        ]
+      },
+      "newWindow": {
+        "type": "boolean"
+      },
+      "icon": {
+        "type": "string"
+      },
+      "iconPosition": {
+        "type": "string",
+        "enum": [
+          "before",
+          "after"
+        ]
+      },
+      "className": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "label",
+      "href"
+    ],
+    "additionalProperties": false
+  },
+  "imageSlots": {},
+  "notes": "",
+  "skills": []
+}

package/templates/common/starter-content/.content/patterns/components/container.json

@@ -0,0 +1,62 @@
+{
+  "$type": "componentPattern",
+  "buildId": "codebuild_01a01331-b53d-7bab-a900-d3cef26465d6",
+  "codeDigest": "sha256:827b1337ab20e5c054419de4e66f6ffedfc210ca1c34dfdee6c23091edd69d02",
+  "name": "container",
+  "schema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "container",
+    "type": "object",
+    "properties": {
+      "theme": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "light",
+          "dark"
+        ]
+      },
+      "className": {
+        "type": "string"
+      },
+      "content": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "$type": {
+              "type": "string",
+              "const": "component"
+            },
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "component": {
+              "type": "string",
+              "minLength": 1
+            },
+            "props": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "$type",
+            "id",
+            "component",
+            "props"
+          ],
+          "additionalProperties": false
+        }
+      }
+    },
+    "additionalProperties": false
+  },
+  "imageSlots": {},
+  "notes": "",
+  "skills": []
+}

package/templates/common/starter-content/.content/patterns/components/feature_card.json

@@ -0,0 +1,30 @@
+{
+  "$type": "componentPattern",
+  "buildId": "codebuild_01a01331-b53d-7bab-a900-d3cef26465d6",
+  "codeDigest": "sha256:827b1337ab20e5c054419de4e66f6ffedfc210ca1c34dfdee6c23091edd69d02",
+  "name": "feature_card",
+  "schema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "feature_card",
+    "type": "object",
+    "properties": {
+      "icon": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "title"
+    ],
+    "additionalProperties": false
+  },
+  "imageSlots": {},
+  "notes": "",
+  "skills": []
+}