@pikku/skills 0.12.34 → 0.12.37

package/README.md

@@ -32,7 +32,12 @@ for (const name of await listSkillNames()) {
 ```
 
 Reads prefer the `skills/` directory on disk, so editing a `SKILL.md` is live
-immediately. `SKILL_FILES` is the same content as an embedded path → contents map,
-which is what makes the skills available inside the `bun --compile` CLI binaries
-where no filesystem copy exists. Regenerate it with `bun run embed` after changing
-anything under `skills/`.
+immediately. A fence marked ```` ```ts snippet:<region> ```` is expanded at read
+time from the embedded snippet map, so an installed copy shows the compiled code
+even though the source keeps the placeholder. `SKILL_FILES` is the same content
+as an embedded path → contents map (already expanded), which is what makes the
+skills available inside the `bun --compile` CLI binaries where no filesystem copy
+exists. Regenerate it with `bun run embed` after changing anything under
+`skills/` — that is also when snippets are collected from
+`examples/online-shop`, and a fence naming a region that does not exist fails
+the embed.

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { SKILL_FILES } from './skills.gen.js';
-export { SKILL_FILES };
+import { SKILL_FILES, SKILL_SNIPPETS } from './skills.gen.js';
+export { SKILL_FILES, SKILL_SNIPPETS };
+export { collectSnippets, expandSkillMarkdown, snippetRegionsIn, DuplicateSnippetError, MissingSnippetError, UnclosedSnippetError, } from './snippets.js';
 /**
  * Absolute path to the `skills/` directory shipped beside this module, or `null`
  * when there is no filesystem copy to read.
@@ -12,8 +13,10 @@ export { SKILL_FILES };
 export declare const skillsDir: string | null;
 /**
  * Reading prefers the filesystem so that editing a SKILL.md is immediately live
- * for `pikku skills install` without re-running `yarn embed`; the manifest is the
- * fallback for bundled contexts. The two are identical after a build.
+ * for `pikku skills install` without re-running `bun run embed`; the manifest is
+ * the fallback for bundled contexts. A filesystem read expands `snippet:` fences
+ * from the embedded snippet map, so the installed text matches the manifest
+ * even though the source keeps placeholders.
  */
 export declare const listSkillNames: () => Promise<string[]>;
 /** Every file belonging to one skill, as paths relative to the skills root. */

package/dist/index.js

@@ -2,8 +2,10 @@ import { existsSync } from 'fs';
 import { readdir, readFile } from 'fs/promises';
 import { dirname, join, relative, sep } from 'path';
 import { fileURLToPath } from 'url';
-import { SKILL_FILES } from './skills.gen.js';
-export { SKILL_FILES };
+import { SKILL_FILES, SKILL_SNIPPETS } from './skills.gen.js';
+import { expandSkillMarkdown } from './snippets.js';
+export { SKILL_FILES, SKILL_SNIPPETS };
+export { collectSnippets, expandSkillMarkdown, snippetRegionsIn, DuplicateSnippetError, MissingSnippetError, UnclosedSnippetError, } from './snippets.js';
 /**
  * Absolute path to the `skills/` directory shipped beside this module, or `null`
  * when there is no filesystem copy to read.
@@ -20,8 +22,10 @@ export const skillsDir = (() => {
 const toPosix = (path) => path.split(sep).join('/');
 /**
  * Reading prefers the filesystem so that editing a SKILL.md is immediately live
- * for `pikku skills install` without re-running `yarn embed`; the manifest is the
- * fallback for bundled contexts. The two are identical after a build.
+ * for `pikku skills install` without re-running `bun run embed`; the manifest is
+ * the fallback for bundled contexts. A filesystem read expands `snippet:` fences
+ * from the embedded snippet map, so the installed text matches the manifest
+ * even though the source keeps placeholders.
  */
 export const listSkillNames = async () => {
     if (skillsDir) {
@@ -68,7 +72,7 @@ export const readSkillFile = async (path) => {
         const full = join(skillsDir, ...path.split('/'));
         if (!existsSync(full))
             return null;
-        return readFile(full, 'utf-8');
+        return expandSkillMarkdown(await readFile(full, 'utf-8'), SKILL_SNIPPETS, path);
     }
     return SKILL_FILES[path] ?? null;
 };

package/dist/skills.gen.d.ts

@@ -1 +1,2 @@
 export declare const SKILL_FILES: Record<string, string>;
+export declare const SKILL_SNIPPETS: Record<string, string>;