@svadmin/create 0.14.1 → 0.16.0

package/README.md

@@ -97,3 +97,14 @@ bun src/sync-template.ts
 # Build CLI (for npm publishing)
 bun run build
 ```
+Generated projects include root-level `DESIGN.md` and `AGENTS.md` files. They
+define the Stripe-first visual language, page information budget, feedback
+ownership, and AI generation acceptance rules.
+
+Existing projects can preview and install any missing guidance files without
+overwriting local standards:
+
+```bash
+bunx @svadmin/create guidance .
+bunx @svadmin/create guidance . --write
+```

package/dist/index.js

@@ -20,12 +20,14 @@ var __toESM = (mod, isNodeMode, target) => {
   }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: __accessProp.bind(mod, key),
-        enumerable: true
-      });
+  if (mod && typeof mod === "object" || typeof mod === "function") {
+    for (let key of __getOwnPropNames(mod))
+      if (!__hasOwnProp.call(to, key))
+        __defProp(to, key, {
+          get: __accessProp.bind(mod, key),
+          enumerable: true
+        });
+  }
   if (canCache)
     cache.set(mod, to);
   return to;
@@ -34,7 +36,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/prompts/node_modules/kleur/index.js
-var require_kleur = __commonJS((exports, module) => {
+var require_kleur = __commonJS(function(exports, module) {
   var { FORCE_COLOR, NODE_DISABLE_COLORS, TERM } = process.env;
   var $ = {
     enabled: !NODE_DISABLE_COLORS && TERM !== "dumb" && FORCE_COLOR !== "0",
@@ -125,7 +127,7 @@ var require_kleur = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/action.js
-var require_action = __commonJS((exports, module) => {
+var require_action = __commonJS(function(exports, module) {
   module.exports = (key, isSelect) => {
     if (key.meta && key.name !== "escape")
       return;
@@ -182,7 +184,7 @@ var require_action = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/strip.js
-var require_strip = __commonJS((exports, module) => {
+var require_strip = __commonJS(function(exports, module) {
   module.exports = (str) => {
     const pattern = ["[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)", "(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PRZcf-ntqry=><~]))"].join("|");
     const RGX = new RegExp(pattern, "g");
@@ -191,7 +193,7 @@ var require_strip = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/sisteransi/src/index.js
-var require_src = __commonJS((exports, module) => {
+var require_src = __commonJS(function(exports, module) {
   var ESC = "\x1B";
   var CSI = `${ESC}[`;
   var beep = "\x07";
@@ -249,7 +251,7 @@ var require_src = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/clear.js
-var require_clear = __commonJS((exports, module) => {
+var require_clear = __commonJS(function(exports, module) {
   function _createForOfIteratorHelper(o, allowArrayLike) {
     var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
     if (!it) {
@@ -335,7 +337,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
 });
 
 // ../../node_modules/prompts/dist/util/figures.js
-var require_figures = __commonJS((exports, module) => {
+var require_figures = __commonJS(function(exports, module) {
   var main = {
     arrowUp: "↑",
     arrowDown: "↓",
@@ -369,7 +371,7 @@ var require_figures = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/style.js
-var require_style = __commonJS((exports, module) => {
+var require_style = __commonJS(function(exports, module) {
   var c = require_kleur();
   var figures = require_figures();
   var styles = Object.freeze({
@@ -411,7 +413,7 @@ var require_style = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/lines.js
-var require_lines = __commonJS((exports, module) => {
+var require_lines = __commonJS(function(exports, module) {
   var strip = require_strip();
   module.exports = function(msg, perLine) {
     let lines = String(strip(msg) || "").split(/\r?\n/);
@@ -422,7 +424,7 @@ var require_lines = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/wrap.js
-var require_wrap = __commonJS((exports, module) => {
+var require_wrap = __commonJS(function(exports, module) {
   module.exports = (msg, opts = {}) => {
     const tab = Number.isSafeInteger(parseInt(opts.margin)) ? new Array(parseInt(opts.margin)).fill(" ").join("") : opts.margin || "";
     const width = opts.width;
@@ -439,7 +441,7 @@ var require_wrap = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/entriesToDisplay.js
-var require_entriesToDisplay = __commonJS((exports, module) => {
+var require_entriesToDisplay = __commonJS(function(exports, module) {
   module.exports = (cursor, total, maxVisible) => {
     maxVisible = maxVisible || total;
     let startIndex = Math.min(total - maxVisible, cursor - Math.floor(maxVisible / 2));
@@ -454,7 +456,7 @@ var require_entriesToDisplay = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/util/index.js
-var require_util = __commonJS((exports, module) => {
+var require_util = __commonJS(function(exports, module) {
   module.exports = {
     action: require_action(),
     clear: require_clear(),
@@ -468,7 +470,7 @@ var require_util = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/elements/prompt.js
-var require_prompt = __commonJS((exports, module) => {
+var require_prompt = __commonJS(function(exports, module) {
   var readline = __require("readline");
   var _require = require_util();
   var action = _require.action;
@@ -536,7 +538,7 @@ var require_prompt = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/elements/text.js
-var require_text = __commonJS((exports, module) => {
+var require_text = __commonJS(function(exports, module) {
   function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
@@ -760,7 +762,7 @@ ${i ? " " : figures.pointerSmall} ${color.red().italic(l)}`, ``);
 });
 
 // ../../node_modules/prompts/dist/elements/select.js
-var require_select = __commonJS((exports, module) => {
+var require_select = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt();
   var _require = require_util();
@@ -916,7 +918,7 @@ var require_select = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/elements/toggle.js
-var require_toggle = __commonJS((exports, module) => {
+var require_toggle = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt();
   var _require = require_util();
@@ -1020,7 +1022,7 @@ var require_toggle = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/datepart.js
-var require_datepart = __commonJS((exports, module) => {
+var require_datepart = __commonJS(function(exports, module) {
   class DatePart {
     constructor({
       token,
@@ -1053,7 +1055,7 @@ var require_datepart = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/meridiem.js
-var require_meridiem = __commonJS((exports, module) => {
+var require_meridiem = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
 
   class Meridiem extends DatePart {
@@ -1075,7 +1077,7 @@ var require_meridiem = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/day.js
-var require_day = __commonJS((exports, module) => {
+var require_day = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
   var pos = (n) => {
     n = n % 10;
@@ -1105,7 +1107,7 @@ var require_day = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/hours.js
-var require_hours = __commonJS((exports, module) => {
+var require_hours = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
 
   class Hours extends DatePart {
@@ -1132,7 +1134,7 @@ var require_hours = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/milliseconds.js
-var require_milliseconds = __commonJS((exports, module) => {
+var require_milliseconds = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
 
   class Milliseconds extends DatePart {
@@ -1156,7 +1158,7 @@ var require_milliseconds = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/minutes.js
-var require_minutes = __commonJS((exports, module) => {
+var require_minutes = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
 
   class Minutes extends DatePart {
@@ -1181,7 +1183,7 @@ var require_minutes = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/month.js
-var require_month = __commonJS((exports, module) => {
+var require_month = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
 
   class Month extends DatePart {
@@ -1208,7 +1210,7 @@ var require_month = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/seconds.js
-var require_seconds = __commonJS((exports, module) => {
+var require_seconds = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
 
   class Seconds extends DatePart {
@@ -1233,7 +1235,7 @@ var require_seconds = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/year.js
-var require_year = __commonJS((exports, module) => {
+var require_year = __commonJS(function(exports, module) {
   var DatePart = require_datepart();
 
   class Year extends DatePart {
@@ -1258,7 +1260,7 @@ var require_year = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/dateparts/index.js
-var require_dateparts = __commonJS((exports, module) => {
+var require_dateparts = __commonJS(function(exports, module) {
   module.exports = {
     DatePart: require_datepart(),
     Meridiem: require_meridiem(),
@@ -1273,7 +1275,7 @@ var require_dateparts = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/elements/date.js
-var require_date = __commonJS((exports, module) => {
+var require_date = __commonJS(function(exports, module) {
   function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
@@ -1500,7 +1502,7 @@ ${i ? ` ` : figures.pointerSmall} ${color.red().italic(l)}`, ``);
 });
 
 // ../../node_modules/prompts/dist/elements/number.js
-var require_number = __commonJS((exports, module) => {
+var require_number = __commonJS(function(exports, module) {
   function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
@@ -1723,7 +1725,7 @@ ${i ? ` ` : figures.pointerSmall} ${color.red().italic(l)}`, ``);
 });
 
 // ../../node_modules/prompts/dist/elements/multiselect.js
-var require_multiselect = __commonJS((exports, module) => {
+var require_multiselect = __commonJS(function(exports, module) {
   var color = require_kleur();
   var _require = require_src();
   var cursor = _require.cursor;
@@ -1959,7 +1961,7 @@ Instructions:
 });
 
 // ../../node_modules/prompts/dist/elements/autocomplete.js
-var require_autocomplete = __commonJS((exports, module) => {
+var require_autocomplete = __commonJS(function(exports, module) {
   function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
@@ -2230,7 +2232,7 @@ var require_autocomplete = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/elements/autocompleteMultiselect.js
-var require_autocompleteMultiselect = __commonJS((exports, module) => {
+var require_autocompleteMultiselect = __commonJS(function(exports, module) {
   var color = require_kleur();
   var _require = require_src();
   var cursor = _require.cursor;
@@ -2392,7 +2394,7 @@ Filtered results for: ${this.inputValue ? this.inputValue : color.gray("Enter so
 });
 
 // ../../node_modules/prompts/dist/elements/confirm.js
-var require_confirm = __commonJS((exports, module) => {
+var require_confirm = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt();
   var _require = require_util();
@@ -2467,7 +2469,7 @@ var require_confirm = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/elements/index.js
-var require_elements = __commonJS((exports, module) => {
+var require_elements = __commonJS(function(exports, module) {
   module.exports = {
     TextPrompt: require_text(),
     SelectPrompt: require_select(),
@@ -2482,7 +2484,7 @@ var require_elements = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/dist/prompts.js
-var require_prompts = __commonJS((exports) => {
+var require_prompts = __commonJS(function(exports) {
   var $ = exports;
   var el = require_elements();
   var noop = (v) => v;
@@ -2543,7 +2545,7 @@ var require_prompts = __commonJS((exports) => {
 });
 
 // ../../node_modules/prompts/dist/index.js
-var require_dist = __commonJS((exports, module) => {
+var require_dist = __commonJS(function(exports, module) {
   function ownKeys(object, enumerableOnly) {
     var keys = Object.keys(object);
     if (Object.getOwnPropertySymbols) {
@@ -2773,7 +2775,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
 });
 
 // ../../node_modules/prompts/lib/util/action.js
-var require_action2 = __commonJS((exports, module) => {
+var require_action2 = __commonJS(function(exports, module) {
   module.exports = (key, isSelect) => {
     if (key.meta && key.name !== "escape")
       return;
@@ -2830,7 +2832,7 @@ var require_action2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/strip.js
-var require_strip2 = __commonJS((exports, module) => {
+var require_strip2 = __commonJS(function(exports, module) {
   module.exports = (str) => {
     const pattern = [
       "[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)",
@@ -2842,7 +2844,7 @@ var require_strip2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/clear.js
-var require_clear2 = __commonJS((exports, module) => {
+var require_clear2 = __commonJS(function(exports, module) {
   var strip = require_strip2();
   var { erase, cursor } = require_src();
   var width = (str) => [...strip(str)].length;
@@ -2859,7 +2861,7 @@ var require_clear2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/figures.js
-var require_figures2 = __commonJS((exports, module) => {
+var require_figures2 = __commonJS(function(exports, module) {
   var main = {
     arrowUp: "↑",
     arrowDown: "↓",
@@ -2893,7 +2895,7 @@ var require_figures2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/style.js
-var require_style2 = __commonJS((exports, module) => {
+var require_style2 = __commonJS(function(exports, module) {
   var c = require_kleur();
   var figures = require_figures2();
   var styles = Object.freeze({
@@ -2923,7 +2925,7 @@ var require_style2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/lines.js
-var require_lines2 = __commonJS((exports, module) => {
+var require_lines2 = __commonJS(function(exports, module) {
   var strip = require_strip2();
   module.exports = function(msg, perLine) {
     let lines = String(strip(msg) || "").split(/\r?\n/);
@@ -2934,7 +2936,7 @@ var require_lines2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/wrap.js
-var require_wrap2 = __commonJS((exports, module) => {
+var require_wrap2 = __commonJS(function(exports, module) {
   module.exports = (msg, opts = {}) => {
     const tab = Number.isSafeInteger(parseInt(opts.margin)) ? new Array(parseInt(opts.margin)).fill(" ").join("") : opts.margin || "";
     const width = opts.width;
@@ -2951,7 +2953,7 @@ var require_wrap2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/entriesToDisplay.js
-var require_entriesToDisplay2 = __commonJS((exports, module) => {
+var require_entriesToDisplay2 = __commonJS(function(exports, module) {
   module.exports = (cursor, total, maxVisible) => {
     maxVisible = maxVisible || total;
     let startIndex = Math.min(total - maxVisible, cursor - Math.floor(maxVisible / 2));
@@ -2963,7 +2965,7 @@ var require_entriesToDisplay2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/util/index.js
-var require_util2 = __commonJS((exports, module) => {
+var require_util2 = __commonJS(function(exports, module) {
   module.exports = {
     action: require_action2(),
     clear: require_clear2(),
@@ -2977,7 +2979,7 @@ var require_util2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/elements/prompt.js
-var require_prompt2 = __commonJS((exports, module) => {
+var require_prompt2 = __commonJS(function(exports, module) {
   var readline = __require("readline");
   var { action } = require_util2();
   var EventEmitter = __require("events");
@@ -3039,7 +3041,7 @@ var require_prompt2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/elements/text.js
-var require_text2 = __commonJS((exports, module) => {
+var require_text2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt2();
   var { erase, cursor } = require_src();
@@ -3227,7 +3229,7 @@ ${i ? " " : figures.pointerSmall} ${color.red().italic(l)}`, ``);
 });
 
 // ../../node_modules/prompts/lib/elements/select.js
-var require_select2 = __commonJS((exports, module) => {
+var require_select2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt2();
   var { style, clear, figures, wrap, entriesToDisplay } = require_util2();
@@ -3376,7 +3378,7 @@ var require_select2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/elements/toggle.js
-var require_toggle2 = __commonJS((exports, module) => {
+var require_toggle2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt2();
   var { style, clear } = require_util2();
@@ -3483,7 +3485,7 @@ var require_toggle2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/datepart.js
-var require_datepart2 = __commonJS((exports, module) => {
+var require_datepart2 = __commonJS(function(exports, module) {
   class DatePart {
     constructor({ token, date, parts, locales }) {
       this.token = token;
@@ -3511,7 +3513,7 @@ var require_datepart2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/meridiem.js
-var require_meridiem2 = __commonJS((exports, module) => {
+var require_meridiem2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
 
   class Meridiem extends DatePart {
@@ -3533,7 +3535,7 @@ var require_meridiem2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/day.js
-var require_day2 = __commonJS((exports, module) => {
+var require_day2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
   var pos = (n) => {
     n = n % 10;
@@ -3563,7 +3565,7 @@ var require_day2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/hours.js
-var require_hours2 = __commonJS((exports, module) => {
+var require_hours2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
 
   class Hours extends DatePart {
@@ -3590,7 +3592,7 @@ var require_hours2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/milliseconds.js
-var require_milliseconds2 = __commonJS((exports, module) => {
+var require_milliseconds2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
 
   class Milliseconds extends DatePart {
@@ -3614,7 +3616,7 @@ var require_milliseconds2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/minutes.js
-var require_minutes2 = __commonJS((exports, module) => {
+var require_minutes2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
 
   class Minutes extends DatePart {
@@ -3639,7 +3641,7 @@ var require_minutes2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/month.js
-var require_month2 = __commonJS((exports, module) => {
+var require_month2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
 
   class Month extends DatePart {
@@ -3666,7 +3668,7 @@ var require_month2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/seconds.js
-var require_seconds2 = __commonJS((exports, module) => {
+var require_seconds2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
 
   class Seconds extends DatePart {
@@ -3691,7 +3693,7 @@ var require_seconds2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/year.js
-var require_year2 = __commonJS((exports, module) => {
+var require_year2 = __commonJS(function(exports, module) {
   var DatePart = require_datepart2();
 
   class Year extends DatePart {
@@ -3716,7 +3718,7 @@ var require_year2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/dateparts/index.js
-var require_dateparts2 = __commonJS((exports, module) => {
+var require_dateparts2 = __commonJS(function(exports, module) {
   module.exports = {
     DatePart: require_datepart2(),
     Meridiem: require_meridiem2(),
@@ -3731,7 +3733,7 @@ var require_dateparts2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/elements/date.js
-var require_date2 = __commonJS((exports, module) => {
+var require_date2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt2();
   var { style, clear, figures } = require_util2();
@@ -3907,7 +3909,7 @@ ${i ? ` ` : figures.pointerSmall} ${color.red().italic(l)}`, ``);
 });
 
 // ../../node_modules/prompts/lib/elements/number.js
-var require_number2 = __commonJS((exports, module) => {
+var require_number2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt2();
   var { cursor, erase } = require_src();
@@ -4094,7 +4096,7 @@ ${i ? ` ` : figures.pointerSmall} ${color.red().italic(l)}`, ``);
 });
 
 // ../../node_modules/prompts/lib/elements/multiselect.js
-var require_multiselect2 = __commonJS((exports, module) => {
+var require_multiselect2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var { cursor } = require_src();
   var Prompt = require_prompt2();
@@ -4323,7 +4325,7 @@ Instructions:
 });
 
 // ../../node_modules/prompts/lib/elements/autocomplete.js
-var require_autocomplete2 = __commonJS((exports, module) => {
+var require_autocomplete2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt2();
   var { erase, cursor } = require_src();
@@ -4547,7 +4549,7 @@ var require_autocomplete2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/elements/autocompleteMultiselect.js
-var require_autocompleteMultiselect2 = __commonJS((exports, module) => {
+var require_autocompleteMultiselect2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var { cursor } = require_src();
   var MultiselectPrompt = require_multiselect2();
@@ -4710,7 +4712,7 @@ Filtered results for: ${this.inputValue ? this.inputValue : color.gray("Enter so
 });
 
 // ../../node_modules/prompts/lib/elements/confirm.js
-var require_confirm2 = __commonJS((exports, module) => {
+var require_confirm2 = __commonJS(function(exports, module) {
   var color = require_kleur();
   var Prompt = require_prompt2();
   var { style, clear } = require_util2();
@@ -4786,7 +4788,7 @@ var require_confirm2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/elements/index.js
-var require_elements2 = __commonJS((exports, module) => {
+var require_elements2 = __commonJS(function(exports, module) {
   module.exports = {
     TextPrompt: require_text2(),
     SelectPrompt: require_select2(),
@@ -4801,7 +4803,7 @@ var require_elements2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/lib/prompts.js
-var require_prompts2 = __commonJS((exports) => {
+var require_prompts2 = __commonJS(function(exports) {
   var $ = exports;
   var el = require_elements2();
   var noop = (v) => v;
@@ -4862,7 +4864,7 @@ var require_prompts2 = __commonJS((exports) => {
 });
 
 // ../../node_modules/prompts/lib/index.js
-var require_lib = __commonJS((exports, module) => {
+var require_lib = __commonJS(function(exports, module) {
   var prompts = require_prompts2();
   var passOn = ["suggest", "format", "onState", "validate", "onRender", "type"];
   var noop = () => {};
@@ -4935,7 +4937,7 @@ var require_lib = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/prompts/index.js
-var require_prompts3 = __commonJS((exports, module) => {
+var require_prompts3 = __commonJS(function(exports, module) {
   function isNodeLT(tar) {
     tar = (Array.isArray(tar) ? tar : tar.split(".")).map(Number);
     let i = 0, src = process.versions.node.split(".").map(Number);
@@ -4951,7 +4953,7 @@ var require_prompts3 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/picocolors/picocolors.js
-var require_picocolors = __commonJS((exports, module) => {
+var require_picocolors = __commonJS(function(exports, module) {
   var p = process || {};
   var argv = p.argv || [];
   var env = p.env || {};
@@ -5516,6 +5518,47 @@ function upgrade(args) {
   const upgradeExecution = commandArguments.write ? writeProjectPackageJsonUpgrade(packagePath, scaffoldManifest, new Date) : planProjectPackageFileUpgrade(packagePath, scaffoldManifest);
   printUpgradeExecution(upgradeExecution, commandArguments.projectDirectory, packagePath);
 }
+var GUIDANCE_FILES = ["DESIGN.md", "AGENTS.md"];
+function missingGuidanceFiles(projectDirectory) {
+  return GUIDANCE_FILES.filter((fileName) => !fs.existsSync(path.join(projectDirectory, fileName)));
+}
+function printGuidancePlan(projectDirectory, missingFiles) {
+  console.log();
+  console.log(import_picocolors.default.bold(`svadmin guidance — ${projectDirectory}`));
+  for (const fileName of missingFiles) {
+    console.log(`  ${import_picocolors.default.cyan("•")} add ${fileName}`);
+  }
+  console.log();
+}
+function installMissingGuidanceFiles(guidanceDirectory, projectDirectory, missingFiles) {
+  for (const fileName of missingFiles) {
+    fs.copyFileSync(path.join(guidanceDirectory, fileName), path.join(projectDirectory, fileName));
+  }
+}
+function guidance(args) {
+  const { projectDirectory, write } = parseUpgradeArguments(args);
+  const guidanceDirectory = path.join(__dirname2, "..", "guidance");
+  if (!fs.existsSync(projectDirectory))
+    throw new Error(`Project directory does not exist: ${projectDirectory}`);
+  if (!fs.existsSync(guidanceDirectory))
+    throw new Error("Shipped svadmin guidance files are missing");
+  const missingFiles = missingGuidanceFiles(projectDirectory);
+  if (missingFiles.length === 0) {
+    console.log(import_picocolors.default.green(`
+  ✔ DESIGN.md and AGENTS.md already exist; nothing was changed.
+`));
+    return;
+  }
+  printGuidancePlan(projectDirectory, missingFiles);
+  if (!write) {
+    console.log(import_picocolors.default.yellow(`  Dry run only; re-run with --write to add missing guidance files.
+`));
+    return;
+  }
+  installMissingGuidanceFiles(guidanceDirectory, projectDirectory, missingFiles);
+  console.log(import_picocolors.default.green(`  ✔ Added ${missingFiles.length} guidance file(s); existing files were preserved.`));
+  console.log();
+}
 async function init() {
   console.log();
   console.log(import_picocolors.default.cyan("  ╔═══════════════════════════════════╗"));
@@ -5583,6 +5626,7 @@ Operation cancelled.
 ${import_picocolors.default.bold("Scaffolding")} project in ${import_picocolors.default.green(projectDir)}...
 `);
   const templateDir = path.join(__dirname2, "..", "template");
+  const guidanceDir = path.join(__dirname2, "..", "guidance");
   const scaffoldManifest = loadShippedScaffoldManifest();
   function copyDir(src, dest) {
     fs.mkdirSync(dest, { recursive: true });
@@ -5601,6 +5645,10 @@ ${import_picocolors.default.bold("Scaffolding")} project in ${import_picocolors.
     copyDir(templateDir, projectDir);
     console.log(import_picocolors.default.green("  ✔") + " Template files copied");
   }
+  if (fs.existsSync(guidanceDir)) {
+    copyDir(guidanceDir, projectDir);
+    console.log(import_picocolors.default.green("  ✔") + " AI and design guidance copied");
+  }
   const packageJson = createProjectPackageJson(scaffoldManifest, {
     projectName: response.projectName,
     dataProvider: response.dataProvider,
@@ -5769,6 +5817,8 @@ if (subcommand === "eject") {
   runCommand(() => doctor(rest));
 } else if (subcommand === "upgrade") {
   runCommand(() => upgrade(rest));
+} else if (subcommand === "guidance") {
+  runCommand(() => guidance(rest));
 } else {
   runCommand(init);
 }

package/guidance/AGENTS.md

@@ -0,0 +1,40 @@
+# svadmin UI Generation Rules
+
+Read `DESIGN.md` before creating, revising, or reviewing any UI. It is the
+authority for visual language, page hierarchy, feedback ownership, and
+acceptance checks in this project.
+
+## Required workflow
+
+1. Name the page's single primary workflow and dominant next action.
+2. Inventory every heading, description, notice, metric, badge, and data view.
+3. Assign each fact and event to one primary UI surface.
+4. Reuse `@svadmin/ui` components and semantic Tailwind tokens before writing
+   custom markup or raw colors.
+5. Verify loading, empty, partial, error, permission, success, and mobile states.
+
+## Feedback invariant
+
+`one event -> one primary feedback surface`
+
+- Field errors are inline.
+- Routine success is a 3-second Toast.
+- If success changes the page into a completed state, render that state and set
+  `successNotification: false` on the hook or form.
+- Persistent notices are only for unresolved context, required action, blocking
+  failures, or risk. Use `FeedbackNotice`; it has no success variant.
+- The first viewport may contain at most one full-width high-emphasis notice.
+- A count or status already shown in a badge, table, progress state, or filename
+  must not be repeated in a banner or explanatory paragraph.
+- Toasts are keyed by event identity when duplicate delivery is possible. Do not
+  deduplicate globally by message text.
+
+## Reject generated UI when
+
+- success appears simultaneously in a Toast, heading, description, Alert, badge,
+  or result summary;
+- the page contains decorative explanation panels or nested cards;
+- copy only describes the controls or data immediately below it;
+- a resolved success banner remains in the normal reading flow;
+- desktop or mobile output overlaps, clips, scrolls horizontally, or pushes the
+  primary action out of view.

package/guidance/DESIGN.md

@@ -0,0 +1,268 @@
+---
+version: "alpha"
+name: "svadmin Stripe-first"
+description: "A restrained, precise product interface for repeated administrative work."
+colors:
+  background: "oklch(0.982 0.003 264)"
+  foreground: "oklch(0.205 0.012 264)"
+  surface: "oklch(1 0 0)"
+  surface-subtle: "oklch(0.968 0.004 264)"
+  muted-foreground: "oklch(0.493 0.018 264)"
+  border: "oklch(0.914 0.006 264)"
+  primary: "oklch(0.558 0.22 278)"
+  on-primary: "oklch(0.99 0 0)"
+  success: "oklch(0.51 0.16 151)"
+  warning: "oklch(0.7 0.15 75)"
+  danger: "oklch(0.58 0.22 27)"
+typography:
+  body:
+    fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif"
+    fontSize: "0.875rem"
+    fontWeight: 400
+    lineHeight: 1.5
+    letterSpacing: "0px"
+  label:
+    fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif"
+    fontSize: "0.8125rem"
+    fontWeight: 500
+    lineHeight: 1.35
+    letterSpacing: "0px"
+  heading:
+    fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif"
+    fontSize: "1.25rem"
+    fontWeight: 600
+    lineHeight: 1.3
+    letterSpacing: "0px"
+rounded:
+  sm: "4px"
+  md: "6px"
+  lg: "8px"
+spacing:
+  xs: "4px"
+  sm: "8px"
+  md: "16px"
+  lg: "24px"
+  xl: "32px"
+components:
+  page:
+    backgroundColor: "{colors.background}"
+    textColor: "{colors.foreground}"
+    typography: "{typography.body}"
+  surface:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.foreground}"
+    rounded: "{rounded.lg}"
+  surface-subtle:
+    backgroundColor: "{colors.surface-subtle}"
+    textColor: "{colors.muted-foreground}"
+    rounded: "{rounded.md}"
+  button-primary:
+    backgroundColor: "{colors.primary}"
+    textColor: "{colors.on-primary}"
+    rounded: "{rounded.md}"
+    typography: "{typography.label}"
+  input:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.foreground}"
+    rounded: "{rounded.md}"
+    typography: "{typography.body}"
+  divider:
+    backgroundColor: "{colors.border}"
+    height: "1px"
+  status-success:
+    backgroundColor: "{colors.success}"
+    textColor: "{colors.on-primary}"
+    rounded: "{rounded.sm}"
+    typography: "{typography.label}"
+  status-warning:
+    backgroundColor: "{colors.warning}"
+    textColor: "{colors.foreground}"
+    rounded: "{rounded.sm}"
+    typography: "{typography.label}"
+  status-danger:
+    backgroundColor: "{colors.danger}"
+    textColor: "{colors.on-primary}"
+    rounded: "{rounded.sm}"
+    typography: "{typography.label}"
+  page-heading:
+    textColor: "{colors.foreground}"
+    typography: "{typography.heading}"
+---
+
+## Overview
+
+svadmin uses a Stripe-first product language: quiet neutral canvases, precise
+type, hairline borders, restrained elevation, compact controls, and clear
+feedback for repeated operational work. The interface should feel like a real
+administrative product with trustworthy states, not a collection of dashboard
+templates.
+
+Metronic is a capability reference only. Its page families, information
+architecture, and scenario coverage may expose missing components or examples,
+but its palette, decoration, card treatment, typography, and branding are not
+visual authority.
+
+### Design principles
+
+Seven principles turn the Stripe-first direction into reviewable product
+decisions. They apply to built-in components, examples, generated applications,
+and documentation:
+
+1. **Clear by default:** every page has one primary job, one dominant next
+   action, and one owner for every visible fact. Supporting copy adds a
+   constraint, consequence, scope, or recovery path instead of repeating UI.
+2. **Efficient in the loop:** preserve filters, selection, navigation context,
+   and keyboard reachability across repeated work. Loading and feedback must not
+   move the primary action or force an unnecessary page transition.
+3. **Consistent by contract:** semantic tokens, component variants, state names,
+   page skeletons, and feedback lifecycles remain stable across products. Layout
+   presets may change density and composition, not interaction meaning.
+4. **Trustworthy in every state:** loading, empty, partial, error, forbidden,
+   destructive, reversible, and completed states expose their scope and next
+   step. Data freshness, permission boundaries, and action consequences must be
+   visible when they affect a decision.
+5. **Restrained like Stripe:** neutral surfaces and precise hierarchy carry the
+   interface. Accent, elevation, radius, animation, and decoration are used only
+   when they clarify priority or interaction.
+6. **Accessible by construction:** keyboard access, visible focus, semantic
+   structure, non-color status cues, readable contrast, stable targets, and
+   responsive behavior are component defaults rather than page-level repairs.
+7. **AI-ready and auditable:** generated UI declares its primary workflow,
+   information owners, state owners, and feedback removal conditions; it uses
+   the trusted component catalog and passes deterministic and visual gates.
+
+Use these principles as an ordered review: first verify the task and state are
+clear, then efficiency and consistency, then trust, restraint, accessibility,
+and generation evidence. A visually polished page still fails when its state or
+action ownership is ambiguous.
+
+## Colors
+
+Neutrals carry the interface. Primary is a single controlled interaction accent,
+not a page background. Success, warning, and danger are reserved for semantic
+status and feedback. Consumer themes may replace the primary hue while keeping
+the neutral hierarchy and contrast relationships intact.
+
+## Typography
+
+Use Inter or the consumer's compatible system sans. Product pages use compact
+headings and normal letter spacing. Uppercase table labels, negative tracking,
+and oversized dashboard numerals are not defaults.
+
+## Layout
+
+Use an 8px spacing rhythm with 4px for tight internal alignment. Pages are
+unframed layouts with a stable content width. Cards represent individual
+objects or bounded tools; page sections are not decorative floating cards and
+cards are not nested for visual effect.
+
+## Elevation & Depth
+
+Surfaces use a one-pixel border plus a subtle two-layer shadow. Hover elevation
+may increase slightly for genuinely clickable items, without translation or
+glow. Dialogs and menus receive stronger depth because they are floating
+layers. Dark mode keeps the same hierarchy with low-chroma surfaces.
+
+## Shapes
+
+Controls use 6px radii and bounded surfaces use 8px radii. Pills are limited to
+status badges, avatar groups, and controls whose geometry carries meaning.
+
+## Components
+
+Buttons, fields, tabs, tables, badges, empty states, skeletons, alerts, and
+feedback use shared components and semantic tokens. Layout presets may adjust
+density and composition, but they must not replace component color, typography,
+focus, or elevation with hard-coded values.
+
+### Reference responsibilities
+
+The reference stack is layered. It is not a visual mixture:
+
+- **Stripe is the visual authority:** hierarchy, restraint, neutral surfaces,
+  typography, density, and interaction tone.
+- **Refine is an application-model reference:** resource routing, CRUD flows,
+  provider state, access control, and mutation ownership.
+- **Ant Design is a behavior reference:** field validation, alerts, messages,
+  notifications, results, empty states, loading, and high-density data tasks.
+- **shadcn/ui is a composition reference:** accessible primitives, source-owned
+  components, semantic tokens, variants, and AI-readable assembly patterns.
+- **Carbon and PatternFly are enterprise-pattern references:** notification
+  lifecycle, inline versus global feedback, empty/error states, and operational
+  page composition.
+- **Metronic is a coverage reference:** page families and missing scenarios only.
+
+Never copy a reference library's palette, radius, elevation, marketing layout,
+or component chrome without an explicit svadmin design decision.
+
+### Page hierarchy and information budget
+
+Every page must have one primary job and one dominant next action. Before adding
+content, identify the page's primary workflow, current unresolved state, data
+state, and action owner.
+
+- From the page header through the primary work area, allow at most one
+  full-width, high-emphasis persistent feedback surface.
+- Explanatory copy must add a constraint, consequence, scope, or recovery path.
+  It must not paraphrase the heading, field label, button, badge, or data below.
+- A fact or count already visible in a filename, badge, table, progress state,
+  or summary has one owner and is not repeated in another banner or paragraph.
+- Use a page section only when it groups a real task or bounded data set. Do not
+  create an informational section solely to describe the surrounding UI.
+- A feedback surface has at most one primary action. Additional recovery paths
+  belong in the destination workflow, menu, or supporting text.
+
+### Feedback hierarchy
+
+The invariant is: **one event -> one primary feedback surface**.
+
+| Event | Primary surface | Lifecycle |
+| --- | --- | --- |
+| Invalid field or field-specific server error | Inline field message | Until corrected |
+| Successful mutation with no next action | Toast | 3 seconds |
+| Success that changes the page into a completed state | New page/local state; disable the automatic Toast | Until navigation or a new task |
+| Unresolved partial result or required user action | `FeedbackNotice` warning | Until resolved |
+| Blocking failure, permission boundary, or unavailable workflow | `FeedbackNotice` danger or error state | Until resolved or dismissed |
+| Non-blocking policy or scope context | `FeedbackNotice` info | While context remains relevant |
+| Reversible mutation | Undoable Toast | Exactly the undo window |
+
+Success is never a persistent page-level banner. `FeedbackNotice` intentionally
+has no success tone. A successful event must not simultaneously occupy a Toast,
+heading, description, Alert, status badge, and data summary. When a page owns a
+completed state, disable hook-level success notification with
+`successNotification: false` on the owning hook or form.
+
+Toasts are collapsed by default, limited to three visible items, and keyed by
+event identity when duplicate delivery is possible. A key represents one event,
+not a message string. Errors may remain longer than success, but persistent
+errors must expose a recovery path or a dismiss action.
+
+### AI generation contract
+
+Before accepting an AI-generated application page, verify all of the following:
+
+1. The page has one explicit primary workflow and the main action is visible.
+2. Every heading, description, notice, metric, badge, and table has unique
+   information ownership.
+3. Loading, empty, partial, error, permission, and success states use the
+   feedback hierarchy above.
+4. Ordinary success uses a Toast; state-transition success uses the new state;
+   the two are never emitted for the same event.
+5. The first viewport contains no nested cards, decorative explanation panels,
+   or more than one persistent high-emphasis notice.
+6. Desktop and mobile screenshots show no overlap, clipping, horizontal scroll,
+   or action displacement caused by feedback content.
+
+## Do's and Don'ts
+
+- Do keep hierarchy quiet, dense, aligned, and easy to scan repeatedly.
+- Do show loading, empty, error, permission, progress, and mutation feedback.
+- Do preserve visible keyboard focus and at least 44px coarse-pointer targets.
+- Do remove, downgrade, or relocate feedback as soon as its state is resolved.
+- Don't copy Metronic colors, decorative treatment, or template branding.
+- Don't repeat a success fact across Toast, title, description, banner, badge,
+  and table data.
+- Don't use persistent success banners for routine mutations.
+- Don't use gradients, glow, glassmorphism, negative letter spacing, or blanket
+  `!important` overrides as the default product language.
+- Don't use cards inside cards or make every section a floating card.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/create",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "Scaffolding tool for svadmin projects",
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   "files": [
     "dist",
     "template",
+    "guidance",
     "scaffold-manifest.json"
   ],
   "scripts": {

package/scaffold-manifest.json

@@ -10,8 +10,8 @@
     "check": "svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {
-    "@svadmin/core": "^0.37.0",
-    "@svadmin/ui": "^0.44.0",
+    "@svadmin/core": "^0.38.0",
+    "@svadmin/ui": "^0.46.0",
     "@tanstack/svelte-query": "^6.1.38",
     "highlight.js": "^11.11.1",
     "@lucide/svelte": "^1.31.0"