@qirtaas/core 0.0.1

package/dist/services/contentChannel.d.ts

@@ -0,0 +1,6 @@
+import { Channel } from './transport';
+export interface ContentChannelOptions {
+    apiUrl: string;
+    apiKey?: string;
+}
+export declare function createContentChannel(opts: ContentChannelOptions): Channel;

package/dist/services/documents.d.ts

@@ -0,0 +1,23 @@
+export type Json = Record<string, unknown>;
+export interface QirtaasDocument {
+    id: string;
+    title: string;
+    content: Json | null;
+    status: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface UpdateResult extends QirtaasDocument {
+    /** Image ids referenced in content that the server refused to link. */
+    rejected_image_ids: string[];
+}
+export declare function getDocument(id: string): Promise<QirtaasDocument>;
+export declare function createDocument(content?: Json): Promise<QirtaasDocument>;
+export declare function updateDocument(id: string, content: Json): Promise<UpdateResult>;
+export declare function deleteDocument(id: string): Promise<void>;
+export interface SharedDocument {
+    id: string;
+    title: string;
+    content: Json | null;
+}
+export declare function getSharedDocument(token: string): Promise<SharedDocument>;

package/dist/services/embedTransport.d.ts

@@ -0,0 +1,11 @@
+import { QirtaasTransport } from './transport';
+export interface EmbedTransportOptions {
+    apiUrl: string;
+    getToken: () => Promise<string> | string;
+    /** Forwarded to the token manager; fired when a forced refresh fails. */
+    onTokenExpired?: () => void;
+    /** Content API base (defaults to apiUrl) + key for quran/hadith/mushaf. */
+    contentApiUrl?: string;
+    contentApiKey?: string;
+}
+export declare function createEmbedTransport(opts: EmbedTransportOptions): QirtaasTransport;

package/dist/services/fetchChannel.d.ts

@@ -0,0 +1,17 @@
+import { Channel } from './transport';
+export declare class QirtaasHttpError extends Error {
+    status: number;
+    path: string;
+    /** Parsed JSON error body, if any (backend uses { error: "code" }). */
+    body?: unknown | undefined;
+    constructor(status: number, path: string, 
+    /** Parsed JSON error body, if any (backend uses { error: "code" }). */
+    body?: unknown | undefined);
+}
+export interface ChannelAuth {
+    headers?: Record<string, string>;
+    params?: Record<string, unknown>;
+}
+export declare function createFetchChannel(apiUrl: string, auth: () => Promise<ChannelAuth> | ChannelAuth, 
+/** Called on a 401 before a single retry — e.g. drop a stale cached token. */
+onUnauthorized?: () => void): Channel;

package/dist/services/hadith.d.ts

@@ -0,0 +1,18 @@
+export interface HadithResult {
+    id: number;
+    slug: string;
+    collection_name_arabic: string;
+    collection_name_english: string;
+    number: number | null;
+    text: string;
+    translation_en: string;
+    narrator_chain: string;
+    grade: string;
+    arabic_bab_name: string;
+    english_bab_name: string;
+    english_grade: string;
+    /** Trimmed excerpt with matched words wrapped in <mark>; null for ref lookups. */
+    text_highlighted?: string | null;
+}
+export declare function searchHadith(query: string): Promise<HadithResult[]>;
+export declare function getHadithByRef(slug: string, number: number): Promise<HadithResult[]>;

package/dist/services/images.d.ts

@@ -0,0 +1,10 @@
+export declare const MAX_IMAGE_BYTES: number;
+export interface UploadTicket {
+    image_id: string;
+    upload_url: string;
+}
+export declare function requestUploadUrl(filename: string, contentType: string): Promise<UploadTicket>;
+export declare function uploadToPresignedUrl(url: string, file: File): Promise<void>;
+export declare function confirmUpload(imageId: string): Promise<void>;
+export declare function invalidateImageUrl(imageId: string): void;
+export declare function getImageUrl(imageId: string, documentId?: string): Promise<string>;

package/dist/services/quran.d.ts

@@ -0,0 +1,52 @@
+export interface SurahBrief {
+    number: number;
+    name_arabic: string;
+    name_english: string;
+}
+export interface AyahResult {
+    surah: SurahBrief;
+    number: number;
+    text: string;
+}
+export interface VerseTafsir {
+    slug: string;
+    name: string;
+    language: string;
+    text: string;
+}
+export interface VerseDetail {
+    surah: number;
+    ayah: number;
+    surah_name_arabic: string;
+    surah_name_english: string;
+    arabic_text: string;
+    translation_en: string;
+    tafsirs: VerseTafsir[];
+}
+export declare function getVerseDetail(surah: number, ayah: number, _locale: string): Promise<VerseDetail>;
+export interface SurahMatch {
+    number: number;
+    name_arabic: string;
+    name_english: string;
+    verse_count: number;
+}
+export interface QuranSearchResponse {
+    surahs: SurahMatch[];
+    verses: AyahResult[];
+}
+export declare function searchQuran(query: string): Promise<QuranSearchResponse>;
+export { SURAHS, MUSHAF_PAGES, type SurahInfo, type MushafPage, type VerseRef, } from '../data/mushaf';
+export interface VerseRangeResult {
+    surah: SurahBrief;
+    from_ayah: number;
+    to_ayah: number;
+    text: string;
+}
+export declare function getVerseRange(surah: number, fromAyah: number, toAyah: number): Promise<VerseRangeResult>;
+export declare function mushafSvgUrl(page: number): string;
+export interface ClipRef {
+    page: number;
+    lineStart: number;
+    lineEnd: number;
+}
+export declare function mushafClipUrl(ref: ClipRef): string;

package/dist/services/rendererTransport.d.ts

@@ -0,0 +1,12 @@
+import { QirtaasTransport } from './transport';
+export interface RendererTransportOptions {
+    apiUrl: string;
+    getToken?: () => Promise<string> | string;
+    getSignature?: () => Promise<{
+        signature: string;
+        exp: number;
+    }>;
+    contentApiUrl?: string;
+    contentApiKey?: string;
+}
+export declare function createRendererTransport(opts: RendererTransportOptions): QirtaasTransport;

package/dist/services/tokenManager.d.ts

@@ -0,0 +1,12 @@
+export interface TokenManagerOptions {
+    getToken: () => Promise<string> | string;
+    /** Fired once when a forced refresh fails (host should prompt re-auth). */
+    onTokenExpired?: () => void;
+}
+export interface TokenManager {
+    /** A token guaranteed fresh past REFRESH_SKEW_MS, refreshing if needed. */
+    getValidToken(): Promise<string>;
+    /** Drop the cache so the next getValidToken() re-fetches (used after a 401). */
+    invalidate(): void;
+}
+export declare function createTokenManager(opts: TokenManagerOptions): TokenManager;

package/dist/services/transport.d.ts

@@ -0,0 +1,18 @@
+export interface Channel {
+    /** Full versioned base URL, e.g. ".../v1" — also for static asset URLs. */
+    apiUrl: string;
+    get<T = unknown>(path: string, opts?: {
+        params?: Record<string, unknown>;
+    }): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+}
+export interface QirtaasTransport {
+    /** documents + images, authorized by the active mode (bearer/signature/share). */
+    data: Channel;
+    /** quran / hadith / mushaf, authorized by the content API key. */
+    content: Channel;
+}
+export declare function setTransport(transport: QirtaasTransport): void;
+export declare function getTransport(): QirtaasTransport;

package/dist/styles/primevuePreset.d.ts

@@ -0,0 +1,12 @@
+export declare const qirtaasPreset: import('@primeuix/themes/types').Preset;
+export declare const embedThemeOptions: {
+    prefix: string;
+    darkModeSelector: string;
+    cssLayer: {
+        name: string;
+        order: string;
+    };
+};
+export declare function embedPrimeVueOptions(): {
+    theme: unknown;
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@qirtaas/core",
+  "version": "0.0.1",
+  "description": "Embeddable rich-text editor SDK for Islamic writings. Framework-agnostic mount API and CDN/UMD bundle.",
+  "license": "MIT",
+  "author": "Alrimaal",
+  "homepage": "https://github.com/alrimaal/qirtaas#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alrimaal/qirtaas.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/alrimaal/qirtaas/issues"
+  },
+  "keywords": [
+    "editor",
+    "rich-text",
+    "wysiwyg",
+    "tiptap",
+    "arabic",
+    "rtl",
+    "quran",
+    "hadith",
+    "qirtaas",
+    "embed",
+    "sdk"
+  ],
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/qirtaas.umd.js",
+  "module": "./dist/qirtaas.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/qirtaas.js",
+      "require": "./dist/qirtaas.umd.js"
+    },
+    "./qirtaas.css": "./dist/qirtaas.css",
+    "./*.vue": "./src/*.vue",
+    "./*": "./src/*.ts"
+  },
+  "scripts": {
+    "build": "vite build",
+    "preview": "vite preview",
+    "prepublishOnly": "vite build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.2.2",
+    "postcss-prefix-selector": "^2.1.1",
+    "vite-plugin-dts": "^5.0.3"
+  }
+}