@vcgstudiosy-beep/dlof 1.0.0

package/dist/dlof/serializeDlof.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeDlof = serializeDlof;
+const serializer_1 = require("../xml/serializer");
+const DLOF_NAMESPACE = "https://dlof.org/schema/1.0";
+/** يحوّل كائن DocumentLoop مُنمَّط إلى نص XML صالح لملف .dlof */
+function serializeDlof(doc) {
+    const metadataChildren = [
+        { tag: "title", text: doc.metadata.title },
+        { tag: "domain", text: doc.metadata.domain },
+    ];
+    if (doc.metadata.author)
+        metadataChildren.push({ tag: "author", text: doc.metadata.author });
+    if (doc.metadata.createdAt)
+        metadataChildren.push({ tag: "createdAt", text: doc.metadata.createdAt });
+    if (doc.metadata.updatedAt)
+        metadataChildren.push({ tag: "updatedAt", text: doc.metadata.updatedAt });
+    if (doc.metadata.language)
+        metadataChildren.push({ tag: "language", text: doc.metadata.language });
+    if (doc.metadata.tags && doc.metadata.tags.length) {
+        metadataChildren.push({
+            tag: "tags",
+            children: doc.metadata.tags.map((t) => ({ tag: "tag", text: t })),
+        });
+    }
+    const loopLinksChildren = [];
+    if (doc.loopLinks.previous) {
+        loopLinksChildren.push({
+            tag: "previous",
+            attrs: { ref: doc.loopLinks.previous.ref, title: doc.loopLinks.previous.title },
+        });
+    }
+    if (doc.loopLinks.next) {
+        loopLinksChildren.push({
+            tag: "next",
+            attrs: { ref: doc.loopLinks.next.ref, title: doc.loopLinks.next.title },
+        });
+    }
+    loopLinksChildren.push({ tag: "loopRoot", text: String(doc.loopLinks.loopRoot) });
+    let contentChild;
+    const c = doc.content;
+    switch (c.kind) {
+        case "genericItem":
+            contentChild = {
+                tag: "genericItem",
+                attrs: { customType: c.customType },
+                children: [
+                    c.type !== undefined ? { tag: "type", text: c.type } : undefined,
+                    c.element !== undefined ? { tag: "element", text: c.element } : undefined,
+                    c.body !== undefined ? { tag: "body", text: c.body } : undefined,
+                ].filter(Boolean),
+            };
+            break;
+        case "qaItem":
+            contentChild = {
+                tag: "qaItem",
+                children: [
+                    { tag: "question", text: c.question },
+                    { tag: "answer", text: c.answer },
+                    c.explanation !== undefined ? { tag: "explanation", text: c.explanation } : undefined,
+                    c.difficulty !== undefined ? { tag: "difficulty", text: c.difficulty } : undefined,
+                ].filter(Boolean),
+            };
+            break;
+        case "bookChapter":
+            contentChild = {
+                tag: "bookChapter",
+                children: [
+                    c.chapterNumber !== undefined
+                        ? { tag: "chapterNumber", text: String(c.chapterNumber) }
+                        : undefined,
+                    { tag: "chapterTitle", text: c.chapterTitle },
+                    { tag: "text", text: c.text },
+                    c.summary !== undefined ? { tag: "summary", text: c.summary } : undefined,
+                ].filter(Boolean),
+            };
+            break;
+        case "termDefinition":
+            contentChild = {
+                tag: "termDefinition",
+                children: [
+                    { tag: "term", text: c.term },
+                    { tag: "definition", text: c.definition },
+                    c.example !== undefined ? { tag: "example", text: c.example } : undefined,
+                ].filter(Boolean),
+            };
+            break;
+        case "infoExplain":
+            contentChild = {
+                tag: "infoExplain",
+                children: [
+                    { tag: "topic", text: c.topic },
+                    { tag: "explanation", text: c.explanation },
+                    c.source !== undefined ? { tag: "source", text: c.source } : undefined,
+                ].filter(Boolean),
+            };
+            break;
+        case "episodeItem":
+            contentChild = {
+                tag: "episodeItem",
+                children: [
+                    c.episodeNumber !== undefined
+                        ? { tag: "episodeNumber", text: String(c.episodeNumber) }
+                        : undefined,
+                    c.seasonNumber !== undefined
+                        ? { tag: "seasonNumber", text: String(c.seasonNumber) }
+                        : undefined,
+                    { tag: "episodeTitle", text: c.episodeTitle },
+                    c.synopsis !== undefined ? { tag: "synopsis", text: c.synopsis } : undefined,
+                    c.duration !== undefined ? { tag: "duration", text: String(c.duration) } : undefined,
+                    c.seriesTitle !== undefined ? { tag: "seriesTitle", text: c.seriesTitle } : undefined,
+                    c.mediaRef !== undefined ? { tag: "mediaRef", text: c.mediaRef } : undefined,
+                    c.releaseDate !== undefined ? { tag: "releaseDate", text: c.releaseDate } : undefined,
+                    c.body !== undefined ? { tag: "body", text: c.body } : undefined,
+                    c.thumbnailBase64 !== undefined
+                        ? { tag: "thumbnailBase64", text: c.thumbnailBase64 }
+                        : undefined,
+                ].filter(Boolean),
+            };
+            break;
+    }
+    const rootChildren = [
+        { tag: "metadata", children: metadataChildren },
+        { tag: "loopLinks", children: loopLinksChildren },
+        { tag: "content", children: [contentChild] },
+    ];
+    if (doc.attachments && doc.attachments.length) {
+        rootChildren.push({
+            tag: "attachments",
+            children: doc.attachments.map((a) => ({
+                tag: "attachment",
+                attrs: {
+                    id: a.id,
+                    fileName: a.fileName,
+                    mimeType: a.mimeType,
+                    kind: a.kind,
+                    sizeBytes: a.sizeBytes,
+                },
+                children: [
+                    a.data !== undefined ? { tag: "data", text: a.data } : undefined,
+                    a.uri !== undefined ? { tag: "uri", text: a.uri } : undefined,
+                    a.caption !== undefined ? { tag: "caption", text: a.caption } : undefined,
+                ].filter(Boolean),
+            })),
+        });
+    }
+    if (doc.template) {
+        rootChildren.push({
+            tag: "template",
+            attrs: {
+                ref: doc.template.ref,
+                primaryColor: doc.template.primaryColor,
+                secondaryColor: doc.template.secondaryColor,
+                backgroundColor: doc.template.backgroundColor,
+                textColor: doc.template.textColor,
+                fontFamily: doc.template.fontFamily,
+                layout: doc.template.layout,
+                headerAttachmentRef: doc.template.headerAttachmentRef,
+            },
+        });
+    }
+    if (doc.mediaFolder && doc.mediaFolder.length) {
+        rootChildren.push({
+            tag: "mediaFolder",
+            children: doc.mediaFolder.map((m) => ({
+                tag: "mediaFile",
+                attrs: { path: m.path, kind: m.kind, label: m.label },
+            })),
+        });
+    }
+    return (0, serializer_1.buildXmlDocument)({
+        tag: "documentLoop",
+        attrs: { xmlns: DLOF_NAMESPACE, version: doc.version, id: doc.id },
+        children: rootChildren,
+    });
+}

package/dist/dlof/validate.d.ts

@@ -0,0 +1,11 @@
+import { DocumentLoop } from "../types";
+export interface ValidationIssue {
+    level: "error" | "warning";
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+/** يتحقق من مستند DLoF مقابل قواعد المواصفة الإلزامية (docs/SPECIFICATION.md) */
+export declare function validateDlof(doc: DocumentLoop): ValidationResult;

package/dist/dlof/validate.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDlof = validateDlof;
+const VALID_DOMAINS = ["education", "book", "infoApp", "infoLoop", "series", "custom"];
+const VALID_ATTACHMENT_KINDS = ["image", "video", "file"];
+const MAX_INLINE_ATTACHMENT_BYTES = 15 * 1024 * 1024; // 15MB، كما توصي المواصفة
+/** يتحقق من مستند DLoF مقابل قواعد المواصفة الإلزامية (docs/SPECIFICATION.md) */
+function validateDlof(doc) {
+    const issues = [];
+    const err = (message) => issues.push({ level: "error", message });
+    const warn = (message) => issues.push({ level: "warning", message });
+    if (!doc.version)
+        err("الصفة version مفقودة على <documentLoop>");
+    if (!doc.id)
+        err("الصفة id مفقودة على <documentLoop>");
+    if (!doc.metadata.title)
+        err("العنصر <title> مطلوب داخل <metadata>");
+    if (!doc.metadata.domain) {
+        err("العنصر <domain> مطلوب داخل <metadata>");
+    }
+    else if (!VALID_DOMAINS.includes(doc.metadata.domain)) {
+        warn(`قيمة domain "${doc.metadata.domain}" غير معروفة (المتوقع أحد: ${VALID_DOMAINS.join(", ")})`);
+    }
+    if (!doc.loopLinks.previous && !doc.loopLinks.next) {
+        warn("لا يوجد previous ولا next: هذا المستند حلقة وحيدة معزولة");
+    }
+    switch (doc.content.kind) {
+        case "qaItem":
+            if (!doc.content.question)
+                err("qaItem: العنصر <question> مطلوب");
+            if (!doc.content.answer)
+                err("qaItem: العنصر <answer> مطلوب");
+            break;
+        case "bookChapter":
+            if (!doc.content.chapterTitle)
+                err("bookChapter: العنصر <chapterTitle> مطلوب");
+            if (!doc.content.text)
+                err("bookChapter: العنصر <text> مطلوب");
+            break;
+        case "termDefinition":
+            if (!doc.content.term)
+                err("termDefinition: العنصر <term> مطلوب");
+            if (!doc.content.definition)
+                err("termDefinition: العنصر <definition> مطلوب");
+            break;
+        case "infoExplain":
+            if (!doc.content.topic)
+                err("infoExplain: العنصر <topic> مطلوب");
+            if (!doc.content.explanation)
+                err("infoExplain: العنصر <explanation> مطلوب");
+            break;
+        case "episodeItem":
+            if (!doc.content.episodeTitle)
+                err("episodeItem: العنصر <episodeTitle> مطلوب");
+            break;
+    }
+    for (const a of doc.attachments ?? []) {
+        if (!a.id)
+            err("attachment: الصفة id مطلوبة");
+        if (!a.fileName)
+            err("attachment: الصفة fileName مطلوبة");
+        if (!VALID_ATTACHMENT_KINDS.includes(a.kind)) {
+            warn(`attachment "${a.id}": قيمة kind "${a.kind}" غير معروفة`);
+        }
+        if (!a.data && !a.uri) {
+            err(`attachment "${a.id}": يجب توفير <data> أو <uri>`);
+        }
+        if (a.data) {
+            const approxBytes = Math.floor((a.data.length * 3) / 4);
+            if (approxBytes > MAX_INLINE_ATTACHMENT_BYTES) {
+                warn(`attachment "${a.id}": الحجم التقريبي ${(approxBytes / 1024 / 1024).toFixed(1)}MB يتجاوز الحد الموصى به (15MB) للتضمين المباشر`);
+            }
+        }
+    }
+    return { valid: !issues.some((i) => i.level === "error"), issues };
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./types";
+export { parseDlof, isDlofFileName, DLOF_EXTENSIONS } from "./dlof/parseDlof";
+export { serializeDlof } from "./dlof/serializeDlof";
+export { validateDlof, ValidationIssue, ValidationResult } from "./dlof/validate";
+export { readDlofPkg, writeDlofPkg, buildDefaultMeta } from "./packages/dlofpkg";
+export { readDlofSeries, writeDlofSeries } from "./packages/dlofSeries";
+export { readZip, findEntry, ZipEntry } from "./zip/zipReader";
+export { writeZip, ZipInputEntry } from "./zip/zipWriter";
+export { resolveLoopChain, buildNavigationMap, LoopChainEntry } from "./loop/loopUtils";
+export { renderViewerHtml, ViewerOptions } from "./viewer/renderViewerHtml";
+export { renderPlayerHtml, PlayerOptions } from "./player/renderPlayerHtml";
+export { resolveTheme, ResolvedTheme } from "./viewer/theme";

package/dist/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTheme = exports.renderPlayerHtml = exports.renderViewerHtml = exports.buildNavigationMap = exports.resolveLoopChain = exports.writeZip = exports.findEntry = exports.readZip = exports.writeDlofSeries = exports.readDlofSeries = exports.buildDefaultMeta = exports.writeDlofPkg = exports.readDlofPkg = exports.validateDlof = exports.serializeDlof = exports.DLOF_EXTENSIONS = exports.isDlofFileName = exports.parseDlof = void 0;
+__exportStar(require("./types"), exports);
+var parseDlof_1 = require("./dlof/parseDlof");
+Object.defineProperty(exports, "parseDlof", { enumerable: true, get: function () { return parseDlof_1.parseDlof; } });
+Object.defineProperty(exports, "isDlofFileName", { enumerable: true, get: function () { return parseDlof_1.isDlofFileName; } });
+Object.defineProperty(exports, "DLOF_EXTENSIONS", { enumerable: true, get: function () { return parseDlof_1.DLOF_EXTENSIONS; } });
+var serializeDlof_1 = require("./dlof/serializeDlof");
+Object.defineProperty(exports, "serializeDlof", { enumerable: true, get: function () { return serializeDlof_1.serializeDlof; } });
+var validate_1 = require("./dlof/validate");
+Object.defineProperty(exports, "validateDlof", { enumerable: true, get: function () { return validate_1.validateDlof; } });
+var dlofpkg_1 = require("./packages/dlofpkg");
+Object.defineProperty(exports, "readDlofPkg", { enumerable: true, get: function () { return dlofpkg_1.readDlofPkg; } });
+Object.defineProperty(exports, "writeDlofPkg", { enumerable: true, get: function () { return dlofpkg_1.writeDlofPkg; } });
+Object.defineProperty(exports, "buildDefaultMeta", { enumerable: true, get: function () { return dlofpkg_1.buildDefaultMeta; } });
+var dlofSeries_1 = require("./packages/dlofSeries");
+Object.defineProperty(exports, "readDlofSeries", { enumerable: true, get: function () { return dlofSeries_1.readDlofSeries; } });
+Object.defineProperty(exports, "writeDlofSeries", { enumerable: true, get: function () { return dlofSeries_1.writeDlofSeries; } });
+var zipReader_1 = require("./zip/zipReader");
+Object.defineProperty(exports, "readZip", { enumerable: true, get: function () { return zipReader_1.readZip; } });
+Object.defineProperty(exports, "findEntry", { enumerable: true, get: function () { return zipReader_1.findEntry; } });
+var zipWriter_1 = require("./zip/zipWriter");
+Object.defineProperty(exports, "writeZip", { enumerable: true, get: function () { return zipWriter_1.writeZip; } });
+var loopUtils_1 = require("./loop/loopUtils");
+Object.defineProperty(exports, "resolveLoopChain", { enumerable: true, get: function () { return loopUtils_1.resolveLoopChain; } });
+Object.defineProperty(exports, "buildNavigationMap", { enumerable: true, get: function () { return loopUtils_1.buildNavigationMap; } });
+var renderViewerHtml_1 = require("./viewer/renderViewerHtml");
+Object.defineProperty(exports, "renderViewerHtml", { enumerable: true, get: function () { return renderViewerHtml_1.renderViewerHtml; } });
+var renderPlayerHtml_1 = require("./player/renderPlayerHtml");
+Object.defineProperty(exports, "renderPlayerHtml", { enumerable: true, get: function () { return renderPlayerHtml_1.renderPlayerHtml; } });
+var theme_1 = require("./viewer/theme");
+Object.defineProperty(exports, "resolveTheme", { enumerable: true, get: function () { return theme_1.resolveTheme; } });

package/dist/loop/loopUtils.d.ts

@@ -0,0 +1,16 @@
+import { DocumentLoop } from "../types";
+export interface LoopChainEntry {
+    fileName: string;
+    document: DocumentLoop;
+}
+/**
+ * يحلّ سلسلة الحلقة كاملة انطلاقاً من ملف بداية (أو loopRoot تلقائياً إن لم يُحدَّد)،
+ * متتبعاً روابط next بالترتيب حتى: نهاية مفتوحة، أو العودة لبداية حلقة مغلقة، أو ref مفقود.
+ * لا يفشل عند فقدان ملف مُشار إليه (توصية القسم 10 من المواصفة) بل يتوقف بهدوء.
+ */
+export declare function resolveLoopChain(documents: Record<string, DocumentLoop>, startFileName?: string): LoopChainEntry[];
+/** يبني خريطة تنقّل سريعة: fileName -> {previous?, next?} كأسماء ملفات محلولة فعلياً */
+export declare function buildNavigationMap(chain: LoopChainEntry[]): Record<string, {
+    previous?: string;
+    next?: string;
+}>;

package/dist/loop/loopUtils.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLoopChain = resolveLoopChain;
+exports.buildNavigationMap = buildNavigationMap;
+/** يطبّع اسم مرجع ref لمطابقته بمفاتيح خريطة المستندات (يتجاهل المسارات النسبية الزائدة) */
+function normalizeRef(ref) {
+    const cleaned = ref.replace(/^\.?\//, "");
+    const parts = cleaned.split("/");
+    return parts[parts.length - 1];
+}
+/**
+ * يحلّ سلسلة الحلقة كاملة انطلاقاً من ملف بداية (أو loopRoot تلقائياً إن لم يُحدَّد)،
+ * متتبعاً روابط next بالترتيب حتى: نهاية مفتوحة، أو العودة لبداية حلقة مغلقة، أو ref مفقود.
+ * لا يفشل عند فقدان ملف مُشار إليه (توصية القسم 10 من المواصفة) بل يتوقف بهدوء.
+ */
+function resolveLoopChain(documents, startFileName) {
+    const byId = new Map(); // id -> fileName، لدعم المراجع بالمعرف أيضاً
+    for (const [fileName, doc] of Object.entries(documents)) {
+        byId.set(doc.id, fileName);
+    }
+    function resolveFileName(ref) {
+        const norm = normalizeRef(ref);
+        if (documents[norm])
+            return norm;
+        if (documents[ref])
+            return ref;
+        if (byId.has(ref))
+            return byId.get(ref);
+        // حاول المطابقة بلا امتداد
+        const withoutExt = norm.replace(/\.(dlof|ep|episode)$/i, "");
+        const match = Object.keys(documents).find((f) => f.replace(/\.(dlof|ep|episode)$/i, "") === withoutExt);
+        return match;
+    }
+    let current = startFileName && documents[startFileName]
+        ? startFileName
+        : Object.keys(documents).find((f) => documents[f].loopLinks.loopRoot) ??
+            Object.keys(documents)[0];
+    if (!current)
+        return [];
+    const chain = [];
+    const visited = new Set();
+    while (current && !visited.has(current)) {
+        visited.add(current);
+        const doc = documents[current];
+        chain.push({ fileName: current, document: doc });
+        const nextRef = doc.loopLinks.next?.ref;
+        if (!nextRef)
+            break;
+        const nextFile = resolveFileName(nextRef);
+        if (!nextFile)
+            break; // ref لا يُعثر عليه: توقف بهدوء دون انهيار
+        current = nextFile;
+    }
+    return chain;
+}
+/** يبني خريطة تنقّل سريعة: fileName -> {previous?, next?} كأسماء ملفات محلولة فعلياً */
+function buildNavigationMap(chain) {
+    const map = {};
+    chain.forEach((entry, idx) => {
+        map[entry.fileName] = {
+            previous: idx > 0 ? chain[idx - 1].fileName : undefined,
+            next: idx < chain.length - 1 ? chain[idx + 1].fileName : undefined,
+        };
+    });
+    return map;
+}

package/dist/packages/dlofSeries.d.ts

@@ -0,0 +1,9 @@
+import { DlofSeries } from "../types";
+/**
+ * يقرأ حزمة .dlofSeries: أرشيف ZIP يحتوي مجلداً واحداً باسم السلسلة،
+ * بداخله ملفات .dlof (أو .ep / .episode) بالإضافة لأصول اختيارية
+ * (fonts/, media/, set.txt...). راجع spec/PACKAGE_FORMATS.md.
+ */
+export declare function readDlofSeries(buf: Buffer): DlofSeries;
+/** ينشئ بيانات ثنائية لحزمة .dlofSeries جاهزة للكتابة إلى القرص */
+export declare function writeDlofSeries(series: DlofSeries): Buffer;

package/dist/packages/dlofSeries.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDlofSeries = readDlofSeries;
+exports.writeDlofSeries = writeDlofSeries;
+const zipReader_1 = require("../zip/zipReader");
+const zipWriter_1 = require("../zip/zipWriter");
+const parseDlof_1 = require("../dlof/parseDlof");
+const serializeDlof_1 = require("../dlof/serializeDlof");
+/**
+ * يقرأ حزمة .dlofSeries: أرشيف ZIP يحتوي مجلداً واحداً باسم السلسلة،
+ * بداخله ملفات .dlof (أو .ep / .episode) بالإضافة لأصول اختيارية
+ * (fonts/, media/, set.txt...). راجع spec/PACKAGE_FORMATS.md.
+ */
+function readDlofSeries(buf) {
+    const entries = (0, zipReader_1.readZip)(buf).filter((e) => !e.isDirectory);
+    if (!entries.length) {
+        throw new Error("حزمة .dlofSeries فارغة أو غير صالحة");
+    }
+    // اسم مجلد السلسلة هو الجزء الأول المشترك من مسارات المُدخلات
+    const firstSegment = entries[0].name.split("/")[0];
+    const allShareRoot = entries.every((e) => e.name.split("/")[0] === firstSegment);
+    const name = allShareRoot ? firstSegment : "series";
+    const docsParsed = {};
+    const assets = {};
+    let rootFileName;
+    for (const entry of entries) {
+        const relPath = allShareRoot ? entry.name.slice(firstSegment.length + 1) : entry.name;
+        if (!relPath)
+            continue;
+        if ((0, parseDlof_1.isDlofFileName)(relPath) && !relPath.includes("/")) {
+            const doc = (0, parseDlof_1.parseDlof)(entry.data.toString("utf8"), relPath);
+            docsParsed[relPath] = doc;
+            if (doc.loopLinks.loopRoot)
+                rootFileName = relPath;
+        }
+        else {
+            assets[relPath] = entry.data;
+        }
+    }
+    // إن لم يُعلن أي ملف عن نفسه كـ loopRoot، جرّب series-index.dlof كافتراضي شائع
+    if (!rootFileName && docsParsed["series-index.dlof"]) {
+        rootFileName = "series-index.dlof";
+    }
+    return { name, documents: docsParsed, rootFileName, assets };
+}
+/** ينشئ بيانات ثنائية لحزمة .dlofSeries جاهزة للكتابة إلى القرص */
+function writeDlofSeries(series) {
+    const entries = [];
+    const base = series.name.replace(/\/+$/, "");
+    for (const [fileName, doc] of Object.entries(series.documents)) {
+        entries.push({
+            name: `${base}/${fileName}`,
+            data: Buffer.from((0, serializeDlof_1.serializeDlof)(doc), "utf8"),
+        });
+    }
+    for (const [path, data] of Object.entries(series.assets)) {
+        entries.push({ name: `${base}/${path}`, data });
+    }
+    return (0, zipWriter_1.writeZip)(entries);
+}

package/dist/packages/dlofpkg.d.ts

@@ -0,0 +1,10 @@
+import { DlofPkg, DlofPkgMeta, DocumentLoop } from "../types";
+/**
+ * يقرأ حزمة .dlofpkg (أرشيف ZIP يحتوي package.dlof + meta.json + attachments/)
+ * راجع spec/PACKAGE_FORMATS.md للبنية الرسمية.
+ */
+export declare function readDlofPkg(buf: Buffer): DlofPkg;
+/** ينشئ بيانات ثنائية لحزمة .dlofpkg جاهزة للكتابة إلى القرص */
+export declare function writeDlofPkg(pkg: DlofPkg): Buffer;
+/** يبني meta.json افتراضياً انطلاقاً من مستند DocumentLoop */
+export declare function buildDefaultMeta(doc: DocumentLoop): DlofPkgMeta;

package/dist/packages/dlofpkg.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDlofPkg = readDlofPkg;
+exports.writeDlofPkg = writeDlofPkg;
+exports.buildDefaultMeta = buildDefaultMeta;
+const zipReader_1 = require("../zip/zipReader");
+const zipWriter_1 = require("../zip/zipWriter");
+const parseDlof_1 = require("../dlof/parseDlof");
+const serializeDlof_1 = require("../dlof/serializeDlof");
+/**
+ * يقرأ حزمة .dlofpkg (أرشيف ZIP يحتوي package.dlof + meta.json + attachments/)
+ * راجع spec/PACKAGE_FORMATS.md للبنية الرسمية.
+ */
+function readDlofPkg(buf) {
+    const entries = (0, zipReader_1.readZip)(buf);
+    const dlofEntry = (0, zipReader_1.findEntry)(entries, "package.dlof");
+    if (!dlofEntry) {
+        throw new Error('حزمة .dlofpkg غير صالحة: لا يحتوي على "package.dlof"');
+    }
+    const document = (0, parseDlof_1.parseDlof)(dlofEntry.data.toString("utf8"), "package.dlof");
+    const metaEntry = (0, zipReader_1.findEntry)(entries, "meta.json");
+    let meta;
+    if (metaEntry) {
+        meta = JSON.parse(metaEntry.data.toString("utf8"));
+    }
+    else {
+        // لا يوجد meta.json: نبني واحداً من البيانات الوصفية داخل المستند نفسه (تسامح مع حزم غير كاملة)
+        meta = {
+            id: document.id,
+            title: document.metadata.title,
+            domain: document.metadata.domain,
+            version: document.version,
+            author: document.metadata.author,
+            language: document.metadata.language,
+            createdAt: document.metadata.createdAt,
+            dlofpkg_version: "1.0",
+        };
+    }
+    const attachments = {};
+    for (const entry of entries) {
+        if (entry.isDirectory)
+            continue;
+        if (entry.name.startsWith("attachments/")) {
+            attachments[entry.name] = entry.data;
+        }
+    }
+    return { meta, document, attachments };
+}
+/** ينشئ بيانات ثنائية لحزمة .dlofpkg جاهزة للكتابة إلى القرص */
+function writeDlofPkg(pkg) {
+    const entries = [
+        { name: "package.dlof", data: Buffer.from((0, serializeDlof_1.serializeDlof)(pkg.document), "utf8") },
+        { name: "meta.json", data: Buffer.from(JSON.stringify(pkg.meta, null, 2), "utf8") },
+    ];
+    for (const [path, data] of Object.entries(pkg.attachments)) {
+        entries.push({ name: path.startsWith("attachments/") ? path : `attachments/${path}`, data });
+    }
+    return (0, zipWriter_1.writeZip)(entries);
+}
+/** يبني meta.json افتراضياً انطلاقاً من مستند DocumentLoop */
+function buildDefaultMeta(doc) {
+    return {
+        id: doc.id,
+        title: doc.metadata.title,
+        domain: doc.metadata.domain,
+        version: doc.version,
+        author: doc.metadata.author,
+        language: doc.metadata.language,
+        createdAt: doc.metadata.createdAt ?? new Date().toISOString(),
+        dlofpkg_version: "1.0",
+    };
+}

package/dist/player/renderPlayerHtml.d.ts

@@ -0,0 +1,13 @@
+import { DlofSeries } from "../types";
+export interface PlayerOptions {
+    /** الحد الأقصى بالبايت لتضمين ملف وسائط كـ data URL مباشرة داخل الصفحة (افتراضي 20MB) */
+    maxInlineMediaBytes?: number;
+    title?: string;
+}
+/**
+ * مشغّل dlof: يبني تطبيق HTML/JS تفاعلي واحد لسلسلة أو حلقة كاملة من ملفات .dlof.
+ * يوفر: قائمة تصفح جانبية، أزرار التالي/السابق (تتبع loopLinks)، تشغيل الوسائط
+ * المرجعية (mediaRef / mediaFolder) مع شريط تقدّم قابل للسحب، وحفظ آخر موضع
+ * تصفح في التخزين المحلي للمتصفح بين الجلسات.
+ */
+export declare function renderPlayerHtml(series: DlofSeries, options?: PlayerOptions): string;