@prose-reader/archive-parser 1.301.0 → 1.304.0

package/dist/opf/spineItemrefProperties.d.ts

@@ -4,9 +4,4 @@ export type OpfItemrefLayoutHints = {
     readonly pageSpreadLeft?: true;
     readonly pageSpreadRight?: true;
 };
-/**
- * EPUB `itemref` `properties` attribute (space-separated tokens).
- *
- * @see https://www.w3.org/TR/epub/#attrdef-properties
- */
 export declare const layoutHintsFromItemrefProperties: (properties: string | undefined) => OpfItemrefLayoutHints;

package/dist/types/archiveResolve.d.ts

@@ -1,66 +1,17 @@
-/**
- * Cross-format hints for manifest-style consumers (identifiers, reading order,
- * fixed-layout, descriptive metadata). Every field is populated by every
- * `resolve*` — values default to `undefined` when the source format has no
- * equivalent or the input is missing/blank, so consumers see a stable shape
- * regardless of which container they're reading. Empty arrays/strings collapse
- * to `undefined` so `result.field !== undefined` is a reliable presence check.
- *
- * Sources are container-agnostic: the same field can come from OPF Dublin
- * Core (`dc:creator`, `dc:date`, …) or from a ComicInfo.xml element
- * (`Writer`, `Year`/`Month`/`Day`, …).
- *
- * @see https://en.wikipedia.org/wiki/ISBN
- */
 export type ArchiveResolveResult = {
-    /** Digits-only GTIN when the source matches a GS1 length (8 / 12 / 13 / 14). */
     gtin?: string;
     isbn?: string;
     readingDirection?: "ltr" | "rtl";
     renditionLayout?: "reflowable" | "pre-paginated";
-    /**
-     * Human-readable title of the work. OPF: `dc:title`. ComicInfo: `Title`.
-     * Bare archive series naming (`Series` without `Title`) is left to the
-     * consumer — the resolver doesn't fall back across container fields.
-     */
     title?: string;
-    /**
-     * Primary creators, in document order. OPF: every `dc:creator`.
-     * ComicInfo: `Writer`, split on commas (the de facto schema convention).
-     * Other ComicInfo roles (`Penciller`, `Inker`, …) stay on the parsed
-     * object — folding them all in here would lose role attribution.
-     */
     authors?: string[];
-    /** OPF: first non-empty `dc:publisher`. ComicInfo: `Publisher`. */
     publisher?: string;
-    /**
-     * Rights / copyright statement. OPF: first non-empty `dc:rights`.
-     * ComicInfo has no spec'd rights field, so this is OPF-only today.
-     */
     rights?: string;
-    /**
-     * Language tags. OPF: every `dc:language` (BCP 47). ComicInfo:
-     * `LanguageISO` lifted into a single-entry array; the schema is
-     * single-language by design but we keep the array shape so consumers
-     * can ignore the source format.
-     */
     languages?: string[];
-    /**
-     * Calendar components extracted from the source date. Each component
-     * is independently optional so partial dates (year only, year+month)
-     * round-trip faithfully. OPF: `dc:date` parsed as W3CDTF. ComicInfo:
-     * `Year` / `Month` / `Day` parsed as integers.
-     */
     date?: {
         year?: number;
         month?: number;
         day?: number;
     };
-    /**
-     * Subject keywords. OPF: every `dc:subject`. ComicInfo: `Genre`
-     * followed by `Tags`, both split on commas, in that order. The schema
-     * assigns slightly different intents to the two ComicInfo fields, but
-     * for the cross-format "subjects" lens they're equivalent.
-     */
     subjects?: string[];
 };

package/dist/utils/normalizeGtin.d.ts

@@ -1,5 +1 @@
-/**
- * Normalize a raw GTIN / EAN / UPC string to digits only when the length
- * matches a GS1 GTIN family size (8, 12, 13, or 14). Does not verify check digits.
- */
 export declare const normalizeGtin: (raw: string | number | undefined | null) => string | undefined;

package/dist/utils/normalizeIsbn.d.ts

@@ -1,11 +1 @@
-/**
- * Normalize a raw ISBN-ish string into a canonical 10- or 13-character
- * form, or `undefined` when no recognisable ISBN can be recovered.
- *
- *  - Strips the common `urn:isbn:` / `isbn:` prefixes.
- *  - Drops everything that isn't a digit or `X`.
- *  - Validates the resulting length (10 or 13).
- *  - Falls back to a lax regex scan so publishers that stuff free text
- *    around the number still yield a usable value.
- */
 export declare const normalizeIsbn: (raw: string | number | undefined | null) => string | undefined;

package/dist/utils/parseW3cDtfDate.d.ts

@@ -1,18 +1,3 @@
-/**
- * Extract the calendar components of a W3CDTF literal — the
- * date subset of ISO 8601 that EPUB 3.3 § 5.5.3.2.4 mandates for
- * `dc:date`. Accepted forms: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`, and
- * any of the above followed by a `Thh:mm[:ss[.s]][TZD]` time
- * portion that we ignore.
- *
- * Components are returned as plain integers (`month` is 1-12,
- * `day` is 1-31), independent of the host timezone — using
- * `Date.parse` would shift `2011-01-01` by a day in negative-offset
- * locales, which is the exact bug this regex-based approach exists
- * to avoid. Returns `undefined` when the input doesn't even match
- * a leading 4-digit year so consumers can fall back without
- * branching on partial shapes.
- */
 export declare const parseW3cDtfDate: (raw: string | undefined) => {
     year?: number;
     month?: number;

package/dist/utils/tokenizeXmlSpaceSeparatedList.d.ts

@@ -1,5 +1 @@
-/**
- * EPUB/XML space-separated token lists (e.g. `properties` on `item` / `itemref`).
- * Trims the raw string, splits on ASCII whitespace, drops empty segments.
- */
 export declare const tokenizeXmlSpaceSeparatedList: (raw: string | undefined) => readonly string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prose-reader/archive-parser",
-  "version": "1.301.0",
+  "version": "1.304.0",
   "type": "module",
   "main": "./dist/index.umd.cjs",
   "module": "./dist/index.js",
@@ -29,5 +29,5 @@
   "dependencies": {
     "xmldoc": "^2.0.0"
   },
-  "gitHead": "c8e649c793f0b56c63d9fe3d50d5b5cef4fcbf23"
+  "gitHead": "1f4e4822d4d74fc2f6025409133db0f4f7f152af"
 }