@erudit-js/core 3.0.0-dev.25

package/dist/brand.d.ts

@@ -0,0 +1,2 @@
+export declare const brandLogotype = "\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\n\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\n\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\n\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D   \u255A\u2550\u255D\n";
+export declare const brandColors: string[];

package/dist/brand.js

@@ -0,0 +1,9 @@
+export const brandLogotype = `
+███████╗██████╗ ██╗   ██╗██████╗ ██╗████████╗
+██╔════╝██╔══██╗██║   ██║██╔══██╗██║╚══██╔══╝
+█████╗  ██████╔╝██║   ██║██║  ██║██║   ██║
+██╔══╝  ██╔══██╗██║   ██║██║  ██║██║   ██║
+███████╗██║  ██║╚██████╔╝██████╔╝██║   ██║
+╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═╝   ╚═╝
+`;
+export const brandColors = ['#4aa44c', '#1278b9'];

package/dist/brandTerminal.d.ts

@@ -0,0 +1,2 @@
+export declare const brandColorLogotype: string;
+export declare const brandColorTitle: string;

package/dist/brandTerminal.js

@@ -0,0 +1,4 @@
+import gradient from 'gradient-string';
+import { brandColors, brandLogotype } from './brand.js';
+export const brandColorLogotype = gradient(brandColors).multiline(brandLogotype);
+export const brandColorTitle = gradient(brandColors)('Erudit');

package/dist/cameo.d.ts

@@ -0,0 +1,11 @@
+export interface Cameo {
+    cameoId: string;
+    name: string;
+    icon: string;
+    messages: string[];
+    avatarExtension: string;
+    color: string;
+    link?: string;
+}
+export type CameoConfig = Omit<Cameo, 'cameoId' | 'avatarExtension' | 'icon'>;
+export declare function defineCameo(cameo: CameoConfig): CameoConfig;

package/dist/cameo.js

@@ -0,0 +1,3 @@
+export function defineCameo(cameo) {
+    return cameo;
+}

package/dist/content/book.d.ts

@@ -0,0 +1,5 @@
+import { type ContentItem, type TypelessContentItem } from './item.js';
+export interface BookContentItem extends ContentItem {
+    type: 'book';
+}
+export declare function defineBook(book?: TypelessContentItem<BookContentItem>): ContentItem;

package/dist/content/book.js

@@ -0,0 +1,4 @@
+import { finalizeContentItem, } from './item.js';
+export function defineBook(book) {
+    return finalizeContentItem('book', book ?? {});
+}

package/dist/content/contributions.d.ts

@@ -0,0 +1,39 @@
+import type { GlobalContributorTypeguard } from '../contributor.js';
+export interface ConfigContributionDescribed {
+    contributor: GlobalContributorTypeguard;
+    description: string;
+}
+export type ConfigContribution = GlobalContributorTypeguard | ConfigContributionDescribed;
+export type IContributable = {
+    /**
+     * List of contributions to this content item.
+     * You can access contributors via `$CONTRIBUTOR` global variable:
+     * ```ts
+     * contributions: [
+     *   $CONTRIBUTOR.john,
+     *   {
+     *     contributor: $CONTRIBUTOR.alice,
+     *     description: 'Proposed problem "A game of circles".'
+     *   }
+     * ],
+     * ```
+     */
+    contributions?: ConfigContribution[];
+};
+export interface ContentContribution {
+    contributorId: string;
+    name?: string;
+    avatarUrl?: string;
+    description?: string;
+}
+export interface ContributorContributionItem {
+    type: 'topic' | 'page';
+    title: string;
+    link: string;
+}
+export interface ContributorContributionBook {
+    type: 'book';
+    title: string;
+    items: ContributorContributionItem[];
+}
+export type ContributorContribution = ContributorContributionItem | ContributorContributionBook;

package/dist/content/contributions.js

@@ -0,0 +1 @@
+export {};

package/dist/content/dependencies.d.ts

@@ -0,0 +1,5 @@
+import type { GlobalContentItemTypeguard } from './global.js';
+export interface ContentDependency {
+    dependency: GlobalContentItemTypeguard;
+    reason: string;
+}

package/dist/content/dependencies.js

@@ -0,0 +1 @@
+export {};

package/dist/content/externals.d.ts

@@ -0,0 +1,15 @@
+interface BaseContentExternal {
+    type: 'web' | 'physical';
+    title: string;
+    info?: string;
+    reason: string;
+}
+export interface WebContentExternal extends BaseContentExternal {
+    type: 'web';
+    link: string;
+}
+export interface PhysicalContentExternal extends BaseContentExternal {
+    type: 'physical';
+}
+export type ContentExternal = WebContentExternal | PhysicalContentExternal;
+export {};

package/dist/content/externals.js

@@ -0,0 +1 @@
+export {};

package/dist/content/flags.d.ts

@@ -0,0 +1,3 @@
+export declare const contentFlags: readonly ["dev", "advanced", "secondary"];
+export type ContentFlag = (typeof contentFlags)[number];
+export type ContentFlags = Partial<Record<ContentFlag, boolean>>;

package/dist/content/flags.js

@@ -0,0 +1 @@
+export const contentFlags = ['dev', 'advanced', 'secondary'];

package/dist/content/global.d.ts

@@ -0,0 +1,26 @@
+declare const globalContentItemBrand: unique symbol;
+declare const globalContentTopicPartBrand: unique symbol;
+declare const globalContentUniqueBrand: unique symbol;
+export interface GlobalContentItemTypeguard {
+    [globalContentItemBrand]: true;
+}
+export interface GlobalContentTopicPartTypeguard {
+    [globalContentTopicPartBrand]: true;
+}
+export interface GlobalContentUniqueTypeguard {
+    [globalContentUniqueBrand]: true;
+}
+export type GlobalContentTypeguard = GlobalContentItemTypeguard | GlobalContentTopicPartTypeguard | GlobalContentUniqueTypeguard;
+export interface GlobalContentItem {
+    __ERUDIT_globalContentItem: true;
+    __path: string;
+}
+export declare function createGlobalContentProxy(path?: string): {
+    __ERUDIT_globalContentItem: true;
+    __path: string;
+};
+export declare function transformGlobalContentPath(path: string): string;
+export declare function createGlobalContent(path: string): GlobalContentItem;
+export declare function isGlobalContent(value: any): value is GlobalContentItem;
+export declare function getGlobalContentPath(item: GlobalContentItem): string;
+export {};

package/dist/content/global.js

@@ -0,0 +1,48 @@
+//
+// Typeguards used only for compile-time checks
+//
+export function createGlobalContentProxy(path = '') {
+    return new Proxy({
+        __ERUDIT_globalContentItem: true,
+        __path: path,
+    }, {
+        get(_, prop) {
+            if (prop === '__ERUDIT_globalContentItem')
+                return true;
+            if (prop === '__path')
+                return path;
+            const finalPath = path ? `${path}/${prop}` : prop;
+            return createGlobalContentProxy(transformGlobalContentPath(finalPath));
+        },
+    });
+}
+export function transformGlobalContentPath(path) {
+    const parts = path.split('/').filter((part) => part.length > 0);
+    const finalParts = [];
+    for (const part of parts) {
+        if (part.startsWith('$')) {
+            finalParts.push(part);
+        }
+        else {
+            finalParts.push(part.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase());
+        }
+    }
+    return finalParts.join('/');
+}
+export function createGlobalContent(path) {
+    return {
+        __ERUDIT_globalContentItem: true,
+        __path: transformGlobalContentPath(path),
+    };
+}
+export function isGlobalContent(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__ERUDIT_globalContentItem' in value &&
+        value.__ERUDIT_globalContentItem === true &&
+        '__path' in value &&
+        typeof value.__path === 'string');
+}
+export function getGlobalContentPath(item) {
+    return item.__path;
+}

package/dist/content/group.d.ts

@@ -0,0 +1,6 @@
+import { type ContentItem, type TypelessContentItem } from './item.js';
+export interface GroupContentItem extends ContentItem {
+    type: 'group';
+    separator?: boolean;
+}
+export declare function defineGroup(group?: TypelessContentItem<GroupContentItem>): ContentItem;

package/dist/content/group.js

@@ -0,0 +1,4 @@
+import { finalizeContentItem, } from './item.js';
+export function defineGroup(group) {
+    return finalizeContentItem('group', group ?? {});
+}

package/dist/content/item.d.ts

@@ -0,0 +1,67 @@
+import type { ContentFlags } from './flags.js';
+import type { ContentDependency } from './dependencies.js';
+import type { ContentType } from './type.js';
+import type { ContentExternal } from './externals.js';
+import type { ContentSeo } from './seo.js';
+export type ContentItem = {
+    type: ContentType;
+} & Partial<{
+    title: string;
+    navTitle: string;
+    description: string;
+    /**
+     * Hidden content items do not appear in aside content navigation
+     * but are still accessible via direct URL.
+     */
+    hidden: boolean;
+    /**
+     * Mark content with specific flags.
+     * @example
+     * ```ts
+     * flags: {
+     *   dev: true, // Override parent `dev` if present
+     *   secondary: false, // Override parent `secondary` if present
+     *   // `advanced` is not set, so it will inherit from parent if present
+     * }
+     * ```
+     */
+    flags: ContentFlags;
+    /**
+     * Manual list of content items this item depends on with explanations.
+     * Use this to emphasize important dependencies beyond the automatic ones.
+     * @example
+     * ```ts
+     * dependencies: [
+     *   {
+     *     dependency: $CONTENT.combinatorics,
+     *     reason: 'Provides foundational concepts used in this topic.'
+     *   },
+     *   {
+     *     dependency: $CONTENT.combinatorics.baseRules.product,
+     *     reason: 'This topic builds upon the product rule explained in that article.'
+     *   },
+     * ];
+     * ```
+     */
+    dependencies: ContentDependency[];
+    /**
+     * List of **important** external resources related to this content item.
+     * It is not a reference list!
+     * Add only resources that can provide significant additional value to the reader and relate directly to the content.
+     * @example
+     * ```ts
+     * externals: [
+     *   {
+     *     type: 'physical',
+     *     title: 'Combinatorial Mathematics',
+     *     description: 'A comprehensive guide to combinatorial principles and applications.',
+     *     reason: 'Great amount of problems to practice combinatorial concepts.'
+     *   },
+     * ];
+     */
+    externals: ContentExternal[];
+    seo: ContentSeo;
+}>;
+export type TypelessContentItem<TContentItem extends ContentItem> = Omit<TContentItem, 'type'>;
+export declare function finalizeContentItem(type: ContentType, item: TypelessContentItem<ContentItem>): ContentItem;
+export declare function isContentItem<TContentItem extends ContentItem>(item: any, type: TContentItem['type']): item is TContentItem;

package/dist/content/item.js

@@ -0,0 +1,12 @@
+// export interface ContentItem extends ContentItemBase {
+//     type: ContentType;
+// }
+export function finalizeContentItem(type, item) {
+    return {
+        ...item,
+        type,
+    };
+}
+export function isContentItem(item, type) {
+    return (item && typeof item === 'object' && 'type' in item && item.type === type);
+}

package/dist/content/page.d.ts

@@ -0,0 +1,6 @@
+import type { IContributable } from './contributions.js';
+import { type ContentItem, type TypelessContentItem } from './item.js';
+export interface PageContentItem extends ContentItem, IContributable {
+    type: 'page';
+}
+export declare function definePage(page?: TypelessContentItem<PageContentItem>): ContentItem;

package/dist/content/page.js

@@ -0,0 +1,4 @@
+import { finalizeContentItem, } from './item.js';
+export function definePage(page) {
+    return finalizeContentItem('page', page ?? {});
+}

package/dist/content/path.d.ts

@@ -0,0 +1,7 @@
+export interface ParsedContentPathPart {
+    position: number;
+    skip: boolean;
+    partId: string;
+}
+export declare function parseContentPathPart(part: string): ParsedContentPathPart | undefined;
+export declare function contentPathToId(path: string, projectPath: string, short: 'full' | 'short'): string | undefined;

package/dist/content/path.js

@@ -0,0 +1,38 @@
+export function parseContentPathPart(part) {
+    const [_all, position, skipChar, partId] = part.match(/^(\d+)([-\+])(.+)$/) || [];
+    if (position && skipChar && partId) {
+        return {
+            position: parseInt(position),
+            skip: skipChar === '+',
+            partId,
+        };
+    }
+}
+export function contentPathToId(path, projectPath, short) {
+    if (path.startsWith(`${projectPath}/content/`)) {
+        const pathAfterContent = path.slice(`${projectPath}/content/`.length);
+        const parts = pathAfterContent.split('/');
+        const parsedParts = [];
+        for (const part of parts) {
+            const parsedPart = parseContentPathPart(part);
+            if (parsedPart) {
+                parsedParts.push(parsedPart);
+            }
+            else {
+                // Reached a part that's not a content path part, stop here
+                break;
+            }
+        }
+        if (parsedParts.length === 0) {
+            return undefined;
+        }
+        // Build the content ID
+        const partsToInclude = short === 'short'
+            ? parsedParts.filter((part, index) => {
+                // Keep all non-skippable parts, or if it's the last part (even if skippable)
+                return !part.skip || index === parsedParts.length - 1;
+            })
+            : parsedParts;
+        return partsToInclude.map((part) => part.partId).join('/');
+    }
+}

package/dist/content/pointer.d.ts

@@ -0,0 +1,15 @@
+import type { TopicPart } from './topic.js';
+import type { ContentType } from './type.js';
+interface BasePointer {
+    type: ContentType;
+    id: string;
+}
+export interface GenericContentPointer extends BasePointer {
+    type: Exclude<ContentType, 'topic'>;
+}
+export interface TopicContentPointer extends BasePointer {
+    type: 'topic';
+    part: TopicPart;
+}
+export type ContentPointer = GenericContentPointer | TopicContentPointer;
+export {};

package/dist/content/pointer.js

@@ -0,0 +1 @@
+export {};

package/dist/content/prose.d.ts

@@ -0,0 +1,3 @@
+export declare const contentProseTypes: readonly ["page", "article", "summary", "practice"];
+export type ContentProseType = (typeof contentProseTypes)[number];
+export declare function isContentProseType(value: unknown): value is ContentProseType;

package/dist/content/prose.js

@@ -0,0 +1,10 @@
+export const contentProseTypes = [
+    'page',
+    'article',
+    'summary',
+    'practice',
+];
+export function isContentProseType(value) {
+    return (typeof value === 'string' &&
+        contentProseTypes.includes(value));
+}

package/dist/content/seo.d.ts

@@ -0,0 +1,4 @@
+export interface ContentSeo {
+    title?: string;
+    description?: string;
+}

package/dist/content/seo.js

@@ -0,0 +1 @@
+export {};

package/dist/content/topic.d.ts

@@ -0,0 +1,9 @@
+import type { IContributable } from './contributions.js';
+import { type ContentItem, type TypelessContentItem } from './item.js';
+export declare const topicParts: readonly ["article", "summary", "practice"];
+export type TopicPart = (typeof topicParts)[number];
+export declare function isTopicPart(value: unknown): value is TopicPart;
+export interface TopicContentItem extends ContentItem, IContributable {
+    type: 'topic';
+}
+export declare function defineTopic(topic?: TypelessContentItem<TopicContentItem>): ContentItem;

package/dist/content/topic.js

@@ -0,0 +1,8 @@
+import { finalizeContentItem, } from './item.js';
+export const topicParts = ['article', 'summary', 'practice'];
+export function isTopicPart(value) {
+    return topicParts.includes(value);
+}
+export function defineTopic(topic) {
+    return finalizeContentItem('topic', topic ?? {});
+}

package/dist/content/type.d.ts

@@ -0,0 +1,3 @@
+export declare const contentTypes: readonly ["book", "group", "page", "topic"];
+export type ContentType = (typeof contentTypes)[number];
+export declare function isContentType(value: unknown): value is ContentType;

package/dist/content/type.js

@@ -0,0 +1,4 @@
+export const contentTypes = ['book', 'group', 'page', 'topic'];
+export function isContentType(value) {
+    return contentTypes.includes(value);
+}

package/dist/contributor.d.ts

@@ -0,0 +1,49 @@
+import type { AnySchema, FinalizedProse, RawElement } from '@jsprose/core';
+import type { ContributorContribution } from './content/contributions.js';
+export interface EruditContributors {
+    enabled: boolean;
+    becomeContributorLink?: string;
+    howToImproveLink?: string;
+    reportIssueLink?: string;
+    editLinkPrefix?: string;
+}
+export type ContributorDefinition = Partial<{
+    displayName: string;
+    short: string;
+    editor: boolean;
+    links: Record<string, string>;
+    description: RawElement<AnySchema>;
+}>;
+export declare function defineContributor(contributor: ContributorDefinition): Partial<{
+    displayName: string;
+    short: string;
+    editor: boolean;
+    links: Record<string, string>;
+    description: RawElement<AnySchema>;
+}>;
+declare const globalContributorBrand: unique symbol;
+export interface GlobalContributorTypeguard {
+    [globalContributorBrand]: true;
+}
+export declare function contributorIdToPropertyName(contributorId: string): string;
+export declare function globalContributorsObject(contributorIds: string[]): Record<string, string>;
+export declare function globalContributorsTypes(contributors: Record<string, string>): string;
+export interface ListContributor {
+    id: string;
+    displayName?: string;
+    short?: string;
+    avatarUrl?: string;
+    contributions?: number;
+    editor?: boolean;
+}
+export interface PageContributor {
+    id: string;
+    displayName?: string;
+    short?: string;
+    links?: Record<string, string>;
+    avatarUrl?: string;
+    description?: FinalizedProse;
+    editor?: boolean;
+    contributions?: ContributorContribution[];
+}
+export {};

package/dist/contributor.js

@@ -0,0 +1,34 @@
+export function defineContributor(contributor) {
+    return contributor;
+}
+export function contributorIdToPropertyName(contributorId) {
+    return contributorId
+        .split('-')
+        .map((p, i) => (i === 0 ? p : p.charAt(0).toUpperCase() + p.slice(1)))
+        .join('');
+}
+export function globalContributorsObject(contributorIds) {
+    const contributors = {};
+    for (const contributorId of contributorIds) {
+        const exportName = contributorIdToPropertyName(contributorId);
+        if (contributors[exportName]) {
+            throw new Error(`Duplicate contributor export name detected: "${exportName}" (from contributor ID: "${contributorId}")!`);
+        }
+        contributors[exportName] = contributorId;
+    }
+    return contributors;
+}
+export function globalContributorsTypes(contributors) {
+    return `import type { GlobalContributorTypeguard } from '@erudit-js/core/contributor';
+
+export {};
+
+declare global {
+    const $CONTRIBUTOR: {
+${Object.keys(contributors)
+        .map((contributorId) => `        ${contributorId}: GlobalContributorTypeguard;`)
+        .join('\n')}
+    };
+}
+`;
+}

package/dist/eruditConfig/ads.d.ts

@@ -0,0 +1,33 @@
+type AdsProvider = 'replacer' | 'yandex' | 'custom';
+interface AdsBase {
+    provider: AdsProvider;
+}
+export interface CustomAdsItem {
+    src: string;
+    link: string;
+}
+export interface EruditAdsReplacer extends AdsBase {
+    provider: 'replacer';
+}
+export interface EruditAdsYandex extends AdsBase {
+    provider: 'yandex';
+    blockId: string;
+}
+export interface EruditAdsCustom extends AdsBase {
+    provider: 'custom';
+    banners: CustomAdsItem[];
+}
+export type EruditAds = EruditAdsReplacer | EruditAdsYandex | EruditAdsCustom;
+export type EruditAdsAsideBanner = EruditAdsReplacer | EruditAdsYandex | {
+    provider: 'custom';
+    banners: {
+        full?: CustomAdsItem[];
+        mobile?: CustomAdsItem[];
+    };
+};
+export type EruditAdsBottomBanner = EruditAdsReplacer | EruditAdsYandex | EruditAdsCustom;
+export interface EruditAdsBanners {
+    aside?: EruditAdsAsideBanner;
+    bottom?: EruditAdsBottomBanner;
+}
+export {};

package/dist/eruditConfig/ads.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/analytics.d.ts

@@ -0,0 +1,12 @@
+export type YandexAnalytics = {
+    metricsId?: string;
+    verification?: string;
+};
+export type GoogleAnalytics = {
+    gtag?: string;
+    verification?: string;
+};
+export interface EruditAnalytics {
+    google?: GoogleAnalytics;
+    yandex?: YandexAnalytics;
+}

package/dist/eruditConfig/analytics.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/config.d.ts

@@ -0,0 +1,34 @@
+import type { Nuxt } from '@nuxt/schema';
+import type { EruditIndexPage } from './indexPage.js';
+import type { EruditSponsors } from '../sponsor.js';
+import type { EruditAdsBanners } from './ads.js';
+import type { EruditAnalytics } from './analytics.js';
+import type { EruditDebug } from './debug.js';
+import type { EruditCustomLinks } from './links.js';
+import type { EruditRepository } from './repository.js';
+import type { EruditSeo } from './seo.js';
+import type { EruditSite } from './site.js';
+import type { EruditLanguage } from './language.js';
+import type { EruditElements } from './elements.js';
+import type { EruditContributors } from '../contributor.js';
+export interface EruditConfig {
+    language?: EruditLanguage;
+    debug?: EruditDebug;
+    contentTargets?: string[];
+    analytics?: EruditAnalytics;
+    ads?: EruditAdsBanners;
+    site?: EruditSite;
+    indexPage?: EruditIndexPage;
+    contributors?: EruditContributors;
+    sponsors?: EruditSponsors;
+    seo?: EruditSeo;
+    repository?: EruditRepository;
+    customLinks?: EruditCustomLinks;
+    elements?: EruditElements;
+    countElements?: (string | string[])[];
+    /**
+     * Erudit uses Nuxt under the hood.
+     * Use this to alter Nuxt configuration.
+     */
+    nuxtAugmentations?: [(nuxt: Nuxt) => Promise<void> | void];
+}

package/dist/eruditConfig/config.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/debug.d.ts

@@ -0,0 +1,9 @@
+export interface EruditDebug {
+    log?: boolean;
+    slowTransition?: boolean;
+    fakeApi?: Partial<{
+        repository: boolean;
+    }>;
+    ads?: boolean;
+    analytics?: boolean;
+}

package/dist/eruditConfig/debug.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/elements.d.ts

@@ -0,0 +1 @@
+export type EruditElements = string[];

package/dist/eruditConfig/elements.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/indexPage.d.ts

@@ -0,0 +1,14 @@
+export type EruditIndexPage = Partial<{
+    title: string;
+    short: string;
+    description: string;
+    logotype: {
+        src: string;
+        maxWidth?: string;
+        invert?: 'light' | 'dark';
+    };
+    seo?: {
+        title?: string;
+        description?: string;
+    };
+}>;

package/dist/eruditConfig/indexPage.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/language.d.ts

@@ -0,0 +1,12 @@
+export declare const eruditLanguageCodes: readonly ["en", "ru"];
+export type EruditLanguageCode = (typeof eruditLanguageCodes)[number];
+export type EruditTranslation = {
+    name: string;
+    link: string;
+};
+export type EruditTranslations = Record<EruditLanguageCode, EruditTranslation>;
+export interface EruditLanguage {
+    current: EruditLanguageCode;
+    translations?: EruditTranslations;
+    contribute?: string;
+}

package/dist/eruditConfig/language.js

@@ -0,0 +1 @@
+export const eruditLanguageCodes = ['en', 'ru'];

package/dist/eruditConfig/links.d.ts

@@ -0,0 +1,6 @@
+export interface EruditCustomLink {
+    label: string;
+    href: string;
+    icon?: string;
+}
+export type EruditCustomLinks = EruditCustomLink[] | undefined;

package/dist/eruditConfig/links.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/repository.d.ts

@@ -0,0 +1,11 @@
+export type EruditRepositoryType = 'custom' | 'github';
+export interface EruditRepositoryCustom {
+    type: 'custom';
+    link: string;
+}
+export interface EruditRepositoryGitHub {
+    type: 'github';
+    name: string;
+    branch: string;
+}
+export type EruditRepository = EruditRepositoryCustom | EruditRepositoryGitHub;

package/dist/eruditConfig/repository.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/seo.d.ts

@@ -0,0 +1,10 @@
+export type EruditSeo = Partial<{
+    siteTitle: string;
+    /** When possible, use book title instead of site title in SEO. */
+    useBookSiteTitle?: boolean;
+    image: {
+        src: string;
+        width: number;
+        height: number;
+    };
+}>;

package/dist/eruditConfig/seo.js

@@ -0,0 +1 @@
+export {};

package/dist/eruditConfig/site.d.ts

@@ -0,0 +1,34 @@
+import type { TopicPart } from '../content/topic.js';
+import type { ContentType } from '../content/type.js';
+export type EruditSiteFaviconConfig = Partial<{
+    default?: string;
+} & Exclude<Record<ContentType, string>, 'topic'> & Record<TopicPart, string>> | string;
+export type EruditSiteFaviconResolved = Partial<{
+    default: string;
+} & Exclude<Record<ContentType, string>, 'topic'> & Record<TopicPart, string>>;
+export type EruditSite = Partial<{
+    /**
+     * `https://en.erudit.io/base-url/article/my-article`
+     *
+     * Origin URL: `https://en.erudit.io/`
+     */
+    originUrl: string;
+    /**
+     * `https://en.erudit.io/base-url/article/my-article`
+     *
+     * Base URL: `/base-url/`
+     */
+    baseUrl: string;
+    title: string;
+    short: string | false;
+    /**
+     * - `string` — url to your logotype (use `projectPublic` to target path inside `public` directory)
+     * - `false` — do not show logotype
+     * - falsy (`0`, `undefined`, `null`, `""` and etc.) — use default Erudit logotype
+     */
+    logotype: string | false;
+    favicon: EruditSiteFaviconConfig;
+    style: Partial<{
+        brandColor: string;
+    }>;
+}>;

package/dist/eruditConfig/site.js

@@ -0,0 +1 @@
+export {};

package/dist/mode.d.ts

@@ -0,0 +1 @@
+export type EruditMode = 'dev' | 'build' | 'generate';

package/dist/mode.js

@@ -0,0 +1 @@
+export {};

package/dist/preview/request.d.ts

@@ -0,0 +1,31 @@
+import type { PreviewType } from './type.js';
+import type { ContentType } from '../content/type.js';
+import type { TopicPart } from '../content/topic.js';
+interface BasePreviewRequest {
+    type: PreviewType;
+}
+export interface PreviewRequestDirectLink extends BasePreviewRequest {
+    type: 'direct-link';
+    href: string;
+}
+export type PreviewRequestContentPage = BasePreviewRequest & {
+    type: 'content-page';
+    fullId: string;
+} & ({
+    contentType: 'topic';
+    topicPart: TopicPart;
+} | {
+    contentType: Exclude<ContentType, 'topic'>;
+});
+export type PreviewRequestUnique = BasePreviewRequest & {
+    type: 'unique';
+    contentFullId: string;
+    uniqueName: string;
+} & ({
+    contentType: 'topic';
+    topicPart: TopicPart;
+} | {
+    contentType: Exclude<ContentType, 'topic'>;
+});
+export type PreviewRequest = PreviewRequestDirectLink | PreviewRequestContentPage | PreviewRequestUnique;
+export {};

package/dist/preview/request.js

@@ -0,0 +1 @@
+export {};

package/dist/preview/type.d.ts

@@ -0,0 +1 @@
+export type PreviewType = 'direct-link' | 'content-page' | 'unique';

package/dist/preview/type.js

@@ -0,0 +1 @@
+export {};

package/dist/prose/documentId.d.ts

@@ -0,0 +1,14 @@
+import type { TopicPart } from '../content/topic.js';
+export interface ContentPageDocumentId {
+    type: 'contentPage';
+    contentId: string;
+}
+export interface ContentTopicDocumentId {
+    type: 'contentTopic';
+    contentId: string;
+    topicPart: TopicPart;
+}
+export type DocumentId = ContentPageDocumentId | ContentTopicDocumentId;
+export declare function stringifyDocumentId(documentId: DocumentId): string;
+export declare function parseDocumentId(strDocumentId: string): DocumentId;
+export declare function pathToDocumentId(path: string, projectPath: string): DocumentId | undefined;

package/dist/prose/documentId.js

@@ -0,0 +1,61 @@
+import { contentPathToId } from '../content/path.js';
+export function stringifyDocumentId(documentId) {
+    switch (documentId.type) {
+        case 'contentPage':
+            return `contentPage/${documentId.contentId}`;
+        case 'contentTopic':
+            return `contentTopic/${documentId.topicPart}/${documentId.contentId}`;
+    }
+}
+export function parseDocumentId(strDocumentId) {
+    const parts = strDocumentId.split('/');
+    const type = parts.shift();
+    switch (type) {
+        case 'contentPage':
+            return {
+                type: 'contentPage',
+                contentId: parts.join('/'),
+            };
+        case 'contentTopic':
+            const topicPart = parts.shift();
+            return {
+                type: 'contentTopic',
+                topicPart,
+                contentId: parts.join('/'),
+            };
+    }
+    throw new Error(`Inable to parse document ID from string: ${strDocumentId}`);
+}
+export function pathToDocumentId(path, projectPath) {
+    if (path.startsWith(`${projectPath}/content/`)) {
+        const fullContentId = contentPathToId(path, projectPath, 'full');
+        if (fullContentId) {
+            const lastPart = path.split('/').pop();
+            switch (lastPart) {
+                case 'page.tsx':
+                    return {
+                        type: 'contentPage',
+                        contentId: fullContentId,
+                    };
+                case 'article.tsx':
+                    return {
+                        type: 'contentTopic',
+                        topicPart: 'article',
+                        contentId: fullContentId,
+                    };
+                case 'summary.tsx':
+                    return {
+                        type: 'contentTopic',
+                        topicPart: 'summary',
+                        contentId: fullContentId,
+                    };
+                case 'practice.tsx':
+                    return {
+                        type: 'contentTopic',
+                        topicPart: 'practice',
+                        contentId: fullContentId,
+                    };
+            }
+        }
+    }
+}

package/dist/prose/link.d.ts

@@ -0,0 +1,22 @@
+import type { ContentPointer } from '../content/pointer.js';
+export declare const proseLinkTypes: readonly ["direct", "contentItem", "unique"];
+export type ProseLinkType = (typeof proseLinkTypes)[number];
+export declare function isProseLinkType(value: unknown): value is ProseLinkType;
+interface BaseProseLink {
+    type: ProseLinkType;
+}
+export interface DirectProseLink extends BaseProseLink {
+    type: 'direct';
+    href: string;
+}
+export interface ContentItemProseLink extends BaseProseLink {
+    type: 'contentItem';
+    contentPointer: ContentPointer;
+}
+export interface UniqueProseLink extends BaseProseLink {
+    type: 'unique';
+    contentPointer: ContentPointer;
+    uniqueName: string;
+}
+export type ProseLink = DirectProseLink | ContentItemProseLink | UniqueProseLink;
+export {};

package/dist/prose/link.js

@@ -0,0 +1,10 @@
+export const proseLinkTypes = [
+    'direct',
+    'contentItem',
+    'unique',
+    // 'anonymousUnique' TODO! Passing anonymous uniques directly to the <A> tag
+];
+export function isProseLinkType(value) {
+    return (typeof value === 'string' &&
+        proseLinkTypes.includes(value));
+}

package/dist/quote.d.ts

@@ -0,0 +1,28 @@
+export type QuoteType = 'cameo' | 'sponsor';
+interface BaseQuote {
+    type: QuoteType;
+    name: string;
+    link?: string;
+}
+export interface CameoQuote extends BaseQuote {
+    type: 'cameo';
+    icon: string;
+    messages: string[];
+    avatarUrl: string;
+    color: string;
+}
+export interface SponsorQuote extends BaseQuote {
+    type: 'sponsor';
+    icon?: string;
+    messages?: string[];
+    avatarUrl?: string;
+    color?: string;
+}
+export type Quote = CameoQuote | SponsorQuote;
+export type QuoteIds = Partial<Record<QuoteType, string[]>>;
+export declare function createQuoteId(type: QuoteType, id: string): string;
+export declare function parseQuoteId(quoteId: string): {
+    type: QuoteType;
+    id: string;
+};
+export {};

package/dist/quote.js

@@ -0,0 +1,19 @@
+//
+//
+//
+export function createQuoteId(type, id) {
+    return `${type}-${id}`;
+}
+export function parseQuoteId(quoteId) {
+    const parts = quoteId.split('-');
+    const type = parts.shift();
+    const id = parts.join('-');
+    switch (type) {
+        case 'cameo':
+            return { type: 'cameo', id };
+        case 'sponsor':
+            return { type: 'sponsor', id };
+        default:
+            throw new Error(`Unknown quote type of "${quoteId}"!`);
+    }
+}

package/dist/sponsor.d.ts

@@ -0,0 +1,32 @@
+export interface EruditSponsors {
+    enabled: boolean;
+    becomeSponsorLink: string;
+    defaultSponsorMessages: string[];
+}
+export interface Sponsor {
+    sponsorId: string;
+    name?: string;
+    group?: string;
+    icon?: string;
+    avatarExtension?: string;
+    info?: string;
+    color?: string;
+    link?: string;
+    messages?: {
+        enabled: boolean;
+        list?: string[];
+    };
+}
+type SponsorOmit = 'sponsorId' | 'avatarExtension';
+export type SponsorConfig = Omit<Sponsor, SponsorOmit>;
+export declare function defineSponsor(sponsor: SponsorConfig): SponsorConfig;
+export interface PageSponsor {
+    name: string;
+    group?: string;
+    icon?: string;
+    info?: string;
+    color?: string;
+    link?: string;
+    avatarUrl?: string;
+}
+export {};

package/dist/sponsor.js

@@ -0,0 +1,3 @@
+export function defineSponsor(sponsor) {
+    return sponsor;
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+    "name": "@erudit-js/core",
+    "version": "3.0.0-dev.25",
+    "type": "module",
+    "description": "Erudit core essentials",
+    "exports": {
+        ".": {},
+        "./*": {
+            "import": "./dist/*.js",
+            "types": "./dist/*.d.ts"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "license": "MIT",
+    "scripts": {
+        "build": "rm -rf dist && bun tsc --project ./tsconfig.src.json",
+        "test": "bun vitest run",
+        "prepack": "bun run build"
+    },
+    "dependencies": {
+        "@jsprose/core": "link:@jsprose/core",
+        "gradient-string": "^3.0.0"
+    }
+}