gff-nostream 2.0.0 → 3.0.0

package/dist/api.d.ts

@@ -1,32 +1,25 @@
 import type { GFF3Feature } from './util.ts';
 export interface LineRecord {
-    fields: string[];
+    line: string;
     lineHash?: string | number;
+    start: number;
+    end: number;
+    hasEscapes: boolean;
 }
 /**
  * Synchronously parse a string containing GFF3 and return an array of the
  * parsed items.
  *
  * @param str - GFF3 string
- * @param inputOptions - Parsing options
- * @returns array of parsed features, directives, comments and/or sequences
+ * @returns array of parsed features
  */
 export declare function parseStringSync(str: string): GFF3Feature[];
 /**
- * Synchronously parse an array of strings containing GFF3 and return an array of the
- * parsed items.
- *
- * @param arr - GFF3 array of strings
- * @param inputOptions - Parsing options
- * @returns array of parsed features, directives, comments and/or sequences
- */
-export declare function parseArraySync(arr: string[]): GFF3Feature[];
-/**
- * Synchronously parse an array of LineRecord objects containing pre-split GFF3
- * fields and return an array of the parsed items.
+ * Parse an array of LineRecord objects containing raw GFF3 lines.
+ * Supports parent/child relationships.
  *
- * @param records - Array of LineRecord objects with fields array and optional lineHash
+ * @param records - Array of LineRecord objects with raw line and metadata
  * @returns array of parsed features
  */
-export declare function parseRecordsSync(records: LineRecord[]): GFF3Feature[];
+export declare function parseRecords(records: LineRecord[]): GFF3Feature[];
 export type { GFF3Comment, GFF3Directive, GFF3Feature, GFF3FeatureLine, GFF3FeatureLineWithRefs, GFF3Item, GFF3Sequence, } from './util.ts';

package/dist/api.js

@@ -1,86 +1,115 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseStringSync = parseStringSync;
-exports.parseArraySync = parseArraySync;
-exports.parseRecordsSync = parseRecordsSync;
-const parse_ts_1 = __importDefault(require("./parse.js"));
+exports.parseRecords = parseRecords;
 const util_ts_1 = require("./util.js");
 /**
  * Synchronously parse a string containing GFF3 and return an array of the
  * parsed items.
  *
  * @param str - GFF3 string
- * @param inputOptions - Parsing options
- * @returns array of parsed features, directives, comments and/or sequences
+ * @returns array of parsed features
  */
 function parseStringSync(str) {
-    const items = [];
-    const parser = new parse_ts_1.default({
-        featureCallback: arg => items.push(arg),
-        disableDerivesFromReferences: true,
-        errorCallback: err => {
-            throw new Error(err);
-        },
-    });
-    for (const line of str.split(/\r?\n/)) {
-        parser.addLine(line);
-    }
-    parser.finish();
-    return items;
-}
-/**
- * Synchronously parse an array of strings containing GFF3 and return an array of the
- * parsed items.
- *
- * @param arr - GFF3 array of strings
- * @param inputOptions - Parsing options
- * @returns array of parsed features, directives, comments and/or sequences
- */
-function parseArraySync(arr) {
-    const items = [];
-    const parser = new parse_ts_1.default({
-        featureCallback: arg => items.push(arg),
-        disableDerivesFromReferences: true,
-        errorCallback: err => {
-            throw new Error(err);
-        },
-    });
-    for (const line of arr) {
-        parser.addLine(line);
+    const lines = str.split(/\r?\n/);
+    const records = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.length === 0 || line[0] === '#') {
+            if (line.startsWith('##FASTA')) {
+                break;
+            }
+            continue;
+        }
+        if (line[0] === '>') {
+            break;
+        }
+        records.push({
+            line,
+            start: 0,
+            end: 0,
+            hasEscapes: line.includes('%'),
+        });
     }
-    parser.finish();
-    return items;
+    return parseRecords(records);
 }
 /**
- * Synchronously parse an array of LineRecord objects containing pre-split GFF3
- * fields and return an array of the parsed items.
+ * Parse an array of LineRecord objects containing raw GFF3 lines.
+ * Supports parent/child relationships.
  *
- * @param records - Array of LineRecord objects with fields array and optional lineHash
+ * @param records - Array of LineRecord objects with raw line and metadata
  * @returns array of parsed features
  */
-function parseRecordsSync(records) {
+function parseRecords(records) {
     const items = [];
-    const parser = new parse_ts_1.default({
-        featureCallback: arg => items.push(arg),
-        disableDerivesFromReferences: true,
-        errorCallback: err => {
-            throw new Error(err);
-        },
-    });
-    for (const record of records) {
-        const featureLine = (0, util_ts_1.parseFieldsArray)(record.fields);
+    const byId = new Map();
+    const orphans = new Map();
+    for (let i = 0; i < records.length; i++) {
+        const record = records[i];
+        const featureLine = (record.hasEscapes
+            ? (0, util_ts_1.parseFeature)(record.line)
+            : (0, util_ts_1.parseFeatureNoUnescape)(record.line));
+        featureLine.child_features = [];
+        featureLine.derived_features = [];
         if (record.lineHash !== undefined) {
             if (!featureLine.attributes) {
                 featureLine.attributes = {};
             }
             featureLine.attributes._lineHash = [String(record.lineHash)];
         }
-        parser.addParsedFeatureLine(featureLine);
+        const attrs = featureLine.attributes;
+        const ids = attrs?.ID;
+        const parents = attrs?.Parent;
+        if (!ids && !parents) {
+            items.push([featureLine]);
+            continue;
+        }
+        let feature;
+        if (ids) {
+            const id = ids[0];
+            const existing = byId.get(id);
+            if (existing) {
+                existing.push(featureLine);
+                feature = existing;
+            }
+            else {
+                feature = [featureLine];
+                if (!parents) {
+                    items.push(feature);
+                }
+                byId.set(id, feature);
+                const waiting = orphans.get(id);
+                if (waiting) {
+                    for (let j = 0; j < waiting.length; j++) {
+                        featureLine.child_features.push(waiting[j]);
+                    }
+                    orphans.delete(id);
+                }
+            }
+        }
+        else {
+            feature = [featureLine];
+        }
+        if (parents) {
+            for (let j = 0; j < parents.length; j++) {
+                const parentId = parents[j];
+                const parent = byId.get(parentId);
+                if (parent) {
+                    for (let k = 0; k < parent.length; k++) {
+                        parent[k].child_features.push(feature);
+                    }
+                }
+                else {
+                    let arr = orphans.get(parentId);
+                    if (!arr) {
+                        arr = [];
+                        orphans.set(parentId, arr);
+                    }
+                    arr.push(feature);
+                }
+            }
+        }
     }
-    parser.finish();
     return items;
 }
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":";;;;;AAkBA,0CAgBC;AAUD,wCAgBC;AASD,4CAuBC;AA5FD,0DAA+B;AAC/B,uCAA4C;AAS5C;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,IAAI,kBAAM,CAAC;QACxB,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACvC,4BAA4B,EAAE,IAAI;QAClC,aAAa,EAAE,GAAG,CAAC,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;QACtB,CAAC;KACF,CAAC,CAAA;IAEF,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IACD,MAAM,CAAC,MAAM,EAAE,CAAA;IAEf,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,GAAa;IAC1C,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,IAAI,kBAAM,CAAC;QACxB,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACvC,4BAA4B,EAAE,IAAI;QAClC,aAAa,EAAE,GAAG,CAAC,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;QACtB,CAAC;KACF,CAAC,CAAA;IAEF,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IACD,MAAM,CAAC,MAAM,EAAE,CAAA;IAEf,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,OAAqB;IACpD,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,IAAI,kBAAM,CAAC;QACxB,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACvC,4BAA4B,EAAE,IAAI;QAClC,aAAa,EAAE,GAAG,CAAC,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;QACtB,CAAC;KACF,CAAC,CAAA;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAoB,IAAA,0BAAgB,EAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACpE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;gBAC5B,WAAW,CAAC,UAAU,GAAG,EAAE,CAAA;YAC7B,CAAC;YACD,WAAW,CAAC,UAAU,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC9D,CAAC;QACD,MAAM,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAA;IAC1C,CAAC;IACD,MAAM,CAAC,MAAM,EAAE,CAAA;IAEf,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,2 @@
-import { parseArraySync, parseRecordsSync, parseStringSync } from './api.ts';
-export { parseArraySync, parseRecordsSync, parseStringSync };
+export { parseRecords, parseStringSync } from './api.ts';
 export type { GFF3Comment, GFF3Directive, GFF3Feature, GFF3FeatureLine, GFF3FeatureLineWithRefs, GFF3Item, GFF3Sequence, LineRecord, } from './api.ts';

package/dist/index.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseStringSync = exports.parseRecordsSync = exports.parseArraySync = void 0;
-const api_ts_1 = require("./api.js");
-Object.defineProperty(exports, "parseArraySync", { enumerable: true, get: function () { return api_ts_1.parseArraySync; } });
-Object.defineProperty(exports, "parseRecordsSync", { enumerable: true, get: function () { return api_ts_1.parseRecordsSync; } });
+exports.parseStringSync = exports.parseRecords = void 0;
+var api_ts_1 = require("./api.js");
+Object.defineProperty(exports, "parseRecords", { enumerable: true, get: function () { return api_ts_1.parseRecords; } });
 Object.defineProperty(exports, "parseStringSync", { enumerable: true, get: function () { return api_ts_1.parseStringSync; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAA4E;AACnE,+FADA,uBAAc,OACA;AAAE,iGADA,yBAAgB,OACA;AAAE,gGADA,wBAAe,OACA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAwD;AAA/C,sGAAA,YAAY,OAAA;AAAE,yGAAA,eAAe,OAAA"}

package/dist/util.d.ts

@@ -4,28 +4,22 @@
  * @param stringVal - Escaped GFF3 string value
  * @returns An unescaped string value
  */
-export declare function unescape(stringVal: string): string;
+export declare function unescape(s: string): string;
 /**
- * Escape a value for use in a GFF3 attribute value.
- *
- * @param rawVal - Raw GFF3 attribute value
- * @returns An escaped string value
- */
-export declare function escape(rawVal: string | number): string;
-/**
- * Escape a value for use in a GFF3 column value.
+ * Parse the 9th column (attributes) of a GFF3 feature line.
  *
- * @param rawVal - Raw GFF3 column value
- * @returns An escaped column value
+ * @param attrString - String of GFF3 9th column
+ * @returns Parsed attributes
  */
-export declare function escapeColumn(rawVal: string | number): string;
+export declare function parseAttributes(attrString: string): GFF3Attributes;
 /**
- * Parse the 9th column (attributes) of a GFF3 feature line.
+ * Parse the 9th column (attributes) of a GFF3 feature line without unescaping.
+ * Fast path for data known to contain no escaped characters.
  *
  * @param attrString - String of GFF3 9th column
  * @returns Parsed attributes
  */
-export declare function parseAttributes(attrString: string): GFF3Attributes;
+export declare function parseAttributesNoUnescape(attrString: string): GFF3Attributes;
 /**
  * Parse a GFF3 feature line
  *
@@ -33,59 +27,36 @@ export declare function parseAttributes(attrString: string): GFF3Attributes;
  * @returns The parsed feature
  */
 export declare function parseFeature(line: string): GFF3FeatureLine;
-export declare function parseFieldsArray(f: (string | null | undefined)[]): GFF3FeatureLine;
-/**
- * Parse a GFF3 directive line.
- *
- * @param line - GFF3 directive line
- * @returns The parsed directive
- */
-export declare function parseDirective(line: string): GFF3Directive | GFF3SequenceRegionDirective | GFF3GenomeBuildDirective | null;
-/**
- * Format an attributes object into a string suitable for the 9th column of GFF3.
- *
- * @param attrs - Attributes
- * @returns GFF3 9th column string
- */
-export declare function formatAttributes(attrs: GFF3Attributes): string;
 /**
- * Format a feature object or array of feature objects into one or more lines of
- * GFF3.
+ * Parse a GFF3 feature line without unescaping.
+ * Fast path for data known to contain no escaped characters.
  *
- * @param featureOrFeatures - A feature object or array of feature objects
- * @returns A string of one or more GFF3 lines
- */
-export declare function formatFeature(featureOrFeatures: GFF3FeatureLine | GFF3FeatureLineWithRefs | (GFF3FeatureLine | GFF3FeatureLineWithRefs)[]): string;
-/**
- * Format a directive into a line of GFF3.
- *
- * @param directive - A directive object
- * @returns A directive line string
+ * @param line - GFF3 feature line
+ * @returns The parsed feature
  */
-export declare function formatDirective(directive: GFF3Directive): string;
+export declare function parseFeatureNoUnescape(line: string): GFF3FeatureLine;
 /**
- * Format a comment into a GFF3 comment.
- * Yes I know this is just adding a # and a newline.
+ * Parse a GFF3 feature from a pre-split fields array
  *
- * @param comment - A comment object
- * @returns A comment line string
+ * @param f - Array of 9 GFF3 column values (use null or '.' for empty values)
+ * @returns The parsed feature
  */
-export declare function formatComment(comment: GFF3Comment): string;
+export declare function parseFieldsArray(f: (string | null | undefined)[]): GFF3FeatureLine;
 /**
- * Format a sequence object as FASTA
+ * Parse a GFF3 feature from a pre-split fields array without unescaping.
+ * Fast path for data known to contain no escaped characters.
  *
- * @param seq - A sequence object
- * @returns Formatted single FASTA sequence string
+ * @param f - Array of 9 GFF3 column values (use null or '.' for empty values)
+ * @returns The parsed feature
  */
-export declare function formatSequence(seq: GFF3Sequence): string;
+export declare function parseFieldsArrayNoUnescape(f: (string | null | undefined)[]): GFF3FeatureLine;
 /**
- * Format a directive, comment, sequence, or feature, or array of such items,
- * into one or more lines of GFF3.
+ * Parse a GFF3 directive line.
  *
- * @param itemOrItems - A comment, sequence, or feature, or array of such items
- * @returns A formatted string or array of strings
+ * @param line - GFF3 directive line
+ * @returns The parsed directive
  */
-export declare function formatItem(itemOrItems: GFF3FeatureLineWithRefs | GFF3Directive | GFF3Comment | GFF3Sequence | (GFF3FeatureLineWithRefs | GFF3Directive | GFF3Comment | GFF3Sequence)[]): string | string[];
+export declare function parseDirective(line: string): GFF3Directive | GFF3SequenceRegionDirective | GFF3GenomeBuildDirective | null;
 /** A record of GFF3 attribute identifiers and the values of those identifiers */
 export type GFF3Attributes = Record<string, string[] | undefined>;
 /** A representation of a single line of a GFF3 file */