@heroiclands/package-build 22.1.0 → 22.1.1

package/types/engine/wikilinks.d.mts

@@ -81,13 +81,18 @@ export function resolveItemDocType(qualifier: string, types: Set<string>): strin
  * @param {Set<string>} types - Every type the content tree contains.
  * @param {Set<string>} [packages] - Every package an address may name. Omitted
  *   by callers that resolve within one package, where the form cannot occur.
+ * @param {Set<string>} [noIndexPackages] - Packages declared `contentIndex:
+ *   false` — a Foundry dependency only, with no fetched index. A fully
+ *   qualified target naming one is refused with `no-content-index` before its
+ *   type is even considered, since there is no index to resolve it against.
  * @returns {{type: string, shortcode: string, itemDoc: boolean,
  *   package?: string, system?: string, reason?: undefined}
- *   | {reason: "unknown-type"} | null}
+ *   | {reason: "unknown-type"|"no-content-index", package?: string} | null}
  *   The resolved qualifier; a `reason` when the target is definitely qualified
- *   but names no known type; or `null` when it is not an address at all.
+ *   but names no known type or no fetched index; or `null` when it is not an
+ *   address at all.
  */
-export function readQualifier(target: string, types: Set<string>, packages?: Set<string>): {
+export function readQualifier(target: string, types: Set<string>, packages?: Set<string>, noIndexPackages?: Set<string>): {
     type: string;
     shortcode: string;
     itemDoc: boolean;
@@ -95,7 +100,8 @@ export function readQualifier(target: string, types: Set<string>, packages?: Set
     system?: string;
     reason?: undefined;
 } | {
-    reason: "unknown-type";
+    reason: "unknown-type" | "no-content-index";
+    package?: string;
 } | null;
 /**
  * The deterministic JournalEntryPage id for one anchor: SHA-256 of
@@ -132,6 +138,10 @@ export function anchorPageId(noteId: string, anchorSlug: string): string;
  * @param {Map<string, object>} [opts.assets] - The files this package ships, by
  *   canonical address. They resolve no link — an asset is not a document — and
  *   answer only the art fields, which name a file and never a document.
+ * @param {Set<string>} [opts.noIndexPackages] - Packages declared
+ *   `contentIndex: false` — a Foundry dependency only. A link naming one fails
+ *   with `no-content-index` rather than resolving, ambiguously, as either a
+ *   typo or an undeclared package.
  * @returns {{byShortcode: Map<string, object>, types: Set<string>}} `types` is
  *   every type the tree actually contains, so a qualifier naming no real type
  *   can be told apart from a missing target.
@@ -144,8 +154,9 @@ export function buildWikilinkIndex(docs: Array<{
     pack?: string;
     docPack?: string;
     draft?: boolean;
-}>, packageId: string, foreign?: Map<string, object>, contentPackage?: string, { assets }?: {
+}>, packageId: string, foreign?: Map<string, object>, contentPackage?: string, { assets, noIndexPackages }?: {
     assets?: Map<string, object> | undefined;
+    noIndexPackages?: Set<string> | undefined;
 }): {
     byShortcode: Map<string, object>;
     types: Set<string>;