silvermoon 0.3.0-rc.2 → 0.4.0

package/dist/src/foundation/event-codec/grammar.d.ts

@@ -0,0 +1,172 @@
+export type EventCodecOptions = {
+    objectIdLength?: number;
+    legacy?: boolean;
+};
+type EventSource = string | NodeJS.ArrayBufferView | ArrayBuffer;
+type EventPayload = Record<string, string | null>;
+type SignalEvent = {
+    sequence: number;
+    type: "ping" | "pong";
+    payload: EventPayload & {
+        message: string;
+    };
+};
+type FieldEvent = {
+    sequence: number;
+    type: "setAlias" | "setLanguage" | "submitIdeal" | "submitInner" | "submitOuter" | "acceptIdeal" | "acceptInner" | "acceptOuter" | "alias.updated" | "language.updated" | "ideal.approved" | "implementation.accepted" | "deployment.accepted";
+    payload: EventPayload;
+};
+type StateEvent = {
+    sequence: number;
+    type: "abandon" | "resume" | "idea.abandoned" | "idea.resumed";
+};
+export type IdeaEvent = SignalEvent | FieldEvent | StateEvent;
+export type IdeaEventStatus = Record<string, string | true | undefined> & {
+    id: string;
+    alias?: string;
+    language?: string;
+    abandoned?: true;
+    approvedRevision?: string;
+    implementationAcceptedRevision?: string;
+    deploymentAcceptedRevision?: string;
+    submittedIdealRevision?: string;
+    submittedImplementationRevision?: string;
+    submittedDeploymentRevision?: string;
+};
+export type IdeaControlOwner = "upstream" | "downstream" | "none";
+export interface IdeaControl {
+    owner: IdeaControlOwner;
+    lastTransfer: {
+        sequence: number;
+        type: "ping" | "pong" | "submitIdeal" | "submitInner" | "submitOuter" | "acceptIdeal" | "acceptInner" | "acceptOuter" | "abandon" | "resume";
+    } | null;
+}
+export type IdeaEventState = {
+    status: IdeaEventStatus;
+    sequence: number;
+    interaction?: {
+        messages: Array<{
+            sequence: number;
+            type: "ping" | "pong";
+            message: string;
+        }>;
+    };
+    control?: IdeaControl;
+};
+export type IdeaEventReduction = {
+    ok: false;
+    code: string;
+    sequence: number;
+} | {
+    ok: true;
+    state: IdeaEventState;
+};
+/** @pure */
+export declare function eventLifecycleStatus(status: IdeaEventStatus): {
+    version: 1;
+    id: string;
+    alias?: string;
+    language?: string;
+    abandoned?: true;
+    approvedRevision?: string;
+    implementationAcceptedRevision?: string;
+    deploymentAcceptedRevision?: string;
+};
+export declare const EVENT_RENAMES: Readonly<Record<string, string>>;
+export declare const LEGACY_EVENT_TYPES: readonly string[];
+export declare const IDEA_EVENT_TYPES: readonly string[];
+/** @pure */
+export declare function renameLegacyEvents(events: unknown[]): ({
+    type: string;
+    sequence: number;
+    payload: EventPayload & {
+        message: string;
+    };
+} | {
+    type: string;
+    sequence: number;
+    payload: EventPayload;
+} | {
+    type: string;
+    sequence: number;
+})[];
+export declare const EVENT_PERMISSIONS: Readonly<{
+    setAlias: "both";
+    setLanguage: "both";
+    submitIdeal: "downstream";
+    submitInner: "downstream";
+    submitOuter: "downstream";
+    acceptIdeal: "upstream";
+    acceptInner: "upstream";
+    acceptOuter: "upstream";
+    abandon: "upstream";
+    resume: "upstream";
+    ping: "upstream";
+    pong: "downstream";
+}>;
+export declare class IdeaEventFormatError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** @pure */
+export declare function validateIdeaEvent(event: unknown, options?: EventCodecOptions): IdeaEvent;
+/** @pure */
+export declare function serializeIdeaEvent(event: unknown, options?: EventCodecOptions): string;
+/** @pure */
+export declare function serializeIdeaEvents(events: unknown, options?: EventCodecOptions): string;
+/** @pure */
+export declare function parseIdeaEvents(source: EventSource | undefined, options?: EventCodecOptions): IdeaEvent[];
+/** @pure */
+export declare function initialEventState(ideaId: string | undefined, options?: EventCodecOptions): IdeaEventState;
+/** @pure */
+export declare function reduceIdeaEvent(before: IdeaEventState, event: unknown, options?: EventCodecOptions): IdeaEventReduction;
+/** @pure */
+export declare function replayIdeaEvents(ideaId: string, events: readonly unknown[], options?: EventCodecOptions): IdeaEventReduction;
+/** @pure */
+export declare function eventsFromStatus(status: IdeaEventStatus & {
+    version: 1;
+}, options?: EventCodecOptions): ({
+    sequence: number;
+    type: string | undefined;
+    payload: {
+        [x: string]: string | true | undefined;
+    };
+} | {
+    sequence: number;
+    type: string;
+    payload?: never;
+})[];
+/** @pure */
+export declare function checkEventChange(ideaId: string, baseSource: EventSource, candidateSource: EventSource, options?: EventCodecOptions): {
+    ok: boolean;
+    mode: string;
+    base: IdeaEventReduction;
+    candidate: {
+        ok: false;
+        code: string;
+        sequence: number;
+    };
+    code: string;
+} | {
+    ok: boolean;
+    mode: string;
+    base: {
+        ok: true;
+        state: IdeaEventState;
+    };
+    candidate: {
+        ok: true;
+        state: IdeaEventState;
+    };
+    code: string;
+} | {
+    ok: boolean;
+    mode: string;
+    base: IdeaEventReduction;
+    candidate: {
+        ok: true;
+        state: IdeaEventState;
+    };
+    code?: never;
+};
+export {};
+//# sourceMappingURL=grammar.d.ts.map

package/dist/src/foundation/event-codec/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../../../../src/foundation/event-codec/grammar.ts"],"names":[],"mappings":"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"}

package/dist/src/foundation/event-codec/grammar.js

@@ -0,0 +1,383 @@
+import { isDeepStrictEqual } from "node:util";
+import { isValidUlid, validateIdeaStatus } from "../idea-model/index.js";
+/** @pure */
+export function eventLifecycleStatus(status) {
+    return validateIdeaStatus({
+        version: 1,
+        id: status.id,
+        ...(status.alias === undefined ? {} : { alias: status.alias }),
+        ...(status.language === undefined ? {} : { language: status.language }),
+        ...(status.abandoned === undefined ? {} : { abandoned: status.abandoned }),
+        ...(status.approvedRevision === undefined
+            ? {}
+            : { approvedRevision: status.approvedRevision }),
+        ...(status.implementationAcceptedRevision === undefined
+            ? {}
+            : {
+                implementationAcceptedRevision: status.implementationAcceptedRevision,
+            }),
+        ...(status.deploymentAcceptedRevision === undefined
+            ? {}
+            : {
+                deploymentAcceptedRevision: status.deploymentAcceptedRevision,
+            }),
+    });
+}
+const LEGACY_FIELDS = Object.freeze({
+    "alias.updated": ["alias", "alias"],
+    "language.updated": ["language", "language"],
+    "ideal.approved": ["idealRevision", "approvedRevision"],
+    "implementation.accepted": ["implementationRevision", "implementationAcceptedRevision"],
+    "deployment.accepted": ["deploymentRevision", "deploymentAcceptedRevision"],
+});
+const SUBMISSION_FIELDS = Object.freeze({
+    submitIdeal: ["idealRevision", "submittedIdealRevision", "approvedRevision"],
+    submitInner: [
+        "implementationRevision",
+        "submittedImplementationRevision",
+        "implementationAcceptedRevision",
+    ],
+    submitOuter: [
+        "deploymentRevision",
+        "submittedDeploymentRevision",
+        "deploymentAcceptedRevision",
+    ],
+});
+export const EVENT_RENAMES = Object.freeze({
+    "alias.updated": "setAlias",
+    "language.updated": "setLanguage",
+    "ideal.approved": "acceptIdeal",
+    "implementation.accepted": "acceptInner",
+    "deployment.accepted": "acceptOuter",
+    "idea.abandoned": "abandon",
+    "idea.resumed": "resume",
+});
+export const LEGACY_EVENT_TYPES = Object.freeze([
+    ...Object.keys(LEGACY_FIELDS), "idea.abandoned", "idea.resumed",
+]);
+export const IDEA_EVENT_TYPES = Object.freeze([
+    ...Object.values(EVENT_RENAMES),
+    ...Object.keys(SUBMISSION_FIELDS),
+    "ping",
+    "pong",
+]);
+/** @pure */
+export function renameLegacyEvents(events) {
+    return events.map((event) => {
+        const validated = validateIdeaEvent(event, { legacy: true });
+        const type = EVENT_RENAMES[validated.type];
+        if (!type)
+            throw new IdeaEventFormatError(`unsupported legacy event type: ${validated.type}`);
+        return { ...validated, type };
+    });
+}
+export const EVENT_PERMISSIONS = Object.freeze({
+    setAlias: "both",
+    setLanguage: "both",
+    submitIdeal: "downstream",
+    submitInner: "downstream",
+    submitOuter: "downstream",
+    acceptIdeal: "upstream",
+    acceptInner: "upstream",
+    acceptOuter: "upstream",
+    abandon: "upstream",
+    resume: "upstream",
+    ping: "upstream",
+    pong: "downstream",
+});
+const LEGACY_TYPES = Object.fromEntries(Object.entries(EVENT_RENAMES).map(([legacy, current]) => [current, legacy]));
+const CONTROL_OWNERS = Object.freeze({
+    ping: "downstream",
+    pong: "upstream",
+    submitIdeal: "upstream",
+    submitInner: "upstream",
+    submitOuter: "upstream",
+    acceptIdeal: "downstream",
+    acceptInner: "downstream",
+    acceptOuter: "none",
+    abandon: "none",
+    resume: "downstream",
+});
+const VALIDATION_ID = "00000000000000000000000000";
+/** @pure */
+function fieldDefinition(type, legacy) {
+    if (legacy)
+        return LEGACY_FIELDS[type];
+    const legacyType = LEGACY_TYPES[type];
+    return (legacyType === undefined ? undefined : LEGACY_FIELDS[legacyType])
+        ?? SUBMISSION_FIELDS[type];
+}
+export class IdeaEventFormatError extends Error {
+    constructor(message, options) {
+        super(`Invalid idea events: ${message}`, options);
+        this.name = "IdeaEventFormatError";
+    }
+}
+/** @pure */
+function keys(value, expected, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)
+        || Object.keys(value).length !== expected.length
+        || expected.some((key) => !Object.hasOwn(value, key)))
+        throw new IdeaEventFormatError(`${label} requires exactly ${expected.join(", ")}`);
+}
+/** @pure */
+function errorMessage(cause) {
+    return cause instanceof Error ? cause.message : String(cause);
+}
+/** @pure */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** @pure */
+function payloadValue(event, key) {
+    if (!("payload" in event)) {
+        throw new IdeaEventFormatError(`payload requires exactly ${key}`);
+    }
+    const value = event.payload[key];
+    if (typeof value !== "string" && value !== null) {
+        throw new IdeaEventFormatError(`payload requires exactly ${key}`);
+    }
+    return value;
+}
+/** @pure */
+function assertValidIdeaEvent(event, options) {
+    const legacy = options?.legacy === true;
+    const type = isRecord(event) ? event.type : undefined;
+    if (typeof type !== "string"
+        || !(legacy ? LEGACY_EVENT_TYPES : IDEA_EVENT_TYPES).includes(type)) {
+        throw new IdeaEventFormatError(`unsupported event type: ${String(type)}`);
+    }
+    const field = fieldDefinition(type, legacy);
+    const message = !legacy && (type === "ping" || type === "pong");
+    keys(event, field || message ? ["sequence", "type", "payload"] : ["sequence", "type"], "event");
+    if (!Number.isSafeInteger(event.sequence)
+        || typeof event.sequence !== "number" || event.sequence < 1) {
+        throw new IdeaEventFormatError("sequence must be a positive safe integer");
+    }
+    if (field) {
+        const [input, output, validationOutput = output] = field;
+        keys(event.payload, [input], "payload");
+        const value = event.payload[input];
+        if (value === null && (output === "alias" || output === "language"))
+            return;
+        try {
+            validateIdeaStatus({
+                version: 1,
+                id: VALIDATION_ID,
+                [validationOutput]: value,
+            }, options);
+        }
+        catch (cause) {
+            throw new IdeaEventFormatError(errorMessage(cause), { cause });
+        }
+    }
+    if (message) {
+        keys(event.payload, ["message"], "payload");
+        if (typeof event.payload.message !== "string" || !event.payload.message.trim()) {
+            throw new IdeaEventFormatError("message must be a nonempty string");
+        }
+    }
+}
+/** @pure */
+export function validateIdeaEvent(event, options) {
+    assertValidIdeaEvent(event, options);
+    return event;
+}
+/** @pure */
+export function serializeIdeaEvent(event, options) {
+    const validated = validateIdeaEvent(event, options);
+    const value = {
+        sequence: validated.sequence,
+        type: validated.type,
+    };
+    const field = fieldDefinition(validated.type, options?.legacy === true);
+    if (field && "payload" in validated) {
+        value.payload = { [field[0]]: payloadValue(validated, field[0]) };
+    }
+    else if (validated.type === "ping" || validated.type === "pong") {
+        value.payload = { message: validated.payload.message };
+    }
+    return JSON.stringify(value);
+}
+/** @pure */
+export function serializeIdeaEvents(events, options) {
+    if (!Array.isArray(events))
+        throw new IdeaEventFormatError("events must be an array");
+    return events.map((event) => `${serializeIdeaEvent(event, options)}\n`).join("");
+}
+/** @pure */
+export function parseIdeaEvents(source, options) {
+    let text;
+    try {
+        text = typeof source === "string"
+            ? source
+            : new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(source);
+    }
+    catch (cause) {
+        throw new IdeaEventFormatError("log must contain valid UTF-8", { cause });
+    }
+    if (text === "")
+        return [];
+    if (!text.endsWith("\n"))
+        throw new IdeaEventFormatError("last record must end with LF");
+    return text.slice(0, -1).split("\n").map((line, index) => {
+        try {
+            const event = JSON.parse(line);
+            if (serializeIdeaEvent(event, options) !== line) {
+                throw new IdeaEventFormatError("record is not canonical JSON");
+            }
+            return event;
+        }
+        catch (cause) {
+            throw new IdeaEventFormatError(`line ${index + 1}: ${errorMessage(cause)}`, { cause });
+        }
+    });
+}
+/** @pure */
+export function initialEventState(ideaId, options) {
+    if (!isValidUlid(ideaId))
+        throw new IdeaEventFormatError("invalid idea identity");
+    return options?.legacy
+        ? { status: { id: ideaId }, sequence: 0 }
+        : {
+            status: { id: ideaId },
+            sequence: 0,
+            interaction: { messages: [] },
+            control: { owner: "downstream", lastTransfer: null },
+        };
+}
+/** @pure */
+function nextControl(before, event) {
+    if (!before.control) {
+        throw new IdeaEventFormatError("current events require control state");
+    }
+    const owner = CONTROL_OWNERS[event.type];
+    if (owner === undefined)
+        return before.control;
+    return {
+        owner,
+        lastTransfer: {
+            sequence: event.sequence,
+            type: event.type,
+        },
+    };
+}
+/** @pure */
+export function reduceIdeaEvent(before, event, options) {
+    const validated = validateIdeaEvent(event, options);
+    const reject = (code) => ({ ok: false, code, sequence: validated.sequence });
+    if (validated.sequence !== before.sequence + 1)
+        return reject("sequence-conflict");
+    const legacy = options?.legacy === true;
+    if (!legacy && before.status.abandoned && validated.type !== "resume")
+        return reject("abandoned");
+    const status = { ...before.status };
+    const field = fieldDefinition(validated.type, legacy);
+    if (field && "payload" in validated) {
+        const [input, output] = field;
+        const value = payloadValue(validated, input);
+        if (value === null)
+            delete status[output];
+        else
+            status[output] = value;
+    }
+    else if (validated.type === "idea.abandoned" || validated.type === "abandon") {
+        status.abandoned = true;
+    }
+    else if (validated.type === "idea.resumed" || validated.type === "resume") {
+        delete status.abandoned;
+    }
+    if (!legacy && (validated.type === "ping" || validated.type === "pong")) {
+        if (!before.interaction) {
+            throw new IdeaEventFormatError("current events require interaction state");
+        }
+        return { ok: true, state: {
+                status, sequence: validated.sequence,
+                interaction: {
+                    messages: [...before.interaction.messages, {
+                            sequence: validated.sequence,
+                            type: validated.type,
+                            message: validated.payload.message,
+                        }],
+                },
+                control: nextControl(before, validated),
+            } };
+    }
+    if (isDeepStrictEqual(status, before.status))
+        return reject("no-state-change");
+    if (legacy)
+        return { ok: true, state: { status, sequence: validated.sequence } };
+    if (!before.interaction) {
+        throw new IdeaEventFormatError("current events require interaction state");
+    }
+    return { ok: true, state: {
+            status,
+            sequence: validated.sequence,
+            interaction: before.interaction,
+            control: nextControl(before, validated),
+        } };
+}
+/** @pure */
+export function replayIdeaEvents(ideaId, events, options) {
+    let state = initialEventState(ideaId, options);
+    for (const event of events) {
+        const result = reduceIdeaEvent(state, event, options);
+        if (!result.ok)
+            return result;
+        state = result.state;
+    }
+    return { ok: true, state };
+}
+// The migration order is a representation order, not a reconstructed chronology.
+/** @pure */
+export function eventsFromStatus(status, options) {
+    validateIdeaStatus(status, options);
+    const events = [];
+    for (const [type, [input, output]] of Object.entries(LEGACY_FIELDS)) {
+        if (Object.hasOwn(status, output)) {
+            events.push({ sequence: events.length + 1,
+                type: options?.legacy ? type : EVENT_RENAMES[type],
+                payload: { [input]: status[output] } });
+        }
+    }
+    if (status.abandoned)
+        events.push({ sequence: events.length + 1,
+            type: options?.legacy ? "idea.abandoned" : "abandon" });
+    return events;
+}
+/** @pure */
+export function checkEventChange(ideaId, baseSource, candidateSource, options) {
+    // Format errors deliberately do not become reduction failures or repair permission.
+    function inspect(source, stage) {
+        try {
+            return replayIdeaEvents(ideaId, parseIdeaEvents(source, options), options);
+        }
+        catch (cause) {
+            if (cause instanceof Error) {
+                Object.defineProperty(cause, "eventStage", { value: stage, configurable: true });
+            }
+            throw cause;
+        }
+    }
+    const base = inspect(baseSource, "base");
+    const candidate = inspect(candidateSource, "candidate");
+    const mode = base.ok ? "append" : "repair";
+    if (!candidate.ok)
+        return { ok: false, mode, base, candidate, code: candidate.code };
+    const baseBytes = sourceBuffer(baseSource);
+    if (base.ok && !sourceBuffer(candidateSource).subarray(0, baseBytes.length)
+        .equals(baseBytes)) {
+        return { ok: false, mode, base, candidate, code: "not-append-only" };
+    }
+    return { ok: true, mode, base, candidate };
+}
+/** @pure */
+function sourceBuffer(source) {
+    if (typeof source === "string")
+        return Buffer.from(source);
+    if (ArrayBuffer.isView(source)) {
+        return Buffer.from(source.buffer, source.byteOffset, source.byteLength);
+    }
+    return Buffer.from(source);
+}
+//# sourceMappingURL=grammar.js.map

package/dist/src/foundation/event-codec/grammar.js.map

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

package/dist/src/foundation/event-codec/index.d.ts

@@ -0,0 +1,3 @@
+export { EVENT_PERMISSIONS, EVENT_RENAMES, IDEA_EVENT_TYPES, IdeaEventFormatError, LEGACY_EVENT_TYPES, checkEventChange, eventLifecycleStatus, eventsFromStatus, initialEventState, parseIdeaEvents, reduceIdeaEvent, renameLegacyEvents, replayIdeaEvents, serializeIdeaEvent, serializeIdeaEvents, validateIdeaEvent, } from "./grammar.ts";
+export type { EventCodecOptions, IdeaEvent, IdeaEventReduction, IdeaEventState, IdeaEventStatus, } from "./grammar.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/event-codec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/event-codec/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/src/foundation/event-codec/index.js

@@ -0,0 +1,2 @@
+export { EVENT_PERMISSIONS, EVENT_RENAMES, IDEA_EVENT_TYPES, IdeaEventFormatError, LEGACY_EVENT_TYPES, checkEventChange, eventLifecycleStatus, eventsFromStatus, initialEventState, parseIdeaEvents, reduceIdeaEvent, renameLegacyEvents, replayIdeaEvents, serializeIdeaEvent, serializeIdeaEvents, validateIdeaEvent, } from "./grammar.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/event-codec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/event-codec/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC"}

package/dist/src/foundation/event-cursor/cursor.d.ts

@@ -0,0 +1,40 @@
+type SnapshotEntry = {
+    mode: string;
+    type: string;
+    name: string;
+    object: string;
+    size: number;
+};
+type SnapshotFileSystem = {
+    lstat(path: string): Promise<{
+        isDirectory(): boolean;
+        isFile(): boolean;
+        isSymbolicLink(): boolean;
+    }>;
+    readFile(path: string): Promise<Buffer>;
+    readdir(path: string): Promise<string[]>;
+    snapshotEntries(path: unknown): SnapshotEntry[];
+    snapshotFile(path: unknown): Promise<Buffer>;
+    snapshotEntry?(path: string): SnapshotEntry | null | undefined;
+};
+export declare function readEventDelta(root: string, paths: {
+    eventsPath: string;
+}, options: {
+    objectIdLength: number;
+    legacy?: boolean;
+}, filesystem: SnapshotFileSystem, cursor: {
+    length: number;
+    digest: string;
+}): Promise<{
+    outcome: string;
+    length: number;
+    digest: string;
+    after: {
+        length: number;
+        digest: string;
+    };
+    events: import("../event-codec/grammar.ts").IdeaEvent[];
+    sequence: number;
+}>;
+export {};
+//# sourceMappingURL=cursor.d.ts.map

package/dist/src/foundation/event-cursor/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../../src/foundation/event-cursor/cursor.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3B,WAAW,IAAI,OAAO,CAAC;QACvB,MAAM,IAAI,OAAO,CAAC;QAClB,cAAc,IAAI,OAAO,CAAC;KAC3B,CAAC,CAAC;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,CAAC;IAChD,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;CAChE,CAAC;AAEF,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAC7B,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EACrD,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;GA0C3C"}