@mulmoclaude/accounting-plugin 0.1.0

package/dist/shared/currencies.d.ts

@@ -0,0 +1,34 @@
+/** ISO 4217 codes shown in the New Book dropdown. Curated for
+ *  recognisability — Intl.DisplayNames provides the localised
+ *  human name at render time, so this stays a flat list of codes. */
+export declare const SUPPORTED_CURRENCY_CODES: readonly ["USD", "EUR", "JPY", "GBP", "CNY", "KRW", "TWD", "HKD", "SGD", "AUD", "CAD", "CHF", "INR", "BRL", "MXN"];
+export type SupportedCurrencyCode = (typeof SUPPORTED_CURRENCY_CODES)[number];
+/** Localised human name for a currency code. Falls back to the
+ *  code itself if the runtime can't resolve the name. */
+export declare function localizedCurrencyName(code: string, locale: string): string;
+/** Number of fraction digits ISO 4217 specifies for a currency.
+ *  JPY = 0, USD = 2, KWD = 3. Used both for amount formatting and
+ *  for the HTML input step on debit/credit fields. */
+export declare function fractionDigitsFor(currency: string): number;
+/** "1" for JPY, "0.01" for USD, "0.001" for KWD. Used as the HTML
+ *  input step on debit/credit fields so a JPY book doesn't let the
+ *  user type cents that would just round-trip back through the
+ *  decimal validator. */
+export declare function inputStepFor(currency: string): string;
+/** Locale-aware currency formatter — returns "¥1,130" / "$1,130.00"
+ *  etc. Falls back to fixed-point formatting if the runtime can't
+ *  resolve the currency code; the fallback still respects the
+ *  currency's natural fraction-digit count so JPY shows whole
+ *  numbers even on the slow path. */
+export declare function formatAmount(value: number, currency: string, locale?: string): string;
+/** Currency-agnostic amount formatter — "1,130.00" — for places that
+ *  don't carry the currency code on the data path (compact preview
+ *  envelopes etc.). Use `formatAmount(value, currency)` whenever the
+ *  currency IS available — the currency-aware path picks the right
+ *  fraction-digit count automatically (JPY = 0, USD = 2).
+ *
+ *  `locale` mirrors `formatAmount`'s signature: pass an explicit BCP-47
+ *  locale (`"en-US"`, `"ja-JP"`, …) when the caller knows the desired
+ *  grouping / digit-shape; omit to fall back to the runtime default. */
+export declare function formatAmountNumeric(value: number, decimals?: number, locale?: string): string;
+//# sourceMappingURL=currencies.d.ts.map

package/dist/shared/currencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.d.ts","sourceRoot":"","sources":["../../src/shared/currencies.ts"],"names":[],"mappings":"AAWA;;qEAEqE;AACrE,eAAO,MAAM,wBAAwB,oHAAqH,CAAC;AAE3J,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAI9E;yDACyD;AACzD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED;;sDAEsD;AACtD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;yBAGyB;AACzB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;;qCAIqC;AACrC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMrF;AAED;;;;;;;;wEAQwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAExF"}

package/dist/shared/dates.d.ts

@@ -0,0 +1,15 @@
+/** Today as `YYYY-MM-DD` in the user's local timezone. */
+export declare function localDateString(now?: Date): string;
+/** Current month as `YYYY-MM` in the user's local timezone. */
+export declare function localMonthString(now?: Date): string;
+/** First day of the current calendar year as `YYYY-MM-DD`. */
+export declare function localStartOfYearString(now?: Date): string;
+/** Previous calendar month as `YYYY-MM` in the user's local timezone. */
+export declare function previousMonthString(now?: Date): string;
+/** Last month of the previous calendar quarter as `YYYY-MM`. Calendar
+ *  quarters: Q1=Jan–Mar, Q2=Apr–Jun, Q3=Jul–Sep, Q4=Oct–Dec. When the
+ *  current month is in Q1, this rolls back to December of last year. */
+export declare function lastMonthOfPreviousQuarterString(now?: Date): string;
+/** December of the previous calendar year as `YYYY-MM`. */
+export declare function decemberOfPreviousYearString(now?: Date): string;
+//# sourceMappingURL=dates.d.ts.map

package/dist/shared/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/shared/dates.ts"],"names":[],"mappings":"AAiBA,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAE9D;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAE/D;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAErE;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAGlE;AAED;;wEAEwE;AACxE,wBAAgB,gCAAgC,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAI/E;AAED,2DAA2D;AAC3D,wBAAgB,4BAA4B,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAE3E"}

package/dist/shared/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function errorMessage(err: unknown, fallback?: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CASpE"}

package/dist/shared/fiscalYear.d.ts

@@ -0,0 +1,22 @@
+export declare const FISCAL_YEAR_ENDS: readonly ["Q1", "Q2", "Q3", "Q4"];
+export type FiscalYearEnd = (typeof FISCAL_YEAR_ENDS)[number];
+export declare const DEFAULT_FISCAL_YEAR_END: FiscalYearEnd;
+export declare function isFiscalYearEnd(value: unknown): value is FiscalYearEnd;
+/** Books written before the field existed are treated as Q4 in code
+ *  but never auto-rewritten on disk. The settings UI persists through
+ *  the field the next time the user saves anything on the book. */
+export declare function resolveFiscalYearEnd(value: FiscalYearEnd | undefined): FiscalYearEnd;
+/** Last calendar month (1-12) of the fiscal year for the given Q. */
+export declare function fiscalYearEndMonth(end: FiscalYearEnd): 3 | 6 | 9 | 12;
+export interface DateRange {
+    /** Inclusive lower bound (YYYY-MM-DD). Empty string = unbounded. */
+    from: string;
+    /** Inclusive upper bound (YYYY-MM-DD). Empty string = unbounded. */
+    to: string;
+}
+export declare function currentQuarterRange(end: FiscalYearEnd, today?: Date): DateRange;
+export declare function previousQuarterRange(end: FiscalYearEnd, today?: Date): DateRange;
+/** Current fiscal year — Q0 start through Q3 close. */
+export declare function currentFiscalYearRange(end: FiscalYearEnd, today?: Date): DateRange;
+export declare function previousFiscalYearRange(end: FiscalYearEnd, today?: Date): DateRange;
+//# sourceMappingURL=fiscalYear.d.ts.map

package/dist/shared/fiscalYear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscalYear.d.ts","sourceRoot":"","sources":["../../src/shared/fiscalYear.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,gBAAgB,mCAAoC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,uBAAuB,EAAE,aAAoB,CAAC;AAE3D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;mEAEmE;AACnE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAEpF;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAKrE;AAED,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;CACZ;AA8DD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,GAAE,IAAiB,GAAG,SAAS,CAE3F;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,GAAE,IAAiB,GAAG,SAAS,CAQ5F;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,GAAE,IAAiB,GAAG,SAAS,CAI9F;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,GAAE,IAAiB,GAAG,SAAS,CAI/F"}

package/dist/shared/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./actions";
+export * from "./channels";
+export * from "./errors";
+export * from "./fiscalYear";
+export * from "./countries";
+export * from "./currencies";
+export * from "./dates";
+export * from "./timeSeriesEnums";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAKA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}

package/dist/shared/timeSeriesEnums.d.ts

@@ -0,0 +1,5 @@
+export declare const TIME_SERIES_METRICS: readonly ["revenue", "expense", "netIncome", "accountBalance"];
+export type TimeSeriesMetric = (typeof TIME_SERIES_METRICS)[number];
+export declare const TIME_SERIES_GRANULARITIES: readonly ["month", "quarter", "year"];
+export type TimeSeriesGranularity = (typeof TIME_SERIES_GRANULARITIES)[number];
+//# sourceMappingURL=timeSeriesEnums.d.ts.map

package/dist/shared/timeSeriesEnums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeriesEnums.d.ts","sourceRoot":"","sources":["../../src/shared/timeSeriesEnums.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,mBAAmB,gEAAiE,CAAC;AAClG,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,yBAAyB,uCAAwC,CAAC;AAC/E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/shared.cjs

@@ -0,0 +1,466 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/shared/actions.ts
+var ACCOUNTING_ACTIONS = {
+	openBook: "openBook",
+	getBooks: "getBooks",
+	createBook: "createBook",
+	updateBook: "updateBook",
+	deleteBook: "deleteBook",
+	getAccounts: "getAccounts",
+	upsertAccount: "upsertAccount",
+	addEntries: "addEntries",
+	voidEntry: "voidEntry",
+	getJournalEntries: "getJournalEntries",
+	getOpeningBalances: "getOpeningBalances",
+	setOpeningBalances: "setOpeningBalances",
+	getReport: "getReport",
+	getTimeSeries: "getTimeSeries",
+	rebuildSnapshots: "rebuildSnapshots"
+};
+//#endregion
+//#region src/shared/channels.ts
+/** Channel factory for per-book event streams. Subscribers:
+*  `useAccountingChannel(bookId)`. Publisher: the package's server
+*  surface `eventPublisher`. */
+function bookChannel(bookId) {
+	return `accounting:${bookId}`;
+}
+/** Book-list-level channel — a book was created / deleted. Subscribers
+*  refetch the BookSwitcher dropdown. Mirrors the host META's
+*  `staticChannels.accountingBooks` literal (kept in sync by value;
+*  the host META stays the codegen-discoverable source for the
+*  aggregator merge). */
+var ACCOUNTING_BOOKS_CHANNEL = "accounting:books";
+/** Event kinds that ride `bookChannel(bookId)`. Single source of
+*  truth for both publishers (server/accounting) and subscribers
+*  (the View) — anyone branching on event kind imports from here
+*  and the type system catches drift on either side.
+*
+*  - `journal`             — addEntry / voidEntry hit the books at `period`.
+*                            Refetch the journal list and (if the View is
+*                            showing balances at or after `period`) the
+*                            relevant report.
+*  - `opening`             — setOpeningBalances. Affects every period from
+*                            the opening date forward; refetch everything.
+*  - `accounts`            — chart-of-accounts mutation that may affect
+*                            aggregation (account type changed). Refetch
+*                            accounts and the active report.
+*  - `snapshotsRebuilding` / `snapshotsReady` — purely informational;
+*                            the View can show a "calculating" spinner
+*                            during rebuild, but the lazy-rebuild safety
+*                            net means a refetch always returns the right
+*                            answer regardless. */
+var BOOK_EVENT_KINDS = {
+	journal: "journal",
+	opening: "opening",
+	accounts: "accounts",
+	snapshotsRebuilding: "snapshots-rebuilding",
+	snapshotsReady: "snapshots-ready"
+};
+//#endregion
+//#region src/shared/errors.ts
+function errorMessage(err, fallback) {
+	if (err instanceof Error) return err.message;
+	if (err !== null && typeof err === "object") {
+		const obj = err;
+		if (typeof obj.details === "string" && obj.details) return obj.details;
+		if (typeof obj.message === "string" && obj.message) return obj.message;
+	}
+	if (fallback !== void 0) return fallback;
+	return String(err);
+}
+//#endregion
+//#region src/shared/fiscalYear.ts
+var FISCAL_YEAR_ENDS = [
+	"Q1",
+	"Q2",
+	"Q3",
+	"Q4"
+];
+var DEFAULT_FISCAL_YEAR_END = "Q4";
+function isFiscalYearEnd(value) {
+	return typeof value === "string" && FISCAL_YEAR_ENDS.includes(value);
+}
+/** Books written before the field existed are treated as Q4 in code
+*  but never auto-rewritten on disk. The settings UI persists through
+*  the field the next time the user saves anything on the book. */
+function resolveFiscalYearEnd(value) {
+	return value ?? "Q4";
+}
+/** Last calendar month (1-12) of the fiscal year for the given Q. */
+function fiscalYearEndMonth(end) {
+	if (end === "Q1") return 3;
+	if (end === "Q2") return 6;
+	if (end === "Q3") return 9;
+	return 12;
+}
+function pad2$1(num) {
+	return String(num).padStart(2, "0");
+}
+function lastDayOfMonth(year, monthZeroBased) {
+	return new Date(year, monthZeroBased + 1, 0).getDate();
+}
+function ymd(year, monthOneBased, day) {
+	return `${year}-${pad2$1(monthOneBased)}-${pad2$1(day)}`;
+}
+/** Fiscal quarter index (0..3) of the given local date under `end`,
+*  where 0 is the first quarter of the fiscal year (right after the
+*  prior year's close) and 3 is the closing quarter. */
+function fiscalQuarterIndex(end, today) {
+	const closingMonth = fiscalYearEndMonth(end);
+	const offset = (today.getMonth() + 1 - closingMonth - 1 + 12) % 12;
+	return Math.floor(offset / 3);
+}
+/** Calendar (year, monthOneBased) of the *first* month of the fiscal
+*  quarter at index `index` in the fiscal year that *contains*
+*  `today`. Returned both as the first day of that month and as the
+*  count of months covered (always 3 — exposed as a constant). */
+function fiscalQuarterStart(end, today, index) {
+	const closingMonth = fiscalYearEndMonth(end);
+	const todayMonth = today.getMonth() + 1;
+	const todayYear = today.getFullYear();
+	const startMonth = closingMonth % 12 + 1;
+	const fyStartYear = todayMonth >= startMonth ? todayYear : todayYear - 1;
+	const flatMonth = startMonth + index * 3;
+	return {
+		year: fyStartYear + Math.floor((flatMonth - 1) / 12),
+		month: (flatMonth - 1) % 12 + 1
+	};
+}
+function quarterRangeAt(end, today, index) {
+	const start = fiscalQuarterStart(end, today, index);
+	const lastMonthFlat = start.month - 1 + 2;
+	const lastMonthYear = start.year + Math.floor(lastMonthFlat / 12);
+	const lastMonth = lastMonthFlat % 12 + 1;
+	const lastDay = lastDayOfMonth(lastMonthYear, lastMonth - 1);
+	return {
+		from: ymd(start.year, start.month, 1),
+		to: ymd(lastMonthYear, lastMonth, lastDay)
+	};
+}
+function currentQuarterRange(end, today = /* @__PURE__ */ new Date()) {
+	return quarterRangeAt(end, today, fiscalQuarterIndex(end, today));
+}
+function previousQuarterRange(end, today = /* @__PURE__ */ new Date()) {
+	const idx = fiscalQuarterIndex(end, today);
+	if (idx > 0) return quarterRangeAt(end, today, idx - 1);
+	return quarterRangeAt(end, new Date(today.getFullYear(), today.getMonth() - 3, 1), 3);
+}
+/** Current fiscal year — Q0 start through Q3 close. */
+function currentFiscalYearRange(end, today = /* @__PURE__ */ new Date()) {
+	const first = quarterRangeAt(end, today, 0);
+	const last = quarterRangeAt(end, today, 3);
+	return {
+		from: first.from,
+		to: last.to
+	};
+}
+function previousFiscalYearRange(end, today = /* @__PURE__ */ new Date()) {
+	return currentFiscalYearRange(end, new Date(today.getFullYear() - 1, today.getMonth(), today.getDate()));
+}
+//#endregion
+//#region src/shared/countries.ts
+/** ISO 3166-1 alpha-2 country codes shown in the book country
+*  dropdown. Curated to cover every jurisdiction the Accounting role
+*  has explicit tax-registration advice for, plus the major economies
+*  represented in `SUPPORTED_CURRENCY_CODES`. */
+var SUPPORTED_COUNTRY_CODES = [
+	"US",
+	"JP",
+	"GB",
+	"CA",
+	"AU",
+	"NZ",
+	"DE",
+	"FR",
+	"IT",
+	"ES",
+	"NL",
+	"BE",
+	"AT",
+	"IE",
+	"PT",
+	"FI",
+	"SE",
+	"DK",
+	"PL",
+	"CH",
+	"NO",
+	"CN",
+	"KR",
+	"TW",
+	"HK",
+	"SG",
+	"IN",
+	"BR",
+	"MX"
+];
+/** EU member states as of 2026. Used by the role-prompt advice path
+*  to recommend a VAT identification number when the book country is
+*  in the EU. */
+var EU_COUNTRY_CODES = /* @__PURE__ */ new Set([
+	"AT",
+	"BE",
+	"BG",
+	"CY",
+	"CZ",
+	"DE",
+	"DK",
+	"EE",
+	"ES",
+	"FI",
+	"FR",
+	"GR",
+	"HR",
+	"HU",
+	"IE",
+	"IT",
+	"LT",
+	"LU",
+	"LV",
+	"MT",
+	"NL",
+	"PL",
+	"PT",
+	"RO",
+	"SE",
+	"SI",
+	"SK"
+]);
+/** Localized human name for a country code. Falls back to the code
+*  itself if the runtime can't resolve the name. */
+function localizedCountryName(code, locale) {
+	try {
+		return new Intl.DisplayNames([locale], { type: "region" }).of(code) ?? code;
+	} catch {
+		return code;
+	}
+}
+/** Runtime guard for `BookSummary.country`. The type is the union
+*  `SupportedCountryCode`, but every entry point that takes user /
+*  LLM input arrives as raw `string` (form submit, JSON-RPC body),
+*  so the service layer narrows here before persisting. */
+function isSupportedCountryCode(value) {
+	return typeof value === "string" && SUPPORTED_COUNTRY_CODES.includes(value);
+}
+/** Country-gated UI features. Each key is a feature name; the value
+*  is the set of country codes for which the feature is enabled.
+*  Components ask `countryHasFeature("...", country)` instead of
+*  hard-coding country lists at the call site.
+*
+*  Add a new country-specific feature by adding a new key here and
+*  reading it via `countryHasFeature`. An unknown / undefined
+*  country never has any feature — components fall back to neutral
+*  default UI rather than guessing.
+*
+*  Mirrors the "Country-aware tax behaviour" prose in the
+*  Accounting role prompt (`src/config/roles.ts`). The two MUST
+*  stay in sync — drift means the LLM and the form give the user
+*  contradictory advice. The prompt is the source of truth for
+*  agent behaviour; this table is structured-data sibling for the
+*  form. */
+var COUNTRY_FEATURES = { 
+/** Show an amber "missing tax ID" warning + helper text on a
+*  postable 14xx (input-tax) line whose taxRegistrationId is
+*  blank. Limited to jurisdictions where the role prompt
+*  explicitly requires the counterparty registration number
+*  (JP T-number, EU VAT ID, GB VAT, GSTIN, ABN, NZ GST, CA BN).
+*  The "other countries" bucket and US (no federal sales-tax
+*  registration) intentionally stay quiet. 24xx output-tax
+*  lines don't trigger the warning — see `isTaxAccountCode`. */
+warnMissingTaxRegistrationId: /* @__PURE__ */ new Set([
+	"JP",
+	"GB",
+	"DE",
+	"FR",
+	"IT",
+	"ES",
+	"NL",
+	"BE",
+	"AT",
+	"IE",
+	"PT",
+	"FI",
+	"SE",
+	"DK",
+	"PL",
+	"IN",
+	"AU",
+	"NZ",
+	"CA"
+]) };
+/** Resolve a country-gated feature flag. Returns `false` when the
+*  country is undefined / unsupported — components default to the
+*  neutral path (no warning, no extra UI) rather than guessing. */
+function countryHasFeature(feature, country) {
+	if (!country) return false;
+	return COUNTRY_FEATURES[feature].has(country);
+}
+//#endregion
+//#region src/shared/currencies.ts
+/** ISO 4217 codes shown in the New Book dropdown. Curated for
+*  recognisability — Intl.DisplayNames provides the localised
+*  human name at render time, so this stays a flat list of codes. */
+var SUPPORTED_CURRENCY_CODES = [
+	"USD",
+	"EUR",
+	"JPY",
+	"GBP",
+	"CNY",
+	"KRW",
+	"TWD",
+	"HKD",
+	"SGD",
+	"AUD",
+	"CAD",
+	"CHF",
+	"INR",
+	"BRL",
+	"MXN"
+];
+var DEFAULT_FALLBACK_DIGITS = 2;
+/** Localised human name for a currency code. Falls back to the
+*  code itself if the runtime can't resolve the name. */
+function localizedCurrencyName(code, locale) {
+	try {
+		return new Intl.DisplayNames([locale], { type: "currency" }).of(code) ?? code;
+	} catch {
+		return code;
+	}
+}
+/** Number of fraction digits ISO 4217 specifies for a currency.
+*  JPY = 0, USD = 2, KWD = 3. Used both for amount formatting and
+*  for the HTML input step on debit/credit fields. */
+function fractionDigitsFor(currency) {
+	try {
+		return new Intl.NumberFormat("en", {
+			style: "currency",
+			currency
+		}).resolvedOptions().maximumFractionDigits ?? DEFAULT_FALLBACK_DIGITS;
+	} catch {
+		return DEFAULT_FALLBACK_DIGITS;
+	}
+}
+/** "1" for JPY, "0.01" for USD, "0.001" for KWD. Used as the HTML
+*  input step on debit/credit fields so a JPY book doesn't let the
+*  user type cents that would just round-trip back through the
+*  decimal validator. */
+function inputStepFor(currency) {
+	const digits = fractionDigitsFor(currency);
+	if (digits === 0) return "1";
+	return (1 / 10 ** digits).toFixed(digits);
+}
+/** Locale-aware currency formatter — returns "¥1,130" / "$1,130.00"
+*  etc. Falls back to fixed-point formatting if the runtime can't
+*  resolve the currency code; the fallback still respects the
+*  currency's natural fraction-digit count so JPY shows whole
+*  numbers even on the slow path. */
+function formatAmount(value, currency, locale) {
+	try {
+		return new Intl.NumberFormat(locale, {
+			style: "currency",
+			currency
+		}).format(value);
+	} catch {
+		return value.toFixed(fractionDigitsFor(currency));
+	}
+}
+/** Currency-agnostic amount formatter — "1,130.00" — for places that
+*  don't carry the currency code on the data path (compact preview
+*  envelopes etc.). Use `formatAmount(value, currency)` whenever the
+*  currency IS available — the currency-aware path picks the right
+*  fraction-digit count automatically (JPY = 0, USD = 2).
+*
+*  `locale` mirrors `formatAmount`'s signature: pass an explicit BCP-47
+*  locale (`"en-US"`, `"ja-JP"`, …) when the caller knows the desired
+*  grouping / digit-shape; omit to fall back to the runtime default. */
+function formatAmountNumeric(value, decimals = 2, locale) {
+	return value.toLocaleString(locale, {
+		minimumFractionDigits: decimals,
+		maximumFractionDigits: decimals
+	});
+}
+//#endregion
+//#region src/shared/dates.ts
+function pad2(num) {
+	return String(num).padStart(2, "0");
+}
+/** Today as `YYYY-MM-DD` in the user's local timezone. */
+function localDateString(now = /* @__PURE__ */ new Date()) {
+	return `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}`;
+}
+/** Current month as `YYYY-MM` in the user's local timezone. */
+function localMonthString(now = /* @__PURE__ */ new Date()) {
+	return `${now.getFullYear()}-${pad2(now.getMonth() + 1)}`;
+}
+/** First day of the current calendar year as `YYYY-MM-DD`. */
+function localStartOfYearString(now = /* @__PURE__ */ new Date()) {
+	return `${now.getFullYear()}-01-01`;
+}
+/** Previous calendar month as `YYYY-MM` in the user's local timezone. */
+function previousMonthString(now = /* @__PURE__ */ new Date()) {
+	const target = new Date(now.getFullYear(), now.getMonth() - 1, 1);
+	return `${target.getFullYear()}-${pad2(target.getMonth() + 1)}`;
+}
+/** Last month of the previous calendar quarter as `YYYY-MM`. Calendar
+*  quarters: Q1=Jan–Mar, Q2=Apr–Jun, Q3=Jul–Sep, Q4=Oct–Dec. When the
+*  current month is in Q1, this rolls back to December of last year. */
+function lastMonthOfPreviousQuarterString(now = /* @__PURE__ */ new Date()) {
+	const firstMonthOfCurrentQuarter = Math.floor(now.getMonth() / 3) * 3;
+	const target = new Date(now.getFullYear(), firstMonthOfCurrentQuarter - 1, 1);
+	return `${target.getFullYear()}-${pad2(target.getMonth() + 1)}`;
+}
+/** December of the previous calendar year as `YYYY-MM`. */
+function decemberOfPreviousYearString(now = /* @__PURE__ */ new Date()) {
+	return `${now.getFullYear() - 1}-12`;
+}
+//#endregion
+//#region src/shared/timeSeriesEnums.ts
+var TIME_SERIES_METRICS = [
+	"revenue",
+	"expense",
+	"netIncome",
+	"accountBalance"
+];
+var TIME_SERIES_GRANULARITIES = [
+	"month",
+	"quarter",
+	"year"
+];
+//#endregion
+exports.ACCOUNTING_ACTIONS = ACCOUNTING_ACTIONS;
+exports.ACCOUNTING_BOOKS_CHANNEL = ACCOUNTING_BOOKS_CHANNEL;
+exports.BOOK_EVENT_KINDS = BOOK_EVENT_KINDS;
+exports.COUNTRY_FEATURES = COUNTRY_FEATURES;
+exports.DEFAULT_FISCAL_YEAR_END = DEFAULT_FISCAL_YEAR_END;
+exports.EU_COUNTRY_CODES = EU_COUNTRY_CODES;
+exports.FISCAL_YEAR_ENDS = FISCAL_YEAR_ENDS;
+exports.SUPPORTED_COUNTRY_CODES = SUPPORTED_COUNTRY_CODES;
+exports.SUPPORTED_CURRENCY_CODES = SUPPORTED_CURRENCY_CODES;
+exports.TIME_SERIES_GRANULARITIES = TIME_SERIES_GRANULARITIES;
+exports.TIME_SERIES_METRICS = TIME_SERIES_METRICS;
+exports.bookChannel = bookChannel;
+exports.countryHasFeature = countryHasFeature;
+exports.currentFiscalYearRange = currentFiscalYearRange;
+exports.currentQuarterRange = currentQuarterRange;
+exports.decemberOfPreviousYearString = decemberOfPreviousYearString;
+exports.errorMessage = errorMessage;
+exports.fiscalYearEndMonth = fiscalYearEndMonth;
+exports.formatAmount = formatAmount;
+exports.formatAmountNumeric = formatAmountNumeric;
+exports.fractionDigitsFor = fractionDigitsFor;
+exports.inputStepFor = inputStepFor;
+exports.isFiscalYearEnd = isFiscalYearEnd;
+exports.isSupportedCountryCode = isSupportedCountryCode;
+exports.lastMonthOfPreviousQuarterString = lastMonthOfPreviousQuarterString;
+exports.localDateString = localDateString;
+exports.localMonthString = localMonthString;
+exports.localStartOfYearString = localStartOfYearString;
+exports.localizedCountryName = localizedCountryName;
+exports.localizedCurrencyName = localizedCurrencyName;
+exports.previousFiscalYearRange = previousFiscalYearRange;
+exports.previousMonthString = previousMonthString;
+exports.previousQuarterRange = previousQuarterRange;
+exports.resolveFiscalYearEnd = resolveFiscalYearEnd;
+
+//# sourceMappingURL=shared.cjs.map

package/dist/shared.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.cjs","names":[],"sources":["../src/shared/actions.ts","../src/shared/channels.ts","../src/shared/errors.ts","../src/shared/fiscalYear.ts","../src/shared/countries.ts","../src/shared/currencies.ts","../src/shared/dates.ts","../src/shared/timeSeriesEnums.ts"],"sourcesContent":["// Single source of truth for the manageAccounting LLM-facing action\n// names. Used by:\n//   - definition.ts (the JSON-schema action enum exposed to the LLM)\n//   - api.ts        (the View's REST helpers — `call(action, args)`)\n//   - server/api/routes/accounting.ts (handler-table keys, PREVIEW\n//     and MESSAGE_BUILDERS membership)\n//   - e2e/fixtures/accounting.ts (mock dispatcher's handler-table)\n//\n// Stays in its own module so server-side callers can import the\n// const without pulling in apiPost / Vue plumbing from `api.ts`.\n//\n// CLAUDE.md \"no magic literals — use existing `as const` objects\"\n// applies here: never reference an action by raw string at any of\n// the call sites above.\n\nexport const ACCOUNTING_ACTIONS = {\n  openBook: \"openBook\",\n  getBooks: \"getBooks\",\n  createBook: \"createBook\",\n  updateBook: \"updateBook\",\n  deleteBook: \"deleteBook\",\n  getAccounts: \"getAccounts\",\n  upsertAccount: \"upsertAccount\",\n  addEntries: \"addEntries\",\n  voidEntry: \"voidEntry\",\n  getJournalEntries: \"getJournalEntries\",\n  getOpeningBalances: \"getOpeningBalances\",\n  setOpeningBalances: \"setOpeningBalances\",\n  getReport: \"getReport\",\n  getTimeSeries: \"getTimeSeries\",\n  rebuildSnapshots: \"rebuildSnapshots\",\n} as const;\n\nexport type AccountingAction = (typeof ACCOUNTING_ACTIONS)[keyof typeof ACCOUNTING_ACTIONS];\n","// Per-book event-stream contract for the accounting plugin — the\n// reusable channel-name factory + event-kind enum + payload shape.\n// Single source of truth for both publishers (the package's server\n// surface, `eventPublisher`) and subscribers (the Vue View's\n// `useAccountingChannel`), so anyone branching on event kind imports\n// from here and the type system catches drift on either side.\n//\n// Lives in the package's `./shared` (browser-safe) rather than the\n// host META because the backend needs it too — keeping it host-side\n// would force an uphill import. The host-wiring META (toolName /\n// apiNamespace / workspaceDirs / staticChannels) stays in the host's\n// `src/plugins/accounting/meta.ts` so the plugin-barrel codegen\n// discovers it.\n//\n// Browser-safe: no Vue imports, no server-only imports.\n\n/** Channel factory for per-book event streams. Subscribers:\n *  `useAccountingChannel(bookId)`. Publisher: the package's server\n *  surface `eventPublisher`. */\nexport function bookChannel(bookId: string): string {\n  return `accounting:${bookId}`;\n}\n\n/** Book-list-level channel — a book was created / deleted. Subscribers\n *  refetch the BookSwitcher dropdown. Mirrors the host META's\n *  `staticChannels.accountingBooks` literal (kept in sync by value;\n *  the host META stays the codegen-discoverable source for the\n *  aggregator merge). */\nexport const ACCOUNTING_BOOKS_CHANNEL = \"accounting:books\";\n\n/** Event kinds that ride `bookChannel(bookId)`. Single source of\n *  truth for both publishers (server/accounting) and subscribers\n *  (the View) — anyone branching on event kind imports from here\n *  and the type system catches drift on either side.\n *\n *  - `journal`             — addEntry / voidEntry hit the books at `period`.\n *                            Refetch the journal list and (if the View is\n *                            showing balances at or after `period`) the\n *                            relevant report.\n *  - `opening`             — setOpeningBalances. Affects every period from\n *                            the opening date forward; refetch everything.\n *  - `accounts`            — chart-of-accounts mutation that may affect\n *                            aggregation (account type changed). Refetch\n *                            accounts and the active report.\n *  - `snapshotsRebuilding` / `snapshotsReady` — purely informational;\n *                            the View can show a \"calculating\" spinner\n *                            during rebuild, but the lazy-rebuild safety\n *                            net means a refetch always returns the right\n *                            answer regardless. */\nexport const BOOK_EVENT_KINDS = {\n  journal: \"journal\",\n  opening: \"opening\",\n  accounts: \"accounts\",\n  snapshotsRebuilding: \"snapshots-rebuilding\",\n  snapshotsReady: \"snapshots-ready\",\n} as const;\n\nexport type BookEventKind = (typeof BOOK_EVENT_KINDS)[keyof typeof BOOK_EVENT_KINDS];\n\n/** Payload published on `bookChannel(bookId)`. */\nexport interface BookChannelPayload {\n  kind: BookEventKind;\n  /** YYYY-MM. Present for `journal` (entry month) and the snapshot\n   *  events (the earliest invalidated month). Absent for `opening`\n   *  (which invalidates everything) and `accounts`. */\n  period?: string;\n}\n","// Normalise an unknown thrown value into a human-readable string.\n// Isomorphic (used by both the Vue surface and the server surface) so\n// it lives in ./shared. Mirrors the host's `src/utils/errors.ts`\n// `errorMessage` — kept in the package so neither surface reaches\n// uphill into the host for it.\n\nexport function errorMessage(err: unknown, fallback?: string): string {\n  if (err instanceof Error) return err.message;\n  if (err !== null && typeof err === \"object\") {\n    const obj = err as { details?: unknown; message?: unknown };\n    if (typeof obj.details === \"string\" && obj.details) return obj.details;\n    if (typeof obj.message === \"string\" && obj.message) return obj.message;\n  }\n  if (fallback !== undefined) return fallback;\n  return String(err);\n}\n","// Fiscal-year arithmetic for the accounting plugin.\n//\n// Each book stores a `fiscalYearEnd` token (Q1..Q4) that says which\n// calendar-quarter end is the book's fiscal year end:\n//\n//   Q1 → fiscal year ends March 31     (FY runs Apr 1 → Mar 31)\n//   Q2 → fiscal year ends June 30      (FY runs Jul 1 → Jun 30)\n//   Q3 → fiscal year ends September 30 (FY runs Oct 1 → Sep 30)\n//   Q4 → fiscal year ends December 31  (FY runs Jan 1 → Dec 31; default)\n//\n// \"Current quarter\" / \"current year\" everywhere in the UI refer to\n// the *fiscal* quarter / *fiscal* year that contains today, under the\n// active book's `fiscalYearEnd`. For Q4 books fiscal quarters and\n// fiscal years coincide with calendar quarters / calendar years; for\n// the other three a shift applies.\n//\n// All helpers return `YYYY-MM-DD` strings in the user's local\n// timezone — same convention as `dates.ts`.\n\nexport const FISCAL_YEAR_ENDS = [\"Q1\", \"Q2\", \"Q3\", \"Q4\"] as const;\nexport type FiscalYearEnd = (typeof FISCAL_YEAR_ENDS)[number];\n\nexport const DEFAULT_FISCAL_YEAR_END: FiscalYearEnd = \"Q4\";\n\nexport function isFiscalYearEnd(value: unknown): value is FiscalYearEnd {\n  return typeof value === \"string\" && (FISCAL_YEAR_ENDS as readonly string[]).includes(value);\n}\n\n/** Books written before the field existed are treated as Q4 in code\n *  but never auto-rewritten on disk. The settings UI persists through\n *  the field the next time the user saves anything on the book. */\nexport function resolveFiscalYearEnd(value: FiscalYearEnd | undefined): FiscalYearEnd {\n  return value ?? DEFAULT_FISCAL_YEAR_END;\n}\n\n/** Last calendar month (1-12) of the fiscal year for the given Q. */\nexport function fiscalYearEndMonth(end: FiscalYearEnd): 3 | 6 | 9 | 12 {\n  if (end === \"Q1\") return 3;\n  if (end === \"Q2\") return 6;\n  if (end === \"Q3\") return 9;\n  return 12;\n}\n\nexport interface DateRange {\n  /** Inclusive lower bound (YYYY-MM-DD). Empty string = unbounded. */\n  from: string;\n  /** Inclusive upper bound (YYYY-MM-DD). Empty string = unbounded. */\n  to: string;\n}\n\nfunction pad2(num: number): string {\n  return String(num).padStart(2, \"0\");\n}\n\nfunction lastDayOfMonth(year: number, monthZeroBased: number): number {\n  // Day 0 of next month = last day of this month, all in local time.\n  return new Date(year, monthZeroBased + 1, 0).getDate();\n}\n\nfunction ymd(year: number, monthOneBased: number, day: number): string {\n  return `${year}-${pad2(monthOneBased)}-${pad2(day)}`;\n}\n\n/** Fiscal quarter index (0..3) of the given local date under `end`,\n *  where 0 is the first quarter of the fiscal year (right after the\n *  prior year's close) and 3 is the closing quarter. */\nfunction fiscalQuarterIndex(end: FiscalYearEnd, today: Date): number {\n  const closingMonth = fiscalYearEndMonth(end); // 1-based\n  const month = today.getMonth() + 1; // 1-based local month\n  // Months past the close of the prior fiscal year, mod 12.\n  const offset = (month - closingMonth - 1 + 12) % 12;\n  return Math.floor(offset / 3);\n}\n\n/** Calendar (year, monthOneBased) of the *first* month of the fiscal\n *  quarter at index `index` in the fiscal year that *contains*\n *  `today`. Returned both as the first day of that month and as the\n *  count of months covered (always 3 — exposed as a constant). */\nfunction fiscalQuarterStart(end: FiscalYearEnd, today: Date, index: number): { year: number; month: number } {\n  const closingMonth = fiscalYearEndMonth(end);\n  const todayMonth = today.getMonth() + 1;\n  const todayYear = today.getFullYear();\n  // Month after the close of the prior fiscal year — fiscal-year start month.\n  const startMonth = (closingMonth % 12) + 1;\n  // The fiscal year that contains `today` started in the calendar\n  // year ≤ today's year. Specifically: if today's calendar month is\n  // ≥ startMonth (or startMonth is 1, which is the Q4 case), the FY\n  // started this calendar year; otherwise it started last year.\n  const fyStartYear = todayMonth >= startMonth ? todayYear : todayYear - 1;\n  // Month of the requested fiscal quarter's first month, expressed\n  // as a 1-based offset from January of fyStartYear.\n  const flatMonth = startMonth + index * 3; // 1-based, may exceed 12\n  const year = fyStartYear + Math.floor((flatMonth - 1) / 12);\n  const month = ((flatMonth - 1) % 12) + 1;\n  return { year, month };\n}\n\nfunction quarterRangeAt(end: FiscalYearEnd, today: Date, index: number): DateRange {\n  const start = fiscalQuarterStart(end, today, index);\n  // Quarter spans 3 calendar months starting at `start`.\n  const lastMonthFlat = start.month - 1 + 2; // 0-based offset of the third month\n  const lastMonthYear = start.year + Math.floor(lastMonthFlat / 12);\n  const lastMonth = (lastMonthFlat % 12) + 1; // 1-based\n  const lastDay = lastDayOfMonth(lastMonthYear, lastMonth - 1);\n  return {\n    from: ymd(start.year, start.month, 1),\n    to: ymd(lastMonthYear, lastMonth, lastDay),\n  };\n}\n\nexport function currentQuarterRange(end: FiscalYearEnd, today: Date = new Date()): DateRange {\n  return quarterRangeAt(end, today, fiscalQuarterIndex(end, today));\n}\n\nexport function previousQuarterRange(end: FiscalYearEnd, today: Date = new Date()): DateRange {\n  const idx = fiscalQuarterIndex(end, today);\n  if (idx > 0) return quarterRangeAt(end, today, idx - 1);\n  // Wrap to Q4 of the prior fiscal year. Step `today` back 3 months\n  // — that lands inside the prior fiscal year regardless of `end`,\n  // and Q4 (closing) is index 3 within whichever FY contains it.\n  const stepped = new Date(today.getFullYear(), today.getMonth() - 3, 1);\n  return quarterRangeAt(end, stepped, 3);\n}\n\n/** Current fiscal year — Q0 start through Q3 close. */\nexport function currentFiscalYearRange(end: FiscalYearEnd, today: Date = new Date()): DateRange {\n  const first = quarterRangeAt(end, today, 0);\n  const last = quarterRangeAt(end, today, 3);\n  return { from: first.from, to: last.to };\n}\n\nexport function previousFiscalYearRange(end: FiscalYearEnd, today: Date = new Date()): DateRange {\n  // Step a year back so `quarterRangeAt` resolves the prior FY.\n  const stepped = new Date(today.getFullYear() - 1, today.getMonth(), today.getDate());\n  return currentFiscalYearRange(end, stepped);\n}\n","// Country utilities for the accounting plugin.\n//\n// The book's country (ISO 3166-1 alpha-2) identifies the tax\n// jurisdiction the book is kept under. The Accounting role uses it\n// to give country-aware advice — Japanese T-number under\n// インボイス制度, EU VAT ID, UK VAT, GSTIN, ABN, etc.\n//\n// Curated against the supported currency list and the tax-regime\n// guidance in `src/config/roles.ts` (Accounting role prompt).\n// Intl.DisplayNames provides the localized human name at render\n// time, so this stays a flat list of codes.\n\n/** ISO 3166-1 alpha-2 country codes shown in the book country\n *  dropdown. Curated to cover every jurisdiction the Accounting role\n *  has explicit tax-registration advice for, plus the major economies\n *  represented in `SUPPORTED_CURRENCY_CODES`. */\nexport const SUPPORTED_COUNTRY_CODES = [\n  \"US\",\n  \"JP\",\n  \"GB\",\n  \"CA\",\n  \"AU\",\n  \"NZ\",\n  \"DE\",\n  \"FR\",\n  \"IT\",\n  \"ES\",\n  \"NL\",\n  \"BE\",\n  \"AT\",\n  \"IE\",\n  \"PT\",\n  \"FI\",\n  \"SE\",\n  \"DK\",\n  \"PL\",\n  \"CH\",\n  \"NO\",\n  \"CN\",\n  \"KR\",\n  \"TW\",\n  \"HK\",\n  \"SG\",\n  \"IN\",\n  \"BR\",\n  \"MX\",\n] as const;\n\nexport type SupportedCountryCode = (typeof SUPPORTED_COUNTRY_CODES)[number];\n\n/** EU member states as of 2026. Used by the role-prompt advice path\n *  to recommend a VAT identification number when the book country is\n *  in the EU. */\nexport const EU_COUNTRY_CODES: ReadonlySet<string> = new Set([\n  \"AT\",\n  \"BE\",\n  \"BG\",\n  \"CY\",\n  \"CZ\",\n  \"DE\",\n  \"DK\",\n  \"EE\",\n  \"ES\",\n  \"FI\",\n  \"FR\",\n  \"GR\",\n  \"HR\",\n  \"HU\",\n  \"IE\",\n  \"IT\",\n  \"LT\",\n  \"LU\",\n  \"LV\",\n  \"MT\",\n  \"NL\",\n  \"PL\",\n  \"PT\",\n  \"RO\",\n  \"SE\",\n  \"SI\",\n  \"SK\",\n]);\n\n/** Localized human name for a country code. Falls back to the code\n *  itself if the runtime can't resolve the name. */\nexport function localizedCountryName(code: string, locale: string): string {\n  try {\n    return new Intl.DisplayNames([locale], { type: \"region\" }).of(code) ?? code;\n  } catch {\n    return code;\n  }\n}\n\n/** Runtime guard for `BookSummary.country`. The type is the union\n *  `SupportedCountryCode`, but every entry point that takes user /\n *  LLM input arrives as raw `string` (form submit, JSON-RPC body),\n *  so the service layer narrows here before persisting. */\nexport function isSupportedCountryCode(value: unknown): value is SupportedCountryCode {\n  return typeof value === \"string\" && (SUPPORTED_COUNTRY_CODES as readonly string[]).includes(value);\n}\n\n/** Country-gated UI features. Each key is a feature name; the value\n *  is the set of country codes for which the feature is enabled.\n *  Components ask `countryHasFeature(\"...\", country)` instead of\n *  hard-coding country lists at the call site.\n *\n *  Add a new country-specific feature by adding a new key here and\n *  reading it via `countryHasFeature`. An unknown / undefined\n *  country never has any feature — components fall back to neutral\n *  default UI rather than guessing.\n *\n *  Mirrors the \"Country-aware tax behaviour\" prose in the\n *  Accounting role prompt (`src/config/roles.ts`). The two MUST\n *  stay in sync — drift means the LLM and the form give the user\n *  contradictory advice. The prompt is the source of truth for\n *  agent behaviour; this table is structured-data sibling for the\n *  form. */\nexport const COUNTRY_FEATURES = {\n  /** Show an amber \"missing tax ID\" warning + helper text on a\n   *  postable 14xx (input-tax) line whose taxRegistrationId is\n   *  blank. Limited to jurisdictions where the role prompt\n   *  explicitly requires the counterparty registration number\n   *  (JP T-number, EU VAT ID, GB VAT, GSTIN, ABN, NZ GST, CA BN).\n   *  The \"other countries\" bucket and US (no federal sales-tax\n   *  registration) intentionally stay quiet. 24xx output-tax\n   *  lines don't trigger the warning — see `isTaxAccountCode`. */\n  warnMissingTaxRegistrationId: new Set<SupportedCountryCode>([\n    \"JP\",\n    \"GB\",\n    \"DE\",\n    \"FR\",\n    \"IT\",\n    \"ES\",\n    \"NL\",\n    \"BE\",\n    \"AT\",\n    \"IE\",\n    \"PT\",\n    \"FI\",\n    \"SE\",\n    \"DK\",\n    \"PL\",\n    \"IN\",\n    \"AU\",\n    \"NZ\",\n    \"CA\",\n  ]),\n} as const;\n\nexport type CountryFeature = keyof typeof COUNTRY_FEATURES;\n\n/** Resolve a country-gated feature flag. Returns `false` when the\n *  country is undefined / unsupported — components default to the\n *  neutral path (no warning, no extra UI) rather than guessing. */\nexport function countryHasFeature(feature: CountryFeature, country: SupportedCountryCode | undefined): boolean {\n  if (!country) return false;\n  return COUNTRY_FEATURES[feature].has(country);\n}\n","// Currency utilities for the accounting plugin.\n//\n// We expose a curated list of ISO 4217 codes for the New Book\n// dropdown — covering the major reserve currencies plus the most\n// requested Asian / regional ones — plus per-currency formatting\n// helpers built on Intl.NumberFormat.\n//\n// The book's currency is per-book metadata (BookSummary.currency)\n// and only matters once the user has opened the book; cross-book\n// aggregation isn't supported.\n\n/** ISO 4217 codes shown in the New Book dropdown. Curated for\n *  recognisability — Intl.DisplayNames provides the localised\n *  human name at render time, so this stays a flat list of codes. */\nexport const SUPPORTED_CURRENCY_CODES = [\"USD\", \"EUR\", \"JPY\", \"GBP\", \"CNY\", \"KRW\", \"TWD\", \"HKD\", \"SGD\", \"AUD\", \"CAD\", \"CHF\", \"INR\", \"BRL\", \"MXN\"] as const;\n\nexport type SupportedCurrencyCode = (typeof SUPPORTED_CURRENCY_CODES)[number];\n\nconst DEFAULT_FALLBACK_DIGITS = 2;\n\n/** Localised human name for a currency code. Falls back to the\n *  code itself if the runtime can't resolve the name. */\nexport function localizedCurrencyName(code: string, locale: string): string {\n  try {\n    return new Intl.DisplayNames([locale], { type: \"currency\" }).of(code) ?? code;\n  } catch {\n    return code;\n  }\n}\n\n/** Number of fraction digits ISO 4217 specifies for a currency.\n *  JPY = 0, USD = 2, KWD = 3. Used both for amount formatting and\n *  for the HTML input step on debit/credit fields. */\nexport function fractionDigitsFor(currency: string): number {\n  try {\n    const opts = new Intl.NumberFormat(\"en\", { style: \"currency\", currency }).resolvedOptions();\n    return opts.maximumFractionDigits ?? DEFAULT_FALLBACK_DIGITS;\n  } catch {\n    return DEFAULT_FALLBACK_DIGITS;\n  }\n}\n\n/** \"1\" for JPY, \"0.01\" for USD, \"0.001\" for KWD. Used as the HTML\n *  input step on debit/credit fields so a JPY book doesn't let the\n *  user type cents that would just round-trip back through the\n *  decimal validator. */\nexport function inputStepFor(currency: string): string {\n  const digits = fractionDigitsFor(currency);\n  if (digits === 0) return \"1\";\n  return (1 / 10 ** digits).toFixed(digits);\n}\n\n/** Locale-aware currency formatter — returns \"¥1,130\" / \"$1,130.00\"\n *  etc. Falls back to fixed-point formatting if the runtime can't\n *  resolve the currency code; the fallback still respects the\n *  currency's natural fraction-digit count so JPY shows whole\n *  numbers even on the slow path. */\nexport function formatAmount(value: number, currency: string, locale?: string): string {\n  try {\n    return new Intl.NumberFormat(locale, { style: \"currency\", currency }).format(value);\n  } catch {\n    return value.toFixed(fractionDigitsFor(currency));\n  }\n}\n\n/** Currency-agnostic amount formatter — \"1,130.00\" — for places that\n *  don't carry the currency code on the data path (compact preview\n *  envelopes etc.). Use `formatAmount(value, currency)` whenever the\n *  currency IS available — the currency-aware path picks the right\n *  fraction-digit count automatically (JPY = 0, USD = 2).\n *\n *  `locale` mirrors `formatAmount`'s signature: pass an explicit BCP-47\n *  locale (`\"en-US\"`, `\"ja-JP\"`, …) when the caller knows the desired\n *  grouping / digit-shape; omit to fall back to the runtime default. */\nexport function formatAmountNumeric(value: number, decimals = 2, locale?: string): string {\n  return value.toLocaleString(locale, { minimumFractionDigits: decimals, maximumFractionDigits: decimals });\n}\n","// Local-calendar date helpers for the accounting forms.\n//\n// Why not `new Date().toISOString().slice(0, 10)`? `toISOString` is\n// UTC. In a negative-offset zone (US Pacific, Eastern, …) the UTC\n// date crosses to \"tomorrow\" several hours before midnight local,\n// so a naively prefilled date input would post entries into the\n// wrong accounting day. Same mistake near month boundaries flips\n// the default Balance Sheet period to the next month.\n//\n// All four helpers below are pure local-calendar formatters built\n// from `getFullYear` / `getMonth` / `getDate`, which the JS engine\n// resolves in the user's local timezone.\n\nfunction pad2(num: number): string {\n  return String(num).padStart(2, \"0\");\n}\n\n/** Today as `YYYY-MM-DD` in the user's local timezone. */\nexport function localDateString(now: Date = new Date()): string {\n  return `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}`;\n}\n\n/** Current month as `YYYY-MM` in the user's local timezone. */\nexport function localMonthString(now: Date = new Date()): string {\n  return `${now.getFullYear()}-${pad2(now.getMonth() + 1)}`;\n}\n\n/** First day of the current calendar year as `YYYY-MM-DD`. */\nexport function localStartOfYearString(now: Date = new Date()): string {\n  return `${now.getFullYear()}-01-01`;\n}\n\n/** Previous calendar month as `YYYY-MM` in the user's local timezone. */\nexport function previousMonthString(now: Date = new Date()): string {\n  const target = new Date(now.getFullYear(), now.getMonth() - 1, 1);\n  return `${target.getFullYear()}-${pad2(target.getMonth() + 1)}`;\n}\n\n/** Last month of the previous calendar quarter as `YYYY-MM`. Calendar\n *  quarters: Q1=Jan–Mar, Q2=Apr–Jun, Q3=Jul–Sep, Q4=Oct–Dec. When the\n *  current month is in Q1, this rolls back to December of last year. */\nexport function lastMonthOfPreviousQuarterString(now: Date = new Date()): string {\n  const firstMonthOfCurrentQuarter = Math.floor(now.getMonth() / 3) * 3;\n  const target = new Date(now.getFullYear(), firstMonthOfCurrentQuarter - 1, 1);\n  return `${target.getFullYear()}-${pad2(target.getMonth() + 1)}`;\n}\n\n/** December of the previous calendar year as `YYYY-MM`. */\nexport function decemberOfPreviousYearString(now: Date = new Date()): string {\n  return `${now.getFullYear() - 1}-12`;\n}\n","// Single source of truth for the `getTimeSeries` action's enum\n// surfaces — kept outside the server module so the frontend tool\n// definition (`definition.ts`) and the server validator\n// (`server/accounting/timeSeries.ts`) can both import without\n// crossing the src ↔ server boundary in the wrong direction.\n//\n// Adding a new metric / granularity: extend the array here, then\n// extend the corresponding switch / aggregation in\n// `server/accounting/timeSeries.ts`. The LLM tool schema picks up\n// the new value automatically via `definition.ts`'s `enum` field.\n\nexport const TIME_SERIES_METRICS = [\"revenue\", \"expense\", \"netIncome\", \"accountBalance\"] as const;\nexport type TimeSeriesMetric = (typeof TIME_SERIES_METRICS)[number];\n\nexport const TIME_SERIES_GRANULARITIES = [\"month\", \"quarter\", \"year\"] as const;\nexport type TimeSeriesGranularity = (typeof TIME_SERIES_GRANULARITIES)[number];\n"],"mappings":"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"}