card-gate-frame 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,143 @@
+import { _ as GatePaintOptions, a as GateFamily, b as GateSeed, d as GateGeometry, h as GateGeometryV3, m as GateGeometryV2, p as GateGeometryV1, r as GateCrest, u as GateGenerationVersion } from "./index-B0WElJq8.js";
+//#region src/dom/index.d.ts
+interface GateOptionsV1 {
+  readonly seed?: GateSeed;
+  readonly generationVersion?: 1;
+  readonly family?: "courtyard";
+  readonly density?: number;
+  readonly curvature?: number;
+  readonly symmetry?: never;
+  readonly peakHeight?: never;
+  readonly sideComplexity?: never;
+  readonly crest?: never;
+  readonly stroke?: string;
+  readonly surface?: string;
+  readonly responsive?: boolean;
+}
+interface GateOptionsV2 {
+  readonly seed?: GateSeed;
+  readonly generationVersion: 2;
+  readonly family?: GateFamily | "auto";
+  readonly density?: number;
+  readonly curvature?: number;
+  readonly symmetry?: number;
+  readonly peakHeight?: number;
+  readonly sideComplexity?: number;
+  readonly crest?: GateCrest;
+  readonly stroke?: string;
+  readonly surface?: string;
+  readonly responsive?: boolean;
+}
+interface GateOptionsV3 extends Omit<GateOptionsV2, "generationVersion"> {
+  readonly generationVersion: 3;
+}
+type GateOptions = GateOptionsV1 | GateOptionsV2 | GateOptionsV3;
+type GateOptionUpdate = Partial<GateOptionsV1> | (Partial<Omit<GateOptionsV2, "generationVersion">> & {
+  readonly generationVersion?: 2;
+}) | (Partial<Omit<GateOptionsV3, "generationVersion">> & {
+  readonly generationVersion?: 3;
+});
+interface GateSnapshotBase {
+  readonly seed: GateSeed;
+  readonly paint: Readonly<Required<GatePaintOptions>>;
+}
+interface GateSnapshotV1 extends GateSnapshotBase {
+  readonly generationVersion: 1;
+  readonly geometry: Readonly<GateGeometryV1>;
+}
+interface GateSnapshotV2 extends GateSnapshotBase {
+  readonly generationVersion: 2;
+  readonly geometry: Readonly<GateGeometryV2>;
+}
+interface GateSnapshotV3 extends GateSnapshotBase {
+  readonly generationVersion: 3;
+  readonly geometry: Readonly<GateGeometryV3>;
+}
+type GateSnapshot = GateSnapshotV1 | GateSnapshotV2 | GateSnapshotV3;
+type GateFrameErrorCode = "INVALID_SELECTOR" | "TARGET_NOT_FOUND" | "TARGET_NOT_HTML_ELEMENT" | "UNSUPPORTED_TARGET" | "POSITIONING_CONFLICT" | "ALREADY_MOUNTED" | "INVALID_OPTIONS" | "UNSUPPORTED_DIMENSIONS" | "INSUFFICIENT_CONTENT_SPACE" | "NOT_READY" | "DESTROYED";
+export declare class GateFrameError extends Error {
+  readonly code: GateFrameErrorCode;
+  readonly context: Readonly<Record<string, unknown>>;
+  constructor(code: GateFrameErrorCode, message: string, context?: Record<string, unknown>, name?: string);
+}
+export declare class GateFrameInvalidSelectorError extends GateFrameError {
+  constructor(selector: string);
+}
+export declare class GateFrameTargetNotFoundError extends GateFrameError {
+  constructor(selector: string);
+}
+export declare class GateFrameTargetNotHTMLElementError extends GateFrameError {
+  constructor(context: {
+    readonly source: "selector";
+    readonly selector: string;
+    readonly tagName: string;
+  } | {
+    readonly source: "direct";
+    readonly tagName: string;
+  } | {
+    readonly source: "direct";
+    readonly valueType: string;
+  });
+}
+export declare class GateFrameAlreadyMountedError extends GateFrameError {
+  constructor(target: HTMLElement);
+}
+type UnsupportedTargetReason = "replaced-element" | "restricted-form-control" | "table-internal" | "display-inline" | "display-contents" | "unsupported-display" | "content-model" | "writing-mode" | "fragmented" | "shadow-host";
+export declare class GateFrameUnsupportedTargetError extends GateFrameError {
+  constructor(target: HTMLElement, reason: UnsupportedTargetReason, details?: Record<string, unknown>);
+}
+export declare class GateFramePositioningConflictError extends GateFrameError {
+  constructor(target: HTMLElement, descendant: Element);
+}
+export declare class GateFrameInvalidOptionsError extends GateFrameError {
+  constructor(context: {
+    readonly optionKeys: ReadonlyArray<string>;
+    readonly reason: string;
+    readonly category?: "shape" | "unknown-key" | "responsive" | "version" | "family" | "seed" | "value" | "crest" | "paint";
+  });
+}
+export declare class GateFrameUnsupportedDimensionsError extends GateFrameError {
+  constructor(dimensions: Readonly<{
+    width: number;
+    height: number;
+  }>);
+}
+interface PhysicalInsets {
+  readonly top: number;
+  readonly right: number;
+  readonly bottom: number;
+  readonly left: number;
+}
+export declare class GateFrameInsufficientSpaceError extends GateFrameError {
+  constructor(measured: PhysicalInsets, required: PhysicalInsets);
+}
+export declare class GateFrameNotReadyError extends GateFrameError {
+  constructor();
+}
+export declare class GateFrameDestroyedError extends GateFrameError {
+  constructor();
+}
+type GateFrameStatus = Readonly<{
+  state: "pending";
+}> | Readonly<{
+  state: "ready";
+  snapshot: Readonly<GateSnapshot>;
+}> | Readonly<{
+  state: "error";
+  error: GateFrameError;
+}> | Readonly<{
+  state: "destroyed";
+}>;
+interface GateFrameController {
+  status(): GateFrameStatus;
+  whenReady(): Promise<Readonly<GateSnapshot>>;
+  update(options: GateOptionUpdate): GateFrameController;
+  randomize(seed?: GateSeed): GateSeed;
+  snapshot(): Readonly<GateSnapshot> | null;
+  toSVG(): string;
+  destroy(): void;
+}
+export declare function gateFrame(targetValue: HTMLElement | string, options?: GateOptions): GateFrameController;
+//#endregion
+export type { GateCrest, GateFamily, GateFrameController, GateFrameErrorCode, GateFrameStatus, GateGenerationVersion, GateGeometry, GateGeometryV1, GateGeometryV2, GateGeometryV3, GateOptionUpdate, GateOptions, GateOptionsV1, GateOptionsV2, GateOptionsV3, GatePaintOptions, GateSeed, GateSnapshot, GateSnapshotBase, GateSnapshotV1, GateSnapshotV2, GateSnapshotV3 };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/dom/index.ts"],"mappings":";;UA4BiB;WACN,OAAO;WACP;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;UAGM;WACN,OAAO;WACP;WACA,SAAS;WACT;WACA;WACA;WACA;WACA;WACA,QAAQ;WACR;WACA;WACA;;UAGM,sBAAsB,KAAK;WACjC;;KAGC,cAAc,gBAAgB,gBAAgB;KAE9C,mBACR,QAAQ,kBACP,QAAQ,KAAK;WACH;MAEV,QAAQ,KAAK;WAAkD;;UAEnD;WACN,MAAM;WACN,OAAO,SAAS,SAAS;;UAGnB,uBAAuB;WAC7B;WACA,UAAU,SAAS;;UAGb,uBAAuB;WAC7B;WACA,UAAU,SAAS;;UAGb,uBAAuB;WAC7B;WACA,UAAU,SAAS;;KAGlB,eAAe,iBAAiB,iBAAiB;KAEjD;qBAwBC,uBAAuB;WACjB,MAAM;WACN,SAAS,SAAS;EAEnC,YACE,MAAM,oBACN,iBACA,UAAS,yBACT;;qBAWS,sCAAsC;EACjD,YAAY;;qBAUD,qCAAqC;EAChD,YAAY;;qBAUD,2CAA2C;EACtD,YACE;aAEe;aACA;aACA;;aAEA;aAA2B;;aAC3B;aAA2B;;;qBAWjC,qCAAqC;EAChD,YAAY,QAAQ;;KAUjB;qBAYQ,wCAAwC;EACnD,YACE,QAAQ,aACR,QAAQ,yBACR,UAAS;;qBAWA,0CAA0C;EACrD,YAAY,QAAQ,aAAa,YAAY;;qBAUlC,qCAAqC;EAChD,YAAY;aACD,YAAY;aACZ;aACA;;;qBA0BA,4CAA4C;EACvD,YAAY,YAAY;IAAW;IAAe;;;UAU1C;WACC;WACA;WACA;WACA;;qBAGE,wCAAwC;EACnD,YAAY,UAAU,gBAAgB,UAAU;;qBAUrC,+BAA+B;EAC1C;;qBAKW,gCAAgC;EAC3C;;KAKU,kBACR;EAAW;KACX;EAAW;EAAgB,UAAU,SAAS;KAC9C;EAAW;EAAgB,OAAO;KAClC;EAAW;;UAEE;EACf,UAAU;EACV,aAAa,QAAQ,SAAS;EAC9B,OAAO,SAAS,mBAAmB;EACnC,UAAU,OAAO,WAAW;EAC5B,YAAY,SAAS;EACrB;EACA;;wBAoiBc,UACd,aAAa,sBACb,UAAS,cACR"}