@askewly/design 0.6.1 → 0.6.3

package/dist/index.js

@@ -10,7 +10,7 @@ import { verifyDir } from "./verify.js";
 import { loadKnowledge, loadRecipes, loadTerms, loadTokens, loadTokensCss, searchKnowledge, searchTerms, tokensForTier, } from "./load.js";
 import { recall, RECALL_AXES } from "./data.js";
 import { assetUrl, buildPrompt, loadAssets, searchAssets, suggestAssets } from "./assets.js";
-import { getSite, listSites, SiteError } from "./site.js";
+import { getSite, listSites, siteNextStep, SiteError } from "./site.js";
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 const program = new Command();
 program
@@ -154,6 +154,14 @@ program
     try {
         const result = addRecipe(recipe, path.resolve(options.out), Boolean(options.force), path.resolve(options.tokens));
         console.log(`wrote ${result.file}`);
+        for (const lib of result.libs) {
+            if (lib.status === "written")
+                console.log(`wrote ${lib.file}`);
+            else if (lib.status === "unchanged")
+                console.log(`unchanged ${lib.file} (already identical)`);
+            else
+                console.log(`⚠ kept ${lib.file} - differs from the bundled lib; not overwritten. Diff it by hand if the component misbehaves.`);
+        }
         if (result.missingTokens.length > 0) {
             console.log(`\n⚠ tokens not found in ${options.tokens} — run \`askewly-design init\` first. Required:`);
             for (const token of result.missingTokens)
@@ -443,8 +451,8 @@ siteCmd
     try {
         const target = dir ?? slug;
         const n = await getSite(slug, target);
-        console.log(`${n} files -> ${target}
-read ${path.join(target, "ASKEWLY-BUNDLE.md")} for what was left out and how to run it`);
+        console.log(`${n} files -> ${target}
+${siteNextStep(target)}`);
     }
     catch (error) {
         if (error instanceof SiteError)

package/dist/inject.js

@@ -71,12 +71,16 @@ export function extractSectionNotes(recipe, title) {
         .filter((line) => line.trim().startsWith("- "))
         .map((line) => line.trim().slice(2));
 }
+/** kickstart 의 srcRoot 규칙과 같다: 프로젝트에 src/ 가 있으면 그 안, 없으면 프로젝트 루트. */
+export function defaultSrcRoot(projectDir) {
+    return existsSync(path.join(projectDir, "src")) ? path.join(projectDir, "src") : projectDir;
+}
 /**
  * Writes the recipe's Code excerpt to <outDir>/<id>.tsx and reports which
  * tokens_used entries are not covered by an existing tokens.css in outDir's
  * project root (heuristic: tokens.css next to outDir or in cwd).
  */
-export function addRecipe(recipe, outDir, force, tokensCssPath) {
+export function addRecipe(recipe, outDir, force, tokensCssPath, srcRoot = defaultSrcRoot(process.cwd())) {
     const snippet = extractCodeSnippet(recipe);
     const file = path.join(outDir, `${recipe.id}.tsx`);
     if (existsSync(file) && !force) {
@@ -84,6 +88,20 @@ export function addRecipe(recipe, outDir, force, tokensCssPath) {
     }
     mkdirSync(outDir, { recursive: true });
     writeFileSync(file, snippet);
+    // 컴포넌트가 import 하는 로컬 lib(`@/lib/...`)도 함께 쓴다. 같은 내용이면 건너뛰고,
+    // 다르면 덮어쓰지 않고 알린다(사용자가 고친 lib 를 조용히 날리지 않는다).
+    const libs = [];
+    for (const lib of recipe.lib_files ?? []) {
+        const dest = path.join(srcRoot, lib.target);
+        if (existsSync(dest)) {
+            const same = readFileSync(dest, "utf8").replace(/\r\n/g, "\n") === lib.content;
+            libs.push({ file: dest, status: same ? "unchanged" : "conflict" });
+            continue;
+        }
+        mkdirSync(path.dirname(dest), { recursive: true });
+        writeFileSync(dest, lib.content);
+        libs.push({ file: dest, status: "written" });
+    }
     let missingTokens = [];
     const tokensUsed = recipe.tokens_used ?? [];
     if (tokensUsed.length > 0) {
@@ -101,6 +119,7 @@ export function addRecipe(recipe, outDir, force, tokensCssPath) {
     }
     return {
         file,
+        libs,
         missingTokens,
         checks: extractSectionNotes(recipe, "Checks"),
         antiPatterns: extractSectionNotes(recipe, "Anti-patterns"),

package/dist/site.js

@@ -79,6 +79,12 @@ export function readZip(buf) {
     }
     return out;
 }
+export function siteNextStep(dir) {
+    if (existsSync(path.join(dir, "content.json"))) {
+        return "edit content.json with your text and media paths, then run the page; read blueprint.md for how it is built";
+    }
+    return `read ${path.join(dir, "ASKEWLY-BUNDLE.md")} for what was left out and how to run it`;
+}
 export async function listSites(base = bundleBaseUrl()) {
     return fetchSiteIndex(base);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askewly/design",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Query, inject, and verify the Askewly Design system (tokens, UI vocabulary, recipes) from your terminal or coding agent.",
   "license": "MIT",
   "homepage": "https://ui.askewly.com",