@a1st/aix-core 0.0.3

package/dist/updater.js

@@ -0,0 +1,100 @@
+import { writeFile, rename, unlink, readFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { resolve, dirname, join } from 'pathe';
+import detectIndent from 'detect-indent';
+import { parseConfig, parseLocalConfig } from '@a1st/aix-schema';
+import { loadConfig } from './loader.js';
+import { parseConfigContent } from './discovery.js';
+import { createBackup } from './backup.js';
+import { ConfigNotFoundError, EmbeddedConfigUpdateError } from './errors.js';
+const DEFAULT_INDENT = 2;
+export async function updateConfig(configPath, updater, options = {}) {
+    const { backup = true } = options, absolutePath = resolve(configPath);
+    if (!existsSync(absolutePath)) {
+        throw new ConfigNotFoundError(absolutePath);
+    }
+    const loaded = await loadConfig(absolutePath);
+    if (!loaded) {
+        throw new ConfigNotFoundError(absolutePath);
+    }
+    // Prevent overwriting package.json when config is embedded in it
+    if (loaded.source === 'package.json') {
+        throw new EmbeddedConfigUpdateError(absolutePath);
+    }
+    // Create backup before modifying (per QA spec)
+    if (backup) {
+        await createBackup(absolutePath);
+    }
+    // Detect existing indentation from the file
+    const existingContent = await readFile(absolutePath, 'utf-8'), indent = detectIndent(existingContent).indent || DEFAULT_INDENT, updated = await updater(loaded.config), validated = parseConfig(updated), 
+    // Use unique temp file name to avoid collisions (pid + timestamp)
+    tempPath = `${absolutePath}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        await writeFile(tempPath, JSON.stringify(validated, null, indent) + '\n', 'utf-8');
+        await rename(tempPath, absolutePath);
+    }
+    catch (error) {
+        if (existsSync(tempPath)) {
+            await unlink(tempPath);
+        }
+        throw error;
+    }
+}
+/**
+ * Update the local config file (ai.local.json).
+ * Creates the file if it doesn't exist.
+ * @param localPath - Path to ai.local.json (or directory containing it)
+ * @param updater - Function to update the config
+ * @param options - Update options
+ */
+export async function updateLocalConfig(localPath, updater, options = {}) {
+    const { backup = true } = options;
+    // If localPath is a directory, append ai.local.json
+    let absolutePath = resolve(localPath);
+    if (!absolutePath.endsWith('.json')) {
+        absolutePath = join(absolutePath, 'ai.local.json');
+    }
+    // Load existing local config or start with empty object
+    let existingConfig = {}, indent = DEFAULT_INDENT;
+    if (existsSync(absolutePath)) {
+        if (backup) {
+            await createBackup(absolutePath);
+        }
+        const content = await readFile(absolutePath, 'utf-8');
+        existingConfig = parseConfigContent(content);
+        indent = detectIndent(content).indent || DEFAULT_INDENT;
+    }
+    else {
+        // Ensure parent directory exists
+        await mkdir(dirname(absolutePath), { recursive: true });
+    }
+    const updated = await updater(existingConfig), 
+    // Validate as local config (no extends allowed)
+    validated = parseLocalConfig(updated), tempPath = `${absolutePath}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        await writeFile(tempPath, JSON.stringify(validated, null, indent) + '\n', 'utf-8');
+        await rename(tempPath, absolutePath);
+    }
+    catch (error) {
+        if (existsSync(tempPath)) {
+            await unlink(tempPath);
+        }
+        throw error;
+    }
+}
+/**
+ * Get the path to ai.local.json given a base config path.
+ * @param configPath - Path to ai.json or directory
+ * @returns Path to ai.local.json
+ */
+export function getLocalConfigPath(configPath) {
+    const absolutePath = resolve(configPath);
+    if (absolutePath.endsWith('ai.json')) {
+        return absolutePath.replace(/ai\.json$/, 'ai.local.json');
+    }
+    if (absolutePath.endsWith('.json')) {
+        return absolutePath.replace(/\.json$/, '.local.json');
+    }
+    return join(absolutePath, 'ai.local.json');
+}
+//# sourceMappingURL=updater.js.map

package/dist/updater.js.map

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

package/dist/url-parsing.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Shared URL parsing utilities for Git host URLs and source references.
+ * Used by CLI commands and core reference parsers.
+ */
+export interface GitHubRepoUrl {
+    owner: string;
+    repo: string;
+}
+export interface GitHubBlobUrl extends GitHubRepoUrl {
+    ref: string;
+    path: string;
+}
+export interface GitHubTreeUrl extends GitHubRepoUrl {
+    ref: string;
+    subdir: string;
+}
+export interface GitLabTreeUrl {
+    group: string;
+    project: string;
+    ref: string;
+    subdir: string;
+}
+export interface GitLabBlobUrl {
+    group: string;
+    project: string;
+    ref: string;
+    path: string;
+}
+export interface BitbucketBlobUrl {
+    workspace: string;
+    repo: string;
+    ref: string;
+    path: string;
+}
+export interface GitShorthand {
+    provider: 'github' | 'gitlab' | 'bitbucket';
+    user: string;
+    repo: string;
+    subpath?: string;
+    ref?: string;
+}
+/**
+ * Parse a GitHub web URL for a repo root (no blob/tree path):
+ * `https://github.com/org/repo` or `https://github.com/org/repo/`
+ */
+export declare function parseGitHubRepoUrl(url: string): GitHubRepoUrl | undefined;
+/**
+ * Parse a GitHub web URL with `/blob/ref/path`:
+ * `https://github.com/org/repo/blob/main/path/to/file.md`
+ */
+export declare function parseGitHubBlobUrl(url: string): GitHubBlobUrl | undefined;
+/**
+ * Parse a GitHub web URL with `/tree/ref/path`:
+ * `https://github.com/org/repo/tree/main/path/to/dir`
+ */
+export declare function parseGitHubTreeUrl(url: string): GitHubTreeUrl | undefined;
+/**
+ * Parse a GitLab web URL with `/-/tree/ref/path`:
+ * `https://gitlab.com/group/project/-/tree/branch/path`
+ */
+export declare function parseGitLabTreeUrl(url: string): GitLabTreeUrl | undefined;
+/**
+ * Parse a GitLab web URL with `/-/blob/ref/path`:
+ * `https://gitlab.com/group/project/-/blob/branch/path/to/file.json`
+ */
+export declare function parseGitLabBlobUrl(url: string): GitLabBlobUrl | undefined;
+/**
+ * Parse a Bitbucket web URL with `/src/ref/path`:
+ * `https://bitbucket.org/workspace/repo/src/branch/path/to/file.json`
+ */
+export declare function parseBitbucketBlobUrl(url: string): BitbucketBlobUrl | undefined;
+/**
+ * Parse git shorthand format: `github:user/repo/path#ref`, `gitlab:user/repo/path#ref`, or `bitbucket:user/repo/path#ref`
+ */
+export declare function parseGitShorthand(input: string): GitShorthand | undefined;
+/**
+ * Check if a source string represents a local file path.
+ */
+export declare function isLocalPath(source: string): boolean;
+/**
+ * Check if a source string is a generic git URL (https, git@, git://).
+ */
+export declare function isGenericGitUrl(source: string): boolean;
+/**
+ * Infer a name from a path by taking the last segment and optionally stripping extensions.
+ * @param path - The path to extract a name from
+ * @param extensions - Extensions to strip (e.g., ['.md', '.txt']). If not provided, no stripping.
+ */
+export declare function inferNameFromPath(path: string, extensions?: string[]): string | undefined;
+/**
+ * Build a GitHub URL from owner and repo.
+ */
+export declare function buildGitHubUrl(owner: string, repo: string): string;
+/**
+ * Build a GitLab URL from group and project.
+ */
+export declare function buildGitLabUrl(group: string, project: string): string;
+/**
+ * Build a provider URL from shorthand components.
+ */
+export declare function buildProviderUrl(provider: 'github' | 'gitlab' | 'bitbucket', user: string, repo: string): string;
+/**
+ * Convert a GitHub blob URL to a raw content URL.
+ * `https://github.com/org/repo/blob/main/path` → `https://raw.githubusercontent.com/org/repo/main/path`
+ */
+export declare function githubBlobToRaw(url: string): string | undefined;
+/**
+ * Convert a GitLab blob URL to a raw content URL.
+ * `https://gitlab.com/group/project/-/blob/main/path` → `https://gitlab.com/group/project/-/raw/main/path`
+ */
+export declare function gitlabBlobToRaw(url: string): string | undefined;
+/**
+ * Convert a Bitbucket blob URL to a raw content URL.
+ * `https://bitbucket.org/workspace/repo/src/branch/path` → `https://bitbucket.org/workspace/repo/raw/branch/path`
+ */
+export declare function bitbucketBlobToRaw(url: string): string | undefined;
+/**
+ * Convert any supported git host blob URL to a raw URL. Returns the original URL if not a recognized blob URL.
+ */
+export declare function convertBlobToRawUrl(url: string): string;
+//# sourceMappingURL=url-parsing.d.ts.map

package/dist/url-parsing.d.ts.map

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

package/dist/url-parsing.js

@@ -0,0 +1,199 @@
+/**
+ * Shared URL parsing utilities for Git host URLs and source references.
+ * Used by CLI commands and core reference parsers.
+ */
+/**
+ * Parse a GitHub web URL for a repo root (no blob/tree path):
+ * `https://github.com/org/repo` or `https://github.com/org/repo/`
+ */
+export function parseGitHubRepoUrl(url) {
+    const match = url.match(/^https:\/\/github\.com\/([^/]+)\/([^/]+)\/?$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, owner, repo] = match;
+    return { owner: owner, repo: repo.replace(/\.git$/, '') };
+}
+/**
+ * Parse a GitHub web URL with `/blob/ref/path`:
+ * `https://github.com/org/repo/blob/main/path/to/file.md`
+ */
+export function parseGitHubBlobUrl(url) {
+    const match = url.match(/^https:\/\/github\.com\/([^/]+)\/([^/]+)\/blob\/([^/]+)\/(.+)$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, owner, repo, ref, path] = match;
+    return { owner: owner, repo: repo, ref: ref, path: path };
+}
+/**
+ * Parse a GitHub web URL with `/tree/ref/path`:
+ * `https://github.com/org/repo/tree/main/path/to/dir`
+ */
+export function parseGitHubTreeUrl(url) {
+    const match = url.match(/^https:\/\/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, owner, repo, ref, subdir] = match;
+    return { owner: owner, repo: repo, ref: ref, subdir: subdir };
+}
+/**
+ * Parse a GitLab web URL with `/-/tree/ref/path`:
+ * `https://gitlab.com/group/project/-/tree/branch/path`
+ */
+export function parseGitLabTreeUrl(url) {
+    const match = url.match(/^https:\/\/gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)\/(.+)$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, group, project, ref, subdir] = match;
+    return { group: group, project: project, ref: ref, subdir: subdir };
+}
+/**
+ * Parse a GitLab web URL with `/-/blob/ref/path`:
+ * `https://gitlab.com/group/project/-/blob/branch/path/to/file.json`
+ */
+export function parseGitLabBlobUrl(url) {
+    const match = url.match(/^https:\/\/gitlab\.com\/([^/]+)\/([^/]+)\/-\/blob\/([^/]+)\/(.+)$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, group, project, ref, path] = match;
+    return { group: group, project: project, ref: ref, path: path };
+}
+/**
+ * Parse a Bitbucket web URL with `/src/ref/path`:
+ * `https://bitbucket.org/workspace/repo/src/branch/path/to/file.json`
+ */
+export function parseBitbucketBlobUrl(url) {
+    const match = url.match(/^https:\/\/bitbucket\.org\/([^/]+)\/([^/]+)\/src\/([^/]+)\/(.+)$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, workspace, repo, ref, path] = match;
+    return { workspace: workspace, repo: repo, ref: ref, path: path };
+}
+/**
+ * Parse git shorthand format: `github:user/repo/path#ref`, `gitlab:user/repo/path#ref`, or `bitbucket:user/repo/path#ref`
+ */
+export function parseGitShorthand(input) {
+    const match = input.match(/^(github|gitlab|bitbucket):([^#]+)(?:#(.+))?$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, provider, repoPath, ref] = match, parts = repoPath.split('/');
+    if (parts.length < 2) {
+        return undefined;
+    }
+    const user = parts[0], repo = parts[1], subpath = parts.length > 2 ? parts.slice(2).join('/') : undefined;
+    return {
+        provider: provider,
+        user,
+        repo,
+        subpath,
+        ref,
+    };
+}
+/**
+ * Check if a source string represents a local file path.
+ */
+export function isLocalPath(source) {
+    return source.startsWith('./') || source.startsWith('../') || source.startsWith('/');
+}
+/**
+ * Check if a source string is a generic git URL (https, git@, git://).
+ */
+export function isGenericGitUrl(source) {
+    return source.startsWith('https://') || source.startsWith('git@') || source.startsWith('git://');
+}
+/**
+ * Infer a name from a path by taking the last segment and optionally stripping extensions.
+ * @param path - The path to extract a name from
+ * @param extensions - Extensions to strip (e.g., ['.md', '.txt']). If not provided, no stripping.
+ */
+export function inferNameFromPath(path, extensions) {
+    const segments = path.split('/').filter(Boolean), lastSegment = segments.pop();
+    if (!lastSegment) {
+        return undefined;
+    }
+    if (!extensions || extensions.length === 0) {
+        return lastSegment;
+    }
+    // Build regex pattern for extensions (escape dots, join with |)
+    const pattern = extensions.map((ext) => ext.replace(/\./g, '\\.')).join('|'), regex = new RegExp(`(${pattern})$`, 'i');
+    return lastSegment.replace(regex, '');
+}
+/**
+ * Build a GitHub URL from owner and repo.
+ */
+export function buildGitHubUrl(owner, repo) {
+    return `https://github.com/${owner}/${repo}`;
+}
+/**
+ * Build a GitLab URL from group and project.
+ */
+export function buildGitLabUrl(group, project) {
+    return `https://gitlab.com/${group}/${project}`;
+}
+/**
+ * Build a provider URL from shorthand components.
+ */
+export function buildProviderUrl(provider, user, repo) {
+    if (provider === 'bitbucket') {
+        return `https://bitbucket.org/${user}/${repo}`;
+    }
+    return `https://${provider}.com/${user}/${repo}`;
+}
+/**
+ * Convert a GitHub blob URL to a raw content URL.
+ * `https://github.com/org/repo/blob/main/path` → `https://raw.githubusercontent.com/org/repo/main/path`
+ */
+export function githubBlobToRaw(url) {
+    const parsed = parseGitHubBlobUrl(url);
+    if (!parsed) {
+        return undefined;
+    }
+    return `https://raw.githubusercontent.com/${parsed.owner}/${parsed.repo}/${parsed.ref}/${parsed.path}`;
+}
+/**
+ * Convert a GitLab blob URL to a raw content URL.
+ * `https://gitlab.com/group/project/-/blob/main/path` → `https://gitlab.com/group/project/-/raw/main/path`
+ */
+export function gitlabBlobToRaw(url) {
+    const parsed = parseGitLabBlobUrl(url);
+    if (!parsed) {
+        return undefined;
+    }
+    return `https://gitlab.com/${parsed.group}/${parsed.project}/-/raw/${parsed.ref}/${parsed.path}`;
+}
+/**
+ * Convert a Bitbucket blob URL to a raw content URL.
+ * `https://bitbucket.org/workspace/repo/src/branch/path` → `https://bitbucket.org/workspace/repo/raw/branch/path`
+ */
+export function bitbucketBlobToRaw(url) {
+    const parsed = parseBitbucketBlobUrl(url);
+    if (!parsed) {
+        return undefined;
+    }
+    return `https://bitbucket.org/${parsed.workspace}/${parsed.repo}/raw/${parsed.ref}/${parsed.path}`;
+}
+/**
+ * Convert any supported git host blob URL to a raw URL. Returns the original URL if not a recognized blob URL.
+ */
+export function convertBlobToRawUrl(url) {
+    const githubRaw = githubBlobToRaw(url);
+    if (githubRaw) {
+        return githubRaw;
+    }
+    const gitlabRaw = gitlabBlobToRaw(url);
+    if (gitlabRaw) {
+        return gitlabRaw;
+    }
+    const bitbucketRaw = bitbucketBlobToRaw(url);
+    if (bitbucketRaw) {
+        return bitbucketRaw;
+    }
+    return url;
+}
+//# sourceMappingURL=url-parsing.js.map

package/dist/url-parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parsing.js","sourceRoot":"","sources":["../src/url-parsing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8CH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAExE,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAE9B,OAAO,EAAE,KAAK,EAAE,KAAM,EAAE,IAAI,EAAE,IAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAE1F,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAEzC,OAAO,EAAE,KAAK,EAAE,KAAM,EAAE,IAAI,EAAE,IAAK,EAAE,GAAG,EAAE,GAAI,EAAE,IAAI,EAAE,IAAK,EAAE,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAE1F,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAE3C,OAAO,EAAE,KAAK,EAAE,KAAM,EAAE,IAAI,EAAE,IAAK,EAAE,GAAG,EAAE,GAAI,EAAE,MAAM,EAAE,MAAO,EAAE,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAE7F,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAE9C,OAAO,EAAE,KAAK,EAAE,KAAM,EAAE,OAAO,EAAE,OAAQ,EAAE,GAAG,EAAE,GAAI,EAAE,MAAM,EAAE,MAAO,EAAE,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAE7F,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAE5C,OAAO,EAAE,KAAK,EAAE,KAAM,EAAE,OAAO,EAAE,OAAQ,EAAE,GAAG,EAAE,GAAI,EAAE,IAAI,EAAE,IAAK,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAE5F,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAE7C,OAAO,EAAE,SAAS,EAAE,SAAU,EAAE,IAAI,EAAE,IAAK,EAAE,GAAG,EAAE,GAAI,EAAE,IAAI,EAAE,IAAK,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAE3E,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,KAAK,EACnC,KAAK,GAAG,QAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,EAChB,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,EAChB,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,OAAO;QACJ,QAAQ,EAAE,QAA6C;QACvD,IAAI;QACJ,IAAI;QACJ,OAAO;QACP,GAAG;KACL,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACpG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,UAAqB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAC1C,WAAW,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;IAEnC,IAAI,CAAC,WAAW,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,WAAW,CAAC;IACtB,CAAC;IAED,gEAAgE;IAChE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EACtE,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,OAAO,IAAI,EAAE,GAAG,CAAC,CAAC;IAE/C,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAY;IACvD,OAAO,sBAAsB,KAAK,IAAI,IAAI,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,OAAe;IAC1D,OAAO,sBAAsB,KAAK,IAAI,OAAO,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC7B,QAA2C,EAC3C,IAAY,EACZ,IAAY;IAEZ,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC5B,OAAO,yBAAyB,IAAI,IAAI,IAAI,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,WAAW,QAAQ,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAEvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,OAAO,qCAAqC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAEvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,OAAO,sBAAsB,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;AACpG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC3C,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,OAAO,yBAAyB,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;AACtG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC5C,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEvC,IAAI,SAAS,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEvC,IAAI,SAAS,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACpB,CAAC;IAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAE7C,IAAI,YAAY,EAAE,CAAC;QAChB,OAAO,YAAY,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+   "name": "@a1st/aix-core",
+   "version": "0.0.3",
+   "description": "Core utilities for aix configuration loading and management",
+   "files": [
+      "dist"
+   ],
+   "type": "module",
+   "main": "./dist/index.js",
+   "types": "./dist/index.d.ts",
+   "exports": {
+      ".": {
+         "types": "./dist/index.d.ts",
+         "import": "./dist/index.js"
+      }
+   },
+   "repository": {
+      "type": "git",
+      "url": "https://github.com/a1st-dev/aix.git",
+      "directory": "packages/core"
+   },
+   "publishConfig": {
+      "access": "public",
+      "registry": "https://registry.npmjs.org/"
+   },
+   "scripts": {
+      "build": "tsc -p tsconfig.build.json",
+      "test": "vitest run",
+      "test:watch": "vitest"
+   },
+   "dependencies": {
+      "@a1st/aix-schema": "*",
+      "c12": "2.0.1",
+      "defu": "6.1.4",
+      "giget": "1.2.3",
+      "nypm": "0.3.12",
+      "p-map": "7.0.4",
+      "pathe": "1.1.2",
+      "yaml": "2.8.2"
+   }
+}