@dork-labs/cloud-api 0.83.0 → 0.87.0

package/dist/billing.js

@@ -1,5 +1,12 @@
 import { z } from 'zod';
-import { IdSchema, MicroAmountSchema, PositiveMicroAmountSchema, TimestampSchema, } from './primitives.js';
+import { CreditMicroSchema, DenominationSchema, IdSchema, MoneyMicroSchema, PositiveMoneyMicroSchema, TimestampSchema, tolerantEnum, } from './primitives.js';
+/**
+ * The optional `denomination` every amount-bearing response carries.
+ *
+ * Optional so a response from an older service still parses. A client that
+ * receives none must not guess a unit.
+ */
+const denominationField = DenominationSchema.optional().describe('The unit these amounts are in. Absent from an older service; a client that receives none must not guess one.');
 /**
  * How remote access works for the caller.
  *
@@ -69,7 +76,7 @@ export const EntitlementLimitsSchema = z
     .object({
     personSeatsIncluded: z.number().int().nonnegative(),
     agentSeatsIncluded: z.number().int().nonnegative(),
-    includedCreditsMicro: MicroAmountSchema,
+    includedCreditsMicro: CreditMicroSchema,
     cloudHours: z.number().nonnegative(),
     storageGb: z.number().nonnegative(),
     remoteAccess: RemoteAccessCapabilitySchema,
@@ -117,6 +124,7 @@ export const EntitlementsSchema = z
     canCreateSeat: z.boolean(),
     canInviteMember: z.boolean(),
     staleAt: TimestampSchema.describe('When this snapshot should be refetched.'),
+    denomination: denominationField,
 })
     .describe('What the caller is allowed to do. A caller with no subscription gets the free entitlement, never a 404.');
 /**
@@ -130,12 +138,12 @@ export const EntitlementsSchema = z
 export const BalanceSchema = z
     .object({
     allowance: z.object({
-        grantedMicro: MicroAmountSchema,
-        remainingMicro: MicroAmountSchema,
+        grantedMicro: CreditMicroSchema,
+        remainingMicro: CreditMicroSchema,
         resetsAt: TimestampSchema,
     }),
     purchased: z.object({
-        remainingMicro: MicroAmountSchema,
+        remainingMicro: CreditMicroSchema,
         holds: z
             .number()
             .int()
@@ -143,15 +151,16 @@ export const BalanceSchema = z
             .optional()
             .describe('How many first-purchase holds are in force. Absent means the server did not say; zero means none.'),
     }),
-    pendingMicro: MicroAmountSchema.optional().describe('Credit the caller has paid for that is not spendable yet, because a hold is still in force. Absent means the server did not say.'),
-    heldMicro: MicroAmountSchema.describe('Reserved against turns currently running.'),
-    owedMicro: MicroAmountSchema.describe('Debt from a turn that overran its reservation. May be "0"; when it is not, show it.'),
+    pendingMicro: CreditMicroSchema.optional().describe('Credit the caller has paid for that is not spendable yet, because a hold is still in force. Absent means the server did not say.'),
+    heldMicro: CreditMicroSchema.describe('Reserved against turns currently running.'),
+    owedMicro: CreditMicroSchema.describe('Debt from a turn that overran its reservation. May be "0"; when it is not, show it.'),
     autoReload: z.object({
         enabled: z.boolean(),
-        ceilingMicro: MicroAmountSchema.nullable(),
+        ceilingMicro: MoneyMicroSchema.nullable(),
     }),
+    denomination: denominationField,
 })
-    .describe('The caller`s credit position. Every amount is an exact integer of micro-units carried as a string.');
+    .describe('The caller`s credit position. Every amount is an exact integer of micro-units carried as a string, counted as credits except the auto-reload ceiling, which is money.');
 /**
  * Where a usage line`s price came from.
  *
@@ -207,8 +216,8 @@ export const UsageRowSchema = z
         .nonnegative()
         .describe('How much was used, in the unit the row is measured in.'),
     unit: z.string().describe('What `units` counts, as a server-supplied string.'),
-    listPriceMicro: MicroAmountSchema.describe('The upstream list price for this row.'),
-    dorkosPriceMicro: MicroAmountSchema.describe('What DorkOS charged for this row.'),
+    listPriceMicro: MoneyMicroSchema.describe('The upstream list price for this row.'),
+    dorkosPriceMicro: CreditMicroSchema.describe('What DorkOS charged for this row.'),
     costBasis: CostBasisSchema,
 })
     .describe('One row of the caller`s own usage, projected. No supplier and no price-list version appear here.');
@@ -221,9 +230,10 @@ export const UsageResponseSchema = z
     state: UsageStateSchema,
     rows: z.array(UsageRowSchema),
     totals: z.object({
-        listPriceMicro: MicroAmountSchema,
-        dorkosPriceMicro: MicroAmountSchema,
+        listPriceMicro: MoneyMicroSchema,
+        dorkosPriceMicro: CreditMicroSchema,
     }),
+    denomination: denominationField,
 })
     .describe('The caller`s own usage for a window, grouped as asked.');
 /** One entry of the published price list. */
@@ -232,8 +242,10 @@ export const PriceListEntrySchema = z
     modelId: IdSchema.describe('An opaque model identifier. This list is the only place a price belongs.'),
     displayName: z.string(),
     unit: z.string().describe('What the prices below are per, as a server-supplied string.'),
-    inputMicro: MicroAmountSchema,
-    outputMicro: MicroAmountSchema,
+    inputMicro: CreditMicroSchema,
+    outputMicro: CreditMicroSchema,
+    cacheReadMicro: CreditMicroSchema.optional().describe('The rate for reading prompt-cached input, in the entry`s existing unit. Absent means the service did not say.'),
+    cacheWriteMicro: CreditMicroSchema.optional().describe('The rate for writing input to the prompt cache, in the entry`s existing unit. Absent means the service did not say.'),
 })
     .describe('One entry of the published price list.');
 /**
@@ -249,8 +261,9 @@ export const PriceListResponseSchema = z
     version: z.string().describe('An opaque version string for this list.'),
     effectiveFrom: TimestampSchema,
     entries: z.array(PriceListEntrySchema),
+    denomination: denominationField,
 })
-    .describe('The published per-model price list. The only route in this contract that carries a price.');
+    .describe('The published per-model price list.');
 /**
  * `GET /v1/nudge` — one already-computed comparison, delivered reduced.
  *
@@ -261,25 +274,84 @@ export const PriceListResponseSchema = z
  */
 export const NudgeSchema = z
     .object({
-    trailing30Micro: MicroAmountSchema,
+    trailing30Micro: CreditMicroSchema,
     suggestedPlanId: IdSchema.describe('An opaque identifier. Never switch on this value.'),
     suggestedPlanDisplayName: z.string(),
-    suggestedPlanPriceMicro: MicroAmountSchema,
-    savingMicro: MicroAmountSchema.describe('The subtraction the server already did.'),
+    suggestedPlanPriceMicro: MoneyMicroSchema,
+    savingMicro: MoneyMicroSchema.describe('The subtraction the server already did.'),
     computedAt: TimestampSchema,
     dismissible: z.literal(true),
+    denomination: denominationField,
 })
     .describe('One already-computed comparison. 404 from this route means "no nudge", not an error.');
+/**
+ * How often an offer recurs.
+ *
+ * Mechanism, not catalog: it says how a charge repeats, not what is on sale.
+ */
+export const OfferIntervalSchema = z
+    .enum(['month', 'year'])
+    .describe('How often an offer recurs: every month, or every year.');
+/**
+ * One thing the service will sell the caller, as `GET /v1/offers` lists it.
+ *
+ * It is the only place a client is handed a `skuId`, which is the string
+ * `POST /v1/checkout` takes back. `skuId` and `planId` are different identifier
+ * spaces and neither can stand in for the other: one subscription has one
+ * `planId` and one `skuId` per interval. `planId` is the same opaque token
+ * `GET /v1/entitlements` publishes, so a page compares the two to mark what the
+ * caller is on; this shape deliberately carries no "current" flag of its own.
+ *
+ * It carries no "recommended" flag and no badge. Render the offers in the order
+ * the service sends them and do not re-sort them; the order carries no meaning
+ * beyond that.
+ *
+ * `interval` is tolerant: an interval added in a later release reads as
+ * `unrecognised`, so one new offer cannot fail the whole list. Generate the JSON
+ * Schema with `{ io: 'input' }`. `limits` is the published entitlement-limits
+ * shape itself, so its own description speaks of an entitlement.
+ */
+export const OfferSchema = z
+    .object({
+    skuId: IdSchema.describe('The opaque identifier `POST /v1/checkout` takes back. Never constructed, parsed or enumerated by a client.'),
+    planId: IdSchema.describe('The opaque identifier `GET /v1/entitlements` publishes for the same subscription. Not interchangeable with `skuId`. Never switch on this value.'),
+    displayName: z.string().describe('The server-supplied string to show a person.'),
+    interval: tolerantEnum(OfferIntervalSchema).describe('How often the offer recurs. An interval this release does not know reads as unrecognised.'),
+    amountMicro: MoneyMicroSchema.describe('The price for one interval, in micro-units of money. Rendered, never computed with.'),
+    // The published limits shape itself, by reference: one shape, one place to
+    // extend. A `.describe()` here would make a copy.
+    limits: EntitlementLimitsSchema,
+})
+    .describe('One thing the service will sell the caller.');
+/**
+ * `GET /v1/offers` — everything the service will sell the caller right now.
+ *
+ * A bearer token or the person's own browser session. An account with nothing
+ * on sale gets 200 and an empty list, never a 404: nothing on sale is a normal
+ * state, and a client that met a 404 would report an outage.
+ */
+export const OffersResponseSchema = z
+    .object({
+    offers: z.array(OfferSchema),
+    denomination: denominationField,
+})
+    .describe('Everything the service will sell the caller right now. An empty list is a normal answer, never a 404.');
 /**
  * A request for a hosted page.
  *
- * `skuId` is an identifier the client received from the server. A client never
- * constructs one and never enumerates the set. The amount and its rendering
- * belong to the hosted page, not to this contract.
+ * `skuId` is an identifier the client received from the server, from
+ * `GET /v1/offers` ({@link OffersResponseSchema}). A client never constructs one
+ * and never enumerates the set. The amount and its rendering belong to the
+ * hosted page, not to this contract.
+ *
+ * `POST /v1/checkout` and `POST /v1/portal` accept either credential: a bearer
+ * token, or the person's own browser session. Their request and response shapes
+ * are the same either way. A request authenticated by a browser session must
+ * come from an origin the service trusts, or it is refused with `forbidden`.
  */
 export const HostedPageRequestSchema = z
     .object({
-    skuId: IdSchema.optional().describe('An opaque identifier the server supplied earlier. Clients never construct or enumerate one.'),
+    skuId: IdSchema.optional().describe('An opaque identifier the server supplied earlier, from `GET /v1/offers`. Clients never construct or enumerate one.'),
     returnUrl: z
         .string()
         .url()
@@ -302,14 +374,48 @@ export const StatementQuerySchema = z
     period: z.string().min(1).describe('The billing period to fetch, as the server labels it.'),
 })
     .describe('Which billing period to fetch a statement for.');
-/** `GET /v1/statement` — a download link for the caller`s itemised statement. */
+/**
+ * `GET /v1/statement` — the caller`s own statement for one period: a download
+ * link, and optionally its lines and totals.
+ *
+ * `lines` and `totals` are the same projection `GET /v1/usage` publishes, one
+ * line per model for the statement's period. They cover inference usage only:
+ * any other charge in the period appears in the downloadable statement, not
+ * here, so `totals` is not the whole bill when there are other charges.
+ *
+ * `from` and `to` are the window the period covers. A period is labelled by a
+ * month, but it need not be a calendar month, so a client never derives the
+ * window from the label.
+ *
+ * All four are optional, and a service sends `lines` and `totals` together or
+ * not at all. A service that predates them answers with the link alone; a client
+ * that meets no `lines` but has `from` and `to` can read the same projection
+ * from `GET /v1/usage` with `groupBy=model` for that window.
+ *
+ * `totals` is the exact sum of the lines. Render it from the exact figures, never
+ * by adding rounded lines.
+ */
 export const StatementResponseSchema = z
     .object({
     period: z.string(),
     downloadUrl: z.string().url(),
     expiresAt: TimestampSchema.describe('When the download link stops working.'),
+    from: TimestampSchema.optional().describe('The start of the window this period covers. Absent from an older service.'),
+    to: TimestampSchema.optional().describe('The end of the window this period covers. Absent from an older service.'),
+    lines: z
+        .array(UsageRowSchema)
+        .optional()
+        .describe('The statement`s inference usage, one line per model, in the shape `GET /v1/usage` publishes. Other charges are only in the download. Sent together with `totals`, or neither. Absent from an older service.'),
+    totals: z
+        .object({
+        listPriceMicro: MoneyMicroSchema.describe('The upstream list price across every line.'),
+        dorkosPriceMicro: CreditMicroSchema.describe('What DorkOS charged across every line.'),
+    })
+        .optional()
+        .describe('The exact totals of the lines, which is inference usage only. Sent together with `lines`, or neither. Absent from an older service.'),
+    denomination: denominationField,
 })
-    .describe('A short-lived download link for the caller`s own itemised usage statement.');
+    .describe('The caller`s own statement for one period: a short-lived download link, and optionally its lines and totals.');
 /**
  * `POST /v1/topup` — buy credit, answered with {@link HostedPageResponseSchema}.
  *
@@ -332,7 +438,7 @@ export const StatementResponseSchema = z
  */
 export const TopupRequestSchema = z
     .object({
-    amountMicro: PositiveMicroAmountSchema.describe('How much credit to buy, in micro-units.'),
+    amountMicro: PositiveMoneyMicroSchema.describe('How much to pay for credit, in micro-units of money.'),
     returnUrl: z
         .string()
         .url()
@@ -341,25 +447,42 @@ export const TopupRequestSchema = z
 })
     .describe('A request to buy credit. Carries an amount and nothing about what an amount is worth.');
 /**
- * `POST /v1/refunds` — ask for one charge to be refunded.
+ * Why the two refund shapes below are withdrawn, and why they are still here.
+ *
+ * DorkOS Cloud does not offer refunds through this API. No release of the
+ * service ever served `POST /v1/refunds`; it answers `not_found`.
+ *
+ * The shapes stay exported because this package is additive within `/v1`:
+ * deleting an export would break the build of anyone who imported it from an
+ * earlier release, and that is a `/v2` change. They are marked deprecated in the
+ * types and in the JSON Schema, and they go when `/v2` does.
+ */
+const REFUNDS_WITHDRAWN = 'Withdrawn: DorkOS Cloud does not offer refunds through this API, and no release of the service answers this route. Kept only so imports from an earlier release keep compiling.';
+/**
+ * `POST /v1/refunds` — withdrawn. A request no release of the service accepts.
  *
- * Opaque identifiers only. The amount is the charge`s own, so the request never
- * names one, and a refund asked for after the window has closed is refused with
- * `refund_window_closed`. How long the window is is server policy and is not
- * published here.
+ * @deprecated DorkOS Cloud does not offer refunds through this API, and the
+ * route answers `not_found`. Kept only so an import from an earlier release
+ * still compiles; it is removed in `/v2`.
  */
 export const RefundRequestSchema = z
     .object({
     chargeId: IdSchema.describe('The charge to refund, as an opaque identifier the server issued.'),
 })
-    .describe('Ask for one charge to be refunded. Opaque identifiers only, and no amount.');
-/** `POST /v1/refunds` — the accepted refund. */
+    .meta({ description: REFUNDS_WITHDRAWN, deprecated: true });
+/**
+ * `POST /v1/refunds` — withdrawn. An answer no release of the service sends.
+ *
+ * @deprecated DorkOS Cloud does not offer refunds through this API, and the
+ * route answers `not_found`. Kept only so an import from an earlier release
+ * still compiles; it is removed in `/v2`.
+ */
 export const RefundResponseSchema = z
     .object({
     refundId: IdSchema,
     chargeId: IdSchema,
-    refundedMicro: MicroAmountSchema.describe('How much came back, in micro-units.'),
+    refundedMicro: MoneyMicroSchema.describe('How much came back, in micro-units.'),
     refundedAt: TimestampSchema,
 })
-    .describe('The accepted refund: which charge it settles, how much came back, and when.');
+    .meta({ description: REFUNDS_WITHDRAWN, deprecated: true });
 //# sourceMappingURL=billing.js.map

package/dist/billing.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"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"}

package/dist/display.d.ts

@@ -0,0 +1,172 @@
+/**
+ * `@dork-labs/cloud-api/display` — one way to render a Cloud amount for a person.
+ *
+ * Every amount on the wire is an exact integer count of micro-units carried as
+ * a string, and a response names its unit in `denomination`: the currency the
+ * micro-units are millionths of, and how many micro-units one credit is. This
+ * module turns an amount and that denomination into text, by the kind of
+ * figure it is:
+ *
+ * - a **position** (what someone has or may still spend) rounds down to whole
+ *   credits, so no page shows credit that cannot be spent;
+ * - a **charge** (what someone spent, was charged or is held for) rounds half
+ *   away from zero to whole credits, and a non-zero amount under half a credit
+ *   reads as less than one credit;
+ * - a **rate** (a price per unit of something) is never rounded;
+ * - **money** rounds to the currency's minor unit, half away from zero, and a
+ *   non-zero amount that rounds to zero reads as less than the smallest unit;
+ * - a **cap** (a money limit) rounds down, so a limit never reads higher than
+ *   the one enforced.
+ *
+ * Rules this module keeps, so two clients can never disagree:
+ *
+ * - **No scale lives here.** The credit scale comes from the served
+ *    denomination on every call. A missing or malformed denomination, or a
+ *    malformed amount, returns `null`: never a guess.
+ * - **No amount becomes a JavaScript number.** Every digit is produced with
+ *    `BigInt`. `Intl.NumberFormat` is asked only for a currency's symbol, where
+ *    the symbol sits, and how many minor-unit digits the currency has. No
+ *    amount is ever handed to `Intl`.
+ * - **No dependencies**, not even the contract's own schemas, so a renderer
+ *    can import this without Zod.
+ *
+ * Numbers are grouped the way `en-US` groups them. Localised formatting is a
+ * separate, later change. The package README lists every rule with worked
+ * examples.
+ *
+ * @packageDocumentation
+ */
+/** The part of a response's `denomination` a credit renderer needs. */
+export interface DisplayDenomination {
+    /** An ISO 4217 code: what the micro-units are millionths of. */
+    currency: string;
+    /** How many micro-units one credit is, as a positive integer string. */
+    microPerCredit: string;
+}
+/** The part of a response's `denomination` a money renderer needs. */
+export interface DisplayCurrency {
+    /** An ISO 4217 code: what the micro-units are millionths of. */
+    currency: string;
+}
+/**
+ * An amount as it came off the wire. Anything but a base-10 integer string
+ * renders as `null`.
+ */
+export type AmountInput = string | null | undefined;
+/**
+ * A response's `denomination` as it came off the wire. Absent or malformed
+ * renders as `null`.
+ */
+export type DenominationInput = DisplayDenomination | null | undefined;
+/** A currency as it came off the wire. Absent or malformed renders as `null`. */
+export type CurrencyInput = DisplayCurrency | null | undefined;
+/** How a credit figure is rounded: see the module overview. */
+export type CreditKind = 'position' | 'charge' | 'rate';
+/** How any figure is rounded: the three credit kinds, plus money and cap. */
+export type AmountDisplayKind = CreditKind | 'money' | 'cap';
+/**
+ * Floor division: the quotient rounded toward negative infinity.
+ *
+ * @param dividend - Any integer.
+ * @param divisor - A positive integer.
+ */
+export declare function floorDiv(dividend: bigint, divisor: bigint): bigint;
+/**
+ * The quotient rounded to the nearest integer, a tie going away from zero.
+ *
+ * @param dividend - Any integer.
+ * @param divisor - A positive integer.
+ */
+export declare function roundHalfAwayFromZero(dividend: bigint, divisor: bigint): bigint;
+/**
+ * Renders what a person has or may still spend: whole credits, rounded toward
+ * negative infinity, so it never shows credit that cannot be spent.
+ *
+ * @param micro - The amount string, in micro-units.
+ * @param denomination - The response's `denomination`.
+ * @returns The grouped credit count, or `null` for a malformed amount or denomination.
+ */
+export declare function formatPosition(micro: AmountInput, denomination: DenominationInput): string | null;
+/**
+ * Renders what a person spent, was charged or is held for: whole credits,
+ * rounded half away from zero. Zero reads as zero; a non-zero amount that rounds
+ * to zero reads as less than one credit, with a minus sign when negative.
+ *
+ * @param micro - The amount string, in micro-units.
+ * @param denomination - The response's `denomination`.
+ * @returns The grouped credit count, or `null` for a malformed amount or denomination.
+ */
+export declare function formatCharge(micro: AmountInput, denomination: DenominationInput): string | null;
+/**
+ * Renders a price per unit of something in credits, never rounded: every
+ * significant digit, trailing zeros trimmed.
+ *
+ * A scale with a prime factor other than two or five cannot write every
+ * amount as a finite decimal. Such an amount returns `null` rather than a
+ * rounded figure.
+ *
+ * @param micro - The amount string, in micro-units.
+ * @param denomination - The response's `denomination`.
+ * @returns The exact credit figure, or `null` when it cannot be written exactly or the input is malformed.
+ */
+export declare function formatRate(micro: AmountInput, denomination: DenominationInput): string | null;
+/**
+ * Renders money: rounded to the currency's minor unit, half away from zero.
+ * An amount that is exactly a whole major unit prints without minor digits;
+ * any other prints with all of them. A non-zero amount that rounds to zero
+ * reads as less than the smallest unit.
+ *
+ * Money needs no credit scale, so a bare `{ currency }` is enough.
+ *
+ * @param micro - The amount string, in micro-units of the currency.
+ * @param currency - The response's `denomination`, or just `{ currency }`.
+ * @returns The money text, or `null` for a malformed amount or currency.
+ */
+export declare function formatMoney(micro: AmountInput, currency: CurrencyInput): string | null;
+/**
+ * Renders a money limit: the money rule, rounded toward negative infinity, so
+ * a limit never reads higher than the one enforced.
+ *
+ * @param micro - The amount string, in micro-units of the currency.
+ * @param currency - The response's `denomination`, or just `{ currency }`.
+ * @returns The money text, or `null` for a malformed amount or currency.
+ */
+export declare function formatCap(micro: AmountInput, currency: CurrencyInput): string | null;
+/**
+ * Renders a price in money, never rounded: the exact amount, with at least the
+ * currency's minor digits.
+ *
+ * @param micro - The amount string, in micro-units of the currency.
+ * @param currency - The response's `denomination`, or just `{ currency }`.
+ * @returns The money text, or `null` for a malformed amount or currency.
+ */
+export declare function formatMoneyRate(micro: AmountInput, currency: CurrencyInput): string | null;
+/**
+ * Renders a credit figure with its money value beside it:
+ * `<credits> credits (<money>)`, with the singular for exactly one credit.
+ *
+ * For a position or a charge the money is worked out from the ROUNDED credit
+ * count times the served scale, never separately from the exact amount, so the
+ * two figures always agree. A charge under one credit reads as less than one
+ * credit, beside less than the money of one credit. A rate is exact on both
+ * sides.
+ *
+ * @param micro - The amount string, in micro-units.
+ * @param denomination - The response's `denomination`.
+ * @param kind - How the credit figure is rounded.
+ * @returns The text, or `null` for a malformed amount or denomination.
+ */
+export declare function formatCreditsWithMoney(micro: AmountInput, denomination: DenominationInput, kind: CreditKind): string | null;
+/**
+ * Renders a total the only honest way: the exact sum of the lines, rounded once
+ * by the kind of what it totals. Never the sum of rounded lines, so a total may
+ * differ from its rounded lines by a credit or two, and it is the total that
+ * matches what was charged.
+ *
+ * @param lines - The exact amount strings being totalled.
+ * @param denomination - The response's `denomination` (or `{ currency }` for money and cap).
+ * @param kind - How the total is rounded.
+ * @returns The total's text, or `null` when any line or the denomination is malformed.
+ */
+export declare function formatTotal(lines: readonly AmountInput[], denomination: DenominationInput | CurrencyInput, kind: AmountDisplayKind): string | null;
+//# sourceMappingURL=display.d.ts.map

package/dist/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvE,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAc7D;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK/E;AA8KD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAQ/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAiB7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAEtF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAEpF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAO1F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,iBAAiB,EAC/B,IAAI,EAAE,UAAU,GACf,MAAM,GAAG,IAAI,CA+Bf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,YAAY,EAAE,iBAAiB,GAAG,aAAa,EAC/C,IAAI,EAAE,iBAAiB,GACtB,MAAM,GAAG,IAAI,CAyBf"}