@voltro/plugin-inventory 0.0.0-stage → 0.88.0

package/dist/components.js

@@ -0,0 +1,320 @@
+import { identifier as e, integer as t, list as n } from "./capture.js";
+import { defineRecipe as r } from "./crafting.js";
+import { captureInventoryPresentation as i, inventoryCanEquip as a, inventoryRecipePreview as o } from "./inventoryPresentation.js";
+import { inventoryUiCopy as s } from "./inventoryUiCopy.js";
+import { useId as c, useMemo as l, useRef as u, useState as d } from "react";
+import { Button as f } from "@voltro/ui-shadcn";
+import { Fragment as p, jsx as m, jsxs as h } from "react/jsx-runtime";
+// src/components.tsx
+var g = (e) => e.copy ?? s[e.locale ?? "en"], _ = "min-h-11 min-w-0 rounded-md border border-input bg-background px-3 text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", v = (e) => {
+	let t = g(e), n = e.item, r = n.content ? e.title(n.content.display.nameKey) : n.instance.itemId;
+	return /* @__PURE__ */ h("article", {
+		className: "flex h-full min-w-0 items-center gap-4 border-b border-border px-4 py-3",
+		children: [
+			e.renderIcon ? /* @__PURE__ */ m("div", {
+				className: "size-12 shrink-0 overflow-hidden rounded-xl",
+				children: e.renderIcon(n)
+			}) : null,
+			/* @__PURE__ */ h("div", {
+				className: "min-w-0 flex-1",
+				children: [
+					/* @__PURE__ */ m("h3", {
+						className: "line-clamp-2 break-words font-medium",
+						title: r,
+						children: r
+					}),
+					/* @__PURE__ */ m("p", {
+						className: "text-sm tabular-nums text-muted-foreground",
+						children: t.quantity(n.instance.qty)
+					}),
+					/* @__PURE__ */ m("p", {
+						className: "line-clamp-2 text-sm text-muted-foreground",
+						children: [
+							n.equipped ? t.equipped : null,
+							n.instance.locked ? t.locked : null,
+							n.expired ? t.expired : null,
+							n.content ? null : t.unknown
+						].filter(Boolean).join(" · ")
+					})
+				]
+			}),
+			e.onSelect ? /* @__PURE__ */ m(f, {
+				type: "button",
+				variant: "outline",
+				className: "min-h-11 shrink-0",
+				"aria-label": `${t.select}: ${r}`,
+				"aria-disabled": e.busy || n.expired || n.instance.locked,
+				onClick: () => {
+					e.busy || n.expired || n.instance.locked || e.onSelect?.(n.instance.id);
+				},
+				children: t.select
+			}) : null
+		]
+	});
+}, y = (e) => {
+	let t = g(e), n = c(), r = c(), a = c(), o = u(null), [s, y] = d(""), [b, x] = d(""), [S, C] = d(!1), [w, T] = d(0), [E, D] = d(), O = l(() => {
+		if (e.source.error !== void 0 || e.catalog.error !== void 0) return { failed: !0 };
+		if (e.source.data === void 0 || e.catalog.data === void 0) return { failed: !1 };
+		try {
+			return {
+				failed: !1,
+				view: i(e.source.data, e.catalog.data, [], e.at)
+			};
+		} catch {
+			return { failed: !0 };
+		}
+	}, [
+		e.source.data,
+		e.source.error,
+		e.catalog.data,
+		e.catalog.error,
+		e.at
+	]), k = O.view, A = [...new Set(k?.catalog.items.flatMap((e) => e.tags) ?? [])].sort(), j = k?.items.filter((t) => (!b || t.content?.tags.includes(b)) && (t.content ? e.title(t.content.display.nameKey) : t.instance.itemId).toLocaleLowerCase(e.locale ?? "en").includes(s.toLocaleLowerCase(e.locale ?? "en"))) ?? [], M = Math.max(0, Math.min(j.length, Math.floor(w / 144) - 2)), N = Math.min(j.length, M + 10), P = S ? j.map((e, t) => t) : Array.from({ length: N - M }, (e, t) => M + t), F = j.findIndex((e) => e.instance.id === E);
+	!S && F >= 0 && !P.includes(F) && P.push(F), P.sort((e, t) => e - t);
+	let I = () => {
+		T(0), o.current && (o.current.scrollTop = 0);
+	};
+	return /* @__PURE__ */ h("section", {
+		"aria-labelledby": n,
+		className: "min-w-0 space-y-5",
+		children: [/* @__PURE__ */ m("h2", {
+			id: n,
+			className: "text-2xl font-semibold",
+			children: t.inventory
+		}), O.failed ? /* @__PURE__ */ m("p", {
+			role: "alert",
+			children: t.unavailable
+		}) : !k || e.source.loading || e.catalog.loading ? /* @__PURE__ */ m("p", {
+			role: "status",
+			children: t.loading
+		}) : /* @__PURE__ */ h(p, { children: [
+			/* @__PURE__ */ h("div", {
+				className: "grid grid-cols-1 items-end gap-4 sm:grid-cols-[minmax(0,1fr)_auto_auto]",
+				children: [
+					/* @__PURE__ */ h("label", {
+						htmlFor: r,
+						className: "flex min-w-0 flex-col gap-2 text-sm",
+						children: [t.search, /* @__PURE__ */ m("input", {
+							id: r,
+							type: "search",
+							maxLength: 120,
+							className: _,
+							value: s,
+							onChange: (e) => {
+								y(e.target.value), I();
+							}
+						})]
+					}),
+					/* @__PURE__ */ h("label", {
+						htmlFor: a,
+						className: "flex min-w-0 flex-col gap-2 text-sm",
+						children: [t.tag, /* @__PURE__ */ h("select", {
+							id: a,
+							className: _,
+							value: b,
+							onChange: (e) => {
+								x(e.target.value), I();
+							},
+							children: [/* @__PURE__ */ m("option", {
+								value: "",
+								children: t.allTags
+							}), A.map((e) => /* @__PURE__ */ m("option", {
+								value: e,
+								children: e
+							}, e))]
+						})]
+					}),
+					/* @__PURE__ */ m(f, {
+						type: "button",
+						variant: "outline",
+						"aria-pressed": S,
+						className: "min-h-11",
+						onClick: () => {
+							C((e) => !e), I();
+						},
+						children: S ? t.virtualize : t.showAll
+					})
+				]
+			}),
+			/* @__PURE__ */ m("p", {
+				role: "status",
+				className: "text-sm tabular-nums text-muted-foreground",
+				children: t.count(j.length, k.items.length)
+			}),
+			j.length === 0 ? /* @__PURE__ */ m("p", { children: k.items.length === 0 ? t.empty : t.noMatches }) : /* @__PURE__ */ m("div", {
+				ref: o,
+				className: "max-h-[36rem] overflow-y-auto rounded-xl border border-border",
+				onScroll: (e) => T(e.currentTarget.scrollTop),
+				children: /* @__PURE__ */ m("ul", {
+					className: S ? "" : "relative",
+					style: S ? void 0 : { height: j.length * 144 },
+					onBlur: (e) => {
+						e.currentTarget.contains(e.relatedTarget) || D(void 0);
+					},
+					children: P.map((t) => {
+						let n = j[t];
+						return /* @__PURE__ */ m("li", {
+							"aria-setsize": j.length,
+							"aria-posinset": t + 1,
+							onFocus: () => D(n.instance.id),
+							style: S ? void 0 : {
+								position: "absolute",
+								top: t * 144,
+								height: 144,
+								width: "100%"
+							},
+							children: /* @__PURE__ */ m(v, {
+								item: n,
+								title: e.title,
+								renderIcon: e.renderIcon,
+								locale: e.locale,
+								copy: e.copy,
+								onSelect: e.onSelect,
+								busy: e.busy
+							})
+						}, n.instance.id);
+					})
+				})
+			})
+		] })]
+	});
+}, b = (t) => {
+	let r = g(t), o = c(), s, l = [], u = !1;
+	try {
+		if (e(t.slotSet), l = n(t.slots, 64).map(e), new Set(l).size !== l.length) throw Error("Repeated slot");
+		u = [
+			t.source,
+			t.catalog,
+			t.loadout
+		].some((e) => e.error !== void 0), !u && t.source.data !== void 0 && t.catalog.data !== void 0 && t.loadout.data !== void 0 && (s = i(t.source.data, t.catalog.data, t.loadout.data, t.at));
+	} catch {
+		u = !0;
+	}
+	let d = s;
+	return /* @__PURE__ */ h("section", {
+		"aria-labelledby": o,
+		className: "min-w-0 space-y-5",
+		children: [/* @__PURE__ */ m("h2", {
+			id: o,
+			className: "text-2xl font-semibold",
+			children: r.loadout
+		}), u ? /* @__PURE__ */ m("p", {
+			role: "alert",
+			children: r.unavailable
+		}) : !d || t.source.loading || t.catalog.loading || t.loadout.loading ? /* @__PURE__ */ m("p", {
+			role: "status",
+			children: r.loading
+		}) : /* @__PURE__ */ m("div", {
+			className: "grid grid-cols-1 gap-5 sm:grid-cols-2",
+			children: l.map((n) => {
+				let i = d.loadout.find((e) => e.slotSet === t.slotSet && e.slot === n)?.instanceId ?? "", s = d.items.filter((e) => a(e, n) || e.instance.id === i), c = o + "." + n;
+				return /* @__PURE__ */ h("label", {
+					htmlFor: c,
+					className: "flex min-w-0 flex-col gap-2 text-sm",
+					children: [t.title(n), /* @__PURE__ */ h("select", {
+						id: c,
+						className: _,
+						disabled: t.busy,
+						value: i,
+						onChange: (r) => {
+							let i = r.target.value || null;
+							!t.busy && (i === null || s.some((e) => e.instance.id === i && a(e, n))) && t.onEquip(Object.freeze({
+								slotSet: t.slotSet,
+								slot: n,
+								instanceId: i,
+								requestId: e(t.requestId())
+							}));
+						},
+						children: [/* @__PURE__ */ m("option", {
+							value: "",
+							children: r.unequipped
+						}), s.map((e) => /* @__PURE__ */ m("option", {
+							value: e.instance.id,
+							disabled: !a(e, n),
+							children: e.content ? t.title(e.content.display.nameKey) : e.instance.itemId
+						}, e.instance.id))]
+					})]
+				}, n);
+			})
+		})]
+	});
+}, x = (e) => {
+	let n = g(e), r = c(), [i, a] = d(1), s = Math.min(i, e.recipe.maxBatches), l = o(e.view, e.recipe, s, e.at);
+	return /* @__PURE__ */ h("article", {
+		className: "min-w-0 space-y-4 border-b border-border pb-5",
+		children: [
+			/* @__PURE__ */ m("h3", {
+				className: "break-words text-lg font-medium",
+				children: e.title(l.recipe.id)
+			}),
+			/* @__PURE__ */ h("label", {
+				htmlFor: r,
+				className: "flex items-center gap-3 text-sm",
+				children: [n.batches, /* @__PURE__ */ m("select", {
+					id: r,
+					className: _,
+					value: s,
+					onChange: (e) => a(t(Number(e.target.value), 1, l.recipe.maxBatches)),
+					children: Array.from({ length: l.recipe.maxBatches }, (e, t) => t + 1).map((e) => /* @__PURE__ */ m("option", {
+						value: e,
+						children: e
+					}, e))
+				})]
+			}),
+			/* @__PURE__ */ h("dl", {
+				className: "grid grid-cols-[minmax(0,1fr)_minmax(0,2fr)] gap-x-4 gap-y-2 text-sm",
+				children: [
+					/* @__PURE__ */ m("dt", {
+						className: "text-muted-foreground",
+						children: n.materials
+					}),
+					/* @__PURE__ */ m("dd", {
+						className: "break-words",
+						children: l.recipe.inputs.map((t) => `${t.qty * s} × ${e.title(t.itemId)}`).join(", ")
+					}),
+					/* @__PURE__ */ m("dt", {
+						className: "text-muted-foreground",
+						children: n.currencyCost
+					}),
+					/* @__PURE__ */ m("dd", {
+						className: "break-words tabular-nums",
+						children: l.currencyCost ? `${l.currencyCost.amount} ${e.currencyLabel?.(l.currencyCost.currency) ?? l.currencyCost.currency}` : n.freeCost
+					})
+				]
+			}),
+			/* @__PURE__ */ m("p", {
+				role: "status",
+				className: "text-sm",
+				children: l.materialsAvailable ? n.materialsReady : n.materialsMissing
+			}),
+			e.renderAction?.(l.recipe, s, l.materialsAvailable)
+		]
+	});
+}, S = (e) => {
+	let t = g(e), i = c(), a = [], s = !1;
+	try {
+		if (a = n(e.recipes, 256).map((e) => r(e)), new Set(a.map((e) => e.id)).size !== a.length) throw Error("Repeated recipe");
+		for (let t of a) o(e.view, t, 1, e.at);
+	} catch {
+		s = !0;
+	}
+	return /* @__PURE__ */ h("section", {
+		"aria-labelledby": i,
+		className: "min-w-0 space-y-5",
+		children: [/* @__PURE__ */ m("h2", {
+			id: i,
+			className: "text-2xl font-semibold",
+			children: t.recipes
+		}), s ? /* @__PURE__ */ m("p", {
+			role: "alert",
+			children: t.unavailable
+		}) : a.length === 0 ? /* @__PURE__ */ m("p", { children: t.empty }) : /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m("p", {
+			className: "max-w-prose text-sm leading-relaxed text-muted-foreground",
+			children: t.serverCraft
+		}), a.map((t) => /* @__PURE__ */ m(x, {
+			...e,
+			recipe: t
+		}, `${t.id}:${t.version}`))] })]
+	});
+};
+export { S as CraftingPanel, y as InventoryGrid, v as ItemCard, b as LoadoutEditor, i as captureInventoryPresentation, a as inventoryCanEquip, o as inventoryRecipePreview, s as inventoryUiCopy };

package/dist/crafting.d.ts

@@ -0,0 +1,211 @@
+import { Context } from 'effect';
+import { Effect } from 'effect';
+import { PluginPrivacyTarget } from '@voltro/protocol';
+import { PreparedSqlMutation } from '@voltro/database/sql';
+import { Schema } from 'effect';
+import { Subject } from '@voltro/protocol';
+import { YieldableError } from 'effect/Cause';
+
+/** Admit actual child receipt or retained craft evidence without rerunning a wallet callback. */
+export declare const captureCraftPayment: (input: unknown, recipe: Recipe, batches: number) => CraftPaymentReceipt | null;
+
+/** Admit retained intent without calling historical custom policies. */
+export declare const captureCraftPlan: (original: unknown, input: CraftInput) => CraftPlan;
+
+export declare interface CraftEconomyParticipant {
+    readonly prepareTransfer: (subject: Subject, input: {
+        readonly tenantId: string;
+        readonly requestId: string;
+        readonly currency: string;
+        readonly amount: string;
+        readonly from: {
+            readonly kind: 'wallet';
+            readonly ownerKind: 'player' | 'guild';
+            readonly ownerId: string;
+        };
+        readonly to: {
+            readonly kind: 'system';
+            readonly id: string;
+        };
+        readonly reason: string;
+        readonly ref: {
+            readonly kind: string;
+            readonly id: string;
+        };
+    }) => Effect.Effect<PreparedSqlMutation<CraftPaymentReceipt>, {
+        readonly code: string;
+    }>;
+}
+
+export declare interface CraftingOptions {
+    readonly recipes: readonly (RecipeDefinition | Recipe)[];
+    readonly craftResolver?: CraftResolver | undefined;
+    readonly version?: string | undefined;
+    readonly service?: CraftingService | undefined;
+    readonly economy?: CraftEconomyParticipant | undefined;
+    readonly systemAccount?: string | undefined;
+}
+
+export declare class CraftingPort extends CraftingPort_base {
+}
+
+declare const CraftingPort_base: Context.ServiceClass<CraftingPort, "@voltro/CraftingPort", CraftingService>;
+
+/** Small independent seam; InventoryPort retains its eight-method surface. */
+export declare interface CraftingService {
+    readonly craft: (subject: Subject, input: CraftRequest) => Effect.Effect<InventoryReceipt, InventoryError>;
+    readonly recipes: (subject: Subject) => Effect.Effect<readonly Recipe[], InventoryError>;
+    readonly exportSubject: (target: PluginPrivacyTarget) => Effect.Effect<unknown, InventoryError>;
+    readonly eraseSubject: (target: PluginPrivacyTarget) => Effect.Effect<void, InventoryError>;
+}
+
+export declare interface CraftInput {
+    readonly recipe: Recipe;
+    readonly batches: number;
+    readonly at: number;
+    readonly available: readonly InventoryInstance[];
+    readonly excludedIds: readonly string[];
+}
+
+export declare interface CraftPaymentReceipt {
+    readonly txId: string;
+    readonly currency: string;
+    readonly amount: string;
+    readonly at: number;
+}
+
+export declare interface CraftPlan {
+    readonly consume: readonly {
+        readonly instanceId: string;
+        readonly qty: number;
+    }[];
+    readonly outputs: readonly RecipeOutput[];
+}
+
+export declare interface CraftRequest {
+    readonly tenantId: string;
+    readonly owner: InventoryOwner;
+    readonly recipeId: string;
+    readonly requestId: string;
+    readonly batches?: number;
+}
+
+export declare type CraftResolver = (input: CraftInput) => CraftPlan;
+
+/** Deterministic oldest acquisitions first; equipped, locked and expired items never enter a recipe. */
+export declare const defaultCraftResolver: CraftResolver;
+
+/** Immediate recipe; currency cost requires an installed exact-store prepared participant. Duration/prerequisites refuse. */
+export declare const defineRecipe: (input: RecipeDefinition) => Recipe;
+
+/** Public errors carry codes, never subjects, catalog values or provider causes. */
+declare class InventoryError extends InventoryError_base {
+}
+
+declare const InventoryError_base: Schema.Class<InventoryError, Schema.TaggedStruct<"InventoryError", {
+    readonly code: Schema.Literals<readonly ["invalid_input", "invalid_record", "invalid_item", "invalid_attributes", "conflict", "forbidden", "not_found", "unavailable", "limit_exceeded", "erased", "insufficient_items", "insufficient_funds", "payment_refused", "locked", "expired", "invalid_slot"]>;
+}>, YieldableError>;
+
+declare interface InventoryInstance {
+    readonly id: string;
+    readonly itemId: string;
+    readonly schemaVersion: number;
+    readonly qty: number;
+    readonly attributes: JsonValue;
+    readonly acquiredAt: number;
+    readonly expiresAt: number | null;
+    readonly locked: boolean;
+    readonly source: string;
+}
+
+declare interface InventoryOwner {
+    readonly ownerKind: 'player' | 'guild';
+    readonly ownerId: string;
+}
+
+declare interface InventoryReceipt {
+    readonly operationId: string;
+    readonly kind: 'grant' | 'consume' | 'equip' | 'expire' | 'craft' | 'reserve' | 'release' | 'transfer-out' | 'transfer-in';
+    readonly changes: readonly {
+        readonly instanceId: string;
+        readonly delta: number;
+    }[];
+    readonly at: number;
+}
+
+declare type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+
+export declare interface Recipe {
+    readonly id: string;
+    readonly version: number;
+    readonly inputs: readonly RecipeIngredient[];
+    readonly outputs: readonly RecipeOutput[];
+    readonly maxBatches: number;
+    readonly cost: RecipeCurrencyCost | null;
+    readonly timeMs: 0;
+    readonly requires: null;
+}
+
+export declare interface RecipeCurrencyCost {
+    readonly currency: string;
+    readonly amount: string;
+}
+
+export declare interface RecipeDefinition {
+    readonly id: string;
+    readonly version?: number;
+    readonly inputs: readonly RecipeIngredient[];
+    readonly outputs: readonly RecipeOutput[];
+    readonly maxBatches?: number;
+    readonly cost?: RecipeCurrencyCost | null;
+    readonly timeMs?: 0;
+    readonly requires?: null;
+}
+
+export declare interface RecipeIngredient {
+    readonly itemId: string;
+    readonly qty: number;
+}
+
+export declare interface RecipeOutput extends RecipeIngredient {
+    readonly attributes?: JsonValue;
+}
+
+export declare const resolveCraftingOptions: (input: CraftingOptions) => Readonly<{
+    economy: Readonly<{
+        prepareTransfer: (subject: Subject, input: {
+            readonly tenantId: string;
+            readonly requestId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly from: {
+                readonly kind: "wallet";
+                readonly ownerKind: "player" | "guild";
+                readonly ownerId: string;
+            };
+            readonly to: {
+                readonly kind: "system";
+                readonly id: string;
+            };
+            readonly reason: string;
+            readonly ref: {
+                readonly kind: string;
+                readonly id: string;
+            };
+        }) => Effect.Effect<PreparedSqlMutation<CraftPaymentReceipt>, {
+            readonly code: string;
+        }>;
+    }> | undefined;
+    systemAccount: string | undefined;
+    recipes: readonly Recipe[];
+    craftResolver: CraftResolver;
+    version: string;
+    service: CraftingService | undefined;
+}>;
+
+/** Custom selection may choose instances and valid output attributes, never amounts or additional value. */
+export declare const resolveCraftPlan: (input: CraftInput, resolver?: CraftResolver) => CraftPlan;
+
+export { }