site-config-stack 3.2.7 → 3.2.9

package/dist/index.cjs

@@ -0,0 +1,110 @@
+'use strict';
+
+const ufo = require('ufo');
+const vue = require('vue');
+
+function normalizeSiteConfig(config) {
+  if (typeof config.indexable !== "undefined")
+    config.indexable = String(config.indexable) !== "false";
+  if (typeof config.trailingSlash !== "undefined" && !config.trailingSlash)
+    config.trailingSlash = String(config.trailingSlash) !== "false";
+  if (config.url && !ufo.hasProtocol(String(config.url), { acceptRelative: true, strict: false }))
+    config.url = ufo.withHttps(String(config.url));
+  const keys = Object.keys(config).sort((a, b) => a.localeCompare(b));
+  const newConfig = {};
+  for (const k of keys)
+    newConfig[k] = config[k];
+  return newConfig;
+}
+function validateSiteConfigStack(stack) {
+  const resolved = normalizeSiteConfig(stack.get({
+    // we need the context
+    debug: true
+  }));
+  const errors = [];
+  if (resolved.url) {
+    const val = resolved.url;
+    const context = resolved._context?.url || "unknown";
+    const url = ufo.parseURL(val);
+    const { hostname } = ufo.parseHost(url.host);
+    if (!url.host)
+      errors.push(`url "${val}" from ${context} is not absolute`);
+    else if (url.pathname && url.pathname !== "/")
+      errors.push(`url "${val}" from ${context} should not contain a path`);
+    else if (url.hash)
+      errors.push(`url "${val}" from ${context} should not contain a hash`);
+    else if (Object.keys(ufo.getQuery(val)).length > 0)
+      errors.push(`url "${val}" from ${context} should not contain a query`);
+    else if (hostname === "localhost" && resolved.env !== "development")
+      errors.push(`url "${val}" from ${context} should not be localhost`);
+  }
+  return errors;
+}
+function createSiteConfigStack(options) {
+  const debug = options?.debug || false;
+  const stack = [];
+  function push(input) {
+    if (!input || typeof input !== "object" || Object.keys(input).length === 0) {
+      return () => {
+      };
+    }
+    if (!input._context && debug) {
+      let lastFunctionName = new Error("tmp").stack?.split("\n")[2]?.split(" ")[5];
+      if (lastFunctionName?.includes("/"))
+        lastFunctionName = "anonymous";
+      input._context = lastFunctionName;
+    }
+    const entry = {};
+    for (const k in input) {
+      const val = input[k];
+      if (typeof val !== "undefined" && val !== "")
+        entry[k] = val;
+    }
+    let idx;
+    if (Object.keys(entry).filter((k) => !k.startsWith("_")).length > 0)
+      idx = stack.push(entry);
+    return () => {
+      if (typeof idx !== "undefined") {
+        stack.splice(idx - 1, 1);
+      }
+    };
+  }
+  function get(options2) {
+    const siteConfig = {};
+    if (options2?.debug)
+      siteConfig._context = {};
+    siteConfig._priority = {};
+    for (const o in stack.sort((a, b) => (a._priority || 0) - (b._priority || 0))) {
+      for (const k in stack[o]) {
+        const key = k;
+        const val = options2?.resolveRefs ? vue.toValue(stack[o][k]) : stack[o][k];
+        if (!k.startsWith("_") && typeof val !== "undefined" && val !== "") {
+          siteConfig[k] = val;
+          if (typeof stack[o]._priority !== "undefined" && stack[o]._priority !== -1) {
+            siteConfig._priority[key] = stack[o]._priority;
+          }
+          if (options2?.debug)
+            siteConfig._context[key] = stack[o]._context?.[key] || stack[o]._context || "anonymous";
+        }
+      }
+    }
+    return options2?.skipNormalize ? siteConfig : normalizeSiteConfig(siteConfig);
+  }
+  return {
+    stack,
+    push,
+    get
+  };
+}
+
+function envSiteConfig(env) {
+  return Object.fromEntries(Object.entries(env).filter(([k]) => k.startsWith("NUXT_SITE_") || k.startsWith("NUXT_PUBLIC_SITE_")).map(([k, v]) => [
+    k.replace(/^NUXT_(PUBLIC_)?SITE_/, "").split("_").map((s, i) => i === 0 ? s.toLowerCase() : s[0]?.toUpperCase() + s.slice(1).toLowerCase()).join(""),
+    v
+  ]));
+}
+
+exports.createSiteConfigStack = createSiteConfigStack;
+exports.envSiteConfig = envSiteConfig;
+exports.normalizeSiteConfig = normalizeSiteConfig;
+exports.validateSiteConfigStack = validateSiteConfigStack;

package/dist/index.d.cts

@@ -0,0 +1,81 @@
+import { ComputedRef, Ref } from 'vue';
+
+interface SiteConfigResolved {
+    /**
+     * The canonical Site URL.
+     *
+     * - Build / Prerender: Inferred from CI environment (Netlify, Vercel)
+     * - SSR: Inferred from request headers
+     * - SPA: Inferred from `window.location`
+     *
+     * Used by: nuxt-simple-sitemap, nuxt-simple-robots, nuxt-schema-org, nuxt-og-image, etc.
+     */
+    url?: string;
+    /**
+     * The name of the site.
+     *
+     * - Build / Prerender: Inferred from CI environment (Netlify) or `package.json`
+     * - SSR:
+     *
+     * Used by: nuxt-schema-org, nuxt-seo-kit
+     */
+    name?: string;
+    /**
+     * Whether the site is indexable by search engines.
+     *
+     * Allows you to opt-out productions environment from being indexed.
+     */
+    indexable?: boolean;
+    /**
+     * The environment of the site. Comparable to `process.env.NODE_ENV`.
+     */
+    env?: 'production' | 'staging' | 'development' | 'preview' | 'uat' | string;
+    /**
+     * Whether the site uses trailing slash.
+     */
+    trailingSlash?: boolean;
+    /**
+     * The mapping of the context of each site config value being set.
+     */
+    _context?: Record<string, string>;
+    /**
+     * Support any keys as site config.
+     */
+    [key: string]: any;
+}
+/**
+ * @deprecated use SiteConfigResolved
+ */
+type SiteConfig = SiteConfigResolved;
+type MaybeComputedRef<T> = T | (() => T) | ComputedRef<T> | Ref<T>;
+type MaybeComputedRefEntries<T> = {
+    [key in keyof T]?: MaybeComputedRef<T[key]>;
+};
+type SiteConfigInput = Omit<MaybeComputedRefEntries<Partial<SiteConfigResolved>>, '_context' | 'indexable'> & {
+    _context?: string;
+    _priority?: number;
+    indexable?: MaybeComputedRef<string | boolean>;
+};
+interface GetSiteConfigOptions {
+    debug?: boolean;
+    skipNormalize?: boolean;
+    resolveRefs?: boolean;
+}
+interface SiteConfigStack {
+    stack: Partial<SiteConfigInput>[];
+    push: (config: SiteConfigInput) => () => void;
+    get: (options?: GetSiteConfigOptions) => SiteConfigResolved;
+}
+
+declare function normalizeSiteConfig(config: SiteConfigResolved): SiteConfigResolved;
+declare function validateSiteConfigStack(stack: SiteConfigStack): string[];
+declare function createSiteConfigStack(options?: {
+    debug: boolean;
+}): SiteConfigStack;
+
+declare function envSiteConfig(env: Record<string, any>): {
+    [k: string]: any;
+};
+
+export { createSiteConfigStack, envSiteConfig, normalizeSiteConfig, validateSiteConfigStack };
+export type { GetSiteConfigOptions, MaybeComputedRef, MaybeComputedRefEntries, SiteConfig, SiteConfigInput, SiteConfigResolved, SiteConfigStack };

package/dist/index.d.mts

@@ -0,0 +1,81 @@
+import { ComputedRef, Ref } from 'vue';
+
+interface SiteConfigResolved {
+    /**
+     * The canonical Site URL.
+     *
+     * - Build / Prerender: Inferred from CI environment (Netlify, Vercel)
+     * - SSR: Inferred from request headers
+     * - SPA: Inferred from `window.location`
+     *
+     * Used by: nuxt-simple-sitemap, nuxt-simple-robots, nuxt-schema-org, nuxt-og-image, etc.
+     */
+    url?: string;
+    /**
+     * The name of the site.
+     *
+     * - Build / Prerender: Inferred from CI environment (Netlify) or `package.json`
+     * - SSR:
+     *
+     * Used by: nuxt-schema-org, nuxt-seo-kit
+     */
+    name?: string;
+    /**
+     * Whether the site is indexable by search engines.
+     *
+     * Allows you to opt-out productions environment from being indexed.
+     */
+    indexable?: boolean;
+    /**
+     * The environment of the site. Comparable to `process.env.NODE_ENV`.
+     */
+    env?: 'production' | 'staging' | 'development' | 'preview' | 'uat' | string;
+    /**
+     * Whether the site uses trailing slash.
+     */
+    trailingSlash?: boolean;
+    /**
+     * The mapping of the context of each site config value being set.
+     */
+    _context?: Record<string, string>;
+    /**
+     * Support any keys as site config.
+     */
+    [key: string]: any;
+}
+/**
+ * @deprecated use SiteConfigResolved
+ */
+type SiteConfig = SiteConfigResolved;
+type MaybeComputedRef<T> = T | (() => T) | ComputedRef<T> | Ref<T>;
+type MaybeComputedRefEntries<T> = {
+    [key in keyof T]?: MaybeComputedRef<T[key]>;
+};
+type SiteConfigInput = Omit<MaybeComputedRefEntries<Partial<SiteConfigResolved>>, '_context' | 'indexable'> & {
+    _context?: string;
+    _priority?: number;
+    indexable?: MaybeComputedRef<string | boolean>;
+};
+interface GetSiteConfigOptions {
+    debug?: boolean;
+    skipNormalize?: boolean;
+    resolveRefs?: boolean;
+}
+interface SiteConfigStack {
+    stack: Partial<SiteConfigInput>[];
+    push: (config: SiteConfigInput) => () => void;
+    get: (options?: GetSiteConfigOptions) => SiteConfigResolved;
+}
+
+declare function normalizeSiteConfig(config: SiteConfigResolved): SiteConfigResolved;
+declare function validateSiteConfigStack(stack: SiteConfigStack): string[];
+declare function createSiteConfigStack(options?: {
+    debug: boolean;
+}): SiteConfigStack;
+
+declare function envSiteConfig(env: Record<string, any>): {
+    [k: string]: any;
+};
+
+export { createSiteConfigStack, envSiteConfig, normalizeSiteConfig, validateSiteConfigStack };
+export type { GetSiteConfigOptions, MaybeComputedRef, MaybeComputedRefEntries, SiteConfig, SiteConfigInput, SiteConfigResolved, SiteConfigStack };

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+import { ComputedRef, Ref } from 'vue';
+
+interface SiteConfigResolved {
+    /**
+     * The canonical Site URL.
+     *
+     * - Build / Prerender: Inferred from CI environment (Netlify, Vercel)
+     * - SSR: Inferred from request headers
+     * - SPA: Inferred from `window.location`
+     *
+     * Used by: nuxt-simple-sitemap, nuxt-simple-robots, nuxt-schema-org, nuxt-og-image, etc.
+     */
+    url?: string;
+    /**
+     * The name of the site.
+     *
+     * - Build / Prerender: Inferred from CI environment (Netlify) or `package.json`
+     * - SSR:
+     *
+     * Used by: nuxt-schema-org, nuxt-seo-kit
+     */
+    name?: string;
+    /**
+     * Whether the site is indexable by search engines.
+     *
+     * Allows you to opt-out productions environment from being indexed.
+     */
+    indexable?: boolean;
+    /**
+     * The environment of the site. Comparable to `process.env.NODE_ENV`.
+     */
+    env?: 'production' | 'staging' | 'development' | 'preview' | 'uat' | string;
+    /**
+     * Whether the site uses trailing slash.
+     */
+    trailingSlash?: boolean;
+    /**
+     * The mapping of the context of each site config value being set.
+     */
+    _context?: Record<string, string>;
+    /**
+     * Support any keys as site config.
+     */
+    [key: string]: any;
+}
+/**
+ * @deprecated use SiteConfigResolved
+ */
+type SiteConfig = SiteConfigResolved;
+type MaybeComputedRef<T> = T | (() => T) | ComputedRef<T> | Ref<T>;
+type MaybeComputedRefEntries<T> = {
+    [key in keyof T]?: MaybeComputedRef<T[key]>;
+};
+type SiteConfigInput = Omit<MaybeComputedRefEntries<Partial<SiteConfigResolved>>, '_context' | 'indexable'> & {
+    _context?: string;
+    _priority?: number;
+    indexable?: MaybeComputedRef<string | boolean>;
+};
+interface GetSiteConfigOptions {
+    debug?: boolean;
+    skipNormalize?: boolean;
+    resolveRefs?: boolean;
+}
+interface SiteConfigStack {
+    stack: Partial<SiteConfigInput>[];
+    push: (config: SiteConfigInput) => () => void;
+    get: (options?: GetSiteConfigOptions) => SiteConfigResolved;
+}
+
+declare function normalizeSiteConfig(config: SiteConfigResolved): SiteConfigResolved;
+declare function validateSiteConfigStack(stack: SiteConfigStack): string[];
+declare function createSiteConfigStack(options?: {
+    debug: boolean;
+}): SiteConfigStack;
+
+declare function envSiteConfig(env: Record<string, any>): {
+    [k: string]: any;
+};
+
+export { createSiteConfigStack, envSiteConfig, normalizeSiteConfig, validateSiteConfigStack };
+export type { GetSiteConfigOptions, MaybeComputedRef, MaybeComputedRefEntries, SiteConfig, SiteConfigInput, SiteConfigResolved, SiteConfigStack };

package/dist/index.mjs

@@ -0,0 +1,105 @@
+import { hasProtocol, withHttps, parseURL, parseHost, getQuery } from 'ufo';
+import { toValue } from 'vue';
+
+function normalizeSiteConfig(config) {
+  if (typeof config.indexable !== "undefined")
+    config.indexable = String(config.indexable) !== "false";
+  if (typeof config.trailingSlash !== "undefined" && !config.trailingSlash)
+    config.trailingSlash = String(config.trailingSlash) !== "false";
+  if (config.url && !hasProtocol(String(config.url), { acceptRelative: true, strict: false }))
+    config.url = withHttps(String(config.url));
+  const keys = Object.keys(config).sort((a, b) => a.localeCompare(b));
+  const newConfig = {};
+  for (const k of keys)
+    newConfig[k] = config[k];
+  return newConfig;
+}
+function validateSiteConfigStack(stack) {
+  const resolved = normalizeSiteConfig(stack.get({
+    // we need the context
+    debug: true
+  }));
+  const errors = [];
+  if (resolved.url) {
+    const val = resolved.url;
+    const context = resolved._context?.url || "unknown";
+    const url = parseURL(val);
+    const { hostname } = parseHost(url.host);
+    if (!url.host)
+      errors.push(`url "${val}" from ${context} is not absolute`);
+    else if (url.pathname && url.pathname !== "/")
+      errors.push(`url "${val}" from ${context} should not contain a path`);
+    else if (url.hash)
+      errors.push(`url "${val}" from ${context} should not contain a hash`);
+    else if (Object.keys(getQuery(val)).length > 0)
+      errors.push(`url "${val}" from ${context} should not contain a query`);
+    else if (hostname === "localhost" && resolved.env !== "development")
+      errors.push(`url "${val}" from ${context} should not be localhost`);
+  }
+  return errors;
+}
+function createSiteConfigStack(options) {
+  const debug = options?.debug || false;
+  const stack = [];
+  function push(input) {
+    if (!input || typeof input !== "object" || Object.keys(input).length === 0) {
+      return () => {
+      };
+    }
+    if (!input._context && debug) {
+      let lastFunctionName = new Error("tmp").stack?.split("\n")[2]?.split(" ")[5];
+      if (lastFunctionName?.includes("/"))
+        lastFunctionName = "anonymous";
+      input._context = lastFunctionName;
+    }
+    const entry = {};
+    for (const k in input) {
+      const val = input[k];
+      if (typeof val !== "undefined" && val !== "")
+        entry[k] = val;
+    }
+    let idx;
+    if (Object.keys(entry).filter((k) => !k.startsWith("_")).length > 0)
+      idx = stack.push(entry);
+    return () => {
+      if (typeof idx !== "undefined") {
+        stack.splice(idx - 1, 1);
+      }
+    };
+  }
+  function get(options2) {
+    const siteConfig = {};
+    if (options2?.debug)
+      siteConfig._context = {};
+    siteConfig._priority = {};
+    for (const o in stack.sort((a, b) => (a._priority || 0) - (b._priority || 0))) {
+      for (const k in stack[o]) {
+        const key = k;
+        const val = options2?.resolveRefs ? toValue(stack[o][k]) : stack[o][k];
+        if (!k.startsWith("_") && typeof val !== "undefined" && val !== "") {
+          siteConfig[k] = val;
+          if (typeof stack[o]._priority !== "undefined" && stack[o]._priority !== -1) {
+            siteConfig._priority[key] = stack[o]._priority;
+          }
+          if (options2?.debug)
+            siteConfig._context[key] = stack[o]._context?.[key] || stack[o]._context || "anonymous";
+        }
+      }
+    }
+    return options2?.skipNormalize ? siteConfig : normalizeSiteConfig(siteConfig);
+  }
+  return {
+    stack,
+    push,
+    get
+  };
+}
+
+function envSiteConfig(env) {
+  return Object.fromEntries(Object.entries(env).filter(([k]) => k.startsWith("NUXT_SITE_") || k.startsWith("NUXT_PUBLIC_SITE_")).map(([k, v]) => [
+    k.replace(/^NUXT_(PUBLIC_)?SITE_/, "").split("_").map((s, i) => i === 0 ? s.toLowerCase() : s[0]?.toUpperCase() + s.slice(1).toLowerCase()).join(""),
+    v
+  ]));
+}
+
+export { createSiteConfigStack, envSiteConfig, normalizeSiteConfig, validateSiteConfigStack };

package/dist/urls.cjs

@@ -0,0 +1,150 @@
+'use strict';
+
+const ufo = require('ufo');
+
+function resolveSitePath(pathOrUrl, options) {
+  let path = pathOrUrl;
+  if (ufo.hasProtocol(pathOrUrl, { strict: false, acceptRelative: true })) {
+    const parsed = ufo.parseURL(pathOrUrl);
+    path = parsed.pathname;
+  }
+  const base = ufo.withLeadingSlash(options.base || "/");
+  if (base !== "/" && path.startsWith(base)) {
+    path = path.slice(base.length);
+  }
+  let origin = ufo.withoutTrailingSlash(options.absolute ? options.siteUrl : "");
+  if (base !== "/" && origin.endsWith(base)) {
+    origin = origin.slice(0, origin.indexOf(base));
+  }
+  const baseWithOrigin = options.withBase ? ufo.withBase(base, origin || "/") : origin;
+  const resolvedUrl = ufo.withBase(path, baseWithOrigin);
+  return path === "/" && !options.withBase ? ufo.withTrailingSlash(resolvedUrl) : fixSlashes(options.trailingSlash, resolvedUrl);
+}
+const fileExtensions = [
+  // Images
+  "jpg",
+  "jpeg",
+  "png",
+  "gif",
+  "bmp",
+  "webp",
+  "svg",
+  "ico",
+  // Documents
+  "pdf",
+  "doc",
+  "docx",
+  "xls",
+  "xlsx",
+  "ppt",
+  "pptx",
+  "txt",
+  "md",
+  "markdown",
+  // Archives
+  "zip",
+  "rar",
+  "7z",
+  "tar",
+  "gz",
+  // Audio
+  "mp3",
+  "wav",
+  "flac",
+  "ogg",
+  "opus",
+  "m4a",
+  "aac",
+  "midi",
+  "mid",
+  // Video
+  "mp4",
+  "avi",
+  "mkv",
+  "mov",
+  "wmv",
+  "flv",
+  "webm",
+  // Web
+  "html",
+  "css",
+  "js",
+  "json",
+  "xml",
+  "tsx",
+  "jsx",
+  "ts",
+  "vue",
+  "svelte",
+  "xsl",
+  "rss",
+  "atom",
+  // Programming
+  "php",
+  "py",
+  "rb",
+  "java",
+  "c",
+  "cpp",
+  "h",
+  "go",
+  // Data formats
+  "csv",
+  "tsv",
+  "sql",
+  "yaml",
+  "yml",
+  // Fonts
+  "woff",
+  "woff2",
+  "ttf",
+  "otf",
+  "eot",
+  // Executables/Binaries
+  "exe",
+  "msi",
+  "apk",
+  "ipa",
+  "dmg",
+  "iso",
+  "bin",
+  // Scripts/Config
+  "bat",
+  "cmd",
+  "sh",
+  "env",
+  "htaccess",
+  "conf",
+  "toml",
+  "ini",
+  // Package formats
+  "deb",
+  "rpm",
+  "jar",
+  "war",
+  // E-books
+  "epub",
+  "mobi",
+  // Common temporary/backup files
+  "log",
+  "tmp",
+  "bak",
+  "old",
+  "sav"
+];
+function isPathFile(path) {
+  const lastSegment = path.split("/").pop();
+  const ext = (lastSegment || path).match(/\.[0-9a-z]+$/i)?.[0];
+  return ext && fileExtensions.includes(ext.replace(".", ""));
+}
+function fixSlashes(trailingSlash, pathOrUrl) {
+  const $url = ufo.parseURL(pathOrUrl);
+  if (isPathFile($url.pathname))
+    return pathOrUrl;
+  const fixedPath = trailingSlash ? ufo.withTrailingSlash($url.pathname) : ufo.withoutTrailingSlash($url.pathname);
+  return `${$url.protocol ? `${$url.protocol}//` : ""}${$url.host || ""}${fixedPath}${$url.search || ""}${$url.hash || ""}`;
+}
+
+exports.fixSlashes = fixSlashes;
+exports.isPathFile = isPathFile;
+exports.resolveSitePath = resolveSitePath;

package/dist/urls.d.cts

@@ -0,0 +1,11 @@
+declare function resolveSitePath(pathOrUrl: string, options: {
+    siteUrl: string;
+    trailingSlash?: boolean;
+    base?: string;
+    absolute?: boolean;
+    withBase?: boolean;
+}): string;
+declare function isPathFile(path: string): boolean | "" | undefined;
+declare function fixSlashes(trailingSlash: boolean | undefined, pathOrUrl: string): string;
+
+export { fixSlashes, isPathFile, resolveSitePath };

package/dist/urls.d.mts

@@ -0,0 +1,11 @@
+declare function resolveSitePath(pathOrUrl: string, options: {
+    siteUrl: string;
+    trailingSlash?: boolean;
+    base?: string;
+    absolute?: boolean;
+    withBase?: boolean;
+}): string;
+declare function isPathFile(path: string): boolean | "" | undefined;
+declare function fixSlashes(trailingSlash: boolean | undefined, pathOrUrl: string): string;
+
+export { fixSlashes, isPathFile, resolveSitePath };

package/dist/urls.d.ts

@@ -0,0 +1,11 @@
+declare function resolveSitePath(pathOrUrl: string, options: {
+    siteUrl: string;
+    trailingSlash?: boolean;
+    base?: string;
+    absolute?: boolean;
+    withBase?: boolean;
+}): string;
+declare function isPathFile(path: string): boolean | "" | undefined;
+declare function fixSlashes(trailingSlash: boolean | undefined, pathOrUrl: string): string;
+
+export { fixSlashes, isPathFile, resolveSitePath };

package/dist/urls.mjs

@@ -0,0 +1,146 @@
+import { hasProtocol, parseURL, withLeadingSlash, withoutTrailingSlash, withBase, withTrailingSlash } from 'ufo';
+
+function resolveSitePath(pathOrUrl, options) {
+  let path = pathOrUrl;
+  if (hasProtocol(pathOrUrl, { strict: false, acceptRelative: true })) {
+    const parsed = parseURL(pathOrUrl);
+    path = parsed.pathname;
+  }
+  const base = withLeadingSlash(options.base || "/");
+  if (base !== "/" && path.startsWith(base)) {
+    path = path.slice(base.length);
+  }
+  let origin = withoutTrailingSlash(options.absolute ? options.siteUrl : "");
+  if (base !== "/" && origin.endsWith(base)) {
+    origin = origin.slice(0, origin.indexOf(base));
+  }
+  const baseWithOrigin = options.withBase ? withBase(base, origin || "/") : origin;
+  const resolvedUrl = withBase(path, baseWithOrigin);
+  return path === "/" && !options.withBase ? withTrailingSlash(resolvedUrl) : fixSlashes(options.trailingSlash, resolvedUrl);
+}
+const fileExtensions = [
+  // Images
+  "jpg",
+  "jpeg",
+  "png",
+  "gif",
+  "bmp",
+  "webp",
+  "svg",
+  "ico",
+  // Documents
+  "pdf",
+  "doc",
+  "docx",
+  "xls",
+  "xlsx",
+  "ppt",
+  "pptx",
+  "txt",
+  "md",
+  "markdown",
+  // Archives
+  "zip",
+  "rar",
+  "7z",
+  "tar",
+  "gz",
+  // Audio
+  "mp3",
+  "wav",
+  "flac",
+  "ogg",
+  "opus",
+  "m4a",
+  "aac",
+  "midi",
+  "mid",
+  // Video
+  "mp4",
+  "avi",
+  "mkv",
+  "mov",
+  "wmv",
+  "flv",
+  "webm",
+  // Web
+  "html",
+  "css",
+  "js",
+  "json",
+  "xml",
+  "tsx",
+  "jsx",
+  "ts",
+  "vue",
+  "svelte",
+  "xsl",
+  "rss",
+  "atom",
+  // Programming
+  "php",
+  "py",
+  "rb",
+  "java",
+  "c",
+  "cpp",
+  "h",
+  "go",
+  // Data formats
+  "csv",
+  "tsv",
+  "sql",
+  "yaml",
+  "yml",
+  // Fonts
+  "woff",
+  "woff2",
+  "ttf",
+  "otf",
+  "eot",
+  // Executables/Binaries
+  "exe",
+  "msi",
+  "apk",
+  "ipa",
+  "dmg",
+  "iso",
+  "bin",
+  // Scripts/Config
+  "bat",
+  "cmd",
+  "sh",
+  "env",
+  "htaccess",
+  "conf",
+  "toml",
+  "ini",
+  // Package formats
+  "deb",
+  "rpm",
+  "jar",
+  "war",
+  // E-books
+  "epub",
+  "mobi",
+  // Common temporary/backup files
+  "log",
+  "tmp",
+  "bak",
+  "old",
+  "sav"
+];
+function isPathFile(path) {
+  const lastSegment = path.split("/").pop();
+  const ext = (lastSegment || path).match(/\.[0-9a-z]+$/i)?.[0];
+  return ext && fileExtensions.includes(ext.replace(".", ""));
+}
+function fixSlashes(trailingSlash, pathOrUrl) {
+  const $url = parseURL(pathOrUrl);
+  if (isPathFile($url.pathname))
+    return pathOrUrl;
+  const fixedPath = trailingSlash ? withTrailingSlash($url.pathname) : withoutTrailingSlash($url.pathname);
+  return `${$url.protocol ? `${$url.protocol}//` : ""}${$url.host || ""}${fixedPath}${$url.search || ""}${$url.hash || ""}`;
+}
+
+export { fixSlashes, isPathFile, resolveSitePath };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "site-config-stack",
   "type": "module",
-  "version": "3.2.7",
+  "version": "3.2.9",
   "description": "Shared site configuration utilities.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/harlan-zw",