@heroiclands/package-build 22.23.0 → 22.25.0

package/types/engine/site-config.d.mts

@@ -65,16 +65,18 @@ export function fetchNavigation(config: object, { url, fetch }?: {
 }): Promise<string>;
 /**
  * The `themesDir` for a repository, as the path from `build/hugo/` to the
- * directory holding the installed theme.
+ * directory holding the theme.
  *
- * Resolved the way Node resolves a package — `node_modules/` in the
- * repository root, then in each parent — and written as a path rather than
- * assumed, so a worktree that resolves its parent's install says so in the
- * generated file.
+ * The theme ships inside this package at `hugo-theme/`, so the directory Hugo
+ * reads themes from is {@link PACKAGE_ROOT}. `theme` stays {@link THEME}, so
+ * Hugo opens `<themesDir>/hugo-theme/layouts`.
+ *
+ * Written as a path rather than assumed: `build/hugo/` and the installed
+ * package sit at whatever distance the install put them, and a worktree
+ * resolving its parent's install says so in the generated file.
  *
  * @param {string} rootDir - The repository root.
  * @returns {string} The relative path, POSIX-separated.
- * @throws {Error} When the theme is installed nowhere above the root.
  */
 export function resolveThemesDir(rootDir: string): string;
 /**
@@ -142,9 +144,7 @@ export const HUGO_CONTENT: "build/hugo/content";
  * site-root` writes `_headers` beside it and the search index inside it.
  */
 export const DEPLOY_ROOT: "build/site";
-/** The npm package the shared theme arrives as. */
-export const THEME_PACKAGE: "@heroiclands/hugo-theme";
-/** The theme's name under `themesDir`, which is the package's unscoped name. */
+/** The theme's directory name under `themesDir`. */
 export const THEME: "hugo-theme";
 /** The locale every site renders in. */
 export const LOCALE: "en-us";