@adammcarter/use-cases 0.1.0

package/packages/core/dist/markers/spanCanon.js

@@ -0,0 +1,42 @@
+// Span canonicalizer `ucase-span-lines-v1` (spec section 3).
+//
+// Algorithm (exact):
+//   1. Require UTF-8.            (callers pass an already-decoded string)
+//   2. Decode as UTF-8.
+//   3. Normalize CRLF and CR to LF.
+//   4. Select complete lines in the span range.
+//   5. Exclude marker lines.     (the scanner passes body lines only)
+//   6. Strip trailing spaces and tabs from each selected line.
+//   7. Preserve leading whitespace.
+//   8. Preserve comments.
+//   9. Preserve blank lines.
+//   10. Join with LF.
+//   11. Ensure exactly one trailing LF.
+//   12. sha256 over UTF-8 bytes.
+import { sha256 } from "./canonicalJson.js";
+// Normalize CRLF and CR to LF (spec step 3).
+export function normalizeNewlines(content) {
+    return content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+// Strip trailing spaces and tabs from a single line (spec step 6).
+function stripTrailingWs(line) {
+    return line.replace(/[ \t]+$/, "");
+}
+// Canonicalize the already-selected span body lines.
+//
+// `lines` are the complete lines strictly between the markers, newline-stripped
+// (CR/CRLF already collapsed by line splitting). Leading whitespace, comments
+// and blank lines are preserved; only trailing spaces/tabs are removed. The
+// result joins with LF and carries exactly one trailing LF, or is empty when the
+// span body has no lines.
+export function canonicalizeSpanLines(lines) {
+    if (lines.length === 0) {
+        return "";
+    }
+    return lines.map(stripTrailingWs).join("\n") + "\n";
+}
+// sha256 over the canonical span bytes, as "sha256:<hex>" (spec step 12).
+export function hashSpanLines(lines) {
+    return sha256(canonicalizeSpanLines(lines));
+}
+//# sourceMappingURL=spanCanon.js.map

package/packages/core/dist/markers/spanCanon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanCanon.js","sourceRoot":"","sources":["../../src/markers/spanCanon.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,qBAAqB;AACrB,0EAA0E;AAC1E,wBAAwB;AACxB,oCAAoC;AACpC,gDAAgD;AAChD,sEAAsE;AACtE,+DAA+D;AAC/D,oCAAoC;AACpC,0BAA0B;AAC1B,6BAA6B;AAC7B,sBAAsB;AACtB,wCAAwC;AACxC,iCAAiC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,6CAA6C;AAC7C,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,mEAAmE;AACnE,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,qDAAqD;AACrD,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,4EAA4E;AAC5E,iFAAiF;AACjF,0BAA0B;AAC1B,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,KAA4B;IACxD,OAAO,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/packages/core/dist/markers/swiftFuncRecognizer.d.ts

@@ -0,0 +1,36 @@
+export declare const SwiftFuncErrorCode: Readonly<{
+    readonly NO_SWIFT_PARSER: "NO_SWIFT_PARSER";
+    readonly SWIFT_PARSE_ERROR_IN_REGION: "SWIFT_PARSE_ERROR_IN_REGION";
+    readonly MARKER_NOT_ADJACENT_TO_DECLARATION: "MARKER_NOT_ADJACENT_TO_DECLARATION";
+    readonly MARKER_INSIDE_ATTACHED_DECLARATION: "MARKER_INSIDE_ATTACHED_DECLARATION";
+    readonly NEXT_NODE_NOT_FUNC: "NEXT_NODE_NOT_FUNC";
+    readonly FUNC_HAS_NO_BODY: "FUNC_HAS_NO_BODY";
+    readonly FUNC_BODY_HAS_NO_CLOSING_BRACE: "FUNC_BODY_HAS_NO_CLOSING_BRACE";
+    readonly NESTED_FUNC_UNSUPPORTED: "NESTED_FUNC_UNSUPPORTED";
+    readonly CONDITIONAL_COMPILATION_IN_SPAN: "CONDITIONAL_COMPILATION_IN_SPAN";
+    readonly ANOTHER_MARKER_INSIDE_SPAN: "ANOTHER_MARKER_INSIDE_SPAN";
+    readonly MULTIPLE_CANDIDATE_DECLARATIONS: "MULTIPLE_CANDIDATE_DECLARATIONS";
+}>;
+export type SwiftFuncErrorCode = (typeof SwiftFuncErrorCode)[keyof typeof SwiftFuncErrorCode];
+export interface SwiftFuncSpan {
+    start_line: number;
+    end_line: number;
+    start_byte: number;
+    end_byte: number;
+}
+export type SwiftFuncRecognizerResult = {
+    ok: true;
+    span: SwiftFuncSpan;
+    symbol_name: string;
+    body_lines: string[];
+} | {
+    ok: false;
+    code: SwiftFuncErrorCode;
+    message: string;
+    line: number;
+};
+export interface SwiftFuncRecognizerOptions {
+    markerCommentPrefix?: string;
+}
+export declare function recognizeSwiftFuncSpan(source: string, markerLineIndex: number, options?: SwiftFuncRecognizerOptions): SwiftFuncRecognizerResult;
+//# sourceMappingURL=swiftFuncRecognizer.d.ts.map

package/packages/core/dist/markers/swiftFuncRecognizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swiftFuncRecognizer.d.ts","sourceRoot":"","sources":["../../src/markers/swiftFuncRecognizer.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAYpB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC5E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,WAAW,0BAA0B;IAGzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AA6ZD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,0BAA0B,GACnC,yBAAyB,CAgU3B"}