web-skill 0.1.0 → 0.1.1

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ZodTypeAny } from \"zod\";\n\nimport type {\n  AddWebSkillFunctionOptions,\n  NewWebSkillOptions,\n  ResolvedWebSkillDefinition,\n  ResolvedWebSkillFunctionDefinition,\n  WebSkillBuilder,\n  WebSkillFunctionDefinition,\n  WebSkillFunctionHandler,\n  WebSkillGenerator,\n  WebSkillMetadata,\n  WebSkillsWindowShape,\n  WebSkillWindowEntry,\n  WebSkillWindowFunction,\n} from \"./types.ts\";\nimport { ensureUniqueString, slugifySkillSegment, titleFromName, toSkillKey } from \"./utils.ts\";\n\ninterface MutableWebSkillDefinition {\n  description: string | null;\n  functions: WebSkillFunctionDefinition<any, any>[];\n  key: string;\n  name: string;\n  slug: string;\n  title: string;\n}\n\nclass WebSkillBuilderImpl implements WebSkillBuilder {\n  constructor(private readonly skill: MutableWebSkillDefinition) {}\n\n  addFunction<TInput, TOutput>(\n    func: WebSkillFunctionHandler<TInput, TOutput>,\n    name: string,\n    options: AddWebSkillFunctionOptions<TInput, TOutput> = {},\n  ): WebSkillBuilder {\n    if (typeof func !== \"function\") {\n      throw new TypeError(`web-skill function \"${name}\" must be a function.`);\n    }\n\n    const normalizedName = name.trim();\n    if (!normalizedName) {\n      throw new TypeError(\"web-skill function name must not be empty.\");\n    }\n    if (normalizedName === \"_meta\") {\n      throw new TypeError('web-skill function name \"_meta\" is reserved.');\n    }\n\n    const existing = this.skill.functions.find((definition) => definition.name === normalizedName);\n    if (existing) {\n      throw new Error(\n        `web-skill \"${this.skill.key}\" already contains a function named \"${normalizedName}\".`,\n      );\n    }\n\n    this.skill.functions.push({\n      func,\n      name: normalizedName,\n      description: options.description?.trim() || undefined,\n      inputSchema: options.inputSchema,\n      outputSchema: options.outputSchema,\n    });\n\n    return this;\n  }\n}\n\nclass WebSkillGeneratorImpl implements WebSkillGenerator {\n  private readonly skills: MutableWebSkillDefinition[] = [];\n  private readonly usedKeys = new Set<string>();\n  private readonly usedNames = new Set<string>();\n  private readonly usedSlugs = new Set<string>();\n\n  newSkill(options: NewWebSkillOptions = {}): WebSkillBuilder {\n    const skillIndex = this.skills.length + 1;\n    const fallbackName = `web-skill-${skillIndex}`;\n    const requestedName = options.name?.trim();\n    const requestedTitle = options.title?.trim();\n    const requestedIdentifier = requestedName || requestedTitle || fallbackName;\n    const requestedKeyBase = requestedName || requestedTitle || `webSkill${skillIndex}`;\n    const requestedTitleBase = requestedTitle || requestedName || fallbackName;\n\n    const slug = ensureUniqueString(slugifySkillSegment(requestedIdentifier), this.usedSlugs);\n    const keyBase = toSkillKey(requestedKeyBase);\n    const key = ensureUniqueString(keyBase, this.usedKeys, (index) => `${keyBase}${index + 1}`);\n    const nameBase = requestedName || slug;\n    const name = ensureUniqueString(nameBase, this.usedNames);\n    const title = requestedTitle || titleFromName(requestedTitleBase);\n\n    const skill: MutableWebSkillDefinition = {\n      description: options.description?.trim() || null,\n      functions: [],\n      key,\n      name,\n      slug,\n      title,\n    };\n\n    this.skills.push(skill);\n    return new WebSkillBuilderImpl(skill);\n  }\n\n  getSkills(): ResolvedWebSkillDefinition[] {\n    return this.skills.map((skill) => ({\n      description: skill.description,\n      key: skill.key,\n      name: skill.name,\n      slug: skill.slug,\n      title: skill.title,\n      functions: skill.functions.map<ResolvedWebSkillFunctionDefinition>((definition) => ({\n        name: definition.name,\n        description: definition.description ?? undefined,\n        inputSchema: definition.inputSchema,\n        outputSchema: definition.outputSchema,\n      })),\n    }));\n  }\n\n  install(target?: Window): WebSkillsWindowShape {\n    const windowTarget = target ?? resolveWindowTarget();\n    const registry = (windowTarget._web_skills ??= {});\n\n    for (const skill of this.skills) {\n      const entry: Partial<WebSkillWindowEntry> = {};\n      const metadata: WebSkillMetadata = {\n        description: skill.description,\n        functions: skill.functions.map((definition) => ({\n          description: definition.description ?? null,\n          hasInputSchema: Boolean(definition.inputSchema),\n          hasOutputSchema: Boolean(definition.outputSchema),\n          name: definition.name,\n        })),\n        key: skill.key,\n        name: skill.name,\n        title: skill.title,\n      };\n\n      entry._meta = metadata;\n\n      for (const definition of skill.functions) {\n        entry[definition.name] = wrapFunction(skill.key, definition);\n      }\n\n      registry[skill.key] = entry as WebSkillWindowEntry;\n    }\n\n    return registry;\n  }\n}\n\nfunction resolveWindowTarget(): Window {\n  if (typeof window === \"undefined\") {\n    throw new Error(\"web-skill install() requires a browser window target.\");\n  }\n\n  return window;\n}\n\nfunction wrapFunction(\n  skillKey: string,\n  definition: WebSkillFunctionDefinition<any, any>,\n): WebSkillWindowFunction {\n  return async (input: unknown) => {\n    const parsedInput = parseWithSchema(definition.inputSchema, input);\n    const result = await definition.func(parsedInput);\n    return parseWithSchema(definition.outputSchema, result);\n  };\n}\n\nfunction parseWithSchema(schema: ZodTypeAny | undefined, value: unknown): unknown {\n  if (!schema) {\n    return value;\n  }\n\n  return schema.parse(value);\n}\n\nexport function createWebSkillGenerator(): WebSkillGenerator {\n  return new WebSkillGeneratorImpl();\n}\n\ndeclare global {\n  interface Window {\n    _web_skills?: WebSkillsWindowShape;\n  }\n}\n"]}

package/dist/vite-plugin-5xZLBPsq.d.ts

@@ -0,0 +1,71 @@
+import { Plugin } from 'vite';
+import { ZodType } from 'zod';
+
+type MaybePromise<T> = T | Promise<T>;
+type WebSkillFunctionHandler<TInput = unknown, TOutput = unknown> = (input: TInput) => MaybePromise<TOutput>;
+interface AddWebSkillFunctionOptions<TInput = unknown, TOutput = unknown> {
+    description?: string;
+    inputSchema?: ZodType<TInput>;
+    outputSchema?: ZodType<TOutput>;
+}
+interface WebSkillFunctionDefinition<TInput = unknown, TOutput = unknown> extends AddWebSkillFunctionOptions<TInput, TOutput> {
+    func: WebSkillFunctionHandler<TInput, TOutput>;
+    name: string;
+}
+interface NewWebSkillOptions {
+    description?: string;
+    name?: string;
+    title?: string;
+}
+interface ResolvedWebSkillFunctionDefinition<TInput = unknown, TOutput = unknown> extends AddWebSkillFunctionOptions<TInput, TOutput> {
+    name: string;
+}
+interface ResolvedWebSkillDefinition {
+    description: string | null;
+    functions: ResolvedWebSkillFunctionDefinition<any, any>[];
+    key: string;
+    name: string;
+    slug: string;
+    title: string;
+}
+interface WebSkillFunctionMetadata {
+    description: string | null;
+    hasInputSchema: boolean;
+    hasOutputSchema: boolean;
+    name: string;
+}
+interface WebSkillMetadata {
+    description: string | null;
+    functions: WebSkillFunctionMetadata[];
+    key: string;
+    name: string;
+    title: string;
+}
+type WebSkillWindowFunction = (input: unknown) => Promise<unknown>;
+type WebSkillWindowEntry = Record<string, WebSkillWindowFunction | WebSkillMetadata> & {
+    _meta: WebSkillMetadata;
+};
+interface WebSkillsWindowShape {
+    [skillKey: string]: WebSkillWindowEntry;
+}
+interface WebSkillLinkTag {
+    href: string;
+    title: string;
+    type: "text/markdown";
+}
+interface WebSkillVitePluginOptions {
+    generator: WebSkillGenerator;
+    publicBasePath?: string;
+}
+interface WebSkillGenerator {
+    getSkills(): ResolvedWebSkillDefinition[];
+    install(target?: Window): WebSkillsWindowShape;
+    newSkill(options?: NewWebSkillOptions): WebSkillBuilder;
+}
+interface WebSkillBuilder {
+    addFunction<TInput, TOutput>(func: WebSkillFunctionHandler<TInput, TOutput>, name: string, options?: AddWebSkillFunctionOptions<TInput, TOutput>): WebSkillBuilder;
+}
+
+declare function webSkillVitePlugin(options: WebSkillVitePluginOptions): Plugin;
+
+export { type AddWebSkillFunctionOptions as A, type NewWebSkillOptions as N, type ResolvedWebSkillDefinition as R, type WebSkillsWindowShape as W, type WebSkillGenerator as a, type WebSkillLinkTag as b, type ResolvedWebSkillFunctionDefinition as c, type WebSkillBuilder as d, type WebSkillFunctionDefinition as e, type WebSkillFunctionHandler as f, type WebSkillMetadata as g, type WebSkillVitePluginOptions as h, type WebSkillWindowEntry as i, type WebSkillWindowFunction as j, webSkillVitePlugin as w };

package/dist/vite-plugin.d.ts

@@ -0,0 +1,3 @@
+import 'vite';
+export { w as webSkillVitePlugin } from './vite-plugin-5xZLBPsq.js';
+import 'zod';

package/dist/vite-plugin.js

@@ -0,0 +1,3 @@
+export { webSkillVitePlugin } from './chunk-YVQDAY47.js';
+//# sourceMappingURL=vite-plugin.js.map
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"vite-plugin.js"}

package/docs/api.md

@@ -0,0 +1,121 @@
+# API Reference
+
+`web-skill` exposes a small public API surface on purpose. The package is designed to let an app define task-level browser actions once, then reuse that definition for runtime registration, generated markdown, and HTML discovery tags.
+
+## `createWebSkillGenerator()`
+
+Creates a generator instance that owns one or more skills.
+
+Returned methods:
+
+- `newSkill(options?)`
+- `getSkills()`
+- `install(target?)`
+
+## `newSkill(options?)`
+
+Creates one logical skill definition.
+
+Options:
+
+- `name?: string`
+- `title?: string`
+- `description?: string`
+
+Behavior:
+
+- `name` is the stable identifier when supplied
+- `title` is the human-facing label shown to agents
+- duplicate names, keys, and slugs are automatically disambiguated
+- omitted values fall back to generated names such as `web-skill-1`
+
+## `skill.addFunction(func, name, options?)`
+
+Registers one task-level function under the current skill.
+
+Arguments:
+
+- `func`: `(input) => output | Promise<output>`
+- `name`: string
+- `options?.description`
+- `options?.inputSchema`
+- `options?.outputSchema`
+
+Runtime guarantees:
+
+- empty names are rejected
+- `_meta` is reserved
+- duplicate function names within a skill are rejected
+- `inputSchema` and `outputSchema` are enforced with Zod when provided
+
+## `generator.install(target?)`
+
+Registers all configured skills under `window._web_skills`, or under the provided `target` object.
+
+Generated shape:
+
+```ts
+window._web_skills.<skillKey>.<functionName>(input)
+window._web_skills.<skillKey>._meta
+```
+
+If `target` is omitted outside a browser environment, `install()` throws.
+
+## `generator.getSkills()`
+
+Returns the normalized skill metadata used by both the runtime and markdown generation helpers.
+
+Each skill includes:
+
+- `key`
+- `name`
+- `slug`
+- `title`
+- `description`
+- `functions`
+
+## `generateSkillMarkdown(skill)`
+
+Renders one normalized skill definition into a `SKILL.md` document suitable for serving or emitting as a build asset.
+
+## `renderZodSchema(schema)`
+
+Converts a Zod schema into a compact TypeScript-like summary string for documentation output.
+
+## `buildWebSkillLinkTags(skills, basePath?)`
+
+Creates the `<link rel="web-skill" ...>` metadata records used by the Vite plugin and any custom integrations.
+
+Return shape:
+
+```ts
+{
+  href: string;
+  title: string;
+  type: "text/markdown";
+}
+```
+
+## `webSkillVitePlugin(options)`
+
+Vite integration that:
+
+- serves generated `SKILL.md` files during local development
+- emits `skills/<slug>/SKILL.md` assets during build
+- injects `<link rel="web-skill">` tags into transformed HTML
+
+Options:
+
+- `generator: WebSkillGenerator`
+- `publicBasePath?: string`
+
+## Error behavior
+
+Common synchronous errors:
+
+- `web-skill function name must not be empty.`
+- `web-skill function name "_meta" is reserved.`
+- `web-skill "<key>" already contains a function named "<name>".`
+- `web-skill install() requires a browser window target.`
+
+Schema validation errors are surfaced directly from Zod.

package/package.json

@@ -1,17 +1,28 @@
 {
   "name": "web-skill",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Generate browser-advertised skills, runtime registries, and Vite head tags for agent-friendly web apps.",
+  "author": "Dillion Kum <dillion@dimbreak.com>",
   "license": "MIT",
   "type": "module",
-  "main": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./vite": "./src/vite-plugin.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite-plugin.d.ts",
+      "import": "./dist/vite-plugin.js",
+      "default": "./dist/vite-plugin.js"
+    }
   },
   "files": [
-    "src",
+    "dist",
     "skills",
+    "docs",
     "README.md",
     "LICENSE"
   ],
@@ -20,8 +31,17 @@
     "node": ">=20"
   },
   "scripts": {
-    "check": "npm run typecheck",
-    "typecheck": "tsc --noEmit -p tsconfig.json"
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsup src/index.ts src/vite-plugin.ts --format esm --dts --sourcemap --target es2022 --out-dir dist --clean --treeshake",
+    "check": "npm run verify",
+    "prepack": "npm run build",
+    "test": "npm run build && node --import tsx --test tests/**/*.test.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "verify": "npm run typecheck && npm run test",
+    "prepublishOnly": "npm run verify"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "repository": {
     "type": "git",
@@ -30,7 +50,7 @@
   "bugs": {
     "url": "https://github.com/dimbreak/webskill/issues"
   },
-  "homepage": "https://github.com/dimbreak/webskill#readme",
+  "homepage": "https://www.npmjs.com/package/web-skill",
   "keywords": [
     "agent",
     "automation",
@@ -47,6 +67,8 @@
   },
   "devDependencies": {
     "@types/node": "^24.3.3",
+    "tsx": "^4.20.6",
+    "tsup": "^8.5.0",
     "typescript": "^5.7.3",
     "vite": "^7.0.0"
   }

package/src/index.ts

@@ -1,20 +0,0 @@
-export { generateSkillMarkdown, renderZodSchema } from "./markdown.ts";
-export { createWebSkillGenerator } from "./runtime.ts";
-export { webSkillVitePlugin } from "./vite-plugin.ts";
-export type {
-  AddWebSkillFunctionOptions,
-  NewWebSkillOptions,
-  ResolvedWebSkillDefinition,
-  ResolvedWebSkillFunctionDefinition,
-  WebSkillBuilder,
-  WebSkillFunctionDefinition,
-  WebSkillFunctionHandler,
-  WebSkillGenerator,
-  WebSkillLinkTag,
-  WebSkillMetadata,
-  WebSkillsWindowShape,
-  WebSkillVitePluginOptions,
-  WebSkillWindowEntry,
-  WebSkillWindowFunction,
-} from "./types.ts";
-export { buildWebSkillLinkTags } from "./utils.ts";

package/src/markdown.ts

@@ -1,230 +0,0 @@
-import type { ZodTypeAny } from "zod";
-
-import type { ResolvedWebSkillDefinition, ResolvedWebSkillFunctionDefinition } from "./types.ts";
-
-const INDENT = "  ";
-
-interface LooseZodDefinition {
-  typeName?: string;
-  [key: string]: unknown;
-}
-
-export function generateSkillMarkdown(skill: ResolvedWebSkillDefinition): string {
-  const description =
-    skill.description
-    ?? `Expose browser-callable functions under \`window._web_skills.${skill.key}\`.`;
-
-  const lines: string[] = [
-    "---",
-    `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()}\n`;
-}
-
-function renderFunctionSection(
-  skill: ResolvedWebSkillDefinition,
-  definition: ResolvedWebSkillFunctionDefinition,
-): string[] {
-  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,
-    "```",
-  ];
-}
-
-export function renderZodSchema(schema: ZodTypeAny): string {
-  return renderSchema(schema, 0);
-}
-
-function renderSchema(schema: ZodTypeAny, depth: number): string {
-  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 as Record<string, string | number>)
-          : undefined,
-      );
-    case "ZodArray":
-      return `${wrapType(renderSchema(definition?.type as ZodTypeAny, depth))}[]`;
-    case "ZodOptional":
-      return `${renderSchema(definition?.innerType as ZodTypeAny, depth)} | undefined`;
-    case "ZodNullable":
-      return `${renderSchema(definition?.innerType as ZodTypeAny, depth)} | null`;
-    case "ZodDefault":
-    case "ZodCatch":
-      return renderSchema(definition?.innerType as ZodTypeAny, depth);
-    case "ZodEffects":
-      return renderSchema(definition?.schema as ZodTypeAny, depth);
-    case "ZodBranded":
-      return renderSchema(definition?.type as ZodTypeAny, depth);
-    case "ZodUnion":
-      return Array.isArray(definition?.options)
-        ? definition.options.map((option) => wrapType(renderSchema(option as ZodTypeAny, depth))).join(" | ")
-        : "unknown";
-    case "ZodDiscriminatedUnion":
-      return Array.from(
-        definition?.options instanceof Map ? definition.options.values() : [],
-      )
-        .map((option) => wrapType(renderSchema(option as ZodTypeAny, depth)))
-        .join(" | ");
-    case "ZodIntersection":
-      return `${wrapType(renderSchema(definition?.left as ZodTypeAny, depth))} & ${wrapType(renderSchema(definition?.right as ZodTypeAny, depth))}`;
-    case "ZodTuple":
-      return `[${Array.isArray(definition?.items)
-        ? definition.items.map((item) => renderSchema(item as ZodTypeAny, depth)).join(", ")
-        : ""}]`;
-    case "ZodRecord":
-      return `Record<${renderRecordKey(definition?.keyType as ZodTypeAny | undefined)}, ${renderSchema(definition?.valueType as ZodTypeAny, depth)}>`;
-    case "ZodObject":
-      return renderObjectSchema(schema, depth);
-    case "ZodLazy":
-      return typeof definition?.getter === "function"
-        ? renderSchema(definition.getter() as ZodTypeAny, depth)
-        : "unknown";
-    default:
-      return "unknown";
-  }
-}
-
-function renderObjectSchema(schema: ZodTypeAny, depth: number): string {
-  const definition = getDefinition(schema);
-  const shapeSource = definition?.shape;
-  const shape =
-    typeof shapeSource === "function"
-      ? (shapeSource() as Record<string, ZodTypeAny>)
-      : ((shapeSource ?? {}) as Record<string, ZodTypeAny>);
-  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: Record<string, string | number> | undefined): string {
-  if (!values) {
-    return "string | number";
-  }
-
-  const rendered = Array.from(
-    new Set(
-      Object.values(values).filter(
-        (value): value is string | number => typeof value === "string" || typeof value === "number",
-      ),
-    ),
-  );
-
-  return rendered.map((value) => JSON.stringify(value)).join(" | ") || "string | number";
-}
-
-function renderRecordKey(keyType: ZodTypeAny | undefined): string {
-  if (!keyType) {
-    return "string";
-  }
-
-  return renderSchema(keyType, 0);
-}
-
-function isOptionalSchema(schema: ZodTypeAny): boolean {
-  return typeof schema.isOptional === "function" ? schema.isOptional() : getDefinition(schema)?.typeName === "ZodOptional";
-}
-
-function unwrapOptionalSchema(schema: ZodTypeAny): ZodTypeAny {
-  const definition = getDefinition(schema);
-  if (definition?.typeName === "ZodOptional") {
-    return definition.innerType as ZodTypeAny;
-  }
-
-  return schema;
-}
-
-function wrapType(value: string): string {
-  return /[|&\n]/u.test(value) ? `(${value})` : value;
-}
-
-function quotePropertyKey(value: string): string {
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(value) ? value : JSON.stringify(value);
-}
-
-function indent(depth: number): string {
-  return INDENT.repeat(depth);
-}
-
-function getDefinition(schema: ZodTypeAny): LooseZodDefinition | undefined {
-  return (schema as unknown as { _def?: LooseZodDefinition })._def;
-}
-
-function escapeFrontmatterValue(value: string): string {
-  return JSON.stringify(value);
-}

package/src/types.ts

@@ -1,89 +0,0 @@
-import type { ZodType, ZodTypeAny } from "zod";
-
-export type MaybePromise<T> = T | Promise<T>;
-
-export type WebSkillFunctionHandler<TInput = unknown, TOutput = unknown> = (
-  input: TInput,
-) => MaybePromise<TOutput>;
-
-export interface AddWebSkillFunctionOptions<TInput = unknown, TOutput = unknown> {
-  description?: string;
-  inputSchema?: ZodType<TInput>;
-  outputSchema?: ZodType<TOutput>;
-}
-
-export interface WebSkillFunctionDefinition<TInput = unknown, TOutput = unknown>
-  extends AddWebSkillFunctionOptions<TInput, TOutput> {
-  func: WebSkillFunctionHandler<TInput, TOutput>;
-  name: string;
-}
-
-export interface NewWebSkillOptions {
-  description?: string;
-  name?: string;
-  title?: string;
-}
-
-export interface ResolvedWebSkillFunctionDefinition<TInput = unknown, TOutput = unknown>
-  extends AddWebSkillFunctionOptions<TInput, TOutput> {
-  name: string;
-}
-
-export interface ResolvedWebSkillDefinition {
-  description: string | null;
-  functions: ResolvedWebSkillFunctionDefinition<any, any>[];
-  key: string;
-  name: string;
-  slug: string;
-  title: string;
-}
-
-export interface WebSkillFunctionMetadata {
-  description: string | null;
-  hasInputSchema: boolean;
-  hasOutputSchema: boolean;
-  name: string;
-}
-
-export interface WebSkillMetadata {
-  description: string | null;
-  functions: WebSkillFunctionMetadata[];
-  key: string;
-  name: string;
-  title: string;
-}
-
-export type WebSkillWindowFunction = (input: unknown) => Promise<unknown>;
-
-export type WebSkillWindowEntry = Record<string, WebSkillWindowFunction | WebSkillMetadata> & {
-  _meta: WebSkillMetadata;
-};
-
-export interface WebSkillsWindowShape {
-  [skillKey: string]: WebSkillWindowEntry;
-}
-
-export interface WebSkillLinkTag {
-  href: string;
-  title: string;
-  type: "text/markdown";
-}
-
-export interface WebSkillVitePluginOptions {
-  generator: WebSkillGenerator;
-  publicBasePath?: string;
-}
-
-export interface WebSkillGenerator {
-  getSkills(): ResolvedWebSkillDefinition[];
-  install(target?: Window): WebSkillsWindowShape;
-  newSkill(options?: NewWebSkillOptions): WebSkillBuilder;
-}
-
-export interface WebSkillBuilder {
-  addFunction<TInput, TOutput>(
-    func: WebSkillFunctionHandler<TInput, TOutput>,
-    name: string,
-    options?: AddWebSkillFunctionOptions<TInput, TOutput>,
-  ): WebSkillBuilder;
-}