@eqtylab/docs 0.3.0

package/dist/chunk-VJN3HXKM.js

@@ -0,0 +1,59 @@
+// src/paths.ts
+function joinPath(...parts) {
+  const joined = parts.filter((p) => typeof p === "string" && p.length > 0).join("/");
+  return "/" + joined.replace(/^\/+/, "").replace(/\/{2,}/g, "/");
+}
+function isExternalHref(href) {
+  return /^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("//");
+}
+function isUnrewritable(href) {
+  return isExternalHref(href) || href.startsWith("#") || href.startsWith("?");
+}
+function ensureTrailingSlash(href) {
+  if (isUnrewritable(href)) return href;
+  const [path, rest = ""] = href.split(/(?=[?#])/, 2);
+  if (path.endsWith("/")) return href;
+  if (/\.[a-z0-9]+$/i.test(path)) return href;
+  return path + "/" + rest;
+}
+function idToPath(id) {
+  return id === "index" ? "" : id;
+}
+function normalizePath(path) {
+  let decoded = path;
+  try {
+    decoded = decodeURI(path);
+  } catch {
+  }
+  return decoded.replace(/\/+$/, "") || "/";
+}
+function withBase(path, ctx) {
+  if (isUnrewritable(path)) return path;
+  return joinPath(ctx.base, path);
+}
+function docsHref(id, ctx) {
+  return ensureTrailingSlash(joinPath(ctx.base, ctx.versionPrefix, ctx.pathPrefix, idToPath(id)));
+}
+function stripBase(pathname, ctx) {
+  let rest = normalizePath(pathname);
+  for (const prefix of [ctx.base, ctx.versionPrefix, ctx.pathPrefix]) {
+    if (!prefix) continue;
+    const norm = normalizePath(joinPath(prefix));
+    if (norm === "/") continue;
+    if (rest === norm) return "/";
+    if (rest.startsWith(norm + "/")) rest = rest.slice(norm.length);
+  }
+  return rest || "/";
+}
+function isActive(currentPathname, target) {
+  return normalizePath(currentPathname) === normalizePath(target);
+}
+function isAncestor(currentPathname, target) {
+  const current = normalizePath(currentPathname);
+  const t = normalizePath(target);
+  return t === "/" ? current === "/" : current === t || current.startsWith(t + "/");
+}
+
+export { docsHref, ensureTrailingSlash, idToPath, isActive, isAncestor, isExternalHref, joinPath, normalizePath, stripBase, withBase };
+//# sourceMappingURL=chunk-VJN3HXKM.js.map
+//# sourceMappingURL=chunk-VJN3HXKM.js.map

package/dist/chunk-VJN3HXKM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/paths.ts"],"names":[],"mappings":"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","file":"chunk-VJN3HXKM.js","sourcesContent":["/** Every URL the framework emits goes through here; nothing else may concatenate a path. */\n\n/** Join path segments, collapsing duplicate slashes, always leading with one. */\nexport function joinPath(...parts: Array<string | undefined | null>): string {\n  const joined = parts.filter((p): p is string => typeof p === 'string' && p.length > 0).join('/');\n  return '/' + joined.replace(/^\\/+/, '').replace(/\\/{2,}/g, '/');\n}\n\n/** True for anything we must not rewrite: protocol, protocol-relative, fragment, or query. */\nexport function isExternalHref(href: string): boolean {\n  return /^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith('//');\n}\n\nfunction isUnrewritable(href: string): boolean {\n  return isExternalHref(href) || href.startsWith('#') || href.startsWith('?');\n}\n\nexport function ensureTrailingSlash(href: string): string {\n  if (isUnrewritable(href)) return href;\n  const [path, rest = ''] = href.split(/(?=[?#])/, 2);\n  if (path.endsWith('/')) return href;\n  // Never slash something that looks like a file (/llms.txt, /a.md).\n  if (/\\.[a-z0-9]+$/i.test(path)) return href;\n  return path + '/' + rest;\n}\n\n/** Astro gives the root `index.mdx` the id \"index\", not \"\". */\nexport function idToPath(id: string): string {\n  return id === 'index' ? '' : id;\n}\n\n/** Trim trailing slashes for comparison. Keeps a bare \"/\" intact. */\nexport function normalizePath(path: string): string {\n  let decoded = path;\n  try {\n    decoded = decodeURI(path);\n  } catch {\n    // Malformed percent-encoding: compare the raw value.\n  }\n  return decoded.replace(/\\/+$/, '') || '/';\n}\n\nexport interface PathContext {\n  /** Astro's `import.meta.env.BASE_URL`. Always has a leading slash. */\n  base: string;\n  /** Mounted-at prefix for docs pages, e.g. \"docs\". Usually empty. */\n  pathPrefix?: string;\n  /** Version segment for a pinned build, e.g. \"v3.1\". Empty for latest-at-root. */\n  versionPrefix?: string;\n}\n\n/** Prefix a site-absolute path with `base`. For assets: favicons, logos, og images. */\nexport function withBase(path: string, ctx: PathContext): string {\n  if (isUnrewritable(path)) return path;\n  return joinPath(ctx.base, path);\n}\n\n/** The public URL for a docs collection entry id. */\nexport function docsHref(id: string, ctx: PathContext): string {\n  return ensureTrailingSlash(joinPath(ctx.base, ctx.versionPrefix, ctx.pathPrefix, idToPath(id)));\n}\n\n/** Remove `base` (and version/path prefixes) from a pathname, yielding a docs-relative path. */\nexport function stripBase(pathname: string, ctx: PathContext): string {\n  let rest = normalizePath(pathname);\n  for (const prefix of [ctx.base, ctx.versionPrefix, ctx.pathPrefix]) {\n    if (!prefix) continue;\n    const norm = normalizePath(joinPath(prefix));\n    if (norm === '/') continue;\n    if (rest === norm) return '/';\n    if (rest.startsWith(norm + '/')) rest = rest.slice(norm.length);\n  }\n  return rest || '/';\n}\n\n/** Whether `target` is the page currently being viewed. Base-aware, slash-insensitive. */\nexport function isActive(currentPathname: string, target: string): boolean {\n  return normalizePath(currentPathname) === normalizePath(target);\n}\n\n/** Whether `target` is the current page or an ancestor of it. Drives group expansion. */\nexport function isAncestor(currentPathname: string, target: string): boolean {\n  const current = normalizePath(currentPathname);\n  const t = normalizePath(target);\n  return t === '/' ? current === '/' : current === t || current.startsWith(t + '/');\n}\n"]}

package/dist/chunk-ZZ45WAVR.js

@@ -0,0 +1,20 @@
+// src/env.ts
+function slashed(value) {
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") return "/";
+  return ("/" + trimmed.replace(/^\/+/, "").replace(/\/+$/, "") + "/").replace(/\/{2,}/g, "/");
+}
+function resolveDocsEnv(defaults = {}) {
+  const env = process.env;
+  return {
+    site: env.DOCS_SITE ?? defaults.site,
+    base: slashed(env.DOCS_BASE ?? defaults.base ?? "/"),
+    versionRoot: slashed(env.DOCS_VERSION_ROOT ?? defaults.versionRoot ?? "/"),
+    version: env.DOCS_VERSION ?? defaults.version ?? null,
+    isLatest: env.DOCS_IS_LATEST ? env.DOCS_IS_LATEST === "true" : defaults.isLatest ?? true
+  };
+}
+
+export { resolveDocsEnv };
+//# sourceMappingURL=chunk-ZZ45WAVR.js.map
+//# sourceMappingURL=chunk-ZZ45WAVR.js.map

package/dist/chunk-ZZ45WAVR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/env.ts"],"names":[],"mappings":";AAiBA,SAAS,QAAQ,KAAA,EAAuB;AACtC,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,IAAI,CAAC,OAAA,IAAW,OAAA,KAAY,GAAA,EAAK,OAAO,GAAA;AACxC,EAAA,OAAA,CAAQ,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA,CAAE,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA,GAAI,GAAA,EAAK,OAAA,CAAQ,WAAW,GAAG,CAAA;AAC7F;AAEO,SAAS,cAAA,CAAe,QAAA,GAA6B,EAAC,EAAY;AACvE,EAAA,MAAM,MAAM,OAAA,CAAQ,GAAA;AACpB,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,GAAA,CAAI,SAAA,IAAa,QAAA,CAAS,IAAA;AAAA,IAChC,MAAM,OAAA,CAAQ,GAAA,CAAI,SAAA,IAAa,QAAA,CAAS,QAAQ,GAAG,CAAA;AAAA,IACnD,aAAa,OAAA,CAAQ,GAAA,CAAI,iBAAA,IAAqB,QAAA,CAAS,eAAe,GAAG,CAAA;AAAA,IACzE,OAAA,EAAS,GAAA,CAAI,YAAA,IAAgB,QAAA,CAAS,OAAA,IAAW,IAAA;AAAA,IACjD,UAAU,GAAA,CAAI,cAAA,GAAiB,IAAI,cAAA,KAAmB,MAAA,GAAU,SAAS,QAAA,IAAY;AAAA,GACvF;AACF","file":"chunk-ZZ45WAVR.js","sourcesContent":["/**\n * Build environment for a versioned deploy. `base` must be literal in the\n * consumer's Astro config, so it is threaded by env var. `versionRoot` is\n * separate because a /v3.1/ build still needs the manifest at /docs-versions.json.\n */\nexport interface DocsEnv {\n  site?: string;\n  /** Astro's `base`. e.g. '/', '/v3.1/', '/equality/v3.1/' */\n  base: string;\n  /** Deploy-root-relative directory holding all version directories. */\n  versionRoot: string;\n  /** This build's version id, e.g. '3.1'. Null for an unversioned build. */\n  version: string | null;\n  /** Whether this build is the canonical latest (indexable, served at root). */\n  isLatest: boolean;\n}\n\nfunction slashed(value: string): string {\n  const trimmed = value.trim();\n  if (!trimmed || trimmed === '/') return '/';\n  return ('/' + trimmed.replace(/^\\/+/, '').replace(/\\/+$/, '') + '/').replace(/\\/{2,}/g, '/');\n}\n\nexport function resolveDocsEnv(defaults: Partial<DocsEnv> = {}): DocsEnv {\n  const env = process.env;\n  return {\n    site: env.DOCS_SITE ?? defaults.site,\n    base: slashed(env.DOCS_BASE ?? defaults.base ?? '/'),\n    versionRoot: slashed(env.DOCS_VERSION_ROOT ?? defaults.versionRoot ?? '/'),\n    version: env.DOCS_VERSION ?? defaults.version ?? null,\n    isLatest: env.DOCS_IS_LATEST ? env.DOCS_IS_LATEST === 'true' : (defaults.isLatest ?? true),\n  };\n}\n"]}

package/dist/config.d.ts

@@ -0,0 +1,78 @@
+/** Integration options: the whole consumer-facing configuration surface. */
+import { z } from 'astro/zod';
+export declare const docsConfigSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    favicon: z.ZodDefault<z.ZodString>;
+    logo: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    contentDir: z.ZodDefault<z.ZodString>;
+    pathPrefix: z.ZodDefault<z.ZodString>;
+    sidebar: z.ZodPrefault<z.ZodObject<{
+        collapsed: z.ZodDefault<z.ZodBoolean>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            alpha: "alpha";
+            filename: "filename";
+            manual: "manual";
+        }>>;
+        extra: z.ZodDefault<z.ZodArray<z.ZodAny>>;
+    }, z.core.$strip>>;
+    header: z.ZodPrefault<z.ZodObject<{
+        links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            external: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        showThemeToggle: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    footer: z.ZodPrefault<z.ZodObject<{
+        editUrl: z.ZodOptional<z.ZodString>;
+        showPrevNext: z.ZodDefault<z.ZodBoolean>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    tableOfContents: z.ZodPrefault<z.ZodUnion<readonly [z.ZodObject<{
+        minLevel: z.ZodDefault<z.ZodNumber>;
+        maxLevel: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodLiteral<false>]>>;
+    code: z.ZodPrefault<z.ZodObject<{
+        highlighter: z.ZodDefault<z.ZodEnum<{
+            codeblock: "codeblock";
+            shiki: "shiki";
+        }>>;
+        themes: z.ZodDefault<z.ZodObject<{
+            light: z.ZodString;
+            dark: z.ZodString;
+        }, z.core.$strip>>;
+        wrap: z.ZodDefault<z.ZodBoolean>;
+        langs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    search: z.ZodPrefault<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<{
+            pagefind: "pagefind";
+            none: "none";
+        }>>;
+    }, z.core.$strip>>;
+    routing: z.ZodPrefault<z.ZodObject<{
+        injectPages: z.ZodDefault<z.ZodBoolean>;
+        markdownTwins: z.ZodDefault<z.ZodBoolean>;
+        notFound: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    theme: z.ZodPrefault<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<{
+            global: "global";
+            scoped: "scoped";
+        }>>;
+        persist: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    customCss: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    clientScripts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    autoIntegrations: z.ZodDefault<z.ZodBoolean>;
+    versions: z.ZodOptional<z.ZodAny>;
+    plugins: z.ZodDefault<z.ZodArray<z.ZodAny>>;
+}, z.core.$strip>;
+export type DocsUserConfig = z.input<typeof docsConfigSchema>;
+export type DocsConfig = z.output<typeof docsConfigSchema>;
+export declare function resolveConfig(user: DocsUserConfig): DocsConfig;

package/dist/config.js

@@ -0,0 +1,3 @@
+export { docsConfigSchema, resolveConfig } from './chunk-ATIOPYKE.js';
+//# sourceMappingURL=config.js.map
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/dev.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin } from 'vite';
+export interface LinkOptions {
+    /** Package name -> path to its package root, relative to the consumer project. */
+    [packageName: string]: string;
+}
+export declare function linkWorkspacePackages(options: LinkOptions): Plugin[];

package/dist/dev.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync } from 'fs';
+import path from 'path';
+import { globSync } from 'tinyglobby';
+
+// src/dev.ts
+function invertExports(pkgRoot, pkgName) {
+  const manifestPath = path.join(pkgRoot, "package.json");
+  if (!existsSync(manifestPath)) return null;
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  const srcDir = path.join(pkgRoot, "src");
+  if (!existsSync(srcDir)) return null;
+  const subpaths = /* @__PURE__ */ new Map();
+  const candidates = globSync(["**/*.{css,ts,tsx}"], { cwd: srcDir, absolute: false });
+  const byBasename = /* @__PURE__ */ new Map();
+  for (const rel of candidates) {
+    const key = path.basename(rel);
+    const list = byBasename.get(key);
+    if (list) list.push(rel);
+    else byBasename.set(key, [rel]);
+  }
+  const targetOf = (value) => {
+    if (typeof value === "string") return value;
+    if (value && typeof value === "object") {
+      const conditions = value;
+      for (const key of ["import", "default", "require"]) {
+        const nested = targetOf(conditions[key]);
+        if (nested) return nested;
+      }
+    }
+    return void 0;
+  };
+  for (const [subpath, value] of Object.entries(manifest.exports ?? {})) {
+    if (subpath === "." || subpath === "./package.json" || subpath.includes("*")) continue;
+    const target = targetOf(value);
+    if (!target) continue;
+    const basename = path.basename(target);
+    const matches = byBasename.get(basename);
+    if (!matches || matches.length === 0) continue;
+    if (matches.length > 1) {
+      matches.sort((a, b) => a.split("/").length - b.split("/").length);
+    }
+    subpaths.set(subpath.replace(/^\.\//, ""), path.join(srcDir, matches[0]));
+  }
+  return { name: pkgName, srcDir, subpaths };
+}
+function linkWorkspacePackages(options) {
+  const linked = [];
+  for (const [name, relativeRoot] of Object.entries(options)) {
+    const pkgRoot = path.resolve(process.cwd(), relativeRoot);
+    const entry = invertExports(pkgRoot, name);
+    if (entry) linked.push(entry);
+  }
+  if (linked.length === 0) return [];
+  const resolver = {
+    name: "eqty-docs:link-workspace-source",
+    enforce: "pre",
+    async resolveId(id, importer, opts) {
+      for (const pkg of linked) {
+        let target;
+        if (id === pkg.name) {
+          target = pkg.srcDir;
+        } else if (id.startsWith(`${pkg.name}/`)) {
+          const subpath = id.slice(pkg.name.length + 1);
+          target = pkg.subpaths.get(subpath) ?? path.join(pkg.srcDir, subpath);
+        }
+        if (!target) continue;
+        const resolved = await this.resolve(target, importer, { ...opts, skipSelf: true });
+        return resolved ?? target;
+      }
+      return null;
+    }
+  };
+  const watcher = {
+    name: "eqty-docs:watch-workspace-source",
+    configureServer(server) {
+      for (const pkg of linked) server.watcher.add(pkg.srcDir);
+    }
+  };
+  return [resolver, watcher];
+}
+
+export { linkWorkspacePackages };
+//# sourceMappingURL=dev.js.map
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dev.ts"],"names":[],"mappings":"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","file":"dev.js","sourcesContent":["/**\n * Dev-only source linking: redirects a workspace package's specifiers to its\n * source tree so edits hot-reload. Subpaths derive from the package's `exports`.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { globSync } from 'tinyglobby';\nimport type { Plugin } from 'vite';\n\nexport interface LinkOptions {\n  /** Package name -> path to its package root, relative to the consumer project. */\n  [packageName: string]: string;\n}\n\ninterface LinkedPackage {\n  name: string;\n  srcDir: string;\n  /** Subpath (e.g. 'theme-config.css') -> absolute file under src/. */\n  subpaths: Map<string, string>;\n}\n\n/** For each `exports` subpath targeting dist/, find the same basename under src/. */\nfunction invertExports(pkgRoot: string, pkgName: string): LinkedPackage | null {\n  const manifestPath = path.join(pkgRoot, 'package.json');\n  if (!existsSync(manifestPath)) return null;\n\n  const manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as {\n    exports?: Record<string, unknown>;\n  };\n  const srcDir = path.join(pkgRoot, 'src');\n  if (!existsSync(srcDir)) return null;\n\n  const subpaths = new Map<string, string>();\n  const candidates = globSync(['**/*.{css,ts,tsx}'], { cwd: srcDir, absolute: false });\n  const byBasename = new Map<string, string[]>();\n  for (const rel of candidates) {\n    const key = path.basename(rel);\n    const list = byBasename.get(key);\n    if (list) list.push(rel);\n    else byBasename.set(key, [rel]);\n  }\n\n  const targetOf = (value: unknown): string | undefined => {\n    if (typeof value === 'string') return value;\n    if (value && typeof value === 'object') {\n      const conditions = value as Record<string, unknown>;\n      for (const key of ['import', 'default', 'require']) {\n        const nested = targetOf(conditions[key]);\n        if (nested) return nested;\n      }\n    }\n    return undefined;\n  };\n\n  for (const [subpath, value] of Object.entries(manifest.exports ?? {})) {\n    if (subpath === '.' || subpath === './package.json' || subpath.includes('*')) continue;\n    const target = targetOf(value);\n    if (!target) continue;\n\n    const basename = path.basename(target);\n    const matches = byBasename.get(basename);\n    if (!matches || matches.length === 0) continue;\n    if (matches.length > 1) {\n      matches.sort((a, b) => a.split('/').length - b.split('/').length);\n    }\n    subpaths.set(subpath.replace(/^\\.\\//, ''), path.join(srcDir, matches[0] as string));\n  }\n\n  return { name: pkgName, srcDir, subpaths };\n}\n\nexport function linkWorkspacePackages(options: LinkOptions): Plugin[] {\n  const linked: LinkedPackage[] = [];\n\n  for (const [name, relativeRoot] of Object.entries(options)) {\n    const pkgRoot = path.resolve(process.cwd(), relativeRoot);\n    const entry = invertExports(pkgRoot, name);\n    if (entry) linked.push(entry);\n  }\n\n  if (linked.length === 0) return [];\n\n  const resolver: Plugin = {\n    name: 'eqty-docs:link-workspace-source',\n    enforce: 'pre',\n    async resolveId(id, importer, opts) {\n      for (const pkg of linked) {\n        let target: string | undefined;\n\n        if (id === pkg.name) {\n          target = pkg.srcDir; // directory -> index.ts\n        } else if (id.startsWith(`${pkg.name}/`)) {\n          const subpath = id.slice(pkg.name.length + 1);\n          target = pkg.subpaths.get(subpath) ?? path.join(pkg.srcDir, subpath);\n        }\n\n        if (!target) continue;\n        // Vite still handles directory and extension resolution.\n        const resolved = await this.resolve(target, importer, { ...opts, skipSelf: true });\n        return resolved ?? target;\n      }\n      return null;\n    },\n  };\n\n  const watcher: Plugin = {\n    name: 'eqty-docs:watch-workspace-source',\n    configureServer(server) {\n      for (const pkg of linked) server.watcher.add(pkg.srcDir);\n    },\n  };\n\n  return [resolver, watcher];\n}\n"]}

package/dist/env.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Build environment for a versioned deploy. `base` must be literal in the
+ * consumer's Astro config, so it is threaded by env var. `versionRoot` is
+ * separate because a /v3.1/ build still needs the manifest at /docs-versions.json.
+ */
+export interface DocsEnv {
+    site?: string;
+    /** Astro's `base`. e.g. '/', '/v3.1/', '/equality/v3.1/' */
+    base: string;
+    /** Deploy-root-relative directory holding all version directories. */
+    versionRoot: string;
+    /** This build's version id, e.g. '3.1'. Null for an unversioned build. */
+    version: string | null;
+    /** Whether this build is the canonical latest (indexable, served at root). */
+    isLatest: boolean;
+}
+export declare function resolveDocsEnv(defaults?: Partial<DocsEnv>): DocsEnv;

package/dist/env.js

@@ -0,0 +1,3 @@
+export { resolveDocsEnv } from './chunk-ZZ45WAVR.js';
+//# sourceMappingURL=env.js.map
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import type { AstroIntegration } from 'astro';
+import { type DocsUserConfig } from './config.ts';
+import { type DocsEnv } from './env.ts';
+export { resolveConfig, type DocsConfig, type DocsUserConfig } from './config.ts';
+export { resolveDocsEnv, type DocsEnv } from './env.ts';
+export { docsSchema, groupSchema, badgeSchema } from './schema.ts';
+export * from './types.ts';
+export interface DocsIntegrationOptions extends DocsUserConfig {
+    /** Build environment for versioned deploys. Defaults to `resolveDocsEnv()`. */
+    env?: Partial<DocsEnv>;
+}
+export default function docs(options?: DocsIntegrationOptions): AstroIntegration;