@a1st/aix-schema 0.0.3

package/dist/normalize.d.ts

@@ -0,0 +1,36 @@
+import type { AiJsonConfig } from './config.js';
+/**
+ * Detect if a string is a local path reference.
+ */
+export declare function isLocalPath(value: string): boolean;
+/**
+ * Normalize a source reference string to its object form.
+ * - Local paths (./,  ../,  /,  file:) → { path: "..." }
+ * - NPM with subpath (pkg/path/file.md) → { npm: { npm: "pkg", path: "path/file.md" } }
+ * - Everything else (URLs, git shorthands) → { git: { url: "..." } }
+ */
+export declare function normalizeSourceRef(value: string | Record<string, unknown>): Record<string, unknown>;
+/**
+ * Normalize a rules config object, expanding string shorthands.
+ */
+export declare function normalizeRulesConfig(rules: Record<string, string | Record<string, unknown>>): Record<string, Record<string, unknown>>;
+/**
+ * Normalize a prompts config object, expanding string shorthands.
+ */
+export declare function normalizePromptsConfig(prompts: Record<string, string | Record<string, unknown>>): Record<string, Record<string, unknown>>;
+/**
+ * Normalize editors from array shorthand to object form.
+ * - String items: "windsurf" → { windsurf: { enabled: true } }
+ * - Object items: { "cursor": {...} } → merged with enabled: true
+ * - Unlisted editors are implicitly disabled.
+ */
+export declare function normalizeEditors(editors: string[] | Array<string | Record<string, unknown>> | Record<string, unknown>): Record<string, {
+    enabled: boolean;
+    [key: string]: unknown;
+}>;
+/**
+ * Normalize entire ai.json config, expanding all shorthands to their verbose forms.
+ * This should be called after schema validation but before internal processing.
+ */
+export declare function normalizeConfig(config: unknown): AiJsonConfig;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAmDD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBnG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOzC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOzC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC7B,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrF,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,CAmB9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAiC7D"}

package/dist/normalize.js

@@ -0,0 +1,143 @@
+/**
+ * Prefixes that indicate a local file path reference.
+ */
+const LOCAL_PATH_PREFIXES = ['./', '../', '/', 'file:'];
+/**
+ * Detect if a string is a local path reference.
+ */
+export function isLocalPath(value) {
+    return LOCAL_PATH_PREFIXES.some((p) => value.startsWith(p));
+}
+/**
+ * Parse npm package reference with optional subpath from a string.
+ * Requires file extension to distinguish from plain package names.
+ *
+ * Examples:
+ * - "@scope/pkg/rules/style.md" → { npm: "@scope/pkg", path: "rules/style.md" }
+ * - "pkg/prompts/review.md" → { npm: "pkg", path: "prompts/review.md" }
+ * - "@scope/pkg" → undefined (no subpath with extension)
+ */
+function parseNpmRef(str) {
+    // Must have a file extension to be treated as npm with subpath
+    const hasExtension = /\.[a-z0-9]+$/i.test(str);
+    if (!hasExtension) {
+        return undefined;
+    }
+    // Don't match git shorthands or URLs
+    if (str.includes(':')) {
+        return undefined;
+    }
+    if (str.startsWith('@')) {
+        // Scoped: @scope/package/subpath
+        const parts = str.split('/');
+        if (parts.length < 3) {
+            return undefined;
+        } // Need at least @scope/pkg/file.ext
+        return {
+            npm: `${parts[0]}/${parts[1]}`,
+            path: parts.slice(2).join('/'),
+        };
+    }
+    // Unscoped: package/subpath
+    const slashIdx = str.indexOf('/');
+    if (slashIdx === -1) {
+        return undefined;
+    } // No subpath
+    return {
+        npm: str.slice(0, slashIdx),
+        path: str.slice(slashIdx + 1),
+    };
+}
+/**
+ * Normalize a source reference string to its object form.
+ * - Local paths (./,  ../,  /,  file:) → { path: "..." }
+ * - NPM with subpath (pkg/path/file.md) → { npm: { npm: "pkg", path: "path/file.md" } }
+ * - Everything else (URLs, git shorthands) → { git: { url: "..." } }
+ */
+export function normalizeSourceRef(value) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    if (isLocalPath(value)) {
+        // Strip file: prefix if present
+        const path = value.startsWith('file:') ? value.slice(5) : value;
+        return { path };
+    }
+    // Check for npm with subpath (has file extension)
+    const npmParsed = parseNpmRef(value);
+    if (npmParsed) {
+        return { npm: npmParsed };
+    }
+    // Everything else is a git/URL reference
+    return { git: { url: value } };
+}
+/**
+ * Normalize a rules config object, expanding string shorthands.
+ */
+export function normalizeRulesConfig(rules) {
+    const result = {};
+    for (const [name, value] of Object.entries(rules)) {
+        result[name] = normalizeSourceRef(value);
+    }
+    return result;
+}
+/**
+ * Normalize a prompts config object, expanding string shorthands.
+ */
+export function normalizePromptsConfig(prompts) {
+    const result = {};
+    for (const [name, value] of Object.entries(prompts)) {
+        result[name] = normalizeSourceRef(value);
+    }
+    return result;
+}
+/**
+ * Normalize editors from array shorthand to object form.
+ * - String items: "windsurf" → { windsurf: { enabled: true } }
+ * - Object items: { "cursor": {...} } → merged with enabled: true
+ * - Unlisted editors are implicitly disabled.
+ */
+export function normalizeEditors(editors) {
+    if (!Array.isArray(editors)) {
+        return editors;
+    }
+    const result = {};
+    for (const item of editors) {
+        if (typeof item === 'string') {
+            result[item] = { enabled: true };
+        }
+        else {
+            // Object entry: { "cursor": { aiSettings: {...} } }
+            for (const [name, config] of Object.entries(item)) {
+                result[name] = { enabled: true, ...config };
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Normalize entire ai.json config, expanding all shorthands to their verbose forms.
+ * This should be called after schema validation but before internal processing.
+ */
+export function normalizeConfig(config) {
+    if (typeof config !== 'object' || config === null) {
+        return config;
+    }
+    const normalized = { ...config };
+    // Normalize editors
+    if (normalized.editors) {
+        normalized.editors = normalizeEditors(normalized.editors);
+    }
+    // Normalize rules (object format)
+    if (normalized.rules && typeof normalized.rules === 'object' && !Array.isArray(normalized.rules)) {
+        normalized.rules = normalizeRulesConfig(normalized.rules);
+    }
+    // Normalize prompts (object format)
+    if (normalized.prompts &&
+        typeof normalized.prompts === 'object' &&
+        !Array.isArray(normalized.prompts)) {
+        normalized.prompts = normalizePromptsConfig(normalized.prompts);
+    }
+    return normalized;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1,297 @@
+import { z } from 'zod';
+/**
+ * Prompt object with metadata and content source.
+ * Note: `name` is no longer needed in object form - it's the key in the parent object.
+ */
+export declare const promptObjectSchema: z.ZodEffects<z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    argumentHint: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    git: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }, {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }>>;
+    npm: z.ZodOptional<z.ZodObject<{
+        npm: z.ZodString;
+        path: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    }, {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}>, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}>;
+/**
+ * A prompt value can be:
+ * - String: source reference (local path or git URL) - normalized at parse time
+ * - Object: full prompt with content source and optional metadata
+ */
+export declare const promptValueSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    argumentHint: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    git: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }, {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }>>;
+    npm: z.ZodOptional<z.ZodObject<{
+        npm: z.ZodString;
+        path: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    }, {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}>, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}>]>;
+/**
+ * Prompt name validation (key in the prompts object).
+ */
+export declare const promptNameSchema: z.ZodString;
+/**
+ * Prompts config - object keyed by prompt name.
+ */
+export declare const promptsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    argumentHint: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    git: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }, {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }>>;
+    npm: z.ZodOptional<z.ZodObject<{
+        npm: z.ZodString;
+        path: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    }, {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}>, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}, {
+    path?: string | undefined;
+    git?: {
+        url: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
+    npm?: {
+        path: string;
+        npm: string;
+        version?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    content?: string | undefined;
+    argumentHint?: string | undefined;
+}>]>, z.ZodLiteral<false>]>>;
+export type PromptObject = z.infer<typeof promptObjectSchema>;
+export type PromptValue = z.infer<typeof promptValueSchema>;
+export type PromptsConfig = z.infer<typeof promptsSchema>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBU,CAAC;AAa1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAoD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAQ6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAEoD,CAAC;AAE/E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/prompts.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { gitSourceSchema, npmSourceSchema } from './rules.js';
+/**
+ * Prompt object with metadata and content source.
+ * Note: `name` is no longer needed in object form - it's the key in the parent object.
+ */
+export const promptObjectSchema = z
+    .object({
+    description: z.string().optional().describe('Shown in command picker'),
+    argumentHint: z.string().optional().describe('Hint for arguments (e.g., "[file] [message]")'),
+    content: z.string().optional().describe('Inline prompt content'),
+    path: z.string().optional().describe('Local file path to prompt content'),
+    git: gitSourceSchema.optional().describe('Git repository source'),
+    npm: npmSourceSchema.optional().describe('NPM package source'),
+})
+    .refine((data) => {
+    const sources = [data.content, data.path, data.git, data.npm].filter(Boolean);
+    return sources.length === 1;
+}, { message: 'Exactly one content source required: content, path, git, or npm' })
+    .describe('Prompt/command definition');
+/**
+ * String shorthand for source references.
+ * - Local paths: "./prompts/review.md", "../shared/prompts.md", "/abs/path", "file:../foo"
+ * - Git URLs: "https://...", "git+https://...", "github:user/repo", "user/repo#ref"
+ */
+const promptStringSchema = z
+    .string()
+    .describe('Source reference: local path (./, ../, /, file:), git URL (https://), or git shorthand (github:)');
+/**
+ * A prompt value can be:
+ * - String: source reference (local path or git URL) - normalized at parse time
+ * - Object: full prompt with content source and optional metadata
+ */
+export const promptValueSchema = z.union([promptStringSchema, promptObjectSchema]);
+/**
+ * Prompt name validation (key in the prompts object).
+ */
+export const promptNameSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, 'Prompt name must be lowercase alphanumeric with single hyphens (e.g., "code-review")')
+    .describe('Prompt name (used as key and command name)');
+/**
+ * Prompts config - object keyed by prompt name.
+ */
+export const promptsSchema = z
+    .record(promptNameSchema, z.union([promptValueSchema, z.literal(false)]))
+    .describe('Map of prompt names to their definitions (or false to disable)');
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACL,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACtE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC7F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACzE,GAAG,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACjE,GAAG,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAChE,CAAC;KACD,MAAM,CACJ,CAAC,IAAI,EAAE,EAAE;IACN,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE9E,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;AAC/B,CAAC,EACD,EAAE,OAAO,EAAE,iEAAiE,EAAE,CAChF;KACA,QAAQ,CAAC,2BAA2B,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,QAAQ,CACN,kGAAkG,CACpG,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACH,0BAA0B,EAC1B,sFAAsF,CACxF;KACA,QAAQ,CAAC,4CAA4C,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC1B,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACxE,QAAQ,CAAC,gEAAgE,CAAC,CAAC"}

package/dist/references.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+export declare const localRefSchema: z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>;
+export declare const gitRefSchema: z.ZodObject<{
+    git: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}>;
+export declare const registryRefSchema: z.ZodObject<{
+    version: z.ZodEffects<z.ZodString, string, string>;
+    registry: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    registry?: string | undefined;
+}, {
+    version: string;
+    registry?: string | undefined;
+}>;
+export declare const sourceRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    git: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}>, z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>, z.ZodObject<{
+    version: z.ZodEffects<z.ZodString, string, string>;
+    registry: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    registry?: string | undefined;
+}, {
+    version: string;
+    registry?: string | undefined;
+}>]>;
+//# sourceMappingURL=references.d.ts.map

package/dist/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;;;EAEzB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAIvB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO6B,CAAC"}

package/dist/references.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { semverRangeSchema } from './core.js';
+export const localRefSchema = z.object({
+    path: z.string().describe('Local file or directory path'),
+});
+export const gitRefSchema = z.object({
+    git: z.string().describe('Git URL (e.g., "github:user/repo", "https://...")'),
+    ref: z.string().optional().describe('Git ref (branch, tag, commit)'),
+    path: z.string().optional().describe('Subdirectory within repo'),
+});
+export const registryRefSchema = z.object({
+    version: semverRangeSchema.describe('Version range from registry'),
+    registry: z.string().url().optional().describe('Custom registry URL'),
+});
+export const sourceRefSchema = z
+    .union([
+    z.string().describe('Shorthand: version range or local path'),
+    gitRefSchema,
+    localRefSchema,
+    registryRefSchema,
+])
+    .describe('Reference to a skill, config, or resource');
+//# sourceMappingURL=references.js.map

package/dist/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC5B,KAAK,CAAC;IACJ,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC7D,YAAY;IACZ,cAAc;IACd,iBAAiB;CACnB,CAAC;KACD,QAAQ,CAAC,2CAA2C,CAAC,CAAC"}