seemore 1.6.1 → 1.8.0

package/README.md

@@ -100,11 +100,11 @@ The preview is not just for reading — it is the fastest way to fix what you ar
   <img src="https://raw.githubusercontent.com/arifszn/seemore/main/packages/site/assets/inline-editor.png" alt="seemore rendering a folder of Markdown in the browser, with a paragraph's Markdown source open in the inline editor" width="640"/>
 </p>
 
-Inline editing is for local previews only — `seemore build` output is static, so nothing is emitted there. It is on by default in dev; switch it off with the `!` prefix:
+Inline editing is for local previews only — `seemore build` output is static, so nothing is emitted there. It is on by default in dev; switch it off like this:
 
 ```ts
 export default {
-  features: ['!content.edit'],
+  features: { 'content.edit': false },
 };
 ```
 
@@ -158,7 +158,7 @@ export default {
   base: '/my-repo/',
   theme: 'ocean',
   css: './custom.css',
-  features: ['navigation.path', 'navigation.instant.preview'],
+  features: { 'navigation.path': true, 'navigation.instant.preview': true },
   nav: [{ text: 'GitHub', link: 'https://github.com/you/repo' }],
   footer: { text: '© 2026' },
   editLink: { base: 'https://github.com/you/repo/edit/main/docs' },
@@ -201,15 +201,15 @@ Twelve built-in colour presets: `neutral` (default), `black`, `catppuccin`, `dus
 
 ### Features
 
-A flat list of switches for fine control, set as an array on the `features` key. Turn something on by adding its flag name, turn something off with the `!` prefix; flags you don't mention keep their default.
+A set of switches for fine control, set on the `features` key. Name the ones you want to change and set each `true` or `false`; flags you don't mention keep their default.
 
 ```ts
 // seemore.config.ts
 export default {
-  features: [
-    'navigation.path',              // off by default → this turns it on
-    '!navigation.instant.prefetch', // on by default → this turns it off
-  ],
+  features: {
+    'navigation.path': true,               // off by default → this turns it on
+    'navigation.instant.prefetch': false,  // on by default → this turns it off
+  },
 };
 ```
 

package/dist/cli/index.js

@@ -147,7 +147,7 @@ var FEATURE_DEFAULTS = {
   "content.action.edit": false,
   // On by default, but only ever active in dev: the stamping that makes a block editable is
   // not emitted by `seemore build`, and the endpoint that writes is registered only by the
-  // dev server. Switch it off with '!content.edit'.
+  // dev server. Switch it off with `'content.edit': false`.
   "content.edit": true,
   "content.image.zoom": true,
   "search.suggest": true,
@@ -169,17 +169,12 @@ var RULES = [
   }
 ];
 function resolveFeatures(input, implicit = {}) {
-  const resolved = { ...FEATURE_DEFAULTS, ...implicit };
-  for (const flag of input) {
-    const off = flag.startsWith("!");
-    const name = off ? flag.slice(1) : flag;
-    resolved[name] = !off;
-  }
+  const resolved = { ...FEATURE_DEFAULTS, ...implicit, ...toMap(input) };
   const problems = [];
   for (const rule of RULES) {
     if (rule.kind === "conflict") {
       if (!resolved[rule.a] || !resolved[rule.b]) continue;
-      const fix = FEATURE_DEFAULTS[rule.b] ? `Add '!${rule.b}' to \`features\` to switch it off.` : `Remove '${rule.b}' from \`features\`.`;
+      const fix = `Set \`'${rule.b}': false\` in \`features\`.`;
       problems.push(`\`${rule.a}\` cannot be combined with \`${rule.b}\`. ${rule.why} ${fix}`);
     } else if (resolved[rule.flag] && !resolved[rule.needs]) {
       problems.push(
@@ -195,6 +190,19 @@ ${problems.map((p) => `  - ${p}`).join("\n")}`
   }
   return resolved;
 }
+function featuresFromFlags(flags) {
+  const map = {};
+  for (const flag of flags) {
+    const off = flag.startsWith("!");
+    map[off ? flag.slice(1) : flag] = !off;
+  }
+  return map;
+}
+function toMap(input) {
+  if (Array.isArray(input)) return featuresFromFlags(input);
+  const set = Object.entries(input).filter(([, on]) => on !== void 0);
+  return Object.fromEntries(set);
+}
 
 // src/node/config/schema.ts
 import { z } from "zod";
@@ -212,7 +220,10 @@ var THEMES = [
   "vitepress",
   "shadcn"
 ];
-var featureFlag = z.enum([...FEATURES, ...FEATURES.map((f) => `!${f}`)]);
+var featuresSchema = z.preprocess((input) => {
+  const isFlagArray = Array.isArray(input) && input.every((flag) => typeof flag === "string");
+  return isFlagArray ? featuresFromFlags(input) : input;
+}, z.partialRecord(z.enum(FEATURES), z.boolean()));
 var navItem = z.lazy(
   () => z.object({
     text: z.string(),
@@ -249,7 +260,7 @@ var configSchema = z.object({
   theme: z.enum(THEMES).default("neutral"),
   /** A CSS file appended after everything else, so it wins. */
   css: z.string().optional(),
-  features: z.array(featureFlag).default([]),
+  features: featuresSchema.default({}),
   nav: z.array(navItem).optional(),
   footer: z.object({
     text: z.string().optional(),
@@ -356,6 +367,10 @@ function explain(issue) {
   if (issue.code === "invalid_value" && issue.path.join(".") === "theme") {
     return `unknown theme. Valid themes: ${THEMES.join(", ")}.`;
   }
+  if (issue.code === "unrecognized_keys" && issue.path.join(".") === "features") {
+    const named = issue.keys.map((key) => `\`${key}\``).join(", ");
+    return `unknown feature ${issue.keys.length === 1 ? "flag" : "flags"}: ${named}. Valid flags: ${FEATURES.join(", ")}.`;
+  }
   return issue.message;
 }