@stego-labs/shared 1.0.1

package/README.md

@@ -0,0 +1,13 @@
+# @stego-labs/shared
+
+`@stego-labs/shared` contains shared contracts and domain primitives used across Stego packages.
+
+Public subpaths:
+
+- `@stego-labs/shared/contracts/cli`
+- `@stego-labs/shared/domain/comments`
+- `@stego-labs/shared/domain/frontmatter`
+- `@stego-labs/shared/domain/images`
+- `@stego-labs/shared/domain/project`
+- `@stego-labs/shared/domain/stages`
+- `@stego-labs/shared/utils`

package/dist/contracts/cli/comments.d.ts

@@ -0,0 +1,98 @@
+import type { CommentStatus, SerializedCommentDocumentState } from "../../domain/comments/index.ts";
+import type { CliOperation } from "./operations.ts";
+type CommentsOperation = Extract<CliOperation, `comments.${string}`>;
+export type CommentsSubcommand = CommentsOperation extends `comments.${infer Subcommand}` ? Subcommand : never;
+export type CommentRangePayload = {
+    start: {
+        line: number;
+        col: number;
+    };
+    end: {
+        line: number;
+        col: number;
+    };
+};
+export type CommentAddPayload = {
+    message: string;
+    author?: string;
+    anchor?: {
+        range?: CommentRangePayload;
+        cursor_line?: number;
+        excerpt?: string;
+    };
+    meta?: Record<string, unknown>;
+};
+export type CommentReplyPayload = {
+    message: string;
+    author?: string;
+};
+export type CommentSyncAnchorsPayload = {
+    updates?: Array<{
+        id: string;
+        start: {
+            line: number;
+            col: number;
+        };
+        end: {
+            line: number;
+            col: number;
+        };
+    }>;
+    delete_ids?: string[];
+};
+export type CommentsReadEnvelope = {
+    ok: true;
+    operation: "read";
+    manuscript: string;
+    state: SerializedCommentDocumentState;
+};
+export type CommentsAddEnvelope = {
+    ok: true;
+    operation: "add";
+    manuscript: string;
+    commentId: string;
+    state: SerializedCommentDocumentState;
+};
+export type CommentsReplyEnvelope = {
+    ok: true;
+    operation: "reply";
+    manuscript: string;
+    commentId: string;
+    state: SerializedCommentDocumentState;
+};
+export type CommentsSetStatusEnvelope = {
+    ok: true;
+    operation: "set-status";
+    manuscript: string;
+    status: CommentStatus;
+    changedIds: string[];
+    state: SerializedCommentDocumentState;
+};
+export type CommentsDeleteEnvelope = {
+    ok: true;
+    operation: "delete";
+    manuscript: string;
+    removed: number;
+    state: SerializedCommentDocumentState;
+};
+export type CommentsClearResolvedEnvelope = {
+    ok: true;
+    operation: "clear-resolved";
+    manuscript: string;
+    removed: number;
+    state: SerializedCommentDocumentState;
+};
+export type CommentsSyncAnchorsEnvelope = {
+    ok: true;
+    operation: "sync-anchors";
+    manuscript: string;
+    updatedCount: number;
+    deletedCount: number;
+    state: SerializedCommentDocumentState;
+};
+export type CommentsSuccessEnvelope = CommentsReadEnvelope | CommentsAddEnvelope | CommentsReplyEnvelope | CommentsSetStatusEnvelope | CommentsDeleteEnvelope | CommentsClearResolvedEnvelope | CommentsSyncAnchorsEnvelope;
+export type CommentsSuccessEnvelopeFor<TSubcommand extends CommentsSubcommand> = Extract<CommentsSuccessEnvelope, {
+    operation: TSubcommand;
+}>;
+export {};
+//# sourceMappingURL=comments.d.ts.map

package/dist/contracts/cli/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,8BAA8B,EAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,KAAK,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,YAAY,MAAM,EAAE,CAAC,CAAC;AAErE,MAAM,MAAM,kBAAkB,GAC5B,iBAAiB,SAAS,YAAY,MAAM,UAAU,EAAE,GACpD,UAAU,GACV,KAAK,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,mBAAmB,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACrC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACpC,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,8BAA8B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,KAAK,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,8BAA8B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,8BAA8B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,8BAA8B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,8BAA8B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,8BAA8B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,cAAc,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,8BAA8B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,oBAAoB,GACpB,mBAAmB,GACnB,qBAAqB,GACrB,yBAAyB,GACzB,sBAAsB,GACtB,6BAA6B,GAC7B,2BAA2B,CAAC;AAEhC,MAAM,MAAM,0BAA0B,CAAC,WAAW,SAAS,kBAAkB,IAC3E,OAAO,CAAC,uBAAuB,EAAE;IAAE,SAAS,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC"}

package/dist/contracts/cli/comments.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=comments.js.map

package/dist/contracts/cli/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/contracts/cli/comments.ts"],"names":[],"mappings":""}

package/dist/contracts/cli/envelopes.d.ts

@@ -0,0 +1,23 @@
+import type { CliOperation } from "./operations.ts";
+import type { CliErrorCode } from "./errors.ts";
+export declare const CLI_CONTRACT_VERSION = 1;
+export type CliSuccessEnvelope<TPayload> = {
+    ok: true;
+    version: number;
+    operation: CliOperation;
+    data: TPayload;
+};
+export type CliErrorEnvelope = {
+    ok: false;
+    version: number;
+    operation?: CliOperation;
+    code: CliErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+};
+export declare function successEnvelope<TPayload>(operation: CliOperation, data: TPayload): CliSuccessEnvelope<TPayload>;
+export declare function errorEnvelope(code: CliErrorCode, message: string, options?: {
+    operation?: CliOperation;
+    details?: Record<string, unknown>;
+}): CliErrorEnvelope;
+//# sourceMappingURL=envelopes.d.ts.map

package/dist/contracts/cli/envelopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelopes.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/envelopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,MAAM,MAAM,kBAAkB,CAAC,QAAQ,IAAI;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,CAAC;IACxB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,wBAAgB,eAAe,CAAC,QAAQ,EACtC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,QAAQ,GACb,kBAAkB,CAAC,QAAQ,CAAC,CAO9B;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACxE,gBAAgB,CASlB"}

package/dist/contracts/cli/envelopes.js

@@ -0,0 +1,20 @@
+export const CLI_CONTRACT_VERSION = 1;
+export function successEnvelope(operation, data) {
+    return {
+        ok: true,
+        version: CLI_CONTRACT_VERSION,
+        operation,
+        data
+    };
+}
+export function errorEnvelope(code, message, options) {
+    return {
+        ok: false,
+        version: CLI_CONTRACT_VERSION,
+        operation: options?.operation,
+        code,
+        message,
+        details: options?.details
+    };
+}
+//# sourceMappingURL=envelopes.js.map

package/dist/contracts/cli/envelopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelopes.js","sourceRoot":"","sources":["../../../src/contracts/cli/envelopes.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAkBtC,MAAM,UAAU,eAAe,CAC7B,SAAuB,EACvB,IAAc;IAEd,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,oBAAoB;QAC7B,SAAS;QACT,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAkB,EAClB,OAAe,EACf,OAAyE;IAEzE,OAAO;QACL,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,OAAO,EAAE,OAAO;KAC1B,CAAC;AACJ,CAAC"}

package/dist/contracts/cli/errors.d.ts

@@ -0,0 +1,8 @@
+export type CliErrorCode = "INVALID_USAGE" | "WORKSPACE_NOT_FOUND" | "PROJECT_NOT_FOUND" | "INVALID_CONFIGURATION" | "INVALID_PAYLOAD" | "VALIDATION_FAILED" | "COMMENT_APPENDIX_INVALID" | "WRITE_FAILURE" | "TOOLING_MISSING" | "INTERNAL_ERROR";
+export declare class CliError extends Error {
+    readonly code: CliErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: CliErrorCode, message: string, details?: Record<string, unknown>);
+    get exitCode(): number;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/contracts/cli/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/errors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,qBAAqB,GACrB,mBAAmB,GACnB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,0BAA0B,GAC1B,eAAe,GACf,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,YAAY,CAAC;IAEnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOzF,IAAW,QAAQ,IAAI,MAAM,CAE5B;CACF"}

package/dist/contracts/cli/errors.js

@@ -0,0 +1,15 @@
+import { getExitCodeForError } from "./exit-codes.js";
+export class CliError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "CliError";
+        this.code = code;
+        this.details = details;
+    }
+    get exitCode() {
+        return getExitCodeForError(this.code);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/contracts/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/contracts/cli/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AActD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,IAAI,CAAe;IAEnB,OAAO,CAA2B;IAElD,YAAmB,IAAkB,EAAE,OAAe,EAAE,OAAiC;QACvF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/contracts/cli/exit-codes.d.ts

@@ -0,0 +1,3 @@
+import type { CliErrorCode } from "./errors.ts";
+export declare function getExitCodeForError(code: CliErrorCode): number;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/contracts/cli/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAehD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE9D"}

package/dist/contracts/cli/exit-codes.js

@@ -0,0 +1,16 @@
+const EXIT_CODES = {
+    INVALID_USAGE: 2,
+    WORKSPACE_NOT_FOUND: 3,
+    PROJECT_NOT_FOUND: 3,
+    INVALID_CONFIGURATION: 4,
+    INVALID_PAYLOAD: 4,
+    VALIDATION_FAILED: 5,
+    COMMENT_APPENDIX_INVALID: 5,
+    WRITE_FAILURE: 6,
+    TOOLING_MISSING: 7,
+    INTERNAL_ERROR: 1
+};
+export function getExitCodeForError(code) {
+    return EXIT_CODES[code] ?? 1;
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/contracts/cli/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../../src/contracts/cli/exit-codes.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAiC;IAC/C,aAAa,EAAE,CAAC;IAChB,mBAAmB,EAAE,CAAC;IACtB,iBAAiB,EAAE,CAAC;IACpB,qBAAqB,EAAE,CAAC;IACxB,eAAe,EAAE,CAAC;IAClB,iBAAiB,EAAE,CAAC;IACpB,wBAAwB,EAAE,CAAC;IAC3B,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,CAAC;IAClB,cAAc,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACpD,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/contracts/cli/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./operations.ts";
+export * from "./errors.ts";
+export * from "./exit-codes.ts";
+export * from "./envelopes.ts";
+export * from "./comments.ts";
+export * from "./metadata.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/contracts/cli/index.js

@@ -0,0 +1,7 @@
+export * from "./operations.js";
+export * from "./errors.js";
+export * from "./exit-codes.js";
+export * from "./envelopes.js";
+export * from "./comments.js";
+export * from "./metadata.js";
+//# sourceMappingURL=index.js.map

package/dist/contracts/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/contracts/cli/metadata.d.ts

@@ -0,0 +1,32 @@
+import type { CliOperation } from "./operations.ts";
+type MetadataOperation = Extract<CliOperation, `metadata.${string}`>;
+export type MetadataSubcommand = MetadataOperation extends `metadata.${infer Subcommand}` ? Subcommand : never;
+export type MetadataState = {
+    path: string;
+    hasFrontmatter: boolean;
+    lineEnding: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+export type MetadataReadEnvelope = {
+    ok: true;
+    operation: "read";
+    state: MetadataState;
+};
+export type MetadataApplyEnvelope = {
+    ok: true;
+    operation: "apply";
+    changed: boolean;
+    state: MetadataState;
+};
+export type MetadataSuccessEnvelope = MetadataReadEnvelope | MetadataApplyEnvelope;
+export type MetadataSuccessEnvelopeFor<TSubcommand extends MetadataSubcommand> = Extract<MetadataSuccessEnvelope, {
+    operation: TSubcommand;
+}>;
+export type MetadataApplyPayload = {
+    frontmatter: Record<string, unknown>;
+    body?: string;
+    hasFrontmatter?: boolean;
+};
+export {};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/contracts/cli/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,KAAK,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,YAAY,MAAM,EAAE,CAAC,CAAC;AAErE,MAAM,MAAM,kBAAkB,GAC5B,iBAAiB,SAAS,YAAY,MAAM,UAAU,EAAE,GACpD,UAAU,GACV,KAAK,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAEnF,MAAM,MAAM,0BAA0B,CAAC,WAAW,SAAS,kBAAkB,IAC3E,OAAO,CAAC,uBAAuB,EAAE;IAAE,SAAS,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC"}

package/dist/contracts/cli/metadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metadata.js.map

package/dist/contracts/cli/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/contracts/cli/metadata.ts"],"names":[],"mappings":""}

package/dist/contracts/cli/operations.d.ts

@@ -0,0 +1,2 @@
+export type CliOperation = "init" | "list-projects" | "new-project" | "new" | "validate" | "build" | "check-stage" | "lint" | "export" | "spine.read" | "spine.new-category" | "spine.new" | "metadata.read" | "metadata.apply" | "comments.read" | "comments.add" | "comments.reply" | "comments.set-status" | "comments.delete" | "comments.clear-resolved" | "comments.sync-anchors";
+//# sourceMappingURL=operations.d.ts.map

package/dist/contracts/cli/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/operations.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,eAAe,GACf,aAAa,GACb,KAAK,GACL,UAAU,GACV,OAAO,GACP,aAAa,GACb,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,oBAAoB,GACpB,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,qBAAqB,GACrB,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,CAAC"}

package/dist/contracts/cli/operations.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operations.js.map

package/dist/contracts/cli/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/contracts/cli/operations.ts"],"names":[],"mappings":""}

package/dist/domain/comments/anchors.d.ts

@@ -0,0 +1,2 @@
+export { addCommentToState, replyToCommentInState, setCommentStatusInState, deleteCommentInState, clearResolvedInState, syncAnchorsInState, normalizeAuthor } from "./parser.ts";
+//# sourceMappingURL=anchors.d.ts.map

package/dist/domain/comments/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../../src/domain/comments/anchors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,aAAa,CAAC"}

package/dist/domain/comments/anchors.js

@@ -0,0 +1,2 @@
+export { addCommentToState, replyToCommentInState, setCommentStatusInState, deleteCommentInState, clearResolvedInState, syncAnchorsInState, normalizeAuthor } from "./parser.js";
+//# sourceMappingURL=anchors.js.map

package/dist/domain/comments/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../src/domain/comments/anchors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,aAAa,CAAC"}

package/dist/domain/comments/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./parser.ts";
+export * from "./serializer.ts";
+export * from "./anchors.ts";
+export * from "./thread-key.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/comments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/comments/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/domain/comments/index.js

@@ -0,0 +1,5 @@
+export * from "./parser.js";
+export * from "./serializer.js";
+export * from "./anchors.js";
+export * from "./thread-key.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/comments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/comments/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/domain/comments/parser.d.ts

@@ -0,0 +1,136 @@
+export declare const START_SENTINEL = "<!-- stego-comments:start -->";
+export declare const END_SENTINEL = "<!-- stego-comments:end -->";
+export type CommentStatus = "open" | "resolved";
+export type CommentRange = {
+    startLine: number;
+    startCol: number;
+    endLine: number;
+    endCol: number;
+};
+export type CommentThread = {
+    id: string;
+    status: CommentStatus;
+    createdAt?: string;
+    timezone?: string;
+    timezoneOffsetMinutes?: number;
+    paragraphIndex?: number;
+    excerpt?: string;
+    excerptStartLine?: number;
+    excerptStartCol?: number;
+    excerptEndLine?: number;
+    excerptEndCol?: number;
+    thread: string[];
+};
+export type ParagraphInfo = {
+    index: number;
+    startLine: number;
+    endLine: number;
+    text: string;
+};
+export type CommentAnchor = {
+    anchorType: "paragraph" | "file";
+    line: number;
+    degraded: boolean;
+    underlineStartLine?: number;
+    underlineStartCol?: number;
+    underlineEndLine?: number;
+    underlineEndCol?: number;
+    paragraphEndLine?: number;
+};
+export type ParsedCommentAppendix = {
+    contentWithoutComments: string;
+    comments: CommentThread[];
+    errors: string[];
+};
+export type LoadedCommentDocumentState = {
+    lineEnding: string;
+    contentWithoutComments: string;
+    comments: CommentThread[];
+    errors: string[];
+    paragraphs: ParagraphInfo[];
+    anchorsById: Map<string, CommentAnchor>;
+};
+export type SerializedCommentDocumentState = {
+    contentWithoutComments: string;
+    comments: CommentThread[];
+    parseErrors: string[];
+    anchorsById: Record<string, CommentAnchor>;
+    totalCount: number;
+    unresolvedCount: number;
+};
+export type AddCommentAnchorInput = {
+    range?: CommentRange;
+    cursorLine?: number;
+    excerpt?: string;
+};
+export type AddCommentInput = {
+    message: string;
+    author?: string;
+    anchor?: AddCommentAnchorInput;
+    meta?: Record<string, unknown>;
+};
+export type ReplyCommentInput = {
+    commentId: string;
+    message: string;
+    author?: string;
+};
+export type SetStatusInput = {
+    commentId: string;
+    status: CommentStatus;
+    thread?: boolean;
+};
+export type SyncAnchorUpdate = {
+    id: string;
+    start: {
+        line: number;
+        col: number;
+    };
+    end: {
+        line: number;
+        col: number;
+    };
+};
+export type SyncAnchorsInput = {
+    updates?: SyncAnchorUpdate[];
+    deleteIds?: string[];
+};
+export type AddCommentResult = {
+    commentId: string;
+    comments: CommentThread[];
+};
+export type ReplyCommentResult = {
+    commentId: string;
+    comments: CommentThread[];
+};
+export type SetStatusResult = {
+    changedIds: string[];
+    comments: CommentThread[];
+};
+export type DeleteCommentResult = {
+    removed: number;
+    comments: CommentThread[];
+};
+export type ClearResolvedResult = {
+    removed: number;
+    comments: CommentThread[];
+};
+export type SyncAnchorsResult = {
+    updatedCount: number;
+    deletedCount: number;
+    comments: CommentThread[];
+};
+export declare function parseCommentAppendix(markdown: string): ParsedCommentAppendix;
+export declare function serializeCommentAppendix(comments: CommentThread[], lineEnding?: string): string;
+export declare function upsertCommentAppendix(contentWithoutComments: string, comments: CommentThread[], lineEnding?: string): string;
+export declare function loadCommentDocumentState(markdownText: string): LoadedCommentDocumentState;
+export declare function serializeLoadedState(state: LoadedCommentDocumentState): SerializedCommentDocumentState;
+export declare function ensureNoParseErrors(state: LoadedCommentDocumentState): void;
+export declare function addCommentToState(markdownText: string, state: LoadedCommentDocumentState, input: AddCommentInput): AddCommentResult;
+export declare function replyToCommentInState(state: LoadedCommentDocumentState, input: ReplyCommentInput): ReplyCommentResult;
+export declare function setCommentStatusInState(state: LoadedCommentDocumentState, input: SetStatusInput): SetStatusResult;
+export declare function deleteCommentInState(state: LoadedCommentDocumentState, commentId: string): DeleteCommentResult;
+export declare function clearResolvedInState(state: LoadedCommentDocumentState): ClearResolvedResult;
+export declare function syncAnchorsInState(markdownText: string, state: LoadedCommentDocumentState, input: SyncAnchorsInput): SyncAnchorsResult;
+export declare function renderStateDocument(state: LoadedCommentDocumentState, comments: CommentThread[]): string;
+export declare function normalizeAuthor(value: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/domain/comments/parser.d.ts.map

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