erudit 2.0.0-dev.7

package/app/styles/_utils.scss

@@ -0,0 +1,44 @@
+@mixin transition($properties...) {
+    transition: all var(--transitionSpeed) var(--transitionFunction);
+    transition-property: $properties;
+}
+
+@mixin dark {
+    :root[data-theme='dark'] & {
+        @content;
+    }
+}
+
+@mixin hoverLink {
+    cursor: pointer;
+    color: inherit;
+    text-decoration: underline;
+    text-decoration-color: transparent;
+    @include transition(text-decoration-color);
+
+    &:hover {
+        text-decoration: underline;
+    }
+}
+
+@mixin scroll {
+    -webkit-overflow-scrolling: auto;
+
+    &::-webkit-scrollbar {
+        -webkit-appearance: none;
+        height: 5px;
+        width: 5px;
+    }
+
+    &::-webkit-scrollbar-thumb {
+        background: var(--scrollbar);
+
+        &:hover {
+            background: color-mix(in srgb, var(--scrollbar), var(--invert) 15%);
+        }
+    }
+
+    &::-webkit-scrollbar-corner {
+        background: var(--border);
+    }
+}

package/app/styles/app.scss

@@ -0,0 +1,91 @@
+@use '$/def/size';
+
+//
+// Vars
+//
+
+:root {
+    --transitionSpeed: 200ms;
+    --transitionFunction: cubic-bezier(0, 0, 0.5, 1);
+    interpolate-size: allow-keywords;
+}
+
+// Sizes
+
+:root {
+    --wAside: #{size.$wAside};
+    --wMainMin: #{size.$wMainMin};
+    --wMainMax: #{size.$wMainMax};
+
+    --gap: #{size.$gap};
+    --gapSmall: #{size.$gapSmall};
+    --gapBig: #{size.$gapBig};
+}
+
+// Colors
+
+:root {
+    --bg: light-dark(#ebebeb, #141414);
+    --bgAside: light-dark(#f7f7f7, #1b1b1b);
+    --bgMain: light-dark(#ffffff, #212121);
+    --bgAccent: light-dark(#e6e6e6, #262626);
+
+    --border: light-dark(#d7d7d7, #373737);
+
+    --text: light-dark(#373737, #b9b9b9);
+    --textDeep: light-dark(#232323, #e1e1e1);
+    --textMuted: light-dark(#696969, #7f7f7f);
+    --textDimmed: light-dark(#969696, #616161);
+    --textDisabled: light-dark(#b9b9b9, #4f4f4f);
+
+    --brand: light-dark(#1879d9, #4e94d9);
+    --error: light-dark(#d91818, #d94e4e);
+    --warn: light-dark(#d98718, #d9b44e);
+    --success: light-dark(#12a512, #51a551);
+
+    --scrollbar: light-dark(#bfbfbf, #494949);
+
+    --invert: light-dark(black, white);
+}
+
+//
+// General rules
+//
+
+// Noto Sans + Noto Serif
+@import url('https://fonts.googleapis.com/css2?family=Noto+Sans:ital,wght@0,100..900;1,100..900&family=Noto+Serif:ital,wght@0,100..900;1,100..900&display=swap');
+
+body {
+    background: var(--bg);
+    font-family: 'Noto Sans', system-ui, sans-serif;
+    color: var(--text);
+}
+
+button {
+    all: unset;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+strong {
+    color: var(--textDeep);
+}
+
+:focus-visible {
+    outline: 2px solid var(--brand);
+    border-radius: 3px;
+}
+
+::selection {
+    background: color-mix(in srgb, var(--brand), transparent 65%);
+}
+
+.icon-flip-h {
+    [my-icon] svg {
+        transform: scaleX(-1);
+    }
+}

package/app/styles/def/_bp.scss

@@ -0,0 +1,24 @@
+@use 'sass:map';
+
+@use '$/def/size';
+
+$bps: (
+    'mobile': 500px,
+    'aside1': size.$wMainMin + size.$wAside,
+    'aside2': size.$wMainMin + size.$wAside * 2,
+);
+
+@mixin above($bp)
+{
+    @media (min-width: map.get($bps, $bp)) { @content; }
+}
+
+@mixin below($bp)
+{
+    @media (max-width: (map.get($bps, $bp) - 1)) { @content; }
+}
+
+@mixin between($bp1, $bp2)
+{
+    @media (min-width: map.get($bps, $bp1)) and (max-width: (map.get($bps, $bp2) - 1)) { @content; }
+}

package/app/styles/def/_size.scss

@@ -0,0 +1,7 @@
+$wMainMin: 800px;
+$wMainMax: 1024px;
+$wAside: 300px;
+
+$gap: 15px;
+$gapSmall: calc($gap / 2);
+$gapBig: calc($gap * 2);

package/app/styles/def/_z.scss

@@ -0,0 +1,5 @@
+$bg: 10;
+$main: 20;
+$asideSwitch: 30;
+$preview: 40;
+$aside: 50;

package/app/styles/default.scss

@@ -0,0 +1,85 @@
+@use '$/def/size';
+
+//
+// Vars
+//
+
+:root
+{
+    --transitionSpeed: 200ms;
+    --transitionFunction: cubic-bezier(0, 0, .5, 1);
+    interpolate-size: allow-keywords;
+}
+
+// Sizes
+
+:root
+{
+    --wAside: #{size.$wAside};
+    --wMainMin: #{size.$wMainMin};
+    --wMainMax: #{size.$wMainMax};
+
+    --gap: #{size.$gap};
+    --gapSmall : #{size.$gapSmall};
+    --gapBig : #{size.$gapBig};
+}
+
+// Colors
+
+:root
+{
+    --bg:           light-dark(#ebebeb, #141414);
+    --bgAside:      light-dark(#f7f7f7, #1b1b1b);
+    --bgMain:       light-dark(#ffffff, #212121);
+    --bgAccent:     light-dark(#e6e6e6, #262626);
+
+    --border:       light-dark(#D7D7D7, #373737);
+
+    --text:         light-dark(#373737, #b9b9b9);
+    --textDeep:     light-dark(#232323, #e1e1e1);
+    --textMuted:    light-dark(#696969, #7f7f7f);
+    --textDimmed:   light-dark(#969696, #616161);
+    --textDisabled: light-dark(#b9b9b9, #4f4f4f);
+
+    --brand:        light-dark(#1879d9, #4e94d9);
+    --error:        light-dark(#d91818, #d94e4e);
+    --warn:         light-dark(#d98718, #d9b44e);
+    --success:      light-dark(#12a512, #51a551);
+
+    --scrollbar:    light-dark(#bfbfbf, #494949);
+
+    --invert:       light-dark(black, white);
+}
+
+//
+// General rules
+//
+
+// Noto Sans + Noto Serif
+@import url('https://fonts.googleapis.com/css2?family=Noto+Sans:ital,wght@0,100..900;1,100..900&family=Noto+Serif:ital,wght@0,100..900;1,100..900&display=swap');
+
+body
+{
+    background: var(--bg);
+    font-family: 'Noto Sans', system-ui, sans-serif;
+    color: var(--text);
+}
+
+h1, h2, h3, h4, h5, h6, strong
+{
+    color: var(--textDeep);
+}
+
+::selection
+{
+    //color: var(--text);
+    background: color-mix(in srgb, var(--brand), transparent 65%);
+}
+
+.icon-flip-h
+{
+    [my-icon] svg
+    {
+        transform: scaleX(-1);
+    }
+}

package/app/styles/normalize.scss

@@ -0,0 +1,63 @@
+// https://www.joshwcomeau.com/css/custom-css-reset/
+
+/* 1. Use a more-intuitive box-sizing model */
+*,
+*::before,
+*::after {
+    box-sizing: border-box;
+}
+
+/* 2. Remove default margin */
+* {
+    margin: 0;
+}
+
+body {
+    /* 3. Add accessible line-height */
+    line-height: 1.5;
+    /* 4. Improve text rendering */
+    -webkit-font-smoothing: antialiased;
+}
+
+/* 5. Improve media defaults */
+img,
+picture,
+video,
+canvas,
+svg {
+    display: block;
+    max-width: 100%;
+}
+
+/* 6. Inherit fonts for form controls */
+input,
+button,
+textarea,
+select {
+    font: inherit;
+}
+
+/* 7. Avoid text overflows */
+p,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    overflow-wrap: break-word;
+}
+
+/* 8. Improve line wrapping */
+p {
+    text-wrap: pretty;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    text-wrap: balance;
+}

package/app/styles/partials/_darkMagic.scss

@@ -0,0 +1,7 @@
+@mixin replacer
+{
+    > div > div
+    {
+        @content;
+    }
+}

package/app/styles/partials/_fnav.scss

@@ -0,0 +1,18 @@
+.frontNavSeparator
+{
+    --_space: calc(var(--gap) / 2);
+}
+
+.frontNavItem + .frontNavSeparator
+{
+    border-top: 1px solid var(--border);
+    margin-top: var(--_space);
+    padding-top: var(--_space);
+}
+
+.frontNavSeparator:has(+ .frontNavItem:not(.frontNavSeparator))
+{
+    border-bottom: 1px solid var(--border);
+    padding-bottom: var(--_space);
+    margin-bottom: var(--_space);
+}

package/app/styles/partials/_preview.scss

@@ -0,0 +1,7 @@
+@mixin hasTheme
+{
+    [data-erudit-preview-theme] &
+    {
+        @content;
+    }
+}

package/globalPath.ts

@@ -0,0 +1,24 @@
+import { fileURLToPath } from 'node:url';
+import { resolvePaths } from 'erudit-cog/kit';
+
+export const ERUDIT_DIR = resolvePaths(fileURLToPath(import.meta.url), '..');
+export const PROJECT_DIR = process.env.ERUDIT_PROJECT_DIR as string;
+
+console.log('ERUDIT_DIR: ', ERUDIT_DIR);
+
+export function eruditPath(path?: string) {
+    console.log('Erudit Path: ', path ? `${ERUDIT_DIR}/${path}` : ERUDIT_DIR);
+    return path ? `${ERUDIT_DIR}/${path}` : ERUDIT_DIR;
+}
+
+export function projectPath(path?: string) {
+    return path ? `${PROJECT_DIR}/${path}` : PROJECT_DIR;
+}
+
+export function eruditBuildPath(path?: string) {
+    return projectPath('.erudit' + (path ? '/' + path : ''));
+}
+
+export function eruditEndNuxtPath(path?: string) {
+    return eruditBuildPath('nuxt' + (path ? '/' + path : ''));
+}

package/globals/bitran.ts

@@ -0,0 +1,39 @@
+import type { GenericProductCore } from 'bitran/core';
+import type { ProductRender } from 'bitran/render';
+
+export interface ConfigProduct {
+    core: () => Promise<GenericProductCore>;
+    render: () => Promise<ProductRender>;
+}
+
+export type ConfigProducts = Record<string, ConfigProduct>;
+
+export interface EruditBitranConfig<
+    TProducts extends ConfigProducts = ConfigProducts,
+> {
+    products: TProducts;
+    toc: (keyof TProducts)[];
+
+    /**
+     * TODO!
+     * Groups of products that are tracked on site, included in TOC, in search, display in front and book pages and so on.
+     *
+     * Example:
+     * tracked: {
+     *     term: {
+     *        products: ['definition', 'axiom'],
+              title: 'Термин',
+              toc: true,
+              search: false,
+              color: '#E0E0E0',
+     *     }
+     * }
+     */
+    tracked: any;
+}
+
+export function defineBitranConfig<T extends ConfigProducts>(
+    config: Partial<EruditBitranConfig<T>>,
+) {
+    return config;
+}

package/globals/content.ts

@@ -0,0 +1,22 @@
+import type {
+    BookConfig,
+    ContentReferences,
+    GroupConfig,
+    TopicConfig,
+} from 'erudit-cog/schema';
+
+export function defineBook(book: Partial<BookConfig>) {
+    return book;
+}
+
+export function defineGroup(group: Partial<GroupConfig>) {
+    return group;
+}
+
+export function defineTopic(topic: Partial<TopicConfig>) {
+    return topic;
+}
+
+export function defineContentReferences(references: ContentReferences) {
+    return references;
+}

package/globals/contributor.ts

@@ -0,0 +1,5 @@
+import type { ContributorConfig } from 'erudit-cog/schema';
+
+export function defineContributor(contributor: Partial<ContributorConfig>) {
+    return contributor;
+}

package/globals/erudit.ts

@@ -0,0 +1,5 @@
+import type { EruditConfig } from 'erudit-cog/schema';
+
+export function defineEruditConfig(eruditConfig: Partial<EruditConfig>) {
+    return eruditConfig;
+}

package/globals/register.ts

@@ -0,0 +1,18 @@
+import * as erudit from './erudit';
+import * as contributor from './contributor';
+import * as bitran from './bitran';
+import * as content from './content';
+import * as asset from '@shared/asset';
+
+export function registerGlobals() {
+    for (const [key, value] of Object.entries({
+        ...erudit,
+        ...contributor,
+        ...bitran,
+        ...content,
+        ...asset,
+    })) {
+        // @ts-ignore
+        globalThis[key] = value;
+    }
+}

package/languages/en.ts

@@ -0,0 +1,95 @@
+const english: EruditPhrases = {
+    _language_title: 'English',
+    _language_code: 'en',
+
+    site_info_title: 'Erudit',
+    site_info_slogan: 'Modern textbook',
+    seo_index_title: 'Erudit - CMS for eductional sites',
+    seo_index_description:
+        'Erudit is a CMS for creating and managing perfect educational sites, maintained by the community.',
+    seo_article_description: (contentTitle) =>
+        `Clear and interesting explanation of the topic "${contentTitle}". Illustrative examples, important properties, interesting facts, life applications, clear proofs. Here you will definitely understand the topic!`,
+    seo_summary_description: (contentTitle) =>
+        `Summary of the topic "${contentTitle}": key definitions, theorems, properties and examples of their use. All the most important things in a concise form!`,
+    seo_practice_description: (contentTitle) =>
+        `Various problems with hints and answers on the topic "${contentTitle}". Interesting conditions, hints and detailed solutions. Turn knowledge into a skill!`,
+    index: 'Index',
+    pages: 'Pages',
+    search: 'Search',
+    language: 'Language',
+    other: 'Other',
+    ads_replacer:
+        'Help us develop the project.<br><strong>Disable your ads blocker!</strong>',
+    theme: 'Theme',
+    theme_system: 'System',
+    theme_light: 'Light',
+    theme_dark: 'Dark',
+    content: 'Content',
+    generator: 'Generator',
+    main_page: 'Main page',
+    members: 'Members',
+    add_translation: 'Add translation',
+    empty_nav: 'Empty navigation',
+    flag_dev: 'Development',
+    flag_dev_description:
+        'This material is in development! It may change in the future and even contain errors!',
+    flag_advanced: 'Advanced',
+    flag_advanced_description:
+        'This material is for learners with a high level of knowledge. It contains information that is not suitable for beginners!',
+    flag_secondary: 'Additional',
+    flag_secondary_description:
+        'This is an optional material is for learners who want to dive deeper and gain additional knowledge and context.',
+    popover_dependencies: 'Dependencies',
+    popover_dependencies_description:
+        'There is no royal way into this topic! You can only figure it out if you know the following topics:',
+    to_index: 'To index',
+    about_book: 'About book',
+    close: 'Close',
+    back: 'Back',
+    goto: 'Go to',
+    error: 'Error!',
+    external_link: 'External link',
+    external_link_warn: 'You are going to visit external resource!',
+    internal_link: 'Internal link',
+    internal_link_warn: 'You are going to visit internal site page!',
+    book: 'Book',
+    group: 'Group',
+    topic: 'Topic',
+    article: 'Article',
+    summary: 'Summary',
+    practice: 'Practice',
+    contributor: 'Contributor',
+    element_id: 'Element ID',
+    preview_missing_title: 'Element not found!',
+    preview_missing_explain: `Can't find the element with specified ID in this page!<br>Perhaps the element ID is specified incorrectly or the element has been changed/deleted.`,
+    preview_missing_explain_mismatch: `Can't find the element with specified ID in this page!<br>The version of the linked page is different from the current version of the page!<br>This is most likely the cause of the error.`,
+    preview_hash_mismatch_title: 'Page version mismatch!',
+    preview_hash_mismatch_explain:
+        'The version of the page you see now is different from the version of the page the original link led to!<br>The content may be different from what you expected to see.',
+    current_page_hash: 'Current hash',
+    expected_page_hash: 'Expected hash',
+    empty_toc: 'Empty table of contents...',
+    contributors: 'Contributors',
+    no_contributors: 'No contributors...',
+    make_contribution: 'Make a contribution',
+    material_improvement: 'Material improvement',
+    how_to_improve: 'How to improve?',
+    edit_page: 'Edit page',
+    report_problem: 'Report a problem',
+    references: 'References',
+    reference_source_featured: 'Featured source',
+    references_description:
+        'List of external sources that were used in writing this material. For a deeper dive into the material, it is recommended to read them in more detail, especially the featured sources, which are marked with an asterisk:',
+};
+
+export default english;
+
+export function m(
+    number: number,
+    one: string,
+    few: string,
+    includeNumber = true,
+) {
+    const text = number === 1 ? one : few;
+    return includeNumber ? `${number} ${text}` : text;
+}

package/languages/ru.ts

@@ -0,0 +1,99 @@
+const russian: EruditPhrases = {
+    _language_title: 'Русский',
+    _language_code: 'ru',
+
+    site_info_title: 'Erudit',
+    site_info_slogan: 'Современный учебник',
+    seo_index_title: 'Erudit - CMS для образовательных сайтов',
+    seo_index_description:
+        'Erudit — CMS для создания и управления идеальными образовательными сайтами, которые поддерживаются сообществом.',
+    seo_article_description: (contentTitle) =>
+        `Понятное и интересное объяснение темы «${contentTitle}». Показательные примеры, важные свойства, интересные факты, применение в жизни, понятные доказательства. Здесь вы точно разберетесь!`,
+    seo_summary_description: (contentTitle) =>
+        `Конспект темы «${contentTitle}»: ключевые определения, теоремы, свойства и примеры их использвания. Все самое важное и в кратком виде!`,
+    seo_practice_description: (contentTitle) =>
+        `Разнообразные задачи с подсказками и ответами по теме «${contentTitle}». Интересные условия, подсказки и подробные решения. Превратите знания в навык!`,
+    index: 'Оглавление',
+    pages: 'Страницы',
+    search: 'Поиск',
+    language: 'Язык',
+    other: 'Другое',
+    ads_replacer:
+        'Помогите нам улучшать проект.<br><strong>Включите показ рекламы!</strong>',
+    theme: 'Тема',
+    theme_system: 'Системная',
+    theme_light: 'Светлая',
+    theme_dark: 'Темная',
+    content: 'Контент',
+    generator: 'Генератор',
+    main_page: 'Главная страница',
+    members: 'Участники',
+    add_translation: 'Добавить перевод',
+    empty_nav: 'Пустая навигация',
+    flag_dev: 'Разработка',
+    flag_dev_description:
+        'Этот материал в разработке! Он может измениться в будущем и даже содержать ошибки!',
+    flag_advanced: 'Профиль',
+    flag_advanced_description:
+        'Этот материал предназначен для учеников с высоким уровнем понимания предмета. Информация здесь не предназначена для новичокв!',
+    flag_secondary: 'Дополнение',
+    flag_secondary_description:
+        'Это дополнительный материал для тех, кто хочет глубже погрузиться предмет и получить дополнительные знания и контекст.',
+    popover_dependencies: 'Зависимости',
+    popover_dependencies_description:
+        'Царского пути в эту тему нет! Вы сможете разобраться только если знаете следующие темы:',
+    to_index: 'К оглавлению',
+    about_book: 'Об учебнике',
+    close: 'Закрыть',
+    back: 'Назад',
+    goto: 'Перейти',
+    error: 'Ошибка!',
+    external_link: 'Внешняя ссылка',
+    external_link_warn: 'Вы собираетесь перейти на внешний ресурс!',
+    internal_link: 'Внутренняя ссылка',
+    internal_link_warn: 'Вы собираетесь перейти на внутреннюю страницу сайта!',
+    book: 'Книга',
+    group: 'Группа',
+    topic: 'Тема',
+    article: 'Статья',
+    summary: 'Конспект',
+    practice: 'Задачи',
+    contributor: 'Автор',
+    element_id: 'ID элемента',
+    preview_missing_title: 'Элемент не найден!',
+    preview_missing_explain:
+        'Не удалось найти на этой странице элемент с указанным ID!<br>Возможно, ID элемента указан неправильно или элемент был изменен/удален.',
+    preview_missing_explain_mismatch: `Не удалось найти на этой странице элемент с указанным ID!<br>Версия страницы, на которую вела ссылка, отличается от текущей версии страницы!<br>Скорее всего, именно это и является причиной ошибки.`,
+    preview_hash_mismatch_title: 'Несовпадение версий страницы!',
+    preview_hash_mismatch_explain:
+        'Версия страницы, которую вы видите сейчас отличается от версии страницы, на которую вела исходная ссылка!<br>Содержимое может отличаться от того, что вы ожидали увидеть.',
+    current_page_hash: 'Текущий хеш',
+    expected_page_hash: 'Ожидаемый хеш',
+    empty_toc: 'Пустая таблица содержимого...',
+    contributors: 'Авторы',
+    no_contributors: 'Авторов нет...',
+    make_contribution: 'Внести свой вклад',
+    material_improvement: 'Улучшение материала',
+    how_to_improve: 'Как улучшить?',
+    edit_page: 'Редактировать страницу',
+    report_problem: 'Сообщить о проблеме',
+    references: 'Источники',
+    reference_source_featured: 'Избранный источник',
+    references_description:
+        'Список внешних источников, которые использовались при написании этого материала. Для более глубокого погружения в материал рекомендуются ознакомиться с ними подробнее, особенно с избранными источниками, которые отмечены звездочкой:',
+};
+
+export default russian;
+
+export function m(
+    number: number,
+    one: string,
+    two: string,
+    five: string,
+    includeNumber = true,
+) {
+    const text = [five, one, two, two, two, five][
+        number % 100 > 10 && number % 100 < 20 ? 0 : Math.min(number % 10, 5)
+    ];
+    return includeNumber ? `${number} ${text}` : text;
+}