@actuate-media/plugin-ai 0.0.1

package/dist/providers/index.d.ts

@@ -0,0 +1,34 @@
+export interface GenerateOptions {
+    maxTokens?: number;
+    temperature?: number;
+    systemPrompt?: string;
+}
+export interface GenerateResult {
+    text: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+    };
+}
+export interface StreamOptions extends GenerateOptions {
+}
+export interface AIProvider {
+    generateText(prompt: string, options?: GenerateOptions): Promise<GenerateResult>;
+    generateEmbedding(text: string): Promise<number[]>;
+    streamText(prompt: string, options?: StreamOptions): AsyncIterable<string>;
+}
+export interface AIProviderConfig {
+    provider: "anthropic" | "openai";
+    apiKey: string;
+    model?: string;
+    openaiApiKey?: string;
+}
+/** Creates an AI provider instance for the specified backend. */
+export declare function createAIProvider(config: AIProviderConfig): AIProvider;
+/** Set the global AI provider used by all plugin features. */
+export declare function setAIProvider(provider: AIProvider): void;
+/** Get the global AI provider. Returns null if not configured. */
+export declare function getAIProvider(): AIProvider | null;
+/** Get the global AI provider or throw if not configured. */
+export declare function requireAIProvider(): AIProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;CAAG;AAEzD,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACjF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAarE;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAExD;AAED,kEAAkE;AAClE,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,IAAI,UAAU,CAQ9C"}

package/dist/providers/index.js

@@ -0,0 +1,35 @@
+import { createAnthropicProvider } from "./anthropic";
+import { createOpenAIProvider } from "./openai";
+let _globalProvider = null;
+/** Creates an AI provider instance for the specified backend. */
+export function createAIProvider(config) {
+    switch (config.provider) {
+        case "anthropic":
+            return createAnthropicProvider({
+                apiKey: config.apiKey,
+                model: config.model,
+                openaiApiKey: config.openaiApiKey,
+            });
+        case "openai":
+            return createOpenAIProvider({ apiKey: config.apiKey, model: config.model });
+        default:
+            throw new Error(`Unsupported AI provider: ${config.provider}`);
+    }
+}
+/** Set the global AI provider used by all plugin features. */
+export function setAIProvider(provider) {
+    _globalProvider = provider;
+}
+/** Get the global AI provider. Returns null if not configured. */
+export function getAIProvider() {
+    return _globalProvider;
+}
+/** Get the global AI provider or throw if not configured. */
+export function requireAIProvider() {
+    if (!_globalProvider) {
+        throw new Error("AI provider not configured. Call aiPlugin({ provider, apiKey }) " +
+            "or setAIProvider() before using AI features.");
+    }
+    return _globalProvider;
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AA4BhD,IAAI,eAAe,GAAsB,IAAI,CAAC;AAE9C,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,uBAAuB,CAAC;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9E;YACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,QAAoB;IAChD,eAAe,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,kEAAkE;YAClE,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,7 @@
+import type { AIProvider } from "./index";
+/** Creates an OpenAI-backed AI provider. */
+export declare function createOpenAIProvider(config: {
+    apiKey: string;
+    model?: string;
+}): AIProvider;
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkD,MAAM,SAAS,CAAC;AAM1F,4CAA4C;AAC5C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,UAAU,CAyHb"}

package/dist/providers/openai.js

@@ -0,0 +1,110 @@
+const DEFAULT_MODEL = "gpt-4o";
+const EMBEDDING_MODEL = "text-embedding-3-small";
+const API_BASE = "https://api.openai.com/v1";
+/** Creates an OpenAI-backed AI provider. */
+export function createOpenAIProvider(config) {
+    const model = config.model ?? DEFAULT_MODEL;
+    const headers = {
+        "Authorization": `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json",
+    };
+    return {
+        async generateText(prompt, options) {
+            const response = await fetch(`${API_BASE}/chat/completions`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    model,
+                    max_tokens: options?.maxTokens ?? 1024,
+                    temperature: options?.temperature ?? 0.7,
+                    messages: [
+                        ...(options?.systemPrompt ? [{ role: "system", content: options.systemPrompt }] : []),
+                        { role: "user", content: prompt },
+                    ],
+                }),
+            });
+            if (!response.ok) {
+                const err = await response.text().catch(() => "Unknown error");
+                throw new Error(`OpenAI API error (${response.status}): ${err}`);
+            }
+            const data = await response.json();
+            return {
+                text: data.choices[0]?.message?.content ?? "",
+                usage: {
+                    promptTokens: data.usage?.prompt_tokens ?? 0,
+                    completionTokens: data.usage?.completion_tokens ?? 0,
+                },
+            };
+        },
+        async generateEmbedding(text) {
+            const response = await fetch(`${API_BASE}/embeddings`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    model: EMBEDDING_MODEL,
+                    input: text,
+                }),
+            });
+            if (!response.ok) {
+                const err = await response.text().catch(() => "Unknown error");
+                throw new Error(`OpenAI embeddings error (${response.status}): ${err}`);
+            }
+            const data = await response.json();
+            return data.data[0]?.embedding ?? [];
+        },
+        async *streamText(prompt, options) {
+            const response = await fetch(`${API_BASE}/chat/completions`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    model,
+                    max_tokens: options?.maxTokens ?? 1024,
+                    temperature: options?.temperature ?? 0.7,
+                    stream: true,
+                    messages: [
+                        ...(options?.systemPrompt ? [{ role: "system", content: options.systemPrompt }] : []),
+                        { role: "user", content: prompt },
+                    ],
+                }),
+            });
+            if (!response.ok) {
+                const err = await response.text().catch(() => "Unknown error");
+                throw new Error(`OpenAI stream error (${response.status}): ${err}`);
+            }
+            const reader = response.body?.getReader();
+            if (!reader)
+                throw new Error("No response body for streaming");
+            const decoder = new TextDecoder();
+            let buffer = "";
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += decoder.decode(value, { stream: true });
+                    const lines = buffer.split("\n");
+                    buffer = lines.pop() ?? "";
+                    for (const line of lines) {
+                        const trimmed = line.trim();
+                        if (!trimmed || !trimmed.startsWith("data: "))
+                            continue;
+                        const payload = trimmed.slice(6);
+                        if (payload === "[DONE]")
+                            return;
+                        try {
+                            const chunk = JSON.parse(payload);
+                            const content = chunk.choices[0]?.delta?.content;
+                            if (content)
+                                yield content;
+                        }
+                        catch { }
+                    }
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"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"}

package/dist/scoring/accessibility.d.ts

@@ -0,0 +1,24 @@
+export interface AccessibilityContent {
+    html: string;
+    images: Array<{
+        src: string;
+        alt?: string;
+    }>;
+    headings: string[];
+    links: Array<{
+        text: string;
+        href: string;
+    }>;
+}
+export interface AccessibilityResult {
+    score: number;
+    issues: Array<{
+        type: "error" | "warning" | "info";
+        rule: string;
+        message: string;
+        element?: string;
+    }>;
+}
+/** Calculates an accessibility score based on common WCAG criteria. */
+export declare function calculateAccessibilityScore(content: AccessibilityContent): AccessibilityResult;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/scoring/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/scoring/accessibility.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACnC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,uEAAuE;AACvE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CA0FrB"}

package/dist/scoring/accessibility.js

@@ -0,0 +1,87 @@
+/** Calculates an accessibility score based on common WCAG criteria. */
+export function calculateAccessibilityScore(content) {
+    const issues = [];
+    let deductions = 0;
+    for (const img of content.images) {
+        if (!img.alt || img.alt.trim().length === 0) {
+            issues.push({
+                type: "error",
+                rule: "img-alt",
+                message: "Image is missing alt text",
+                element: `<img src="${img.src}">`,
+            });
+            deductions += 10;
+        }
+        else if (img.alt.length > 125) {
+            issues.push({
+                type: "warning",
+                rule: "img-alt-length",
+                message: "Alt text exceeds recommended 125 characters",
+                element: `<img alt="${img.alt.slice(0, 30)}...">`,
+            });
+            deductions += 3;
+        }
+    }
+    for (const link of content.links) {
+        if (!link.text || link.text.trim().length === 0) {
+            issues.push({
+                type: "error",
+                rule: "link-text",
+                message: "Link has no accessible text",
+                element: `<a href="${link.href}">`,
+            });
+            deductions += 10;
+        }
+        const genericTexts = ["click here", "read more", "here", "link", "more"];
+        if (genericTexts.includes(link.text.toLowerCase().trim())) {
+            issues.push({
+                type: "warning",
+                rule: "link-text-descriptive",
+                message: `Link text "${link.text}" is not descriptive`,
+                element: `<a href="${link.href}">${link.text}</a>`,
+            });
+            deductions += 5;
+        }
+    }
+    const headingPattern = /^h(\d)$/i;
+    let prevLevel = 0;
+    for (const heading of content.headings) {
+        const match = heading.match(headingPattern);
+        if (match) {
+            const level = parseInt(match[1] ?? "0", 10);
+            if (level > prevLevel + 1 && prevLevel > 0) {
+                issues.push({
+                    type: "warning",
+                    rule: "heading-order",
+                    message: `Heading level skipped from h${prevLevel} to h${level}`,
+                    element: heading,
+                });
+                deductions += 5;
+            }
+            prevLevel = level;
+        }
+    }
+    if (content.headings.length === 0) {
+        issues.push({
+            type: "info",
+            rule: "heading-presence",
+            message: "No headings found — headings improve navigation for screen readers",
+        });
+        deductions += 5;
+    }
+    const plainText = content.html.replace(/<[^>]*>/g, "");
+    const words = plainText.split(/\s+/).filter(Boolean);
+    const longWords = words.filter((w) => w.length > 14).length;
+    const longWordRatio = words.length > 0 ? longWords / words.length : 0;
+    if (longWordRatio > 0.15) {
+        issues.push({
+            type: "info",
+            rule: "reading-level",
+            message: "Content may be difficult to read — high proportion of complex words",
+        });
+        deductions += 3;
+    }
+    const score = Math.max(0, Math.min(100, 100 - deductions));
+    return { score, issues };
+}
+//# sourceMappingURL=accessibility.js.map

package/dist/scoring/accessibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../src/scoring/accessibility.ts"],"names":[],"mappings":"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"}

package/dist/scoring/brand-alignment.d.ts

@@ -0,0 +1,12 @@
+import type { BrandVoiceProfile } from "../brand/voice-profile.js";
+export interface BrandAlignmentResult {
+    score: number;
+    dimensions: Array<{
+        name: string;
+        score: number;
+        feedback: string;
+    }>;
+}
+/** Calculates how well the given content aligns with a brand voice profile. */
+export declare function calculateBrandAlignment(content: string, profile: BrandVoiceProfile): BrandAlignmentResult;
+//# sourceMappingURL=brand-alignment.d.ts.map

package/dist/scoring/brand-alignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-alignment.d.ts","sourceRoot":"","sources":["../../src/scoring/brand-alignment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,oBAAoB,CAsDtB"}

package/dist/scoring/brand-alignment.js

@@ -0,0 +1,46 @@
+/** Calculates how well the given content aligns with a brand voice profile. */
+export function calculateBrandAlignment(content, profile) {
+    const dimensions = [];
+    const words = content.split(/\s+/).filter(Boolean);
+    const sentences = content.split(/[.!?]+/).filter(Boolean);
+    const avgSentenceLength = sentences.length > 0 ? words.length / sentences.length : 0;
+    const targetLengths = { short: 12, medium: 20, long: 30, varied: 18 };
+    const targetLen = targetLengths[profile.style.sentenceLength] ?? 18;
+    const sentenceDelta = Math.abs(avgSentenceLength - targetLen);
+    const sentenceScore = Math.max(0, 100 - sentenceDelta * 5);
+    dimensions.push({
+        name: "Sentence length",
+        score: Math.round(sentenceScore),
+        feedback: sentenceDelta < 3 ? "Sentence length matches brand style" : `Average sentence length (${Math.round(avgSentenceLength)}) differs from target (${targetLen})`,
+    });
+    const preferredHits = profile.vocabulary.preferred.filter((w) => content.toLowerCase().includes(w.toLowerCase())).length;
+    const preferredRatio = profile.vocabulary.preferred.length > 0
+        ? (preferredHits / profile.vocabulary.preferred.length) * 100
+        : 100;
+    dimensions.push({
+        name: "Preferred vocabulary",
+        score: Math.round(preferredRatio),
+        feedback: preferredRatio > 70 ? "Good use of brand vocabulary" : "Consider using more brand-preferred terms",
+    });
+    const avoidedHits = profile.vocabulary.avoided.filter((w) => content.toLowerCase().includes(w.toLowerCase())).length;
+    const avoidedScore = profile.vocabulary.avoided.length > 0
+        ? Math.max(0, 100 - avoidedHits * 25)
+        : 100;
+    dimensions.push({
+        name: "Avoided vocabulary",
+        score: Math.round(avoidedScore),
+        feedback: avoidedHits === 0 ? "No off-brand terms detected" : `Found ${avoidedHits} term(s) that should be avoided`,
+    });
+    for (const tone of profile.tone) {
+        dimensions.push({
+            name: `Tone: ${tone.dimension}`,
+            score: Math.round(tone.value * 100),
+            feedback: `Tone dimension "${tone.dimension}" requires AI analysis for accurate measurement`,
+        });
+    }
+    const avgScore = dimensions.length > 0
+        ? dimensions.reduce((sum, d) => sum + d.score, 0) / dimensions.length
+        : 0;
+    return { score: Math.round(avgScore), dimensions };
+}
+//# sourceMappingURL=brand-alignment.js.map

package/dist/scoring/brand-alignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-alignment.js","sourceRoot":"","sources":["../../src/scoring/brand-alignment.ts"],"names":[],"mappings":"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"}

package/dist/scoring/composite.d.ts

@@ -0,0 +1,19 @@
+export interface ScoreInputs {
+    readability?: number;
+    seo?: number;
+    brandAlignment?: number;
+    accessibility?: number;
+    freshness?: number;
+}
+export interface CompositeScore {
+    overall: number;
+    breakdown: Record<string, {
+        score: number;
+        weight: number;
+        weighted: number;
+    }>;
+    grade: "A" | "B" | "C" | "D" | "F";
+}
+/** Calculates a weighted composite score from individual content quality dimensions. */
+export declare function calculateCompositeScore(scores: ScoreInputs, weights?: Partial<Record<keyof ScoreInputs, number>>): CompositeScore;
+//# sourceMappingURL=composite.d.ts.map

package/dist/scoring/composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../../src/scoring/composite.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CACpC;AAUD,wFAAwF;AACxF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,WAAW,EAAE,MAAM,CAAC,CAAC,GACnD,cAAc,CA6BhB"}

package/dist/scoring/composite.js

@@ -0,0 +1,38 @@
+const DEFAULT_WEIGHTS = {
+    readability: 0.2,
+    seo: 0.25,
+    brandAlignment: 0.2,
+    accessibility: 0.2,
+    freshness: 0.15,
+};
+/** Calculates a weighted composite score from individual content quality dimensions. */
+export function calculateCompositeScore(scores, weights) {
+    const mergedWeights = { ...DEFAULT_WEIGHTS, ...weights };
+    const breakdown = {};
+    let totalWeight = 0;
+    let totalWeighted = 0;
+    for (const [key, value] of Object.entries(scores)) {
+        if (value === undefined)
+            continue;
+        const k = key;
+        const weight = mergedWeights[k] ?? 0;
+        const weighted = value * weight;
+        breakdown[key] = { score: value, weight, weighted };
+        totalWeight += weight;
+        totalWeighted += weighted;
+    }
+    const overall = totalWeight > 0 ? Math.round(totalWeighted / totalWeight) : 0;
+    let grade;
+    if (overall >= 90)
+        grade = "A";
+    else if (overall >= 80)
+        grade = "B";
+    else if (overall >= 70)
+        grade = "C";
+    else if (overall >= 60)
+        grade = "D";
+    else
+        grade = "F";
+    return { overall, breakdown, grade };
+}
+//# sourceMappingURL=composite.js.map

package/dist/scoring/composite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.js","sourceRoot":"","sources":["../../src/scoring/composite.ts"],"names":[],"mappings":"AAcA,MAAM,eAAe,GAAsC;IACzD,WAAW,EAAE,GAAG;IAChB,GAAG,EAAE,IAAI;IACT,cAAc,EAAE,GAAG;IACnB,aAAa,EAAE,GAAG;IAClB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CACrC,MAAmB,EACnB,OAAoD;IAEpD,MAAM,aAAa,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAgC,EAAE,CAAC;IAClD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAElC,MAAM,CAAC,GAAG,GAAwB,CAAC;QACnC,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;QAEhC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACpD,WAAW,IAAI,MAAM,CAAC;QACtB,aAAa,IAAI,QAAQ,CAAC;IAC5B,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,IAAI,KAA8B,CAAC;IACnC,IAAI,OAAO,IAAI,EAAE;QAAE,KAAK,GAAG,GAAG,CAAC;SAC1B,IAAI,OAAO,IAAI,EAAE;QAAE,KAAK,GAAG,GAAG,CAAC;SAC/B,IAAI,OAAO,IAAI,EAAE;QAAE,KAAK,GAAG,GAAG,CAAC;SAC/B,IAAI,OAAO,IAAI,EAAE;QAAE,KAAK,GAAG,GAAG,CAAC;;QAC/B,KAAK,GAAG,GAAG,CAAC;IAEjB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC"}

package/dist/scoring/freshness.d.ts

@@ -0,0 +1,15 @@
+export interface FreshnessOptions {
+    publishedAt: Date;
+    updatedAt?: Date;
+    contentType: string;
+    averageLifespanDays?: number;
+}
+export interface FreshnessResult {
+    score: number;
+    decayRate: number;
+    daysOld: number;
+    recommendation: "current" | "review" | "stale" | "outdated";
+}
+/** Calculates a freshness score using exponential decay based on content age. */
+export declare function calculateFreshnessScore(options: FreshnessOptions): FreshnessResult;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/scoring/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../src/scoring/freshness.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;CAC7D;AAUD,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA2BlF"}

package/dist/scoring/freshness.js

@@ -0,0 +1,37 @@
+const DEFAULT_LIFESPANS = {
+    news: 7,
+    blog: 180,
+    tutorial: 365,
+    documentation: 730,
+    evergreen: 1095,
+};
+/** Calculates a freshness score using exponential decay based on content age. */
+export function calculateFreshnessScore(options) {
+    const lifespanDays = options.averageLifespanDays
+        ?? DEFAULT_LIFESPANS[options.contentType]
+        ?? 365;
+    const referenceDate = options.updatedAt ?? options.publishedAt;
+    const now = new Date();
+    const msPerDay = 1000 * 60 * 60 * 24;
+    const daysOld = Math.max(0, (now.getTime() - referenceDate.getTime()) / msPerDay);
+    const halfLife = lifespanDays / 2;
+    const decayRate = Math.LN2 / halfLife;
+    const score = Math.round(100 * Math.exp(-decayRate * daysOld));
+    const clampedScore = Math.max(0, Math.min(100, score));
+    let recommendation;
+    if (clampedScore >= 75)
+        recommendation = "current";
+    else if (clampedScore >= 50)
+        recommendation = "review";
+    else if (clampedScore >= 25)
+        recommendation = "stale";
+    else
+        recommendation = "outdated";
+    return {
+        score: clampedScore,
+        decayRate: Math.round(decayRate * 10000) / 10000,
+        daysOld: Math.round(daysOld),
+        recommendation,
+    };
+}
+//# sourceMappingURL=freshness.js.map

package/dist/scoring/freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../src/scoring/freshness.ts"],"names":[],"mappings":"AAcA,MAAM,iBAAiB,GAA2B;IAChD,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,GAAG;IACb,aAAa,EAAE,GAAG;IAClB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,OAAyB;IAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,mBAAmB;WAC3C,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC;WACtC,GAAG,CAAC;IAET,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;IAC/D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;IAElF,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAEvD,IAAI,cAAiD,CAAC;IACtD,IAAI,YAAY,IAAI,EAAE;QAAE,cAAc,GAAG,SAAS,CAAC;SAC9C,IAAI,YAAY,IAAI,EAAE;QAAE,cAAc,GAAG,QAAQ,CAAC;SAClD,IAAI,YAAY,IAAI,EAAE;QAAE,cAAc,GAAG,OAAO,CAAC;;QACjD,cAAc,GAAG,UAAU,CAAC;IAEjC,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,KAAK;QAChD,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/scoring/readability.d.ts

@@ -0,0 +1,16 @@
+export interface ReadabilityResult {
+    fleschKincaid: number;
+    gunningFog: number;
+    smog: number;
+    averageGradeLevel: number;
+    difficulty: "easy" | "moderate" | "difficult" | "expert";
+}
+/** Calculates the Flesch-Kincaid grade level for the given text. */
+export declare function calculateFleschKincaid(text: string): number;
+/** Calculates the Gunning Fog index for the given text. */
+export declare function calculateGunningFog(text: string): number;
+/** Calculates the SMOG readability index for the given text. */
+export declare function calculateSMOG(text: string): number;
+/** Returns a comprehensive readability analysis of the given text. */
+export declare function getReadabilityScore(text: string): ReadabilityResult;
+//# sourceMappingURL=readability.d.ts.map

package/dist/scoring/readability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readability.d.ts","sourceRoot":"","sources":["../../src/scoring/readability.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC1D;AAmCD,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY3D;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAanE"}

package/dist/scoring/readability.js

@@ -0,0 +1,77 @@
+function countSentences(text) {
+    const matches = text.match(/[.!?]+/g);
+    return matches ? matches.length : 1;
+}
+function countWords(text) {
+    const matches = text.trim().split(/\s+/).filter(Boolean);
+    return matches.length;
+}
+function countSyllables(word) {
+    const cleaned = word.toLowerCase().replace(/[^a-z]/g, "");
+    if (cleaned.length <= 3)
+        return 1;
+    let count = 0;
+    const vowels = "aeiouy";
+    let previousWasVowel = false;
+    for (const char of cleaned) {
+        const isVowel = vowels.includes(char);
+        if (isVowel && !previousWasVowel)
+            count++;
+        previousWasVowel = isVowel;
+    }
+    if (cleaned.endsWith("e") && count > 1)
+        count--;
+    return Math.max(count, 1);
+}
+function countComplexWords(text) {
+    const words = text.trim().split(/\s+/).filter(Boolean);
+    return words.filter((w) => countSyllables(w) >= 3).length;
+}
+/** Calculates the Flesch-Kincaid grade level for the given text. */
+export function calculateFleschKincaid(text) {
+    const words = countWords(text);
+    const sentences = countSentences(text);
+    const syllables = text
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .reduce((sum, word) => sum + countSyllables(word), 0);
+    if (words === 0 || sentences === 0)
+        return 0;
+    return 0.39 * (words / sentences) + 11.8 * (syllables / words) - 15.59;
+}
+/** Calculates the Gunning Fog index for the given text. */
+export function calculateGunningFog(text) {
+    const words = countWords(text);
+    const sentences = countSentences(text);
+    const complex = countComplexWords(text);
+    if (words === 0 || sentences === 0)
+        return 0;
+    return 0.4 * (words / sentences + 100 * (complex / words));
+}
+/** Calculates the SMOG readability index for the given text. */
+export function calculateSMOG(text) {
+    const sentences = countSentences(text);
+    const complex = countComplexWords(text);
+    if (sentences === 0)
+        return 0;
+    return 1.0430 * Math.sqrt(complex * (30 / sentences)) + 3.1291;
+}
+/** Returns a comprehensive readability analysis of the given text. */
+export function getReadabilityScore(text) {
+    const fleschKincaid = calculateFleschKincaid(text);
+    const gunningFog = calculateGunningFog(text);
+    const smog = calculateSMOG(text);
+    const averageGradeLevel = (fleschKincaid + gunningFog + smog) / 3;
+    let difficulty;
+    if (averageGradeLevel <= 6)
+        difficulty = "easy";
+    else if (averageGradeLevel <= 10)
+        difficulty = "moderate";
+    else if (averageGradeLevel <= 14)
+        difficulty = "difficult";
+    else
+        difficulty = "expert";
+    return { fleschKincaid, gunningFog, smog, averageGradeLevel, difficulty };
+}
+//# sourceMappingURL=readability.js.map