npm - web-skill - Versions diffs - 0.1.0 → 0.1.1 - Mend

web-skill 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +20 -2
package/dist/chunk-YVQDAY47.js +305 -0
package/dist/chunk-YVQDAY47.js.map +1 -0
package/dist/index.d.ts +18 -0
package/{src/runtime.ts → dist/index.js} +41 -94
package/dist/index.js.map +1 -0
package/dist/vite-plugin-5xZLBPsq.d.ts +71 -0
package/dist/vite-plugin.d.ts +3 -0
package/dist/vite-plugin.js +3 -0
package/dist/vite-plugin.js.map +1 -0
package/docs/api.md +121 -0
package/package.json +30 -8
package/src/index.ts +0 -20
package/src/markdown.ts +0 -230
package/src/types.ts +0 -89
package/src/utils.ts +0 -90
package/src/vite-plugin.ts +0 -91

package/README.md CHANGED Viewed

@@ -8,7 +8,9 @@ From one shared config it can:
 - generate one `SKILL.md` file per published skill
 - inject `<link rel="web-skill" ...>` tags into the HTML `<head>` through Vite
-The package is source-first and works best in TypeScript apps that already use Vite and Zod.
+The package is TypeScript-first and works best in apps that already use Vite and Zod.
+Status: early, but installable. The package now ships compiled `dist/` output, basic automated tests, and a small API reference so adopters do not need to compile TypeScript source themselves just to try it.
 ## Install
@@ -154,6 +156,10 @@ Each generated `SKILL.md` contains:
 The repository also includes [`skills/use-web-skill/SKILL.md`](./skills/use-web-skill/SKILL.md), a discovery workflow for agents that inspect `<head>` before automating a page.
+## API reference
+For the exported surface, expected behaviors, and common runtime errors, see [`docs/api.md`](./docs/api.md).
 ## Design guidance
 `web-skill` works best when you expose task-level actions instead of raw UI primitives.
@@ -182,11 +188,23 @@ Treat destructive actions as special cases:
 - return structured results instead of relying on toast text
 - avoid exposing unstable internal helpers just because they are easy to call
+## Authorization guidance
+`web-skill` does not enforce authorization by itself. The recommended model is for the application to decide which skill documents and runtime functions are exposed in the current session.
+Typical patterns:
+- only render admin-only `<link rel="web-skill" ...>` tags for admin users
+- serve different skill documents for different audiences such as `/admin-only/SKILL.md` and `/user/SKILL.md`
+- keep backend APIs as the final authorization boundary even if a browser skill becomes visible
+If your agent flow benefits from advisory hints, prefer putting that information directly in the visible skill description or link title. For example, titles and descriptions such as `Admin-only order approval API` are often enough to help agents choose the right skill without adding new package-level permission features.
 ## Local development
 ```bash
 npm install
-npm run check
+npm run verify
 ```
 ## License

package/dist/chunk-YVQDAY47.js ADDED Viewed

@@ -0,0 +1,305 @@
+// src/markdown.ts
+var INDENT = "  ";
+function generateSkillMarkdown(skill) {
+  const description = skill.description ?? `Expose browser-callable functions under \`window._web_skills.${skill.key}\`.`;
+  const lines = [
+    "---",
+    `name: ${skill.slug}`,
+    `description: ${escapeFrontmatterValue(description)}`,
+    "---",
+    "",
+    `# ${skill.title}`,
+    "",
+    "Use the browser console entrypoint:",
+    "",
+    "```js",
+    `window._web_skills.${skill.key}`,
+    "```",
+    "",
+    "Available functions:",
+    ""
+  ];
+  for (const definition of skill.functions) {
+    lines.push(...renderFunctionSection(skill, definition), "");
+  }
+  return `${lines.join("\n").trimEnd()}
+`;
+}
+function renderFunctionSection(skill, definition) {
+  const inputSchema = definition.inputSchema ? renderZodSchema(definition.inputSchema) : "unknown";
+  const outputSchema = definition.outputSchema ? renderZodSchema(definition.outputSchema) : "unknown";
+  return [
+    `## \`${definition.name}(input)\``,
+    "",
+    `Purpose: ${definition.description ?? `Invoke \`window._web_skills.${skill.key}.${definition.name}(input)\`.`}`,
+    "",
+    "Input:",
+    "",
+    "```ts",
+    inputSchema,
+    "```",
+    "",
+    "Output:",
+    "",
+    "```ts",
+    outputSchema,
+    "```"
+  ];
+}
+function renderZodSchema(schema) {
+  return renderSchema(schema, 0);
+}
+function renderSchema(schema, depth) {
+  const definition = getDefinition(schema);
+  const typeName = definition?.typeName;
+  switch (typeName) {
+    case "ZodString":
+      return "string";
+    case "ZodNumber":
+      return "number";
+    case "ZodBoolean":
+      return "boolean";
+    case "ZodBigInt":
+      return "bigint";
+    case "ZodDate":
+      return "Date";
+    case "ZodUndefined":
+      return "undefined";
+    case "ZodNull":
+      return "null";
+    case "ZodVoid":
+      return "void";
+    case "ZodAny":
+      return "any";
+    case "ZodUnknown":
+      return "unknown";
+    case "ZodNever":
+      return "never";
+    case "ZodLiteral":
+      return JSON.stringify(definition?.value);
+    case "ZodEnum":
+      return Array.isArray(definition?.values) ? definition.values.map((value) => JSON.stringify(value)).join(" | ") : "string";
+    case "ZodNativeEnum":
+      return renderNativeEnum(
+        definition?.values && typeof definition.values === "object" ? definition.values : void 0
+      );
+    case "ZodArray":
+      return `${wrapType(renderSchema(definition?.type, depth))}[]`;
+    case "ZodOptional":
+      return `${renderSchema(definition?.innerType, depth)} | undefined`;
+    case "ZodNullable":
+      return `${renderSchema(definition?.innerType, depth)} | null`;
+    case "ZodDefault":
+    case "ZodCatch":
+      return renderSchema(definition?.innerType, depth);
+    case "ZodEffects":
+      return renderSchema(definition?.schema, depth);
+    case "ZodBranded":
+      return renderSchema(definition?.type, depth);
+    case "ZodUnion":
+      return Array.isArray(definition?.options) ? definition.options.map((option) => wrapType(renderSchema(option, depth))).join(" | ") : "unknown";
+    case "ZodDiscriminatedUnion":
+      return Array.from(
+        definition?.options instanceof Map ? definition.options.values() : []
+      ).map((option) => wrapType(renderSchema(option, depth))).join(" | ");
+    case "ZodIntersection":
+      return `${wrapType(renderSchema(definition?.left, depth))} & ${wrapType(renderSchema(definition?.right, depth))}`;
+    case "ZodTuple":
+      return `[${Array.isArray(definition?.items) ? definition.items.map((item) => renderSchema(item, depth)).join(", ") : ""}]`;
+    case "ZodRecord":
+      return `Record<${renderRecordKey(definition?.keyType)}, ${renderSchema(definition?.valueType, depth)}>`;
+    case "ZodObject":
+      return renderObjectSchema(schema, depth);
+    case "ZodLazy":
+      return typeof definition?.getter === "function" ? renderSchema(definition.getter(), depth) : "unknown";
+    default:
+      return "unknown";
+  }
+}
+function renderObjectSchema(schema, depth) {
+  const definition = getDefinition(schema);
+  const shapeSource = definition?.shape;
+  const shape = typeof shapeSource === "function" ? shapeSource() : shapeSource ?? {};
+  const entries = Object.entries(shape);
+  if (entries.length === 0) {
+    return "{}";
+  }
+  const propertyLines = entries.map(([key, propertySchema]) => {
+    const optional = isOptionalSchema(propertySchema);
+    const renderedType = renderSchema(optional ? unwrapOptionalSchema(propertySchema) : propertySchema, depth + 1);
+    return `${indent(depth + 1)}${quotePropertyKey(key)}${optional ? "?" : ""}: ${renderedType};`;
+  });
+  return ["{", ...propertyLines, `${indent(depth)}}`].join("\n");
+}
+function renderNativeEnum(values) {
+  if (!values) {
+    return "string | number";
+  }
+  const rendered = Array.from(
+    new Set(
+      Object.values(values).filter(
+        (value) => typeof value === "string" || typeof value === "number"
+      )
+    )
+  );
+  return rendered.map((value) => JSON.stringify(value)).join(" | ") || "string | number";
+}
+function renderRecordKey(keyType) {
+  if (!keyType) {
+    return "string";
+  }
+  return renderSchema(keyType, 0);
+}
+function isOptionalSchema(schema) {
+  return typeof schema.isOptional === "function" ? schema.isOptional() : getDefinition(schema)?.typeName === "ZodOptional";
+}
+function unwrapOptionalSchema(schema) {
+  const definition = getDefinition(schema);
+  if (definition?.typeName === "ZodOptional") {
+    return definition.innerType;
+  }
+  return schema;
+}
+function wrapType(value) {
+  return /[|&\n]/u.test(value) ? `(${value})` : value;
+}
+function quotePropertyKey(value) {
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(value) ? value : JSON.stringify(value);
+}
+function indent(depth) {
+  return INDENT.repeat(depth);
+}
+function getDefinition(schema) {
+  return schema._def;
+}
+function escapeFrontmatterValue(value) {
+  return JSON.stringify(value);
+}
+// src/utils.ts
+var NON_ALPHANUMERIC_PATTERN = /[^a-zA-Z0-9]+/gu;
+var TRIM_DASHES_PATTERN = /^-+|-+$/gu;
+var CAMEL_BOUNDARY_PATTERN = /[-_\s]+([a-zA-Z0-9])/gu;
+var NON_IDENTIFIER_PATTERN = /[^a-zA-Z0-9_$]/gu;
+var LEADING_INVALID_IDENTIFIER_PATTERN = /^[^a-zA-Z_$]+/u;
+function slugifySkillSegment(value) {
+  const normalized = value.trim().replace(NON_ALPHANUMERIC_PATTERN, "-").replace(TRIM_DASHES_PATTERN, "").toLowerCase();
+  return normalized || "web-skill";
+}
+function toSkillKey(value) {
+  const identifier = value.trim().replace(CAMEL_BOUNDARY_PATTERN, (_match, character) => character.toUpperCase()).replace(NON_IDENTIFIER_PATTERN, "").replace(LEADING_INVALID_IDENTIFIER_PATTERN, "");
+  if (!identifier) {
+    return "webSkill";
+  }
+  return identifier[0].toLowerCase() + identifier.slice(1);
+}
+function titleFromName(value) {
+  const normalized = value.replace(/([a-z0-9])([A-Z])/gu, "$1 $2").replace(/[-_]+/gu, " ").trim();
+  if (!normalized) {
+    return "Web Skill";
+  }
+  return normalized.split(/\s+/u).map((part) => part[0].toUpperCase() + part.slice(1)).join(" ");
+}
+function ensureUniqueString(value, used, formatter = (index) => `${value}-${index + 1}`) {
+  if (!used.has(value)) {
+    used.add(value);
+    return value;
+  }
+  let index = 1;
+  while (true) {
+    const nextValue = formatter(index);
+    if (!used.has(nextValue)) {
+      used.add(nextValue);
+      return nextValue;
+    }
+    index += 1;
+  }
+}
+function joinBasePath(basePath, relativePath) {
+  const normalizedBase = (basePath ?? "/").trim();
+  const base = normalizedBase === "/" ? "" : `/${normalizedBase.replace(/^\/+|\/+$/gu, "")}`;
+  const path = relativePath.startsWith("/") ? relativePath : `/${relativePath}`;
+  return `${base}${path}`;
+}
+function toSkillMarkdownAssetPath(skill) {
+  return `/skills/${skill.slug}/SKILL.md`;
+}
+function buildWebSkillLinkTags(skills, basePath) {
+  return skills.map((skill) => ({
+    href: joinBasePath(basePath, toSkillMarkdownAssetPath(skill)),
+    title: skill.title,
+    type: "text/markdown"
+  }));
+}
+// src/vite-plugin.ts
+function webSkillVitePlugin(options) {
+  let resolvedConfig = null;
+  return {
+    name: "web-skill",
+    configResolved(config) {
+      resolvedConfig = config;
+    },
+    configureServer(server) {
+      server.middlewares.use((request, response, next) => {
+        if (!resolvedConfig) {
+          next();
+          return;
+        }
+        if (!tryServeGeneratedSkillMarkdown(
+          request,
+          response,
+          options.generator.getSkills(),
+          options.publicBasePath ?? resolvedConfig.base
+        )) {
+          next();
+        }
+      });
+    },
+    generateBundle() {
+      for (const skill of options.generator.getSkills()) {
+        this.emitFile({
+          fileName: `skills/${skill.slug}/SKILL.md`,
+          source: generateSkillMarkdown(skill),
+          type: "asset"
+        });
+      }
+    },
+    transformIndexHtml() {
+      const tags = buildWebSkillLinkTags(
+        options.generator.getSkills(),
+        options.publicBasePath ?? resolvedConfig?.base ?? "/"
+      );
+      return tags.map((tag) => ({
+        tag: "link",
+        attrs: {
+          rel: "web-skill",
+          href: tag.href,
+          title: tag.title,
+          type: tag.type
+        },
+        injectTo: "head"
+      }));
+    }
+  };
+}
+function tryServeGeneratedSkillMarkdown(request, response, skills, basePath) {
+  const requestUrl = request.url;
+  if (!requestUrl) {
+    return false;
+  }
+  const pathname = new URL(requestUrl, "http://localhost").pathname;
+  const tags = buildWebSkillLinkTags(skills, basePath);
+  const matchedIndex = tags.findIndex((tag) => tag.href === pathname);
+  if (matchedIndex === -1) {
+    return false;
+  }
+  response.statusCode = 200;
+  response.setHeader("Content-Type", "text/markdown; charset=utf-8");
+  response.end(generateSkillMarkdown(skills[matchedIndex]));
+  return true;
+}
+export { buildWebSkillLinkTags, ensureUniqueString, generateSkillMarkdown, renderZodSchema, slugifySkillSegment, titleFromName, toSkillKey, webSkillVitePlugin };
+//# sourceMappingURL=chunk-YVQDAY47.js.map
+//# sourceMappingURL=chunk-YVQDAY47.js.map

package/dist/chunk-YVQDAY47.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/markdown.ts","../src/utils.ts","../src/vite-plugin.ts"],"names":[],"mappings":"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","file":"chunk-YVQDAY47.js","sourcesContent":["import type { ZodTypeAny } from \"zod\";\n\nimport type { ResolvedWebSkillDefinition, ResolvedWebSkillFunctionDefinition } from \"./types.ts\";\n\nconst INDENT = \" \";\n\ninterface LooseZodDefinition {\n typeName?: string;\n [key: string]: unknown;\n}\n\nexport function generateSkillMarkdown(skill: ResolvedWebSkillDefinition): string {\n const description =\n skill.description\n ?? `Expose browser-callable functions under \\`window._web_skills.${skill.key}\\`.`;\n\n const lines: string[] = [\n \"---\",\n `name: ${skill.slug}`,\n `description: ${escapeFrontmatterValue(description)}`,\n \"---\",\n \"\",\n `# ${skill.title}`,\n \"\",\n \"Use the browser console entrypoint:\",\n \"\",\n \"```js\",\n `window._web_skills.${skill.key}`,\n \"```\",\n \"\",\n \"Available functions:\",\n \"\",\n ];\n\n for (const definition of skill.functions) {\n lines.push(...renderFunctionSection(skill, definition), \"\");\n }\n\n return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n\nfunction renderFunctionSection(\n skill: ResolvedWebSkillDefinition,\n definition: ResolvedWebSkillFunctionDefinition,\n): string[] {\n const inputSchema = definition.inputSchema ? renderZodSchema(definition.inputSchema) : \"unknown\";\n const outputSchema = definition.outputSchema ? renderZodSchema(definition.outputSchema) : \"unknown\";\n\n return [\n `## \\`${definition.name}(input)\\``,\n \"\",\n `Purpose: ${definition.description ?? `Invoke \\`window._web_skills.${skill.key}.${definition.name}(input)\\`.`}`,\n \"\",\n \"Input:\",\n \"\",\n \"```ts\",\n inputSchema,\n \"```\",\n \"\",\n \"Output:\",\n \"\",\n \"```ts\",\n outputSchema,\n \"```\",\n ];\n}\n\nexport function renderZodSchema(schema: ZodTypeAny): string {\n return renderSchema(schema, 0);\n}\n\nfunction renderSchema(schema: ZodTypeAny, depth: number): string {\n const definition = getDefinition(schema);\n const typeName = definition?.typeName;\n\n switch (typeName) {\n case \"ZodString\":\n return \"string\";\n case \"ZodNumber\":\n return \"number\";\n case \"ZodBoolean\":\n return \"boolean\";\n case \"ZodBigInt\":\n return \"bigint\";\n case \"ZodDate\":\n return \"Date\";\n case \"ZodUndefined\":\n return \"undefined\";\n case \"ZodNull\":\n return \"null\";\n case \"ZodVoid\":\n return \"void\";\n case \"ZodAny\":\n return \"any\";\n case \"ZodUnknown\":\n return \"unknown\";\n case \"ZodNever\":\n return \"never\";\n case \"ZodLiteral\":\n return JSON.stringify(definition?.value);\n case \"ZodEnum\":\n return Array.isArray(definition?.values)\n ? definition.values.map((value) => JSON.stringify(value)).join(\" | \")\n : \"string\";\n case \"ZodNativeEnum\":\n return renderNativeEnum(\n definition?.values && typeof definition.values === \"object\"\n ? (definition.values as Record<string, string | number>)\n : undefined,\n );\n case \"ZodArray\":\n return `${wrapType(renderSchema(definition?.type as ZodTypeAny, depth))}[]`;\n case \"ZodOptional\":\n return `${renderSchema(definition?.innerType as ZodTypeAny, depth)} | undefined`;\n case \"ZodNullable\":\n return `${renderSchema(definition?.innerType as ZodTypeAny, depth)} | null`;\n case \"ZodDefault\":\n case \"ZodCatch\":\n return renderSchema(definition?.innerType as ZodTypeAny, depth);\n case \"ZodEffects\":\n return renderSchema(definition?.schema as ZodTypeAny, depth);\n case \"ZodBranded\":\n return renderSchema(definition?.type as ZodTypeAny, depth);\n case \"ZodUnion\":\n return Array.isArray(definition?.options)\n ? definition.options.map((option) => wrapType(renderSchema(option as ZodTypeAny, depth))).join(\" | \")\n : \"unknown\";\n case \"ZodDiscriminatedUnion\":\n return Array.from(\n definition?.options instanceof Map ? definition.options.values() : [],\n )\n .map((option) => wrapType(renderSchema(option as ZodTypeAny, depth)))\n .join(\" | \");\n case \"ZodIntersection\":\n return `${wrapType(renderSchema(definition?.left as ZodTypeAny, depth))} & ${wrapType(renderSchema(definition?.right as ZodTypeAny, depth))}`;\n case \"ZodTuple\":\n return `[${Array.isArray(definition?.items)\n ? definition.items.map((item) => renderSchema(item as ZodTypeAny, depth)).join(\", \")\n : \"\"}]`;\n case \"ZodRecord\":\n return `Record<${renderRecordKey(definition?.keyType as ZodTypeAny | undefined)}, ${renderSchema(definition?.valueType as ZodTypeAny, depth)}>`;\n case \"ZodObject\":\n return renderObjectSchema(schema, depth);\n case \"ZodLazy\":\n return typeof definition?.getter === \"function\"\n ? renderSchema(definition.getter() as ZodTypeAny, depth)\n : \"unknown\";\n default:\n return \"unknown\";\n }\n}\n\nfunction renderObjectSchema(schema: ZodTypeAny, depth: number): string {\n const definition = getDefinition(schema);\n const shapeSource = definition?.shape;\n const shape =\n typeof shapeSource === \"function\"\n ? (shapeSource() as Record<string, ZodTypeAny>)\n : ((shapeSource ?? {}) as Record<string, ZodTypeAny>);\n const entries = Object.entries(shape);\n\n if (entries.length === 0) {\n return \"{}\";\n }\n\n const propertyLines = entries.map(([key, propertySchema]) => {\n const optional = isOptionalSchema(propertySchema);\n const renderedType = renderSchema(optional ? unwrapOptionalSchema(propertySchema) : propertySchema, depth + 1);\n return `${indent(depth + 1)}${quotePropertyKey(key)}${optional ? \"?\" : \"\"}: ${renderedType};`;\n });\n\n return [\"{\", ...propertyLines, `${indent(depth)}}`].join(\"\\n\");\n}\n\nfunction renderNativeEnum(values: Record<string, string | number> | undefined): string {\n if (!values) {\n return \"string | number\";\n }\n\n const rendered = Array.from(\n new Set(\n Object.values(values).filter(\n (value): value is string | number => typeof value === \"string\" || typeof value === \"number\",\n ),\n ),\n );\n\n return rendered.map((value) => JSON.stringify(value)).join(\" | \") || \"string | number\";\n}\n\nfunction renderRecordKey(keyType: ZodTypeAny | undefined): string {\n if (!keyType) {\n return \"string\";\n }\n\n return renderSchema(keyType, 0);\n}\n\nfunction isOptionalSchema(schema: ZodTypeAny): boolean {\n return typeof schema.isOptional === \"function\" ? schema.isOptional() : getDefinition(schema)?.typeName === \"ZodOptional\";\n}\n\nfunction unwrapOptionalSchema(schema: ZodTypeAny): ZodTypeAny {\n const definition = getDefinition(schema);\n if (definition?.typeName === \"ZodOptional\") {\n return definition.innerType as ZodTypeAny;\n }\n\n return schema;\n}\n\nfunction wrapType(value: string): string {\n return /[|&\\n]/u.test(value) ? `(${value})` : value;\n}\n\nfunction quotePropertyKey(value: string): string {\n return /^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(value) ? value : JSON.stringify(value);\n}\n\nfunction indent(depth: number): string {\n return INDENT.repeat(depth);\n}\n\nfunction getDefinition(schema: ZodTypeAny): LooseZodDefinition | undefined {\n return (schema as unknown as { _def?: LooseZodDefinition })._def;\n}\n\nfunction escapeFrontmatterValue(value: string): string {\n return JSON.stringify(value);\n}\n","import type { ResolvedWebSkillDefinition, WebSkillLinkTag } from \"./types.ts\";\n\nconst NON_ALPHANUMERIC_PATTERN = /[^a-zA-Z0-9]+/gu;\nconst TRIM_DASHES_PATTERN = /^-+|-+$/gu;\nconst CAMEL_BOUNDARY_PATTERN = /[-_\\s]+([a-zA-Z0-9])/gu;\nconst NON_IDENTIFIER_PATTERN = /[^a-zA-Z0-9_$]/gu;\nconst LEADING_INVALID_IDENTIFIER_PATTERN = /^[^a-zA-Z_$]+/u;\n\nexport function slugifySkillSegment(value: string): string {\n const normalized = value\n .trim()\n .replace(NON_ALPHANUMERIC_PATTERN, \"-\")\n .replace(TRIM_DASHES_PATTERN, \"\")\n .toLowerCase();\n\n return normalized || \"web-skill\";\n}\n\nexport function toSkillKey(value: string): string {\n const identifier = value\n .trim()\n .replace(CAMEL_BOUNDARY_PATTERN, (_match, character: string) => character.toUpperCase())\n .replace(NON_IDENTIFIER_PATTERN, \"\")\n .replace(LEADING_INVALID_IDENTIFIER_PATTERN, \"\");\n\n if (!identifier) {\n return \"webSkill\";\n }\n\n return identifier[0]!.toLowerCase() + identifier.slice(1);\n}\n\nexport function titleFromName(value: string): string {\n const normalized = value\n .replace(/([a-z0-9])([A-Z])/gu, \"$1 $2\")\n .replace(/[-_]+/gu, \" \")\n .trim();\n\n if (!normalized) {\n return \"Web Skill\";\n }\n\n return normalized\n .split(/\\s+/u)\n .map((part) => part[0]!.toUpperCase() + part.slice(1))\n .join(\" \");\n}\n\nexport function ensureUniqueString(\n value: string,\n used: Set<string>,\n formatter: (index: number) => string = (index) => `${value}-${index + 1}`,\n): string {\n if (!used.has(value)) {\n used.add(value);\n return value;\n }\n\n let index = 1;\n while (true) {\n const nextValue = formatter(index);\n if (!used.has(nextValue)) {\n used.add(nextValue);\n return nextValue;\n }\n index += 1;\n }\n}\n\nexport function joinBasePath(basePath: string | undefined, relativePath: string): string {\n const normalizedBase = (basePath ?? \"/\").trim();\n const base = normalizedBase === \"/\" ? \"\" : `/${normalizedBase.replace(/^\\/+|\\/+$/gu, \"\")}`;\n const path = relativePath.startsWith(\"/\") ? relativePath : `/${relativePath}`;\n return `${base}${path}`;\n}\n\nexport function toSkillMarkdownAssetPath(skill: ResolvedWebSkillDefinition): string {\n return `/skills/${skill.slug}/SKILL.md`;\n}\n\nexport function buildWebSkillLinkTags(\n skills: ResolvedWebSkillDefinition[],\n basePath?: string,\n): WebSkillLinkTag[] {\n return skills.map((skill) => ({\n href: joinBasePath(basePath, toSkillMarkdownAssetPath(skill)),\n title: skill.title,\n type: \"text/markdown\",\n }));\n}\n","import type { IncomingMessage, ServerResponse } from \"node:http\";\n\nimport type { Plugin, ResolvedConfig } from \"vite\";\n\nimport { generateSkillMarkdown } from \"./markdown.ts\";\nimport type { ResolvedWebSkillDefinition, WebSkillVitePluginOptions } from \"./types.ts\";\nimport { buildWebSkillLinkTags } from \"./utils.ts\";\n\nexport function webSkillVitePlugin(options: WebSkillVitePluginOptions): Plugin {\n let resolvedConfig: ResolvedConfig | null = null;\n\n return {\n name: \"web-skill\",\n\n configResolved(config): void {\n resolvedConfig = config;\n },\n\n configureServer(server) {\n server.middlewares.use((request, response, next) => {\n if (!resolvedConfig) {\n next();\n return;\n }\n\n if (\n !tryServeGeneratedSkillMarkdown(\n request,\n response,\n options.generator.getSkills(),\n options.publicBasePath ?? resolvedConfig.base,\n )\n ) {\n next();\n }\n });\n },\n\n generateBundle() {\n for (const skill of options.generator.getSkills()) {\n this.emitFile({\n fileName: `skills/${skill.slug}/SKILL.md`,\n source: generateSkillMarkdown(skill),\n type: \"asset\",\n });\n }\n },\n\n transformIndexHtml() {\n const tags = buildWebSkillLinkTags(\n options.generator.getSkills(),\n options.publicBasePath ?? resolvedConfig?.base ?? \"/\",\n );\n return tags.map((tag) => ({\n tag: \"link\",\n attrs: {\n rel: \"web-skill\",\n href: tag.href,\n title: tag.title,\n type: tag.type,\n },\n injectTo: \"head\" as const,\n }));\n },\n };\n}\n\nfunction tryServeGeneratedSkillMarkdown(\n request: IncomingMessage,\n response: ServerResponse,\n skills: ResolvedWebSkillDefinition[],\n basePath: string,\n): boolean {\n const requestUrl = request.url;\n if (!requestUrl) {\n return false;\n }\n\n const pathname = new URL(requestUrl, \"http://localhost\").pathname;\n const tags = buildWebSkillLinkTags(skills, basePath);\n const matchedIndex = tags.findIndex((tag) => tag.href === pathname);\n\n if (matchedIndex === -1) {\n return false;\n }\n\n response.statusCode = 200;\n response.setHeader(\"Content-Type\", \"text/markdown; charset=utf-8\");\n response.end(generateSkillMarkdown(skills[matchedIndex]!));\n return true;\n}\n"]}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import { ZodTypeAny } from 'zod';
+import { R as ResolvedWebSkillDefinition, W as WebSkillsWindowShape, a as WebSkillGenerator, b as WebSkillLinkTag } from './vite-plugin-5xZLBPsq.js';
+export { A as AddWebSkillFunctionOptions, N as NewWebSkillOptions, c as ResolvedWebSkillFunctionDefinition, d as WebSkillBuilder, e as WebSkillFunctionDefinition, f as WebSkillFunctionHandler, g as WebSkillMetadata, h as WebSkillVitePluginOptions, i as WebSkillWindowEntry, j as WebSkillWindowFunction, w as webSkillVitePlugin } from './vite-plugin-5xZLBPsq.js';
+import 'vite';
+declare function generateSkillMarkdown(skill: ResolvedWebSkillDefinition): string;
+declare function renderZodSchema(schema: ZodTypeAny): string;
+declare function createWebSkillGenerator(): WebSkillGenerator;
+declare global {
+    interface Window {
+        _web_skills?: WebSkillsWindowShape;
+    }
+}
+declare function buildWebSkillLinkTags(skills: ResolvedWebSkillDefinition[], basePath?: string): WebSkillLinkTag[];
+export { ResolvedWebSkillDefinition, WebSkillGenerator, WebSkillLinkTag, WebSkillsWindowShape, buildWebSkillLinkTags, createWebSkillGenerator, generateSkillMarkdown, renderZodSchema };

package/{src/runtime.ts → dist/index.js} RENAMED Viewed

@@ -1,42 +1,15 @@
-import type { ZodTypeAny } from "zod";
+import { ensureUniqueString, slugifySkillSegment, toSkillKey, titleFromName } from './chunk-YVQDAY47.js';
+export { buildWebSkillLinkTags, generateSkillMarkdown, renderZodSchema, webSkillVitePlugin } from './chunk-YVQDAY47.js';
-import type {
-  AddWebSkillFunctionOptions,
-  NewWebSkillOptions,
-  ResolvedWebSkillDefinition,
-  ResolvedWebSkillFunctionDefinition,
-  WebSkillBuilder,
-  WebSkillFunctionDefinition,
-  WebSkillFunctionHandler,
-  WebSkillGenerator,
-  WebSkillMetadata,
-  WebSkillsWindowShape,
-  WebSkillWindowEntry,
-  WebSkillWindowFunction,
-} from "./types.ts";
-import { ensureUniqueString, slugifySkillSegment, titleFromName, toSkillKey } from "./utils.ts";
-interface MutableWebSkillDefinition {
-  description: string | null;
-  functions: WebSkillFunctionDefinition<any, any>[];
-  key: string;
-  name: string;
-  slug: string;
-  title: string;
-}
-class WebSkillBuilderImpl implements WebSkillBuilder {
-  constructor(private readonly skill: MutableWebSkillDefinition) {}
-  addFunction<TInput, TOutput>(
-    func: WebSkillFunctionHandler<TInput, TOutput>,
-    name: string,
-    options: AddWebSkillFunctionOptions<TInput, TOutput> = {},
-  ): WebSkillBuilder {
+// src/runtime.ts
+var WebSkillBuilderImpl = class {
+  constructor(skill) {
+    this.skill = skill;
+  }
+  addFunction(func, name, options = {}) {
     if (typeof func !== "function") {
       throw new TypeError(`web-skill function "${name}" must be a function.`);
     }
     const normalizedName = name.trim();
     if (!normalizedName) {
       throw new TypeError("web-skill function name must not be empty.");
@@ -44,33 +17,28 @@ class WebSkillBuilderImpl implements WebSkillBuilder {
     if (normalizedName === "_meta") {
       throw new TypeError('web-skill function name "_meta" is reserved.');
     }
     const existing = this.skill.functions.find((definition) => definition.name === normalizedName);
     if (existing) {
       throw new Error(
-        `web-skill "${this.skill.key}" already contains a function named "${normalizedName}".`,
+        `web-skill "${this.skill.key}" already contains a function named "${normalizedName}".`
       );
     }
     this.skill.functions.push({
       func,
       name: normalizedName,
-      description: options.description?.trim() || undefined,
+      description: options.description?.trim() || void 0,
       inputSchema: options.inputSchema,
-      outputSchema: options.outputSchema,
+      outputSchema: options.outputSchema
     });
     return this;
   }
-}
-class WebSkillGeneratorImpl implements WebSkillGenerator {
-  private readonly skills: MutableWebSkillDefinition[] = [];
-  private readonly usedKeys = new Set<string>();
-  private readonly usedNames = new Set<string>();
-  private readonly usedSlugs = new Set<string>();
-  newSkill(options: NewWebSkillOptions = {}): WebSkillBuilder {
+};
+var WebSkillGeneratorImpl = class {
+  skills = [];
+  usedKeys = /* @__PURE__ */ new Set();
+  usedNames = /* @__PURE__ */ new Set();
+  usedSlugs = /* @__PURE__ */ new Set();
+  newSkill(options = {}) {
     const skillIndex = this.skills.length + 1;
     const fallbackName = `web-skill-${skillIndex}`;
     const requestedName = options.name?.trim();
@@ -78,108 +46,87 @@ class WebSkillGeneratorImpl implements WebSkillGenerator {
     const requestedIdentifier = requestedName || requestedTitle || fallbackName;
     const requestedKeyBase = requestedName || requestedTitle || `webSkill${skillIndex}`;
     const requestedTitleBase = requestedTitle || requestedName || fallbackName;
     const slug = ensureUniqueString(slugifySkillSegment(requestedIdentifier), this.usedSlugs);
     const keyBase = toSkillKey(requestedKeyBase);
     const key = ensureUniqueString(keyBase, this.usedKeys, (index) => `${keyBase}${index + 1}`);
     const nameBase = requestedName || slug;
     const name = ensureUniqueString(nameBase, this.usedNames);
     const title = requestedTitle || titleFromName(requestedTitleBase);
-    const skill: MutableWebSkillDefinition = {
+    const skill = {
       description: options.description?.trim() || null,
       functions: [],
       key,
       name,
       slug,
-      title,
+      title
     };
     this.skills.push(skill);
     return new WebSkillBuilderImpl(skill);
   }
-  getSkills(): ResolvedWebSkillDefinition[] {
+  getSkills() {
     return this.skills.map((skill) => ({
       description: skill.description,
       key: skill.key,
       name: skill.name,
       slug: skill.slug,
       title: skill.title,
-      functions: skill.functions.map<ResolvedWebSkillFunctionDefinition>((definition) => ({
+      functions: skill.functions.map((definition) => ({
         name: definition.name,
-        description: definition.description ?? undefined,
+        description: definition.description ?? void 0,
         inputSchema: definition.inputSchema,
-        outputSchema: definition.outputSchema,
-      })),
+        outputSchema: definition.outputSchema
+      }))
     }));
   }
-  install(target?: Window): WebSkillsWindowShape {
+  install(target) {
     const windowTarget = target ?? resolveWindowTarget();
-    const registry = (windowTarget._web_skills ??= {});
+    const registry = windowTarget._web_skills ??= {};
     for (const skill of this.skills) {
-      const entry: Partial<WebSkillWindowEntry> = {};
-      const metadata: WebSkillMetadata = {
+      const entry = {};
+      const metadata = {
         description: skill.description,
         functions: skill.functions.map((definition) => ({
           description: definition.description ?? null,
           hasInputSchema: Boolean(definition.inputSchema),
           hasOutputSchema: Boolean(definition.outputSchema),
-          name: definition.name,
+          name: definition.name
         })),
         key: skill.key,
         name: skill.name,
-        title: skill.title,
+        title: skill.title
       };
       entry._meta = metadata;
       for (const definition of skill.functions) {
         entry[definition.name] = wrapFunction(skill.key, definition);
       }
-      registry[skill.key] = entry as WebSkillWindowEntry;
+      registry[skill.key] = entry;
     }
     return registry;
   }
-}
-function resolveWindowTarget(): Window {
+};
+function resolveWindowTarget() {
   if (typeof window === "undefined") {
     throw new Error("web-skill install() requires a browser window target.");
   }
   return window;
 }
-function wrapFunction(
-  skillKey: string,
-  definition: WebSkillFunctionDefinition<any, any>,
-): WebSkillWindowFunction {
-  return async (input: unknown) => {
+function wrapFunction(skillKey, definition) {
+  return async (input) => {
     const parsedInput = parseWithSchema(definition.inputSchema, input);
     const result = await definition.func(parsedInput);
     return parseWithSchema(definition.outputSchema, result);
   };
 }
-function parseWithSchema(schema: ZodTypeAny | undefined, value: unknown): unknown {
+function parseWithSchema(schema, value) {
   if (!schema) {
     return value;
   }
   return schema.parse(value);
 }
-export function createWebSkillGenerator(): WebSkillGenerator {
+function createWebSkillGenerator() {
   return new WebSkillGeneratorImpl();
 }
-declare global {
-  interface Window {
-    _web_skills?: WebSkillsWindowShape;
-  }
-}
+export { createWebSkillGenerator };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map