@acta-dev/web 1.0.0

package/src/locales/en/sidebar.json

@@ -0,0 +1,25 @@
+{
+  "brand": {
+    "subtitle": "ADR and Specs"
+  },
+  "nav": {
+    "documents": "Documents",
+    "graph": "Graph",
+    "validation": "Validation"
+  },
+  "theme": {
+    "legend": "Theme",
+    "system": "System",
+    "light": "Light",
+    "dark": "Dark"
+  },
+  "sidebar": {
+    "collapse": "Collapse sidebar",
+    "expand": "Expand sidebar"
+  },
+  "language": {
+    "legend": "Language",
+    "en": "English",
+    "ru": "Russian"
+  }
+}

package/src/locales/en/validation.json

@@ -0,0 +1,13 @@
+{
+  "tab": "Acta validation",
+  "meta": "Acta validation results",
+  "eyebrow": "Repository health",
+  "header": "Validation",
+  "counts": "{{errors}} errors, {{warnings}} warnings",
+  "empty": "No validation issues.",
+  "severity": {
+    "error": "error",
+    "warning": "warning",
+    "info": "info"
+  }
+}

package/src/locales/ru/common.json

@@ -0,0 +1,6 @@
+{
+  "all": "Все",
+  "none": "Нет",
+  "valid": "Без проблем",
+  "needsAttention": "Требует внимания"
+}

package/src/locales/ru/dashboard.json

@@ -0,0 +1,8 @@
+{
+  "tab": "Acta — документы",
+  "meta": "Просмотр ADR и спецификаций Acta",
+  "eyebrow": "Просмотр репозитория",
+  "header": "Документы",
+  "counts": "{{count}} документов, {{adrs}} ADR, {{specs}} спецификаций",
+  "issuesPill": "{{errors}} ошибок · {{warnings}} предупреждений"
+}

package/src/locales/ru/documents.json

@@ -0,0 +1,63 @@
+{
+  "filters": {
+    "legend": "Фильтры документов",
+    "search": "Поиск",
+    "searchPlaceholder": "Заголовок, тег, владелец, раздел...",
+    "kind": "Тип",
+    "status": "Статус",
+    "tag": "Тег",
+    "component": "Компонент",
+    "sort": "Сортировка",
+    "sortNewest": "Сначала новые",
+    "sortDependency": "По зависимостям",
+    "searchContent": "Искать в содержимом",
+    "searchingContent": "Идет поиск по содержимому..."
+  },
+  "empty": "Нет подходящих документов.",
+  "showMore": "Показать ещё",
+  "detail": {
+    "file": "Файл",
+    "owners": "Владельцы",
+    "tags": "Теги",
+    "components": "Компоненты",
+    "validation": "Валидация",
+    "links": "Ссылки",
+    "backlinks": "Обратные ссылки",
+    "externalReferences": "Внешние ссылки",
+    "noOutgoing": "Нет исходящих внутренних ссылок.",
+    "noBacklinks": "Нет обратных ссылок.",
+    "back": "К списку документов"
+  },
+  "linkTypes": {
+    "tooltipOutgoing": "Что значит \"{{key}}\"?",
+    "tooltipIncoming": "Что значит \"{{key}}\" (входящие)?",
+    "related": {
+      "outgoing": "Свободная семантическая связь — общий контекст, без зависимости.",
+      "incoming": "Другие документы, отмечающие этот как связанный контекст."
+    },
+    "supersedes": {
+      "outgoing": "Этот документ заменяет указанные.",
+      "incoming": "Документы, заменяющие этот (этот устарел)."
+    },
+    "replacedBy": {
+      "outgoing": "Указанные документы заменяют этот.",
+      "incoming": "Документы, которые заменяет этот."
+    },
+    "decidedBy": {
+      "outgoing": "Решения (ADR), определяющие этот документ.",
+      "incoming": "Документы, определяемые решением, зафиксированным здесь."
+    },
+    "dependsOn": {
+      "outgoing": "Документы, от которых зависит этот.",
+      "incoming": "Документы, зависящие от этого."
+    },
+    "validates": {
+      "outgoing": "Документы, которые проверяет этот (например, тесты/спеки подтверждают решения).",
+      "incoming": "Документы, проверяющие этот."
+    },
+    "references": {
+      "outgoing": "Внешние URL, упоминаемые в этом документе.",
+      "incoming": "Внешние ссылки, указывающие сюда."
+    }
+  }
+}

package/src/locales/ru/graph.json

@@ -0,0 +1,19 @@
+{
+  "tab": "Acta — граф",
+  "meta": "Исследуйте связи между документами Acta",
+  "eyebrow": "Просмотр репозитория",
+  "header": "Граф",
+  "counts": "{{nodes}} узлов, {{edges}} связей",
+  "filters": {
+    "legend": "Фильтры графа",
+    "kind": "Тип",
+    "status": "Статус"
+  },
+  "areaLabel": "Граф связей документов",
+  "legend": {
+    "label": "Легенда графа",
+    "dependency": "Зависимость",
+    "related": "Связано",
+    "supersession": "Замещение"
+  }
+}

package/src/locales/ru/search.json

@@ -0,0 +1,7 @@
+{
+  "tab": "Acta — поиск",
+  "meta": "Поиск по ADR и спецификациям Acta",
+  "eyebrow": "Поиск по репозиторию",
+  "header": "Поиск",
+  "counts": "{{count}} документов в индексе"
+}

package/src/locales/ru/sidebar.json

@@ -0,0 +1,25 @@
+{
+  "brand": {
+    "subtitle": "ADR и спецификации"
+  },
+  "nav": {
+    "documents": "Документы",
+    "graph": "Граф",
+    "validation": "Валидация"
+  },
+  "theme": {
+    "legend": "Тема",
+    "system": "Системная",
+    "light": "Светлая",
+    "dark": "Тёмная"
+  },
+  "sidebar": {
+    "collapse": "Свернуть боковую панель",
+    "expand": "Развернуть боковую панель"
+  },
+  "language": {
+    "legend": "Язык",
+    "en": "Английский",
+    "ru": "Русский"
+  }
+}

package/src/locales/ru/validation.json

@@ -0,0 +1,13 @@
+{
+  "tab": "Acta — валидация",
+  "meta": "Результаты валидации Acta",
+  "eyebrow": "Состояние репозитория",
+  "header": "Валидация",
+  "counts": "{{errors}} ошибок, {{warnings}} предупреждений",
+  "empty": "Проблем валидации нет.",
+  "severity": {
+    "error": "ошибка",
+    "warning": "предупреждение",
+    "info": "инфо"
+  }
+}

package/src/pages/documents/[id]/index.astro

@@ -0,0 +1,39 @@
+---
+import { renderMarkdown } from "@acta-dev/renderer";
+import BaseLayout from "../../../layouts/BaseLayout.astro";
+import DocumentView from "../../../components/DocumentView.astro";
+import { getIssuesForDocument } from "@lib/documents.js";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, isLocale, type Locale } from "@lib/i18n.js";
+
+export async function getStaticPaths() {
+  const { project, validation } = await loadActaWebData();
+
+  return Promise.all(
+    project.documents.map(async (document) => ({
+      params: { id: document.id },
+      props: {
+        document,
+        documents: project.documents,
+        issues: getIssuesForDocument(validation.issues, document),
+        rendered: await renderMarkdown(document.body),
+      },
+    })),
+  );
+}
+
+const { document, documents, issues, rendered } = Astro.props;
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+---
+
+<BaseLayout title={`${document.id} · ${document.title}`} description={document.summary}>
+  <DocumentView
+    document={document}
+    documents={documents}
+    issues={issues}
+    rendered={rendered}
+    locale={locale}
+  />
+</BaseLayout>

package/src/pages/graph.astro

@@ -0,0 +1,54 @@
+---
+import BaseLayout from "../layouts/BaseLayout.astro";
+import { buildDocumentHref, collectFilterOptions } from "@lib/documents.js";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, getT, isLocale, localizedHref, type Locale } from "@lib/i18n.js";
+import DocumentGraphIsland from "../components/graph/DocumentGraphIsland.tsx";
+
+const { project } = await loadActaWebData();
+const documents = project.documents;
+const filterOptions = collectFilterOptions(documents);
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+const t = await getT(locale);
+
+const hrefForId = Object.fromEntries(
+  documents.map((d) => [d.id, localizedHref(locale, buildDocumentHref(d.id))]),
+);
+
+const tg = (key: string, params?: Record<string, unknown>) => t(`graph:${key}`, params);
+const tc = (key: string) => t(`common:${key}`);
+
+const graphLabels = {
+  filtersLegend: tg("filters.legend"),
+  filterKind: tg("filters.kind"),
+  filterStatus: tg("filters.status"),
+  all: tc("all"),
+  areaLabel: tg("areaLabel"),
+  legendLabel: tg("legend.label"),
+  legendDependency: tg("legend.dependency"),
+  legendRelated: tg("legend.related"),
+  legendSupersession: tg("legend.supersession"),
+};
+---
+
+<BaseLayout title={tg("tab")} description={tg("meta")}>
+  <section class="page-header">
+    <div class="crumbs">
+      <span>{tg("eyebrow")}</span>
+    </div>
+    <h1>{tg("header")}<span class="accent-period">.</span></h1>
+    <p class="page-sub">
+      {tg("counts", { nodes: project.graph.nodes.length, edges: project.graph.edges.length })}
+    </p>
+  </section>
+
+  <DocumentGraphIsland
+    client:load
+    graph={project.graph}
+    filterOptions={filterOptions}
+    hrefForId={hrefForId}
+    labels={graphLabels}
+  />
+</BaseLayout>

package/src/pages/index.astro

@@ -0,0 +1,41 @@
+---
+import BaseLayout from "../layouts/BaseLayout.astro";
+import DocumentSearchList from "../components/DocumentSearchList.astro";
+import Pill from "../components/ui/Pill.astro";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, getT, isLocale, localizedHref, type Locale } from "@lib/i18n.js";
+
+const { project, validation } = await loadActaWebData();
+const documents = project.documents;
+const adrCount = documents.filter((document) => document.kind === "adr").length;
+const specCount = documents.filter((document) => document.kind === "spec").length;
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+const t = await getT(locale);
+---
+
+<BaseLayout title={t("dashboard:tab")} description={t("dashboard:meta")}>
+  <section class="page-header">
+    <div class="crumbs">
+      <span>{t("dashboard:eyebrow")}</span>
+      <span class="grow"></span>
+      <Pill
+        as="a"
+        href={localizedHref(locale, "/validation/")}
+        tone={validation.valid ? "success" : "danger"}
+      >
+        {t("dashboard:issuesPill", { errors: validation.errorCount, warnings: validation.warningCount })}
+      </Pill>
+    </div>
+    <h1>{t("dashboard:header")}<span class="accent-period">.</span></h1>
+    <p class="page-sub">
+      {t("dashboard:counts", { count: documents.length, adrs: adrCount, specs: specCount })}
+    </p>
+  </section>
+
+  <DocumentSearchList
+    documents={documents}
+    dependencyDocumentIds={project.ordering.documentIds}
+  />
+</BaseLayout>

package/src/pages/ru/documents/[id]/index.astro

@@ -0,0 +1,39 @@
+---
+import { renderMarkdown } from "@acta-dev/renderer";
+import BaseLayout from "../../../../layouts/BaseLayout.astro";
+import DocumentView from "../../../../components/DocumentView.astro";
+import { getIssuesForDocument } from "@lib/documents.js";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, isLocale, type Locale } from "@lib/i18n.js";
+
+export async function getStaticPaths() {
+  const { project, validation } = await loadActaWebData();
+
+  return Promise.all(
+    project.documents.map(async (document) => ({
+      params: { id: document.id },
+      props: {
+        document,
+        documents: project.documents,
+        issues: getIssuesForDocument(validation.issues, document),
+        rendered: await renderMarkdown(document.body),
+      },
+    })),
+  );
+}
+
+const { document, documents, issues, rendered } = Astro.props;
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+---
+
+<BaseLayout title={`${document.id} · ${document.title}`} description={document.summary}>
+  <DocumentView
+    document={document}
+    documents={documents}
+    issues={issues}
+    rendered={rendered}
+    locale={locale}
+  />
+</BaseLayout>

package/src/pages/ru/graph.astro

@@ -0,0 +1,54 @@
+---
+import BaseLayout from "../../layouts/BaseLayout.astro";
+import { buildDocumentHref, collectFilterOptions } from "@lib/documents.js";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, getT, isLocale, localizedHref, type Locale } from "@lib/i18n.js";
+import DocumentGraphIsland from "../../components/graph/DocumentGraphIsland.tsx";
+
+const { project } = await loadActaWebData();
+const documents = project.documents;
+const filterOptions = collectFilterOptions(documents);
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+const t = await getT(locale);
+
+const hrefForId = Object.fromEntries(
+  documents.map((d) => [d.id, localizedHref(locale, buildDocumentHref(d.id))]),
+);
+
+const tg = (key: string, params?: Record<string, unknown>) => t(`graph:${key}`, params);
+const tc = (key: string) => t(`common:${key}`);
+
+const graphLabels = {
+  filtersLegend: tg("filters.legend"),
+  filterKind: tg("filters.kind"),
+  filterStatus: tg("filters.status"),
+  all: tc("all"),
+  areaLabel: tg("areaLabel"),
+  legendLabel: tg("legend.label"),
+  legendDependency: tg("legend.dependency"),
+  legendRelated: tg("legend.related"),
+  legendSupersession: tg("legend.supersession"),
+};
+---
+
+<BaseLayout title={tg("tab")} description={tg("meta")}>
+  <section class="page-header">
+    <div class="crumbs">
+      <span>{tg("eyebrow")}</span>
+    </div>
+    <h1>{tg("header")}<span class="accent-period">.</span></h1>
+    <p class="page-sub">
+      {tg("counts", { nodes: project.graph.nodes.length, edges: project.graph.edges.length })}
+    </p>
+  </section>
+
+  <DocumentGraphIsland
+    client:load
+    graph={project.graph}
+    filterOptions={filterOptions}
+    hrefForId={hrefForId}
+    labels={graphLabels}
+  />
+</BaseLayout>

package/src/pages/ru/index.astro

@@ -0,0 +1,41 @@
+---
+import BaseLayout from "../../layouts/BaseLayout.astro";
+import DocumentSearchList from "../../components/DocumentSearchList.astro";
+import Pill from "../../components/ui/Pill.astro";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, getT, isLocale, localizedHref, type Locale } from "@lib/i18n.js";
+
+const { project, validation } = await loadActaWebData();
+const documents = project.documents;
+const adrCount = documents.filter((document) => document.kind === "adr").length;
+const specCount = documents.filter((document) => document.kind === "spec").length;
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+const t = await getT(locale);
+---
+
+<BaseLayout title={t("dashboard:tab")} description={t("dashboard:meta")}>
+  <section class="page-header">
+    <div class="crumbs">
+      <span>{t("dashboard:eyebrow")}</span>
+      <span class="grow"></span>
+      <Pill
+        as="a"
+        href={localizedHref(locale, "/validation/")}
+        tone={validation.valid ? "success" : "danger"}
+      >
+        {t("dashboard:issuesPill", { errors: validation.errorCount, warnings: validation.warningCount })}
+      </Pill>
+    </div>
+    <h1>{t("dashboard:header")}<span class="accent-period">.</span></h1>
+    <p class="page-sub">
+      {t("dashboard:counts", { count: documents.length, adrs: adrCount, specs: specCount })}
+    </p>
+  </section>
+
+  <DocumentSearchList
+    documents={documents}
+    dependencyDocumentIds={project.ordering.documentIds}
+  />
+</BaseLayout>

package/src/pages/ru/search-index-full.json.ts

@@ -0,0 +1 @@
+export { GET } from "../search-index-full.json";

package/src/pages/ru/search.astro

@@ -0,0 +1,27 @@
+---
+import DocumentSearchList from "../../components/DocumentSearchList.astro";
+import BaseLayout from "../../layouts/BaseLayout.astro";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, getT, isLocale, type Locale } from "@lib/i18n.js";
+
+const { project } = await loadActaWebData();
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+const t = await getT(locale);
+---
+
+<BaseLayout title={t("search:tab")} description={t("search:meta")}>
+  <section class="page-header">
+    <div>
+      <p class="eyebrow">{t("search:eyebrow")}</p>
+      <h1>{t("search:header")}</h1>
+      <p class="muted">{t("search:counts", { count: project.documents.length })}</p>
+    </div>
+  </section>
+
+  <DocumentSearchList
+    documents={project.documents}
+    dependencyDocumentIds={project.ordering.documentIds}
+  />
+</BaseLayout>

package/src/pages/ru/validation.astro

@@ -0,0 +1,63 @@
+---
+import BaseLayout from "../../layouts/BaseLayout.astro";
+import Pill from "../../components/ui/Pill.astro";
+import { buildDocumentHref } from "@lib/documents.js";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, getT, isLocale, localizedHref, type Locale } from "@lib/i18n.js";
+
+const { project, validation } = await loadActaWebData();
+const documentsById = new Map(project.documents.map((document) => [document.id, document]));
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+const t = await getT(locale);
+const severityLabel = (sev: string) => t(`validation:severity.${sev}`);
+---
+
+<BaseLayout title={t("validation:tab")} description={t("validation:meta")}>
+  <section class="page-header">
+    <div class="crumbs">
+      <span>{t("validation:eyebrow")}</span>
+      <span class="grow"></span>
+      <Pill
+        as="a"
+        href={localizedHref(locale, "/validation/")}
+        tone={validation.valid ? "success" : "danger"}
+      >
+        {validation.valid ? t("common:valid") : t("common:needsAttention")}
+      </Pill>
+    </div>
+    <h1>{t("validation:header")}<span class="accent-period">.</span></h1>
+    <p class="page-sub">
+      {t("validation:counts", { errors: validation.errorCount, warnings: validation.warningCount })}
+    </p>
+  </section>
+
+  {
+    validation.issues.length === 0 ? (
+      <p class="empty-state">{t("validation:empty")}</p>
+    ) : (
+      <section class="issue-list">
+        {validation.issues.map((issue) => {
+          const document = issue.documentId ? documentsById.get(issue.documentId) : undefined;
+          return (
+            <article class={`issue severity-${issue.severity}`}>
+              <div>
+                <strong>{severityLabel(issue.severity)}</strong>
+                <span>{issue.ruleId}</span>
+              </div>
+              <p>{issue.message}</p>
+              {document ? (
+                <a href={localizedHref(locale, buildDocumentHref(document.id))}>
+                  {document.id} · {document.title}
+                </a>
+              ) : (
+                issue.path && <span class="muted">{issue.path}</span>
+              )}
+            </article>
+          );
+        })}
+      </section>
+    )
+  }
+</BaseLayout>

package/src/pages/search-index-full.json.ts

@@ -0,0 +1,12 @@
+import { buildFullSearchIndex } from "@acta-dev/core";
+import { loadActaWebData } from "@lib/project.js";
+
+export async function GET() {
+  const { project } = await loadActaWebData();
+
+  return new Response(JSON.stringify(buildFullSearchIndex(project.documents)), {
+    headers: {
+      "content-type": "application/json; charset=utf-8",
+    },
+  });
+}

package/src/pages/search-index.json.ts

@@ -0,0 +1,12 @@
+import { buildSearchIndex } from "@acta-dev/core";
+import { loadActaWebData } from "@lib/project.js";
+
+export async function GET() {
+  const { project } = await loadActaWebData();
+
+  return new Response(JSON.stringify(buildSearchIndex(project.documents)), {
+    headers: {
+      "content-type": "application/json; charset=utf-8",
+    },
+  });
+}

package/src/pages/search.astro

@@ -0,0 +1,27 @@
+---
+import DocumentSearchList from "../components/DocumentSearchList.astro";
+import BaseLayout from "../layouts/BaseLayout.astro";
+import { loadActaWebData } from "@lib/project.js";
+import { defaultLocale, getT, isLocale, type Locale } from "@lib/i18n.js";
+
+const { project } = await loadActaWebData();
+
+const rawLocale = Astro.currentLocale ?? defaultLocale;
+const locale: Locale = isLocale(rawLocale) ? rawLocale : defaultLocale;
+const t = await getT(locale);
+---
+
+<BaseLayout title={t("search:tab")} description={t("search:meta")}>
+  <section class="page-header">
+    <div>
+      <p class="eyebrow">{t("search:eyebrow")}</p>
+      <h1>{t("search:header")}</h1>
+      <p class="muted">{t("search:counts", { count: project.documents.length })}</p>
+    </div>
+  </section>
+
+  <DocumentSearchList
+    documents={project.documents}
+    dependencyDocumentIds={project.ordering.documentIds}
+  />
+</BaseLayout>