@homepages/template-kit 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @homepages/template-kit
 
+## 0.8.0
+
+### Minor Changes
+
+- 3f9d98e: `renderSectionHtml` now emits hydration-ready markup (`renderToString`) instead of
+  static markup. Sections carrying a `"use client"` island could not hydrate in
+  `template-kit dev`, because static markup strips the markers the island runtime
+  needs. Rendered HTML gains React's `<!-- -->` text separators, so any test
+  asserting exact HTML from `@homepages/template-kit/ssr` — or from `template-kit
+check` — needs its expectation updated.
+
+### Patch Changes
+
+- 735cfae: Islands now declare their editor-canvas behavior explicitly. A "use client" component with
+  a default export must `export const editor` with a boolean `live`: `{ live: true }` hydrates
+  it in the editor canvas, `{ live: false }` leaves it as static server-rendered HTML there.
+  The new `require-island-editor` rule reports an island that declares neither. Previously an
+  undeclared island silently stayed static — the same code for "static, on purpose" and "not
+  thought about yet". Add `export const editor = { live: false };` to keep an existing
+  island's current behavior. The new `IslandEditor` type is exported for `satisfies`.
+- dad1c9a: Repository layout only: both packages now live under `packages/*` behind a private
+  workspace root. No changes to the published API, exports, types, CLI, or the
+  `create-homepages-workspace` scaffolding experience — installing and using either
+  package is exactly as before.
+
 ## 0.7.0
 
 ### Minor Changes

package/dist/cli/check/stages/render.js

@@ -1,14 +1,10 @@
 import { FixtureModuleShape, buildInvariantFixtures } from "../../../schema/fixture-schema.js";
 import { loadSection } from "../loader.js";
 import { flattenLayout } from "../../../schema/rows.js";
+import { renderSectionHtml } from "../../../ssr.js";
 import { checkRenderInvariants } from "../render-invariants.js";
-import { createElement } from "react";
-import { renderToStaticMarkup } from "react-dom/server";
 
 //#region src/cli/check/stages/render.ts
-function renderSectionHtml(renderer, props) {
-	return renderToStaticMarkup(createElement(renderer, props));
-}
 const SLOT_ID_RE = /data-slot-id="([^"]*)"/g;
 function renderSlotOrder(html) {
 	const seen = /* @__PURE__ */ new Set();
@@ -98,4 +94,4 @@ async function renderStage(workspaceRoot, template) {
 }
 
 //#endregion
-export { checkSidebarOrder, renderSectionHtml, renderStage };
+export { checkSidebarOrder, renderStage };

package/dist/cli/check/stages/validate/nav-contract.js

@@ -1,13 +1,12 @@
 import { FixtureModuleShape, buildFixtureSet } from "../../../../schema/fixture-schema.js";
 import { TemplateManifest } from "../../../../schema/manifest.js";
 import { loadSection } from "../../loader.js";
+import { renderSectionHtml } from "../../../../ssr.js";
 import { resolveSectionRef } from "../../../../schema/resolve-section-ref.js";
 import { materializeSection } from "./orchestrator.js";
 import { resolveAnchorMap } from "../../../../schema/section-nav.js";
-import { createElement } from "react";
 import { join } from "node:path";
 import { readFile } from "node:fs/promises";
-import { renderToStaticMarkup } from "react-dom/server";
 
 //#region src/cli/check/stages/validate/nav-contract.ts
 const ALLOWED_EXTERNAL_ANCHORS = ["#privacy-policy"];
@@ -75,7 +74,7 @@ async function assertNavContract(workspaceRoot, template) {
 			selfAnchor: anchor
 		}).find((f) => f.id === "typical");
 		if (!base) throw new Error(`Template "${template.key}": section "${section.name}" has no "typical" base fixture.`);
-		html += renderToStaticMarkup(createElement(rendererByName.get(section.name), {
+		html += renderSectionHtml(rendererByName.get(section.name), {
 			slots: base.props.slots,
 			options: base.props.options,
 			nav: {
@@ -83,7 +82,7 @@ async function assertNavContract(workspaceRoot, template) {
 				anchors
 			},
 			variants: base.props.variants
-		}));
+		});
 	}
 	const violations = collectNavViolations(html, ALLOWED_EXTERNAL_ANCHORS);
 	if (violations.length > 0) throw new Error(`Template "${template.key}": nav link(s) resolve to no composed section id: ${violations.join(", ")}.`);

package/dist/cli/dev/structure-summary.js

@@ -30,6 +30,7 @@ function decode(s) {
 	return s.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&#39;/g, "'");
 }
 function parseHtml(html) {
+	html = html.replace(/<!--[\s\S]*?-->/g, "");
 	const root = {
 		tag: "#root",
 		classes: [],

package/dist/cli/new/scaffold-assets.js

@@ -7,7 +7,7 @@ const here = dirname(fileURLToPath(import.meta.url));
 function assetsRoot() {
 	const dist = join(here, "scaffold");
 	if (existsSync(dist)) return dist;
-	return join(here, "..", "..", "..", "create-homepages-workspace", "scaffold");
+	return join(here, "..", "..", "..", "..", "create-homepages-workspace", "scaffold");
 }
 function templateAssetsDir() {
 	return join(assetsRoot(), "template");

package/dist/eslint/rules/require-island-editor.js

@@ -0,0 +1,74 @@
+import { docsPathForRule } from "../../rules/registry.js";
+import { hasClientDirective } from "../is-client-file.js";
+
+//#region src/eslint/rules/require-island-editor.ts
+function unwrap(node) {
+	let current = node;
+	while (current && (current.type === "TSSatisfiesExpression" || current.type === "TSAsExpression" || current.type === "TSTypeAssertion")) current = current.expression;
+	return current;
+}
+function propNamed(object, want) {
+	for (const prop of object.properties ?? []) {
+		if (prop.type !== "Property" || prop.computed || prop.kind !== "init") continue;
+		if ((prop.key.type === "Identifier" ? prop.key.name : prop.key.type === "Literal" ? String(prop.key.value) : null) === want) return prop;
+	}
+}
+const requireIslandEditor = {
+	meta: {
+		type: "problem",
+		docs: {
+			description: "Every island must declare whether it is live in the editor canvas",
+			url: docsPathForRule("require-island-editor")
+		},
+		schema: [],
+		messages: {
+			missingEditor: "this island does not declare its editor-canvas behavior — add `export const editor`. Fix: `export const editor = { live: false };` if it should stay static SSR HTML in the editor, or `{ live: true }` to hydrate it there behind the selection gate.",
+			missingLive: "`editor` does not declare `live`. Fix: add `live: true` to hydrate this island in the editor canvas, or `live: false` to leave it as static SSR HTML there. There is no default — an omitted `live` used to mean `false` silently, which is the bug this rule exists to prevent.",
+			liveNotBoolean: "`editor.live` must be `true` or `false` written literally, not a computed value. Fix: write the literal. The editor host reads `editor` once when the module loads, so a value that varies at runtime cannot mean anything — and a declaration a reader cannot see is the very thing this rule exists to prevent."
+		}
+	},
+	create(context) {
+		return { "Program:exit"(program) {
+			if (!hasClientDirective(context.sourceCode.getText())) return;
+			let hasDefaultExport = false;
+			let editorInit;
+			let editorReportNode;
+			for (const stmt of program.body) {
+				if (stmt.type === "ExportDefaultDeclaration") {
+					hasDefaultExport = true;
+					continue;
+				}
+				if (stmt.type !== "ExportNamedDeclaration") continue;
+				const declaration = stmt.declaration;
+				if (declaration?.type !== "VariableDeclaration") continue;
+				for (const decl of declaration.declarations) if (decl.id.type === "Identifier" && decl.id.name === "editor") {
+					editorInit = unwrap(decl.init);
+					editorReportNode = decl.init ?? decl.id;
+				}
+			}
+			if (!hasDefaultExport) return;
+			if (!editorReportNode) {
+				context.report({
+					node: program,
+					messageId: "missingEditor"
+				});
+				return;
+			}
+			const live = editorInit?.type === "ObjectExpression" ? propNamed(editorInit, "live") : void 0;
+			if (!live) {
+				context.report({
+					node: editorReportNode,
+					messageId: "missingLive"
+				});
+				return;
+			}
+			if (live.value.type !== "Literal" || typeof live.value.value !== "boolean") context.report({
+				node: live.value,
+				messageId: "liveNotBoolean"
+			});
+		} };
+	}
+};
+
+//#endregion
+export { requireIslandEditor };

package/dist/eslint.js

@@ -7,6 +7,7 @@ import { noInlineStyle } from "./eslint/rules/no-inline-style.js";
 import { noNondeterminism } from "./eslint/rules/no-nondeterminism.js";
 import { noRawElement } from "./eslint/rules/no-raw-element.js";
 import { propsFromSchema } from "./eslint/rules/props-from-schema.js";
+import { requireIslandEditor } from "./eslint/rules/require-island-editor.js";
 import { serializableIslandProps } from "./eslint/rules/serializable-island-props.js";
 import { slotMarkerLiteral } from "./eslint/rules/slot-marker-literal.js";
 import tsParser from "@typescript-eslint/parser";
@@ -17,6 +18,7 @@ const rules = {
 	"no-nondeterminism": noNondeterminism,
 	"no-client-runtime-in-server": noClientRuntimeInServer,
 	"serializable-island-props": serializableIslandProps,
+	"require-island-editor": requireIslandEditor,
 	"props-from-schema": propsFromSchema,
 	"no-inline-style": noInlineStyle,
 	"no-raw-element": noRawElement,
@@ -51,6 +53,7 @@ const templateKitConfig = [
 			"template-kit/no-nondeterminism": "error",
 			"template-kit/no-client-runtime-in-server": "error",
 			"template-kit/serializable-island-props": "error",
+			"template-kit/require-island-editor": "error",
 			"template-kit/no-inline-style": "error",
 			"template-kit/no-raw-element": "error",
 			"template-kit/image-bare-needs-reason": "error",

package/dist/index.d.ts

@@ -15,7 +15,7 @@ import { Decision, FillSpec, FillSpecShape } from "./schema/fill-spec.js";
 import { FixtureModule, FixtureModuleShape, FixtureOverride, ResolvedFixture, buildFixtureSet, buildInvariantFixtures } from "./schema/fixture-schema.js";
 import { TemplateManifest, TemplateManifestShape } from "./schema/manifest.js";
 import "./schema/index.js";
-import { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ISLAND_ELEMENT, IslandComponent, IslandEditorOptions, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, islandId, serializeIslandProps } from "./islands/contract.js";
+import { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ISLAND_ELEMENT, IslandComponent, IslandEditor, IslandEditorOptions, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, islandId, serializeIslandProps } from "./islands/contract.js";
 import { IslandMarker, IslandMarkerProps } from "./islands/marker.js";
 import { Image } from "./primitives/Image.js";
 import { PicturePlan, PictureSourceSpec } from "./primitives/picture-sources.js";
@@ -39,4 +39,4 @@ import { TokenNameSchema, TokenTheme, TokenThemeSchema, compileThemeToCss } from
  */
 declare const KIT_VERSION: string;
 //#endregion
-export { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ATTR_SECTION_INSTANCE_ID, ATTR_SLOT_GROUP, ATTR_SLOT_ID, ATTR_SLOT_ITEM, ATTR_SLOT_TEXT_LEAF, ATTR_TR_ENHANCE, type AddressParts, COLLECTIONS, CONTENT_SLOT_TYPES, type CollectionField, type CollectionIdKey, type CollectionOwnership, ContentSlot, type ContentSlotType, type Coordinates, DECISION_TYPES, DERIVED_INPUT_FIELDS, Decision, type DecisionType, type DerivedInputName, FORMATTER_NAMES, FillSpec, type FillSpecShape, type FixtureModule, FixtureModuleShape, type FixtureOverride, type FloorplanAssignment, type FormatterName, type FrameConfig, ISLAND_ELEMENT, Image, type ImageCollectionValue, type ImageValue, IslandComponent, IslandEditorOptions, IslandMarker, type IslandMarkerProps, IslandModule, IslandProps, IslandPropsError, KIT_VERSION, OptionDef, type OptionValue, type PicturePlan, type PictureSourceSpec, type PlaybackConfig, type PoiRow, type PropertyFacts, REFERRAL_FIELDS, REFERRAL_IMAGE_FIELDS, REF_SLOT_TYPES, type RefSlotType, type ReferralField, type ReferralImageField, type ResolvedFixture, type ResponsiveImage, type ResponsiveSource, SLOT_TYPES, SLOT_TYPE_DESCRIPTORS, SOURCE_FIELDS, Section, SectionMeta, type SectionMetaShape, type SectionNav, type SectionProps, SectionSchema, type SectionSchemaResolved, type SectionSchemaShape, ShieldMode, Slot, SlotDef, type Slot$1 as SlotDefinition, SlotGroup, SlotGroupDef, type SlotGroupDefShape, SlotItem, type SlotType, type SlotValue, type SourceFieldContainer, type SourceFieldDescriptor, type SourceFieldName, type SourceFieldValueType, TRANSFORMS, TRANSFORM_NAMES, TemplateManifest, type TemplateManifestShape, TokenNameSchema, type TokenTheme, TokenThemeSchema, type TransformDescriptor, type TransformFn, type TransformInput, type TransformName, type TransformUnit, type UnitRow, VERIFICATION_WIDTHS, type VariantSelectorFn, type VariantsMeta, type VerificationWidth, Video, type VideoCollectionValue, type VideoValue, type WritebackTarget, buildFixtureSet, buildInvariantFixtures, collectionForSlot, compileThemeToCss, defaultForSlotType, derived, deserializeIslandProps, direct, islandId, makeResolveVariants, serializeIslandProps, slotDefTypes };
+export { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ATTR_SECTION_INSTANCE_ID, ATTR_SLOT_GROUP, ATTR_SLOT_ID, ATTR_SLOT_ITEM, ATTR_SLOT_TEXT_LEAF, ATTR_TR_ENHANCE, type AddressParts, COLLECTIONS, CONTENT_SLOT_TYPES, type CollectionField, type CollectionIdKey, type CollectionOwnership, ContentSlot, type ContentSlotType, type Coordinates, DECISION_TYPES, DERIVED_INPUT_FIELDS, Decision, type DecisionType, type DerivedInputName, FORMATTER_NAMES, FillSpec, type FillSpecShape, type FixtureModule, FixtureModuleShape, type FixtureOverride, type FloorplanAssignment, type FormatterName, type FrameConfig, ISLAND_ELEMENT, Image, type ImageCollectionValue, type ImageValue, IslandComponent, IslandEditor, IslandEditorOptions, IslandMarker, type IslandMarkerProps, IslandModule, IslandProps, IslandPropsError, KIT_VERSION, OptionDef, type OptionValue, type PicturePlan, type PictureSourceSpec, type PlaybackConfig, type PoiRow, type PropertyFacts, REFERRAL_FIELDS, REFERRAL_IMAGE_FIELDS, REF_SLOT_TYPES, type RefSlotType, type ReferralField, type ReferralImageField, type ResolvedFixture, type ResponsiveImage, type ResponsiveSource, SLOT_TYPES, SLOT_TYPE_DESCRIPTORS, SOURCE_FIELDS, Section, SectionMeta, type SectionMetaShape, type SectionNav, type SectionProps, SectionSchema, type SectionSchemaResolved, type SectionSchemaShape, ShieldMode, Slot, SlotDef, type Slot$1 as SlotDefinition, SlotGroup, SlotGroupDef, type SlotGroupDefShape, SlotItem, type SlotType, type SlotValue, type SourceFieldContainer, type SourceFieldDescriptor, type SourceFieldName, type SourceFieldValueType, TRANSFORMS, TRANSFORM_NAMES, TemplateManifest, type TemplateManifestShape, TokenNameSchema, type TokenTheme, TokenThemeSchema, type TransformDescriptor, type TransformFn, type TransformInput, type TransformName, type TransformUnit, type UnitRow, VERIFICATION_WIDTHS, type VariantSelectorFn, type VariantsMeta, type VerificationWidth, Video, type VideoCollectionValue, type VideoValue, type WritebackTarget, buildFixtureSet, buildInvariantFixtures, collectionForSlot, compileThemeToCss, defaultForSlotType, derived, deserializeIslandProps, direct, islandId, makeResolveVariants, serializeIslandProps, slotDefTypes };

package/dist/island-runtime.d.ts

@@ -1,4 +1,4 @@
-import { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ISLAND_ELEMENT, IslandComponent, IslandEditorOptions, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, islandId, serializeIslandProps } from "./islands/contract.js";
+import { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ISLAND_ELEMENT, IslandComponent, IslandEditor, IslandEditorOptions, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, islandId, serializeIslandProps } from "./islands/contract.js";
 //#region src/islands/runtime.d.ts
 /** What the loader knows about one island once its module has loaded. */
 interface IslandContext {
@@ -27,4 +27,4 @@ declare function hydrateIslands(options: HydrateIslandsOptions): Promise<IslandH
  */
 declare function unmountIslands(root?: ParentNode): void;
 //#endregion
-export { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, HydrateIslandsOptions, ISLAND_ELEMENT, IslandComponent, IslandContext, IslandEditorOptions, IslandHandle, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, hydrateIslands, islandId, serializeIslandProps, unmountIslands };
+export { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, HydrateIslandsOptions, ISLAND_ELEMENT, IslandComponent, IslandContext, IslandEditor, IslandEditorOptions, IslandHandle, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, hydrateIslands, islandId, serializeIslandProps, unmountIslands };

package/dist/islands/contract.d.ts

@@ -12,10 +12,15 @@ declare const ATTR_ISLAND_PROPS = "data-tr-island-props";
 type IslandProps = Record<string, unknown>;
 /** How the editor sizes the transparent selection shield over a live island. */
 type ShieldMode = "fill-self" | "fill-parent";
-/** Optional `export const editor` on a client component: how it behaves inside the editor canvas. */
-interface IslandEditorOptions {
+/**
+ * What a `"use client"` island must declare about its editor-canvas behavior.
+ *
+ * An explicit `false` is a decision; a missing field was an accident wearing a
+ * decision's clothes.
+ */
+interface IslandEditor {
   /** Hydrate this island in the editor canvas (behind the editor's selection gate). */
-  live?: boolean;
+  live: boolean;
   /** Shield placement. Default "fill-parent". */
   shieldMode?: ShieldMode;
   /** Which element(s) inside the island the shield covers. Omit → the whole island. Runs in the browser. */
@@ -23,6 +28,17 @@ interface IslandEditorOptions {
   /** Editor-only props, merged over the server-rendered props (e.g. an accordion's single-open canvas mirror). */
   props?: IslandProps;
 }
+/**
+ * The RUNTIME's tolerant view of `IslandEditor` — every field optional, `live` included.
+ *
+ * Deliberately not the same type as the authoring contract. `hydrateIslands` reaches a
+ * module through a dynamic `import()` and a cast (runtime.ts): it cannot enforce what
+ * the module actually exports, and the published-page path never reads `editor` at all.
+ * Requiring `live` here would be an assumption the loader has no way to hold. The
+ * authoring requirement is enforced where it can be — the `require-island-editor` lint
+ * rule and the registry's ingest validator.
+ */
+type IslandEditorOptions = Partial<IslandEditor>;
 /**
  * A client component's own prop type is the author's business — island props are
  * validated at runtime (serializeIslandProps), not through this alias, and a
@@ -53,4 +69,4 @@ declare function serializeIslandProps(props: IslandProps): string;
 /** Read a props payload back. Throws IslandPropsError on anything that is not a JSON object. */
 declare function deserializeIslandProps(payload: string): IslandProps;
 //#endregion
-export { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ISLAND_ELEMENT, IslandComponent, IslandEditorOptions, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, islandId, serializeIslandProps };
+export { ATTR_ISLAND_ID, ATTR_ISLAND_KEY, ATTR_ISLAND_PROPS, ISLAND_ELEMENT, IslandComponent, IslandEditor, IslandEditorOptions, IslandModule, IslandProps, IslandPropsError, ShieldMode, deserializeIslandProps, islandId, serializeIslandProps };

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.7.0";
+var version = "0.8.0";
 
 //#endregion
 export { version };

package/dist/ssr.d.ts

@@ -25,7 +25,10 @@ declare const nativeSectionLoader: SectionModuleLoader;
  * contract files; it defaults to native dynamic import.
  */
 declare function loadSectionBundle(dir: string, load?: SectionModuleLoader): Promise<LoadedSection>;
-/** Render a resolved fixture's props to static markup — the byte-for-byte page render. */
+/**
+ * Render a resolved fixture's props to hydration-ready HTML — the byte-for-byte
+ * page render.
+ */
 declare function renderSectionHtml(renderer: ComponentType<Record<string, unknown>>, props: Record<string, unknown>): string;
 //#endregion
 export { LoadedSection, SectionModuleLoader, findSectionIslands, hasClientDirective, isClientComponentFile, islandKey, islandTransformEsbuildPlugin, loadSectionBundle, nativeSectionLoader, renderSectionHtml, wrapClientModuleSource };

package/dist/ssr.js

@@ -1,13 +1,13 @@
 import { FixtureModuleShape, buildFixtureSet, buildInvariantFixtures } from "./schema/fixture-schema.js";
 import { hasClientDirective } from "./eslint/is-client-file.js";
 import { isClientComponentFile, islandKey } from "./islands/detect.js";
-import { findSectionIslands } from "./islands/discover.js";
 import { wrapClientModuleSource } from "./islands/wrap.js";
+import { findSectionIslands } from "./islands/discover.js";
 import { islandTransformEsbuildPlugin } from "./islands/esbuild-plugin.js";
 import { createElement } from "react";
 import { basename, join } from "node:path";
 import { pathToFileURL } from "node:url";
-import { renderToStaticMarkup } from "react-dom/server";
+import { renderToString } from "react-dom/server";
 
 //#region src/ssr/index.ts
 const nativeSectionLoader = (dir, file) => import(pathToFileURL(join(dir, file)).href);
@@ -37,9 +37,12 @@ async function loadSectionBundle(dir, load = nativeSectionLoader) {
 		schemaSlots: schemaMod.schema.slots
 	};
 }
-/** Render a resolved fixture's props to static markup — the byte-for-byte page render. */
+/**
+* Render a resolved fixture's props to hydration-ready HTML — the byte-for-byte
+* page render.
+*/
 function renderSectionHtml(renderer, props) {
-	return renderToStaticMarkup(createElement(renderer, props));
+	return renderToString(createElement(renderer, props));
 }
 
 //#endregion

package/guide/islands.md

@@ -83,20 +83,24 @@ runtime check's job.
 ## Editor options
 
 Templates are edited in a canvas where the section is re-rendered on every keystroke.
-An island can declare how it behaves there:
+Every island must declare how it behaves there:
+
+- **`live`** — **required**. `true` hydrates the island in the editor canvas behind the
+  selection gate; `false` leaves it as static SSR HTML there.
+- **`shieldMode`, `liveSurface`, `props`** — optional, and only meaningful when `live: true`.
 
 ```tsx
 "use client";
-import type { IslandEditorOptions } from "@homepages/template-kit";
+import type { IslandEditor } from "@homepages/template-kit";
 
 export default function Accordion({ items, singleOpen }: Props) { /* … */ }
 
-export const editor: IslandEditorOptions = {
-  live: true,                            // hydrate in the editor canvas (default: false)
+export const editor = {
+  live: true,                            // required — hydrate in the editor canvas
   shieldMode: "fill-parent",             // how the editor sizes its selection shield
   liveSurface: (root) => [...root.querySelectorAll(".accordion")], // shield only these
   props: { singleOpen: true },           // editor-only props, merged over the real ones
-};
+} satisfies IslandEditor;
 ```
 
 `props` merge in as an update immediately after the island hydrates, not as part of its
@@ -104,8 +108,23 @@ first mount — so an island must read them during render. A value read only at
 (a `useState` initializer, an `<input defaultValue>`) sees the real prop, and the
 editor-only override never reaches it.
 
-Omit `editor` entirely and the island simply renders as static markup in the editor —
-which is the right choice for most islands.
+There is no default, deliberately. An island that declared nothing used to stay static in
+the canvas, which made "I have not decided" and "static is what I want" the same code. The
+[`require-island-editor`](rules/require-island-editor.md) rule now asks for the answer.
+`live: false` is the safe one if you are unsure — it is what an undeclared island already
+did, written down.
+
+The minimal declaration carries just the required field:
+
+```tsx
+"use client";
+
+export const editor = { live: true };
+
+export default function Lightbox({ headline }: { headline: string }) {
+  // …
+}
+```
 
 ## The DOM contract
 

package/guide/llms.txt

@@ -73,6 +73,9 @@ and [Pick a scenario](recipes/pick-a-scenario.md).
   rendered inside the section.
 - [README](../README.md): install, exports, and the release flow.
 - [Islands](islands.md): interactivity — client components, the serializable-props contract, editor options, and the browser loader.
+  Every "use client" module with a default export MUST `export const editor` declaring a
+  boolean literal `live` — `{ live: true }` hydrates it in the editor canvas, `{ live: false }`
+  leaves it static there. There is no default; the require-island-editor rule enforces it.
 - [Static assets](assets.md): shipping a logo, texture, icon, or brand font with a
   template — where an asset file lives (template level, or a section folder if the
   section references it), referencing it from a section's CSS with `url()`/`@font-face`

package/guide/rules/INDEX.md

@@ -2,7 +2,7 @@
 purpose: Router for the rule corpus — every template-kit/<id> an author can hit, and the page that explains it.
 status: living
 related: [server-vs-client.md, ../eslint.md, ../check.md, ../INDEX.md]
-updated: 2026-07-15
+updated: 2026-07-17
 ---
 # Rules
 
@@ -25,6 +25,7 @@ and it is explained there rather than on each of them.
 | [`no-nondeterminism`](no-nondeterminism.md) | eslint | No clock or randomness reads in server-rendered code. |
 | [`no-client-runtime-in-server`](no-client-runtime-in-server.md) | eslint | No effects, state, event handlers, network, or browser globals in server-rendered code. |
 | [`serializable-island-props`](serializable-island-props.md) | eslint | Props handed to an island must be JSON-serializable. |
+| [`require-island-editor`](require-island-editor.md) | eslint | Every island must declare whether it is live in the editor canvas. |
 | [`no-client-directive-in-contract`](no-client-directive-in-contract.md) | eslint | No "use client" in a section's four contract files. |
 | [`props-from-schema`](props-from-schema.md) | eslint | A Renderer's Props type must be derived from schema.ts, not hand-written. |
 | [`no-inline-style`](no-inline-style.md) | eslint | No inline style= in server-rendered JSX. Islands are exempt. |

package/guide/rules/require-island-editor.md

@@ -0,0 +1,101 @@
+---
+purpose: The template-kit/require-island-editor authoring rule — what it enforces, why, and how to fix it.
+status: living
+related: [INDEX.md, server-vs-client.md, ../islands.md]
+updated: 2026-07-17
+---
+# template-kit/require-island-editor
+
+> Every island declares whether it hydrates in the editor canvas. There is no default.
+
+## Rule
+
+A file is an island when its directive prologue says `"use client"` **and** it has a
+default export (see [server vs client](server-vs-client.md)). Every island must carry:
+
+```ts
+export const editor = { live: true };
+```
+
+`live` must be written as `true` or `false` literally. A computed value reports.
+
+Two files are exempt, and neither is a loophole:
+
+- A module with no `"use client"` — it is server-rendered code, not an island.
+- A `"use client"` module with **no default export** — the platform's codemod only turns
+  a default-exported client module into an island, so this file never becomes one.
+
+## Reason
+
+`live` controls one thing: whether the editor canvas hydrates your island, or leaves it
+as the static HTML the server rendered. Both answers are legitimate. A gallery lightbox
+wants `live: true` so an author can see it behave; a scroll-triggered animation wants
+`live: false` so it does not fire while someone is editing copy.
+
+The rule exists because the answer used to be expressed by **saying nothing**. An island
+with no `editor` export simply never hydrated in the canvas — which meant "I have not
+thought about this" and "I want static HTML here" produced identical code. They are not
+the same statement, and the difference is invisible in review.
+
+`live` is read **once**, when your module loads. That is why it must be a literal: a
+value computed at runtime cannot change the answer, so a non-literal is never a working
+declaration — only a misleading one.
+
+## Fix
+
+Declare it. If you are unsure, `live: false` is the safe answer: it is exactly what your
+island does today, now written down.
+
+### Before
+
+```tsx
+// sections/gallery/Lightbox.tsx
+"use client";
+
+import { useState } from "react";
+
+export default function Lightbox({ headline }: { headline: string }) {
+  const [open, setOpen] = useState(false);
+  return (
+    <div>
+      <button onClick={() => setOpen(true)}>Open gallery</button>
+      {open && <p>{headline}</p>}
+    </div>
+  );
+}
+```
+
+### After
+
+```tsx
+// sections/gallery/Lightbox.tsx
+"use client";
+
+import { useState } from "react";
+
+// Authors open the lightbox in the canvas to check it, so hydrate it there.
+export const editor = { live: true };
+
+export default function Lightbox({ headline }: { headline: string }) {
+  const [open, setOpen] = useState(false);
+  return (
+    <div>
+      <button onClick={() => setOpen(true)}>Open gallery</button>
+      {open && <p>{headline}</p>}
+    </div>
+  );
+}
+```
+
+Type it if you want the editor to check the shape:
+
+```ts
+import type { IslandEditor } from "@homepages/template-kit";
+
+export const editor = { live: true } satisfies IslandEditor;
+```
+
+## See also
+
+- [Islands](../islands.md) — the full `editor` contract: `shieldMode`, `liveSurface`, `props`.
+- [Server vs client](server-vs-client.md) — the directive, the prologue, and what an island may do.

package/package.json

@@ -1,19 +1,16 @@
 {
   "name": "@homepages/template-kit",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Authoring kit for HomePages marketing-section templates: schema system, contract primitives, theme tokens, and the template-kit CLI.",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {
     "node": ">=20.0.0"
   },
-  "workspaces": [
-    ".",
-    "create-homepages-workspace"
-  ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/falktravis/template-kit.git"
+    "url": "git+https://github.com/falktravis/template-packages.git",
+    "directory": "packages/template-kit"
   },
   "publishConfig": {
     "access": "public"
@@ -71,11 +68,7 @@
     "lint:pkg": "publint --strict && attw --pack . --profile esm-only --exclude-entrypoints styles.css base.css",
     "verify:consumer": "node scripts/verify-consumer.mjs",
     "size:islands": "node scripts/check-island-runtime-size.mjs",
-    "check": "npm run typecheck && npm run lint && npm run build && npm run size:islands && npm run test && npm run lint:pkg && npm run verify:consumer && npm run check:scaffolder",
-    "check:scaffolder": "npm run typecheck -w create-homepages-workspace && npm run build -w create-homepages-workspace && npm run test -w create-homepages-workspace",
-    "changeset": "changeset",
-    "version": "changeset version && npm install --package-lock-only",
-    "release": "changeset publish"
+    "check": "npm run typecheck && npm run lint && npm run build && npm run size:islands && npm run test && npm run lint:pkg && npm run verify:consumer"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -83,7 +76,6 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@changesets/cli": "^2.29.8",
     "@eslint/js": "^9.39.4",
     "@playwright/test": "^1.60.0",
     "@tailwindcss/cli": "^4.3.0",