@normed/bundle 4.8.6 → 4.8.8

package/bundles/esbuild-plugins/load_pug.d.ts

@@ -1,15 +1,5 @@
 import type * as esbuild from "esbuild";
 export declare function getLinkingAttrs(elementName: string): string[] | undefined;
-export declare function findPackageRoot(filePath: string): string | null;
-/**
- * Resolve an asset path from a pug file, treating "/" as srcWebRoot (not filesystem root).
- */
-export declare function resolveAssetPath(assetPath: string, pugDir: string, srcWebRoot: string): string;
-/**
- * Assert that an absolute path is within one of the allowed source roots.
- * Throws if the path escapes all allowed roots.
- */
-export declare function assertWithinAllowedRoots(absolutePath: string, allowedRoots: string[], originalValue: string, pugFilePath: string): void;
 /**
  * Discovered pug file reference from HTML.
  */

package/bundles/esbuild-plugins/safe_path_resolution.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Prefix for package references in pug files.
+ * Usage: pkg:bootstrap/dist/js/bootstrap.min.js
+ * @deprecated Use `copy:` instead. `pkg:` is a legacy alias for `copy:`.
+ */
+export declare const PKG_PREFIX = "pkg:";
+/**
+ * Prefix for build references in pug files.
+ * Resolves via Node's require.resolve, then compiles through the appropriate pipeline.
+ * Usage: build:#shared/styles.less, build:@acme/design-system/src/theme.less
+ */
+export declare const BUILD_PREFIX = "build:";
+/**
+ * Prefix for copy references in pug files.
+ * Resolves via Node's require.resolve, then copies to output with content-hashing.
+ * Usage: copy:bootstrap/dist/js/bootstrap.min.js, copy:#assets/logo.png
+ */
+export declare const COPY_PREFIX = "copy:";
+/**
+ * Prefix for verbatim references that bypass all path processing.
+ * Usage: verbatim:./runtime-path.png
+ */
+export declare const VERBATIM_PREFIX = "verbatim:";
+/**
+ * Check if a path is a relative asset path that should be processed.
+ * Returns false for URLs, data URIs, fragments, etc.
+ */
+export declare function isRelativeAssetPath(assetPath: string): boolean;
+/**
+ * Check if a path is a build reference (starts with build:).
+ */
+export declare function isBuildReference(assetPath: string): boolean;
+/**
+ * Check if a path is a copy reference (starts with copy:).
+ */
+export declare function isCopyReference(assetPath: string): boolean;
+/**
+ * Check if a path is a package reference (starts with pkg:).
+ * @deprecated Use `isCopyReference` instead.
+ */
+export declare function isPackageReference(assetPath: string): boolean;
+/**
+ * Check if a path is a verbatim reference (starts with verbatim:).
+ */
+export declare function isVerbatimReference(assetPath: string): boolean;
+/**
+ * Check if a package reference is a CSS file that needs processing.
+ */
+export declare function isPackageCssReference(assetPath: string): boolean;
+/**
+ * Strip the build:/copy:/pkg: prefix and return the specifier.
+ */
+export declare function getResolvedSpecifier(assetPath: string): string;
+/**
+ * Get the package specifier from a pkg: reference.
+ * @deprecated Use `getResolvedSpecifier` instead.
+ */
+export declare function getPackageSpecifier(assetPath: string): string;
+/**
+ * Get the raw path from a verbatim: reference.
+ */
+export declare function getVerbatimPath(assetPath: string): string;
+/**
+ * Resolve a package specifier to an absolute file path.
+ * Uses Node's module resolution from the context of the pug file.
+ */
+export declare function resolvePackagePath(packageSpecifier: string, fromFile: string): string | null;
+export declare function findPackageRoot(filePath: string): string | null;
+/**
+ * Resolve an asset path from a pug file, treating "/" as srcWebRoot (not filesystem root).
+ */
+export declare function resolveAssetPath(assetPath: string, pugDir: string, srcWebRoot: string): string;
+/**
+ * Assert that an absolute path is within one of the allowed source roots.
+ * Throws if the path escapes all allowed roots.
+ */
+export declare function assertWithinAllowedRoots(absolutePath: string, allowedRoots: string[], originalValue: string, pugFilePath: string): void;