/**
 * Ambient types for Markdown and skill imports.
 *
 * Reference this once per project, in any declaration file your tsconfig
 * includes:
 *
 * ```ts
 * /// <reference types="@fabric-harness/sdk/markdown" />
 * ```
 *
 * `fh init` writes `.fabricharness/fabric-env.d.ts` with that line. The types
 * are opt-in rather than automatic because `*.md` is a global wildcard:
 * declaring it on every SDK import would collide with projects that already
 * type Markdown through Vite, MDX, or their own loader.
 */

/**
 * An import resolving to a file named SKILL.md compiles the whole skill
 * directory: the Markdown body becomes the instructional prompt, the
 * frontmatter becomes metadata, and every sibling file is packaged as a
 * resource the model can read on demand.
 */
declare module "*/SKILL.md" {
  const skill: import("@fabric-harness/sdk").Skill;
  export default skill;
}

/**
 * Every other bare Markdown import loads as a text module. Compose it with
 * defineSkill() when the file is not a SKILL.md, or use it as prompt text.
 */
declare module "*.md" {
  const markdown: string;
  export default markdown;
}