mechanica 2.0.0 → 2.0.1

package/README.md

@@ -45,7 +45,7 @@ src/composer.ts       optional: your design system for the Block Composer
 .mech/data.json       site-wide data values
 ```
 
-`.mech/` is content — commit it. Scaffolded projects also include a `CLAUDE.md` that teaches AI coding assistants to author blocks and pages in this format.
+`.mech/` is content — commit it. Scaffolded projects also include an `AGENTS.md` that teaches AI coding assistants (Claude Code, Codex and others) to author blocks and pages in this format.
 
 ### Adding Mechanica to an existing Vite + Vue project
 
@@ -139,14 +139,29 @@ data:
 
 ::: hero
 title: About us
+cta: { url: /contacts, title: Write to us }
 @subtitle
 We build fast websites
 for people who care about the details.
 :::
+
+::: columns
+gap: lg
+::: card slot=left
+title: Fast
+:::
+::: card slot=right
+title: Readable
+:::
+::: /columns
 ```
 
 - The YAML frontmatter holds the editor label (`name`), page-scoped data (`data`) and optional `layout`, `draft: true` (hidden from listings and the export) and `meta` (`noindex: true`, `lastmod`).
-- Each block is a fence: `::: <blockId>`, then its props as YAML, then `@field` regions for long text, closed by `:::`. A region fills a `text` prop with its text as written, and a `richText` prop with its Markdown turned into rich text. Blocks nest by placing fences inside a container's fence.
+- Each block is a fence: `::: <blockId>`, then its props as YAML, then `@field` regions for long text, then any child blocks, closed by `:::`. Keep that order: once a region has started, a `key: value` line is part of its text.
+- A region runs until the next `@field`, child block or `:::`, and is taken as written, blank lines and Markdown included. It fills a `text` prop with that text, and a `richText` prop with its Markdown turned into rich text.
+- Blocks nest by placing fences inside a container's fence, and `slot=<name>` puts a child into a named slot (a container's children go either all to the default slot or all to named ones). Nothing is indented: every `:::` and `@field` starts at the beginning of its line, and a block is a child of whichever fence is still open. A container may close with `::: /<blockId>`, which reports a missing `:::` at the line where the fences stop pairing up.
+- Props are YAML, so quote a value that starts with `#` or contains `: `, as in `href: "#pricing"`. Inside a region nothing needs quoting; only a line that starts with `:::`, or consists of just `@name`, takes a leading backslash (`\:::`), and not even that inside a code fence.
+- An `image` prop points at an uploaded file: `photo: { src: /@mechanica/assets/team.jpg, alt: "Our team" }`.
 - Props left out take their schema defaults, so a hand-written page renders exactly like one made in the editor.
 
 With `npm run dev` running, edits you make to these files show up in the editor live, and the editor won't overwrite a file that changed on disk underneath it.

package/dist/chunks/{page-assets-Bp6mxPSy.js → page-assets-CM_MCuoa.js}

@@ -975,6 +975,12 @@ function resolveChunkAssets(manifest, key, into = {
 * Build the `<link>` tags for one page: stylesheets first (they must apply
 * before first paint — the server-rendered blocks are already in the HTML),
 * then `modulepreload` for the block chunks and their shared imports.
+*
+* Every tag carries `crossorigin`, like the ones Vite writes into the built
+* index: a later `import()` of the same chunk always fetches in CORS mode, and
+* on a cross-origin CDN a copy cached by a no-CORS hint has no
+* `Access-Control-Allow-Origin`, so the browser would block the import. The
+* attribute is a no-op for same-origin builds.
 */
 function blockAssetLinks(options) {
 	const keyByFile = /* @__PURE__ */ new Map();
@@ -991,7 +997,7 @@ function blockAssetLinks(options) {
 	}
 	const wanted = (file) => !options.alreadyLinked?.(file);
 	const href = (file) => `${options.base ?? ""}/${file}`;
-	return [...assets.css.filter(wanted).map((file) => `<link rel="stylesheet" href="${href(file)}">`), ...assets.js.filter(wanted).map((file) => `<link rel="modulepreload" href="${href(file)}">`)];
+	return [...assets.css.filter(wanted).map((file) => `<link rel="stylesheet" crossorigin href="${href(file)}">`), ...assets.js.filter(wanted).map((file) => `<link rel="modulepreload" crossorigin href="${href(file)}">`)];
 }
 //#endregion
 export { renamePage as A, readImageManifest as B, getPagePath as C, pageUrlOf as D, movePage as E, translationsOf as F, wasRecentlyMutated as G, saveUpload as H, UPLOADS_PREFIX as I, hasSharp as J, writeFileAtomic as K, assetFileOf as L, setPageBlocks as M, setPageCodec as N, pageVersion as O, setPageDraft as P, isDerivedAsset as R, fillImageMeta as S, listPages as T, updateImageManifest as U, saveDerivedAsset as V, markMutated as W, isRasterImage as Y, createTranslation as _, toBlockMeta as a, duplicatePage as b, mergeLocaleFolderData as c, readFolderData as d, readFoldersData as f, createPage as g, PageExistsError as h, composedBlockMeta as i, savePage as j, readPage as k, mergeLocaleSiteData as l, readSiteLocaleOverride as m, blockAssetLinks as n, folderOf as o, readSiteData as p, analyzeImageBuffer as q, buildRichTextCodec as r, mergeFolderData as s, BLOCKS_MANIFEST_FILE as t, mergeSiteData as u, deletePage as v, listFolders as w, fillContentDefaults as x, deleteTranslation as y, listImages as z };

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { B as readImageManifest, C as getPagePath, I as UPLOADS_PREFIX, J as hasSharp, L as assetFileOf, N as setPageCodec, R as isDerivedAsset, T as listPages, U as updateImageManifest, Y as isRasterImage, a as toBlockMeta, d as readFolderData, f as readFoldersData, i as composedBlockMeta, m as readSiteLocaleOverride, n as blockAssetLinks, p as readSiteData, q as analyzeImageBuffer, r as buildRichTextCodec, t as BLOCKS_MANIFEST_FILE } from "./chunks/page-assets-Bp6mxPSy.js";
+import { B as readImageManifest, C as getPagePath, I as UPLOADS_PREFIX, J as hasSharp, L as assetFileOf, N as setPageCodec, R as isDerivedAsset, T as listPages, U as updateImageManifest, Y as isRasterImage, a as toBlockMeta, d as readFolderData, f as readFoldersData, i as composedBlockMeta, m as readSiteLocaleOverride, n as blockAssetLinks, p as readSiteData, q as analyzeImageBuffer, r as buildRichTextCodec, t as BLOCKS_MANIFEST_FILE } from "./chunks/page-assets-CM_MCuoa.js";
 import fs from "node:fs";
 import { dirname, join, parse, relative } from "node:path";
 import { applySeoTags, auditPageHtml, buildRobotsTxt, buildSitemap, findUnknownBlocks, generateProject, isPaginatedQuery, localePath, mergeTranslation, migrateContent, paginationVariantPath, registerFieldSchemas, resolveQueryKey, templateBlockIds, validateLinks, walkSchema, walkTree } from "mechanica-shared";

package/dist/plugin.js

@@ -1,4 +1,4 @@
-import { A as renamePage, D as pageUrlOf, E as movePage, F as translationsOf, G as wasRecentlyMutated, H as saveUpload, K as writeFileAtomic, M as setPageBlocks, N as setPageCodec, O as pageVersion, P as setPageDraft, S as fillImageMeta, T as listPages, V as saveDerivedAsset, W as markMutated, _ as createTranslation, a as toBlockMeta, b as duplicatePage, c as mergeLocaleFolderData, d as readFolderData, g as createPage, h as PageExistsError, i as composedBlockMeta, j as savePage, k as readPage, l as mergeLocaleSiteData, o as folderOf, p as readSiteData, r as buildRichTextCodec, s as mergeFolderData, t as BLOCKS_MANIFEST_FILE, u as mergeSiteData, v as deletePage, w as listFolders, x as fillContentDefaults, y as deleteTranslation, z as listImages } from "./chunks/page-assets-Bp6mxPSy.js";
+import { A as renamePage, D as pageUrlOf, E as movePage, F as translationsOf, G as wasRecentlyMutated, H as saveUpload, K as writeFileAtomic, M as setPageBlocks, N as setPageCodec, O as pageVersion, P as setPageDraft, S as fillImageMeta, T as listPages, V as saveDerivedAsset, W as markMutated, _ as createTranslation, a as toBlockMeta, b as duplicatePage, c as mergeLocaleFolderData, d as readFolderData, g as createPage, h as PageExistsError, i as composedBlockMeta, j as savePage, k as readPage, l as mergeLocaleSiteData, o as folderOf, p as readSiteData, r as buildRichTextCodec, s as mergeFolderData, t as BLOCKS_MANIFEST_FILE, u as mergeSiteData, v as deletePage, w as listFolders, x as fillContentDefaults, y as deleteTranslation, z as listImages } from "./chunks/page-assets-CM_MCuoa.js";
 import fs, { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, join, relative, resolve, sep } from "node:path";
 import { parseVueRequest } from "@vitejs/plugin-vue";

package/dist/types/cli/page-assets.d.ts

@@ -68,5 +68,11 @@ export interface BlockAssetLinkOptions {
  * Build the `<link>` tags for one page: stylesheets first (they must apply
  * before first paint — the server-rendered blocks are already in the HTML),
  * then `modulepreload` for the block chunks and their shared imports.
+ *
+ * Every tag carries `crossorigin`, like the ones Vite writes into the built
+ * index: a later `import()` of the same chunk always fetches in CORS mode, and
+ * on a cross-origin CDN a copy cached by a no-CORS hint has no
+ * `Access-Control-Allow-Origin`, so the browser would block the import. The
+ * attribute is a no-op for same-origin builds.
  */
 export declare function blockAssetLinks(options: BlockAssetLinkOptions): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mechanica",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Build Vue 3 websites with a visual block editor",
   "license": "MIT",
   "repository": {
@@ -54,10 +54,10 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun ../../scripts/ensure-bun-publish.js && bun run build"
   },
   "dependencies": {
-    "mechanica-shared": "workspace:*",
+    "mechanica-shared": "2.0.1",
     "@vue/compiler-sfc": "^3.5.38",
     "compact-json-schema": "^0.1.5",
     "estree-walker": "^3.0.3",