@evanion/astro-widget 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## 0.2.0 (2026-09-10)
+
+### 🩹 Fixes
+
+- ⚠️  **astro-widget:** report validation problems in english ([e51907c](https://github.com/Evanion/libraries/commit/e51907c))
+- ⚠️  **astro-widget:** keep placement data out of block props ([2378269](https://github.com/Evanion/libraries/commit/2378269))
+
+### ⚠️  Breaking Changes
+
+- **astro-widget:** report validation problems in english  ([e51907c](https://github.com/Evanion/libraries/commit/e51907c))
+  BlockProblem.message strings changed. A caller matching on the
+  old text must match "unknown block type", "missing field <name>" and "blocks is
+  not a list" instead.
+- **astro-widget:** keep placement data out of block props  ([2378269](https://github.com/Evanion/libraries/commit/2378269))
+  a block that read placement data out of its own props must now
+  read it from `meta` on the item chrome instead.
+  Part of #71
+
+### ❤️ Thank You
+
+- Claude Opus 5 (1M context)
+- Mikael Pettersson @Evanion
+
 ## 0.1.0 (2026-08-30)
 
 ### 🚀 Features

package/dist/index.js

@@ -8,7 +8,7 @@ function t(e, n, r = {}) {
 	if (!Array.isArray(e)) return [{
 		index: -1,
 		type: "-",
-		message: "sektionslistan är inte en lista"
+		message: "blocks is not a list"
 	}];
 	let i = [];
 	return e.forEach((e, a) => {
@@ -16,14 +16,14 @@ function t(e, n, r = {}) {
 		if (!(o in n)) i.push({
 			index: a,
 			type: o,
-			message: "okänd blocktyp"
+			message: "unknown block type"
 		});
 		else for (let t of r[o] ?? []) {
 			let n = e[t];
 			(n == null || typeof n == "string" && n.trim() === "") && i.push({
 				index: a,
 				type: o,
-				message: `saknar fältet ${t}`
+				message: `missing field ${t}`
 			});
 		}
 		Array.isArray(e?.children) && i.push(...t(e.children, n, r));

package/dist/types.d.ts

@@ -9,6 +9,10 @@ export interface BlockItem {
         <slot />, not through a `children` prop. A block that wants nesting
         renders <Widgets items={children} registry={registry} /> itself. */
     children?: BlockItem[];
+    /** Placement and presentation data for `chrome.item`. Handed to the item
+        wrapper and never spread into the block's own props, because where a
+        block sits is not something the block should know. */
+    meta?: Record<string, unknown>;
     /** Everything else is passed to the component as props. */
     [key: string]: unknown;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;2EAGuE;IACvE,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,2DAA2D;IAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;2EAGuE;IACvE,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB;;6DAEyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evanion/astro-widget",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Render CMS-driven Astro sections from structured block data. Build-time, zero runtime.",
   "keywords": [
     "astro",
@@ -47,15 +47,17 @@
     "!src/**/*.test.*",
     "!src/**/*.spec.*",
     "!src/**/*.test-d.*",
+    "!src/**/__fixtures__/**",
     "!src/test-setup.ts",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "peerDependencies": {
-    "astro": ">=5"
+    "astro": "^7.3.1"
   }
 }

package/src/astro-modules.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Ambient types for `.astro` imports.
+ *
+ * Apps get these from `astro sync`, which writes `.astro/types.d.ts` into the
+ * project. A library has no Astro project to sync, so the one declaration the
+ * tests need is written by hand.
+ */
+declare module '*.astro' {
+  const Component: import('astro/runtime/server/index.js').AstroComponentFactory;
+  export default Component;
+}

package/src/components/Widgets.astro

@@ -29,10 +29,14 @@ const Item = chrome?.item as never;
     const Component = registry[item?.type] as never;
     if (!Component) return null;
 
-    const { type, id, children, ...props } = item;
+    // `meta` is placement data for the item chrome -- grid column, span,
+    // ordering, CMS edit affordances. It is destructured out here so it never
+    // reaches the block: where a block sits is not something the block should
+    // know, and spreading it in would collide with the block's own props.
+    const { type, id, children, meta, ...props } = item;
 
     return Item ? (
-      <Item type={type} id={id} {...props}>
+      <Item type={type} id={id} meta={meta} {...props}>
         <Component {...props} id={id} ctx={ctx} children={children} />
       </Item>
     ) : (

package/src/types.ts

@@ -9,6 +9,10 @@ export interface BlockItem {
       <slot />, not through a `children` prop. A block that wants nesting
       renders <Widgets items={children} registry={registry} /> itself. */
   children?: BlockItem[];
+  /** Placement and presentation data for `chrome.item`. Handed to the item
+      wrapper and never spread into the block's own props, because where a
+      block sits is not something the block should know. */
+  meta?: Record<string, unknown>;
   /** Everything else is passed to the component as props. */
   [key: string]: unknown;
 }

package/src/validate-blocks.ts

@@ -13,7 +13,7 @@ export function validateBlocks(
   required: Record<string, string[]> = {}
 ): BlockProblem[] {
   if (!Array.isArray(items)) {
-    return [{ index: -1, type: '-', message: 'sektionslistan är inte en lista' }];
+    return [{ index: -1, type: '-', message: 'blocks is not a list' }];
   }
 
   const problems: BlockProblem[] = [];
@@ -22,7 +22,7 @@ export function validateBlocks(
     const type = typeof item?.type === 'string' ? item.type : '-';
 
     if (!(type in registry)) {
-      problems.push({ index, type, message: 'okänd blocktyp' });
+      problems.push({ index, type, message: 'unknown block type' });
     } else {
       for (const field of required[type] ?? []) {
         const value = item[field];
@@ -31,7 +31,7 @@ export function validateBlocks(
           value === null ||
           (typeof value === 'string' && value.trim() === '');
         if (blank) {
-          problems.push({ index, type, message: `saknar fältet ${field}` });
+          problems.push({ index, type, message: `missing field ${field}` });
         }
       }
     }