bingo 0.4.2 → 0.5.1

package/lib/producers/produceTemplate.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"produceTemplate.test.js","sourceRoot":"","sources":["../../src/producers/produceTemplate.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,QAAQ,GAAG,cAAc,CAAC;IAC/B,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;IAChC,OAAO,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB;IACD,OAAO,CAAC,EAAE,OAAO,EAAE;QAClB,OAAO;YACN,KAAK,EAAE;gBACN,WAAW,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;aACjC;SACD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,EAAE,OAAO,EAAE;QAChB,OAAO;YACN,KAAK,EAAE;gBACN,iBAAiB,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;aACvC;SACD,CAAC;IACH,CAAC;IACD,UAAU,CAAC,EAAE,OAAO,EAAE;QACrB,OAAO;YACN,KAAK,EAAE;gBACN,sBAAsB,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;aAC5C;SACD,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QACnF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE;YAC1C,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE;gBACN,WAAW,EAAE,cAAc;aAC3B;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE;YAC1C,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE;gBACN,iBAAiB,EAAE,cAAc;gBACjC,WAAW,EAAE,cAAc;aAC3B;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC7E,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE;YAC1C,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE;gBACN,sBAAsB,EAAE,cAAc;gBACtC,WAAW,EAAE,cAAc;aAC3B;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"produceTemplate.test.js","sourceRoot":"","sources":["../../src/producers/produceTemplate.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,QAAQ,GAAG,cAAc,CAAC;IAC/B,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;IAChC,OAAO,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB;IACD,OAAO,CAAC,EAAE,OAAO,EAAE;QAClB,OAAO;YACN,KAAK,EAAE;gBACN,WAAW,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;aACjC;SACD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,EAAE,OAAO,EAAE;QAChB,OAAO;YACN,KAAK,EAAE;gBACN,iBAAiB,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;aACvC;SACD,CAAC;IACH,CAAC;IACD,UAAU,CAAC,EAAE,OAAO,EAAE;QACrB,OAAO;YACN,KAAK,EAAE;gBACN,sBAAsB,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;aAC5C;SACD,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE;YAChD,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE;gBACN,WAAW,EAAE,cAAc;aAC3B;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE;YAChD,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE;gBACN,iBAAiB,EAAE,cAAc;gBACjC,WAAW,EAAE,cAAc;aAC3B;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE;YAChD,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE;gBACN,sBAAsB,EAAE,cAAc;gBACtC,WAAW,EAAE,cAAc;aAC3B;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/lib/runners/runInput.d.ts

@@ -1,6 +1,6 @@
 import { BingoSystem } from "bingo-systems";
-import { AnyShape, InferredObject } from "../options.js";
 import { Input } from "../types/inputs.js";
+import { AnyShape, InferredObject } from "../types/shapes.js";
 export interface RunInputSettings<Args extends object = object> extends Partial<BingoSystem> {
     args: Args;
     auth?: string;

package/lib/runners/runInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runInput.d.ts","sourceRoot":"","sources":["../../src/runners/runInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,WAAW,gBAAgB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAC7D,SAAQ,OAAO,CAAC,WAAW,CAAC;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,QAAQ,EAC1D,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,UAWrD"}
+{"version":3,"file":"runInput.d.ts","sourceRoot":"","sources":["../../src/runners/runInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,WAAW,gBAAgB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAC7D,SAAQ,OAAO,CAAC,WAAW,CAAC;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,QAAQ,EAC1D,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,UAWrD"}

package/lib/runners/runTemplate.d.ts

@@ -1,7 +1,7 @@
 import { BingoSystem } from "bingo-systems";
-import { AnyShape, InferredObject } from "../options.js";
 import { Creation } from "../types/creations.js";
 import { ProductionMode } from "../types/modes.js";
+import { AnyShape, InferredObject } from "../types/shapes.js";
 import { Template } from "../types/templates.js";
 export interface RunSettingsBase extends Partial<BingoSystem> {
     auth?: string;

package/lib/runners/runTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runTemplate.d.ts","sourceRoot":"","sources":["../../src/runners/runTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,WAAW,eAAgB,SAAQ,OAAO,CAAC,WAAW,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB,CAAC,YAAY,SAAS,QAAQ,CACjE,SAAQ,eAAe;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACtC;AAED,wBAAsB,WAAW,CAAC,YAAY,SAAS,QAAQ,EAC9D,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAChC,QAAQ,EAAE,mBAAmB,CAAC,YAAY,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAc5B"}
+{"version":3,"file":"runTemplate.d.ts","sourceRoot":"","sources":["../../src/runners/runTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,WAAW,eAAgB,SAAQ,OAAO,CAAC,WAAW,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB,CAAC,YAAY,SAAS,QAAQ,CACjE,SAAQ,eAAe;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACtC;AAED,wBAAsB,WAAW,CAAC,YAAY,SAAS,QAAQ,EAC9D,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAChC,QAAQ,EAAE,mBAAmB,CAAC,YAAY,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAc5B"}

package/lib/runners/runTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"runTemplate.js","sourceRoot":"","sources":["../../src/runners/runTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIlE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAe/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,QAAgC,EAChC,QAA2C;IAE3C,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC;QAChD,SAAS;QACT,GAAG,QAAQ;KACX,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAE7E,MAAM,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC;AACjB,CAAC"}
+{"version":3,"file":"runTemplate.js","sourceRoot":"","sources":["../../src/runners/runTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAKlE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAe/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,QAAgC,EAChC,QAA2C;IAE3C,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC;QAChD,SAAS;QACT,GAAG,QAAQ;KACX,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAE7E,MAAM,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/lib/shapes.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * Any object containing Zod schemas that are optional.
+ * In other words, allows providing an empty object {} value.
+ */
+export type AnyOptionalShape = Record<string, z.ZodDefault<z.ZodType> | z.ZodOptional<z.ZodType>>;
+/**
+ * Any object containing Zod schemas as values.
+ */
+export type AnyShape = z.ZodRawShape;
+/**
+ * Given an object containing Zod schemas, produces the equivalent runtime type.
+ * @example
+ * ```ts
+ * InferredObject<{ value: z.ZodNumber }>
+ * ```
+ * is the same as:
+ * ```ts
+ * { value: number }
+ * ```
+ */
+export type InferredObject<OptionsShape extends AnyShape | undefined> = OptionsShape extends AnyShape ? z.infer<z.ZodObject<OptionsShape>> : undefined;
+//# sourceMappingURL=shapes.d.ts.map

package/lib/shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.d.ts","sourceRoot":"","sources":["../src/shapes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CACpC,MAAM,EACN,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,CAAC,YAAY,SAAS,QAAQ,GAAG,SAAS,IACnE,YAAY,SAAS,QAAQ,GAC1B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,GAClC,SAAS,CAAC"}

package/lib/shapes.js

@@ -0,0 +1,4 @@
+// eslint-disable-next-line @eslint-community/eslint-comments/disable-enable-pair
+/* eslint-disable jsdoc/text-escaping -- https://github.com/gajus/eslint-plugin-jsdoc/issues/1360 */
+export {};
+//# sourceMappingURL=shapes.js.map

package/lib/shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.js","sourceRoot":"","sources":["../src/shapes.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oGAAoG"}

package/lib/types/about.d.ts

@@ -1,3 +1,6 @@
+/**
+ * The minimum metadata available in the .about property of many constructs.
+ */
 export interface AboutBase {
     description?: string;
     name?: string;

package/lib/types/about.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../src/types/about.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../src/types/about.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd"}

package/lib/types/creations.d.ts

@@ -1,20 +1,49 @@
 import { CreatedDirectory } from "bingo-fs";
 import { SystemFetchers } from "bingo-systems";
+/**
+ * A request to make to set up part of a repository's tooling.
+ * @todo This will eventually become a serializable format:
+ * https://github.com/JoshuaKGoldberg/bingo/issues/65
+ */
 export interface CreatedRequest {
     id: string;
     send: CreatedRequestSender;
 }
 export type CreatedRequestSender = (fetchers: SystemFetchers) => Promise<void>;
+/**
+ * A script to run to set up part of a repository's tooling.
+ * Can be a rich object with multiple commands, or a single command string.
+ */
 export type CreatedScript = CreatedScriptWithOptions | string;
+/**
+ * Commands to run to set up part of a repository's tooling.
+ */
 export interface CreatedScriptWithOptions {
     commands: string[];
     phase?: number;
     silent?: boolean;
 }
+/**
+ * In-memory representation of a repository.
+ * Creations are returned by template `produce()` functions to describe how to create a repository.
+ * @see https://www.create.bingo/build/concepts/creations
+ */
 export interface Creation {
+    /**
+     * Files to write to disk.
+     */
     files: CreatedDirectory;
+    /**
+     * Network requests to send to initialize repository API settings.
+     */
     requests: CreatedRequest[];
+    /**
+     * Scripts to run after writing files to disk.
+     */
     scripts: CreatedScript[];
+    /**
+     * Suggestions to hint in the CLI after running.
+     */
     suggestions: string[];
 }
 //# sourceMappingURL=creations.d.ts.map

package/lib/types/creations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"creations.d.ts","sourceRoot":"","sources":["../../src/types/creations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E,MAAM,MAAM,aAAa,GAAG,wBAAwB,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB"}
+{"version":3,"file":"creations.d.ts","sourceRoot":"","sources":["../../src/types/creations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,wBAAwB,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACxB;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B;;OAEG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;IAEzB;;OAEG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/lib/types/inputs.d.ts

@@ -1,25 +1,74 @@
 import { ReadingFileSystem, SystemFetchers, SystemRunner } from "bingo-systems";
-import { AnyShape, InferredObject } from "../options.js";
+import { AnyShape, InferredObject } from "./shapes.js";
+/**
+ * An Input that might have args schema defined.
+ * @template Result Return type from the Input's produce().
+ * @template ArgsShape Arguments schema, if the Input defines them.
+ * @see {@link https://create.bingo/build/details/inputs}
+ */
 export type Input<Result, ArgsShape extends AnyShape | undefined = undefined> = ArgsShape extends AnyShape ? InputWithArgs<Result, ArgsShape> : InputWithoutArgs<Result>;
-export interface InputContext {
+/**
+ * Shared helper functions and information passed to Inputs, including args.
+ * @template Args Values as defined by the Input's args schema.
+ * @see {@link https://create.bingo/build/details/contexts#input-contexts}
+ */
+export interface InputContextWithArgs<Args extends object> extends InputContextWithoutArgs {
+    args: Args;
+}
+/**
+ * Shared helper functions and information passed to Inputs.
+ * @see {@link https://create.bingo/build/details/contexts#input-contexts}
+ */
+export interface InputContextWithoutArgs {
     fetchers: SystemFetchers;
+    /**
+     * APIs to read from a file system.
+     */
     fs: ReadingFileSystem;
+    /**
+     * Whether Bingo is being run in an "offline" mode.
+     * @see {@link http://create.bingo/build/details/contexts#input-offline}
+     */
     offline?: boolean;
     runner: SystemRunner;
     take: TakeInput;
 }
-export interface InputContextWithArgs<Args extends object> extends InputContext {
-    args: Args;
-}
+/**
+ * Producer function for an Input that defines an args schema.
+ */
 export type InputProducerWithArgs<Result, ArgsSchema extends AnyShape> = (context: InputContextWithArgs<InferredObject<ArgsSchema>>) => Result;
-export type InputProducerWithoutArgs<Result> = (context: InputContext) => Result;
+/**
+ * Producer function for an Input that does not define an args schema.
+ */
+export type InputProducerWithoutArgs<Result> = (context: InputContextWithoutArgs) => Result;
+/**
+ * An Input that defines an args schema.
+ * @see {@link https://create.bingo/build/details/inputs}
+ */
 export interface InputWithArgs<Result, ArgsSchema extends AnyShape> {
     (context: InputContextWithArgs<InferredObject<ArgsSchema>>): Result;
     args: ArgsSchema;
 }
-export type InputWithoutArgs<Result> = (context: InputContext) => Result;
+/**
+ * An Input that does not define an args schema.
+ * @see {@link https://create.bingo/build/details/inputs}
+ */
+export type InputWithoutArgs<Result> = (context: InputContextWithoutArgs) => Result;
+/**
+ * Shared context function to run an Input.
+ * @see {@link http://create.bingo/build/details/contexts#input-take}
+ */
 export interface TakeInput {
+    /**
+     * Runs the produce() of an Input with args schema.
+     * @param input Input that defines an args schema.
+     * @param args Values corresponding to the Input's args schema.
+     */
     <Result, ArgsShape extends AnyShape>(input: InputWithArgs<Result, ArgsShape>, args: InferredObject<ArgsShape>): Result;
+    /**
+     * Runs the produce() of an Input without an args schema.
+     * @param input Input that does not define an args schema.
+     */
     <Result>(input: InputWithoutArgs<Result>): Result;
 }
 //# sourceMappingURL=inputs.d.ts.map

package/lib/types/inputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/types/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,MAAM,KAAK,CAChB,MAAM,EACN,SAAS,SAAS,QAAQ,GAAG,SAAS,GAAG,SAAS,IAC/C,SAAS,SAAS,QAAQ,GAC3B,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,GAChC,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,EAAE,EAAE,iBAAiB,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,MAAM,CACxD,SAAQ,YAAY;IACpB,IAAI,EAAE,IAAI,CAAC;CACX;AAED,MAAM,MAAM,qBAAqB,CAAC,MAAM,EAAE,UAAU,SAAS,QAAQ,IAAI,CACxE,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,KACrD,MAAM,CAAC;AAEZ,MAAM,MAAM,wBAAwB,CAAC,MAAM,IAAI,CAC9C,OAAO,EAAE,YAAY,KACjB,MAAM,CAAC;AAEZ,MAAM,WAAW,aAAa,CAAC,MAAM,EAAE,UAAU,SAAS,QAAQ;IACjE,CAAC,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC;IACpE,IAAI,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,CAAC;AAEzE,MAAM,WAAW,SAAS;IACzB,CAAC,MAAM,EAAE,SAAS,SAAS,QAAQ,EAClC,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,EACvC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,GAC7B,MAAM,CAAC;IACV,CAAC,MAAM,EAAE,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAClD"}
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/types/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,KAAK,CAChB,MAAM,EACN,SAAS,SAAS,QAAQ,GAAG,SAAS,GAAG,SAAS,IAC/C,SAAS,SAAS,QAAQ,GAC3B,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,GAChC,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,MAAM,CACxD,SAAQ,uBAAuB;IAC/B,IAAI,EAAE,IAAI,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,EAAE,EAAE,iBAAiB,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,MAAM,EAAE,UAAU,SAAS,QAAQ,IAAI,CACxE,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,KACrD,MAAM,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,MAAM,IAAI,CAC9C,OAAO,EAAE,uBAAuB,KAC5B,MAAM,CAAC;AAEZ;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,EAAE,UAAU,SAAS,QAAQ;IACjE,CAAC,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC;IACpE,IAAI,EAAE,UAAU,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,IAAI,CACtC,OAAO,EAAE,uBAAuB,KAC5B,MAAM,CAAC;AAEZ;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB;;;;OAIG;IACH,CAAC,MAAM,EAAE,SAAS,SAAS,QAAQ,EAClC,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,EACvC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,GAC7B,MAAM,CAAC;IAEV;;;OAGG;IACH,CAAC,MAAM,EAAE,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAClD"}

package/lib/types/modes.d.ts

@@ -1,2 +1,6 @@
+/**
+ * Which repository mode Bingo is being run in.
+ * @see {@link https://create.bingo/build/concepts/modes}
+ */
 export type ProductionMode = "setup" | "transition";
 //# sourceMappingURL=modes.d.ts.map

package/lib/types/modes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/types/modes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,YAAY,CAAC"}
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/types/modes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,YAAY,CAAC"}

package/lib/types/options.d.ts

@@ -1,11 +1,32 @@
 import { TakeInput } from "./inputs.js";
+/**
+ * Either a value, an async function, or a sync function to generate the value or undefined.
+ */
 export type LazyOptionalOption<T> = (() => Promise<T | undefined>) | (() => T | undefined) | T | undefined;
+/**
+ * "Lazy" version of an options shape: each property might be a lazy-loading function.
+ */
 export type LazyOptionalOptions<Options> = {
     [K in keyof Options]: LazyOptionalOption<Options[K]>;
 };
+/**
+ * Context provided to options preparation.
+ * @see {@link http://create.bingo/build/apis/prepare-options}
+ */
 export interface OptionsContext<Options extends object> {
+    /**
+     * Whether Bingo is being run in an "offline" mode.
+     * @see {@link http://create.bingo/build/details/contexts#options-offline}
+     */
     offline?: boolean;
+    /**
+     * Any values explicitly provided by the user.
+     */
     options: Partial<Options>;
+    /**
+     * Runs an Input.
+     * @see {@link http://create.bingo/build/details/contexts#input-take}
+     */
     take: TakeInput;
 }
 //# sourceMappingURL=options.d.ts.map

package/lib/types/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC7B,CAAC,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAC9B,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,GACrB,CAAC,GACD,SAAS,CAAC;AAEb,MAAM,MAAM,mBAAmB,CAAC,OAAO,IAAI;KACzC,CAAC,IAAI,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,EAAE,SAAS,CAAC;CAChB"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC7B,CAAC,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAC9B,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,GACrB,CAAC,GACD,SAAS,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,OAAO,IAAI;KACzC,CAAC,IAAI,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACpD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM;IACrD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1B;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;CAChB"}

package/lib/types/shapes.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * Any object containing Zod schemas that are optional.
+ * In other words, allows providing an empty object {} value.
+ */
+export type AnyOptionalShape = Record<string, z.ZodDefault<z.ZodType> | z.ZodOptional<z.ZodType>>;
+/**
+ * Any object containing Zod schemas as values.
+ */
+export type AnyShape = z.ZodRawShape;
+/**
+ * Given an object containing Zod schemas, produces the equivalent runtime type.
+ * @example
+ * ```ts
+ * InferredObject<{ value: z.ZodNumber }>
+ * ```
+ * is the same as:
+ * ```ts
+ * { value: number }
+ * ```
+ */
+export type InferredObject<OptionsShape extends AnyShape | undefined> = OptionsShape extends AnyShape ? z.infer<z.ZodObject<OptionsShape>> : undefined;
+//# sourceMappingURL=shapes.d.ts.map

package/lib/types/shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.d.ts","sourceRoot":"","sources":["../../src/types/shapes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CACpC,MAAM,EACN,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,CAAC,YAAY,SAAS,QAAQ,GAAG,SAAS,IACnE,YAAY,SAAS,QAAQ,GAC1B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,GAClC,SAAS,CAAC"}

package/lib/types/shapes.js

@@ -0,0 +1,4 @@
+// eslint-disable-next-line @eslint-community/eslint-comments/disable-enable-pair
+/* eslint-disable jsdoc/text-escaping -- https://github.com/gajus/eslint-plugin-jsdoc/issues/1360 */
+export {};
+//# sourceMappingURL=shapes.js.map

package/lib/types/shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.js","sourceRoot":"","sources":["../../src/types/shapes.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oGAAoG"}

package/lib/types/system.d.ts

@@ -1,9 +1,10 @@
 import { BingoSystem } from "bingo-systems";
 import { Display } from "../contexts/createDisplay.js";
-import { TakeInput } from "./inputs.js";
+/**
+ * Internal context in Bingo areas that rely on a CLI-style directory or display.
+ */
 export interface SystemContext extends BingoSystem {
     directory: string;
     display: Display;
-    take: TakeInput;
 }
 //# sourceMappingURL=system.d.ts.map

package/lib/types/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/types/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CAChB"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/types/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CACjB"}

package/lib/types/templates.d.ts

@@ -1,32 +1,114 @@
-import { AnyShape, InferredObject } from "../options.js";
 import { AboutBase } from "./about.js";
 import { Creation } from "./creations.js";
 import { TakeInput } from "./inputs.js";
 import { LazyOptionalOptions } from "./options.js";
+import { AnyShape, InferredObject } from "./shapes.js";
+/**
+ * Either a value or a Promise for the value.
+ */
+export type PromiseOrSync<T> = Promise<T> | T;
+/**
+ * Description of where to find a repository on GitHub.
+ */
 export interface RepositoryLocator {
+    /**
+     * Organization or user account the repository is under.
+     */
     owner: string;
+    /**
+     * Repository name within its owner.
+     */
     repository: string;
 }
+/**
+ * Description of how to setup or transition a repository given a set of options.
+ * @template OptionsShape Schemas of options the template takes in.
+ * @see {@link https://create.bingo/build/concepts/templates}
+ */
 export interface Template<OptionsShape extends AnyShape = AnyShape> extends TemplateDefinition<OptionsShape> {
+    /**
+     * Schemas of options the template takes in.
+     */
     options: OptionsShape;
 }
+/**
+ * About information for a template, including an optional repository locator.
+ */
 export interface TemplateAbout extends AboutBase {
+    /**
+     * GitHub repository locator, if this is attached to a template repository.
+     */
     repository?: RepositoryLocator;
 }
+/**
+ * Context provided to template producers.
+ * @template Options Options values as described by the template's options schema.
+ * @see {@link http://create.bingo/build/details/contexts#template-contexts}
+ */
 export interface TemplateContext<Options extends object> {
+    /**
+     * Options values as described by the template's options schema.
+     */
     options: Options;
 }
+/**
+ * Definition for creating a new Template.
+ * @template OptionsShape Schemas of options the template takes in.
+ * @see {@link https://www.create.bingo/build/apis/create-template}
+ */
 export interface TemplateDefinition<OptionsShape extends AnyShape = AnyShape> {
+    /**
+     * About information for the template, including an optional repository locator.
+     * @see {@link https://www.create.bingo/build/apis/create-template#about}
+     */
     about?: TemplateAbout;
+    /**
+     * Schemas of options the template takes in.
+     * @see {@link https://www.create.bingo/build/apis/create-template#options}
+     */
     options?: OptionsShape;
+    /**
+     * Sets up lazily load default options values.
+     * @see {@link https://www.create.bingo/build/apis/create-template#prepare}
+     */
     prepare?: TemplatePrepare<InferredObject<OptionsShape>>;
+    /**
+     * Generates the creations describing a repository made from the template.
+     * @see {@link https://www.create.bingo/build/apis/create-template#produce}
+     */
     produce: TemplateProduce<InferredObject<OptionsShape>>;
+    /**
+     * Additional production function for initializing a new repository with the template.
+     * @see {@link https://www.create.bingo/build/apis/create-template#setup}
+     */
     setup?: TemplateProduce<InferredObject<OptionsShape>>;
+    /**
+     * Additional production function for migrating an existing repository to the template.
+     * @see {@link https://www.create.bingo/build/apis/create-template#transition}
+     */
     transition?: TemplateProduce<InferredObject<OptionsShape>>;
 }
+/**
+ * Sets up lazily loaded default options values.
+ * @param context Shared helper functions and information.
+ * @see {@link https://www.create.bingo/build/apis/create-template#prepare}
+ */
 export type TemplatePrepare<Options extends object> = (context: TemplatePrepareContext<Partial<Options>>) => LazyOptionalOptions<Partial<Options>>;
+/**
+ * Shared helper functions and information passed to template options preparers.
+ * @param context Shared helper functions and information.
+ * @see {@link https://www.create.bingo/build/details/contexts#options-contexts}
+ */
 export interface TemplatePrepareContext<Options extends object> extends TemplateContext<Options> {
+    /**
+     * Runs an Input.
+     */
     take: TakeInput;
 }
-export type TemplateProduce<Options extends object> = (context: TemplateContext<Options>) => Partial<Creation>;
+/**
+ * Generates the creations describing a repository made from the template.
+ * @param context Shared helper functions and information.
+ * @see {@link https://www.create.bingo/build/apis/create-template#produce}
+ */
+export type TemplateProduce<Options extends object> = (context: TemplateContext<Options>) => PromiseOrSync<Partial<Creation>>;
 //# sourceMappingURL=templates.d.ts.map

package/lib/types/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/types/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ,CAAC,YAAY,SAAS,QAAQ,GAAG,QAAQ,CACjE,SAAQ,kBAAkB,CAAC,YAAY,CAAC;IACxC,OAAO,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC/C,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM;IACtD,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB,CAAC,YAAY,SAAS,QAAQ,GAAG,QAAQ;IAC3E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;CAC3D;AAED,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,MAAM,IAAI,CACrD,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAC7C,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3C,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,MAAM,CAC7D,SAAQ,eAAe,CAAC,OAAO,CAAC;IAChC,IAAI,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,MAAM,IAAI,CACrD,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,KAC7B,OAAO,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/types/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,YAAY,SAAS,QAAQ,GAAG,QAAQ,CACjE,SAAQ,kBAAkB,CAAC,YAAY,CAAC;IACxC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC/C;;OAEG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM;IACtD;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,YAAY,SAAS,QAAQ,GAAG,QAAQ;IAC3E;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAExD;;;OAGG;IACH,OAAO,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAEvD;;;OAGG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAEtD;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;CAC3D;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,MAAM,IAAI,CACrD,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAC7C,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,MAAM,CAC7D,SAAQ,eAAe,CAAC,OAAO,CAAC;IAChC;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,MAAM,IAAI,CACrD,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,KAC7B,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/lib/utils/tryCatch.d.ts

@@ -1,3 +1,3 @@
-export declare function tryCatchError<T>(promise: Promise<T>): Promise<T | Error>;
+export declare function tryCatchError<T>(promise: Promise<T>): Promise<Error | T>;
 export declare function tryCatchSafe<T>(promise: Promise<T>): Promise<T | undefined>;
 //# sourceMappingURL=tryCatch.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bingo",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "Delightful templates for web repositories. 💝",
   "repository": {
     "type": "git",
@@ -24,18 +24,19 @@
   "dependencies": {
     "@clack/prompts": "^0.10.0",
     "cached-factory": "^0.1.0",
+    "call-id": "^0.1.0",
     "chalk": "^5.4.1",
     "get-github-auth-token": "^0.1.1",
     "hash-object": "^5.0.1",
     "hosted-git-info": "^8.0.2",
-    "import-local-or-npx": "^0.3.0",
     "prettier": "3.5.1",
+    "read-package-up": "^11.0.0",
     "read-pkg": "^9.0.1",
     "slugify": "^1.6.6",
     "without-undefined-properties": "^0.1.1",
     "zod": "^3.24.2",
-    "bingo-fs": "^0.4.1",
-    "bingo-systems": "^0.4.1"
+    "bingo-systems": "^0.5.1",
+    "bingo-fs": "^0.5.1"
   },
   "devDependencies": {
     "@types/hosted-git-info": "3.0.5",

package/lib/cli/findPositionalFrom.d.ts

@@ -1,2 +0,0 @@
-export declare function findPositionalFrom(positionals: string[]): string | undefined;
-//# sourceMappingURL=findPositionalFrom.d.ts.map

package/lib/cli/findPositionalFrom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"findPositionalFrom.d.ts","sourceRoot":"","sources":["../../src/cli/findPositionalFrom.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,sBAMvD"}

package/lib/cli/findPositionalFrom.js

@@ -1,8 +0,0 @@
-import { isLocalPath } from "./utils.js";
-export function findPositionalFrom(positionals) {
-    const from = positionals.find((positional) => !positional.startsWith("-"));
-    return from && !isLocalPath(from) && !from.startsWith("create-")
-        ? `create-${from}`
-        : from;
-}
-//# sourceMappingURL=findPositionalFrom.js.map

package/lib/cli/findPositionalFrom.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"findPositionalFrom.js","sourceRoot":"","sources":["../../src/cli/findPositionalFrom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,WAAqB;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAE3E,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAC/D,CAAC,CAAC,UAAU,IAAI,EAAE;QAClB,CAAC,CAAC,IAAI,CAAC;AACT,CAAC"}

package/lib/cli/findPositionalFrom.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=findPositionalFrom.test.d.ts.map

package/lib/cli/findPositionalFrom.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"findPositionalFrom.test.d.ts","sourceRoot":"","sources":["../../src/cli/findPositionalFrom.test.ts"],"names":[],"mappings":""}

package/lib/cli/findPositionalFrom.test.js

@@ -1,15 +0,0 @@
-import { describe, expect, test } from "vitest";
-import { findPositionalFrom } from "./findPositionalFrom.js";
-describe("findPositionalFrom", () => {
-    test.each([
-        [[], undefined],
-        [["./create-typescript-app"], "./create-typescript-app"],
-        [["./create-typescript-app", "other"], "./create-typescript-app"],
-        [["./typescript-app"], "./typescript-app"],
-        [["create-typescript-app"], "create-typescript-app"],
-        [["typescript-app"], "create-typescript-app"],
-    ])("%j", (input, expected) => {
-        expect(findPositionalFrom(input)).toBe(expected);
-    });
-});
-//# sourceMappingURL=findPositionalFrom.test.js.map

package/lib/cli/findPositionalFrom.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"findPositionalFrom.test.js","sourceRoot":"","sources":["../../src/cli/findPositionalFrom.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,IAAI,CAAC,IAAI,CAAC;QACT,CAAC,EAAE,EAAE,SAAS,CAAC;QACf,CAAC,CAAC,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;QACxD,CAAC,CAAC,yBAAyB,EAAE,OAAO,CAAC,EAAE,yBAAyB,CAAC;QACjE,CAAC,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;QAC1C,CAAC,CAAC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;QACpD,CAAC,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;KAC7C,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/lib/cli/importers/createNpxInstallationConfirm.d.ts

@@ -1,3 +0,0 @@
-import { ClackSpinner } from "../display/createClackDisplay.js";
-export declare function createNpxInstallationConfirm(from: string, spinner: ClackSpinner, yes: boolean | undefined): () => Promise<Error | undefined>;
-//# sourceMappingURL=createNpxInstallationConfirm.d.ts.map

package/lib/cli/importers/createNpxInstallationConfirm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createNpxInstallationConfirm.d.ts","sourceRoot":"","sources":["../../../src/cli/importers/createNpxInstallationConfirm.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,OAAO,GAAG,SAAS,oCAyBxB"}

package/lib/cli/importers/createNpxInstallationConfirm.js

@@ -1,20 +0,0 @@
-import * as prompts from "@clack/prompts";
-import chalk from "chalk";
-export function createNpxInstallationConfirm(from, spinner, yes) {
-    return async () => {
-        if (yes) {
-            spinner.stop(`${chalk.blue(from)} not found locally and ${chalk.blue("--yes")} specified. ${from} will be fetched with npx. `);
-            spinner.start(`Loading ${chalk.blue(from)}`);
-            return undefined;
-        }
-        spinner.stop(`${chalk.blue(from)} not found locally and ${chalk.blue("--yes")} not specified. ${from} will need to be fetched with npx. `);
-        const allowed = await prompts.confirm({
-            message: `Ok to proceed?`,
-        });
-        if (allowed !== true) {
-            return new Error("Installation cancelled.");
-        }
-        spinner.start(`Loading ${chalk.blue(from)}`);
-    };
-}
-//# sourceMappingURL=createNpxInstallationConfirm.js.map

package/lib/cli/importers/createNpxInstallationConfirm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createNpxInstallationConfirm.js","sourceRoot":"","sources":["../../../src/cli/importers/createNpxInstallationConfirm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,UAAU,4BAA4B,CAC3C,IAAY,EACZ,OAAqB,EACrB,GAAwB;IAExB,OAAO,KAAK,IAAI,EAAE;QACjB,IAAI,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CACX,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,6BAA6B,CAChH,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7C,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,IAAI,CACX,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,qCAAqC,CAC5H,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC;YACrC,OAAO,EAAE,gBAAgB;SACzB,CAAC,CAAC;QAEH,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC;AACH,CAAC"}

package/lib/cli/importers/createNpxInstallationConfirm.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=createNpxInstallationConfirm.test.d.ts.map

package/lib/cli/importers/createNpxInstallationConfirm.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createNpxInstallationConfirm.test.d.ts","sourceRoot":"","sources":["../../../src/cli/importers/createNpxInstallationConfirm.test.ts"],"names":[],"mappings":""}