@riebeckite/core 0.0.14 → 0.0.16

package/README.md

@@ -37,7 +37,7 @@ export default defineConfig({
 ```
 
 The content directory is resolved relative to the application root. See
-[Configuration](../../docs/en/reference/configuration.md) for the full field list and the
+[Configuration](../../docs/en/docs/reference/configuration.md) for the full field list and the
 `projectRoot` / `appRoot` / `configRoot` / `contentRoot` resolution rules.
 
 ## Public API
@@ -88,7 +88,8 @@ The content directory is resolved relative to the application root. See
 
 ## See also
 
-- [Framework Reference](../../docs/en/reference/README.md)
-- [Content System](../../docs/en/framework/content-system.md)
-- [Plugin System](../../docs/en/reference/plugin-api.md) / [Theme System](../../docs/en/reference/theme-api.md)
-- [Architecture](../../docs/en/framework/architecture.md)
+- [Framework Reference](../../docs/en/docs/reference/README.md)
+- [Content System](../../docs/en/docs/framework/content-system.md)
+- [Plugin System](../../docs/en/docs/reference/plugin-api.md) / [Theme System](../../docs/en/docs/reference/theme-api.md)
+- [Architecture](../../docs/en/docs/framework/architecture.md)
+

package/README_ja.md

@@ -1,12 +1,12 @@
 # @riebeckite/core
 
-Riebeckite の移植可能なフレームワーク契約です。設定、コンテンツソース、ContentManager、Markdown/HTML パイプライン、Plugin と Theme の契約、診断、可観測性を担います。
+Riebeckite の移植可能なフレームワーク本体です。設定、コンテンツソース、ContentManager、Markdown/HTML パイプライン、Plugin と Theme の拡張の約束、診断、可観測性を担います。
 
 [English](./README.md)
 
 ## 概要
 
-`@riebeckite/core` はコンテンツの読み込みと解釈、および拡張が依存する契約を所有します。HonoX や Vite、特定の Plugin・Theme・アプリケーションには依存しません。依存の向きは常に Core へ向かい、その逆には向かいません。
+`@riebeckite/core` はコンテンツの読み込みと解釈、および拡張が依存する取り決めを所有します。HonoX や Vite、特定の Plugin・Theme・アプリケーションには依存しません。依存の向きは常に Core へ向かい、その逆には向かいません。
 
 サイトは `defineConfig` で Core を設定し、[`@riebeckite/honox`](../integrations/honox/README_ja.md) のような integration がビルドを実行します。Plugin と Theme は `definePlugin`、`defineTheme` が返すただのオブジェクトです。
 
@@ -29,7 +29,7 @@ export default defineConfig({
 });
 ```
 
-コンテンツディレクトリはアプリケーションルート基準で解決します。設定項目の全体と `projectRoot` / `appRoot` / `configRoot` / `contentRoot` の解決規則は [Configuration](../../docs/ja/reference/configuration.md) を参照してください。
+コンテンツディレクトリはアプリケーションルート基準で解決します。設定項目の全体と `projectRoot` / `appRoot` / `configRoot` / `contentRoot` の解決規則は [Configuration](../../docs/ja/docs/reference/configuration.md) を参照してください。
 
 ## 公開 API
 
@@ -57,7 +57,7 @@ export default defineConfig({
 - `defineEndpoint`、`createClientEntry`、`createStyleAsset`
 - `Plugin*` のコンテキスト、アセット、エンドポイント、診断、SEO、パイプラインの型
 
-### Theme と契約
+### Theme と設定
 
 - `defineTheme` と `Theme*` の型
 - `RiebeckiteConfig`、`ResolvedRiebeckiteConfig`、`SiteConfig`、`PostContent`、`PostFrontmatter`、`PublishStrategy`
@@ -69,7 +69,8 @@ export default defineConfig({
 
 ## 関連資料
 
-- [Framework Reference](../../docs/ja/reference/README.md)
-- [Content System](../../docs/ja/framework/content-system.md)
-- [Plugin System](../../docs/ja/reference/plugin-api.md) / [Theme System](../../docs/ja/reference/theme-api.md)
-- [Architecture](../../docs/ja/framework/architecture.md)
+- [Framework Reference](../../docs/ja/docs/reference/README.md)
+- [Content System](../../docs/ja/docs/framework/content-system.md)
+- [Plugin System](../../docs/ja/docs/reference/plugin-api.md) / [Theme System](../../docs/ja/docs/reference/theme-api.md)
+- [Architecture](../../docs/ja/docs/framework/architecture.md)
+

package/dist/client.d.ts

@@ -1,2 +1,2 @@
-export type { GraphEdge, GraphLayoutNode, LinkableGraphNode, RadialGraphLayoutOptions, } from "./src/content/graph_layout.js";
-export { buildGraphEdges, layoutRadialGraph, } from "./src/content/graph_layout.js";
+export type { ForceGraphLayoutOptions, ForceLayoutGuardOptions, GraphEdge, GraphLayoutNode, LinkableGraphNode, RadialGraphLayoutOptions, } from "./src/content/graph_layout.js";
+export { buildGraphEdges, FORCE_LAYOUT_CONFIRM_NODE_COUNT, layoutForceGraph, layoutRadialGraph, shouldGuardForceLayout, } from "./src/content/graph_layout.js";

package/dist/client.js

@@ -1,4 +1,8 @@
 // src/content/graph_layout.ts
+var FORCE_LAYOUT_CONFIRM_NODE_COUNT = 500;
+function shouldGuardForceLayout(options) {
+  return options.layout === "force" && options.mode === "global" && options.nodeCount >= FORCE_LAYOUT_CONFIRM_NODE_COUNT && !options.approved;
+}
 function buildGraphEdges(nodes, visibleSlugs = new Set(nodes.map((node) => node.slug))) {
   const edges = /* @__PURE__ */ new Map();
   for (const node of nodes) {
@@ -34,10 +38,147 @@ function layoutRadialGraph(nodes, options) {
   });
   return layout;
 }
+function layoutForceGraph(nodes, options) {
+  const safeOptions = resolveForceGraphLayoutOptions(options);
+  const layoutNodes = [...nodes].sort((a, b) => a.slug.localeCompare(b.slug));
+  const layout = createInitialLayout(layoutNodes, safeOptions);
+  const visibleSlugs = new Set(layoutNodes.map((node) => node.slug));
+  const edges = buildGraphEdges(layoutNodes, visibleSlugs).filter(
+    (edge) => edge.source !== edge.target
+  );
+  const velocities = new Map(
+    layoutNodes.map((node) => [node.slug, { x: 0, y: 0 }])
+  );
+  const centerX = safeOptions.width / 2;
+  const centerY = safeOptions.height / 2;
+  for (let iteration = 0; iteration < safeOptions.iterations; iteration++) {
+    const alpha = 1 - iteration / safeOptions.iterations;
+    applyRepulsion(
+      layoutNodes,
+      layout,
+      velocities,
+      safeOptions.repulsion * alpha
+    );
+    applyLinks(edges, layout, velocities, safeOptions.linkDistance, alpha);
+    applyCentering(layoutNodes, layout, velocities, centerX, centerY, alpha);
+    integrate(
+      layoutNodes,
+      layout,
+      velocities,
+      safeOptions,
+      safeOptions.damping
+    );
+  }
+  return layout;
+}
+function resolveForceGraphLayoutOptions(options) {
+  const minNodeRadius = clampFinite(options.minNodeRadius ?? 8, 1, 64);
+  const maxNodeRadius = Math.max(
+    minNodeRadius,
+    clampFinite(options.maxNodeRadius ?? 14, minNodeRadius, 96)
+  );
+  return {
+    width: clampFinite(options.width, maxNodeRadius * 2, 2e4),
+    height: clampFinite(options.height, maxNodeRadius * 2, 2e4),
+    centerSlug: options.centerSlug,
+    linkDistance: clampFinite(options.linkDistance ?? 84, 1, 2e3),
+    repulsion: clampFinite(options.repulsion ?? 1800, 0, 1e5),
+    iterations: Math.round(clampFinite(options.iterations ?? 160, 0, 1e3)),
+    damping: clampFinite(options.damping ?? 0.82, 0, 1),
+    minNodeRadius,
+    maxNodeRadius
+  };
+}
+function createInitialLayout(nodes, options) {
+  return layoutRadialGraph(nodes, {
+    width: options.width,
+    height: options.height,
+    centerSlug: options.centerSlug ?? nodes[0]?.slug ?? "",
+    radiusRatio: 0.28,
+    minNodeRadius: options.minNodeRadius,
+    maxNodeRadius: options.maxNodeRadius
+  });
+}
+function applyRepulsion(nodes, layout, velocities, strength) {
+  for (let sourceIndex = 0; sourceIndex < nodes.length; sourceIndex++) {
+    for (let targetIndex = sourceIndex + 1; targetIndex < nodes.length; targetIndex++) {
+      const source = layout.get(nodes[sourceIndex]?.slug ?? "");
+      const target = layout.get(nodes[targetIndex]?.slug ?? "");
+      const sourceVelocity = velocities.get(nodes[sourceIndex]?.slug ?? "");
+      const targetVelocity = velocities.get(nodes[targetIndex]?.slug ?? "");
+      if (!source || !target || !sourceVelocity || !targetVelocity) continue;
+      const dx = target.x - source.x || 0.01;
+      const dy = target.y - source.y || 0.01;
+      const distanceSquared = Math.max(dx * dx + dy * dy, 64);
+      const force = strength / distanceSquared;
+      const distance = Math.sqrt(distanceSquared);
+      const fx = dx / distance * force;
+      const fy = dy / distance * force;
+      sourceVelocity.x -= fx;
+      sourceVelocity.y -= fy;
+      targetVelocity.x += fx;
+      targetVelocity.y += fy;
+    }
+  }
+}
+function applyLinks(edges, layout, velocities, linkDistance, alpha) {
+  for (const edge of edges) {
+    const source = layout.get(edge.source);
+    const target = layout.get(edge.target);
+    const sourceVelocity = velocities.get(edge.source);
+    const targetVelocity = velocities.get(edge.target);
+    if (!source || !target || !sourceVelocity || !targetVelocity) continue;
+    const dx = target.x - source.x || 0.01;
+    const dy = target.y - source.y || 0.01;
+    const distance = Math.max(Math.sqrt(dx * dx + dy * dy), 1);
+    const force = (distance - linkDistance) * 0.018 * alpha;
+    const fx = dx / distance * force;
+    const fy = dy / distance * force;
+    sourceVelocity.x += fx;
+    sourceVelocity.y += fy;
+    targetVelocity.x -= fx;
+    targetVelocity.y -= fy;
+  }
+}
+function applyCentering(nodes, layout, velocities, centerX, centerY, alpha) {
+  for (const node of nodes) {
+    const point = layout.get(node.slug);
+    const velocity = velocities.get(node.slug);
+    if (!point || !velocity) continue;
+    velocity.x += (centerX - point.x) * 4e-3 * alpha;
+    velocity.y += (centerY - point.y) * 4e-3 * alpha;
+  }
+}
+function integrate(nodes, layout, velocities, options, damping) {
+  for (const node of nodes) {
+    const point = layout.get(node.slug);
+    const velocity = velocities.get(node.slug);
+    if (!point || !velocity) continue;
+    velocity.x *= damping;
+    velocity.y *= damping;
+    point.x = clamp(
+      point.x + velocity.x,
+      point.radius,
+      options.width - point.radius
+    );
+    point.y = clamp(
+      point.y + velocity.y,
+      point.radius,
+      options.height - point.radius
+    );
+  }
+}
 function clamp(value, min, max) {
   return Math.min(Math.max(value, min), max);
 }
+function clampFinite(value, min, max) {
+  if (!Number.isFinite(value)) return min;
+  return clamp(value, min, max);
+}
 export {
+  FORCE_LAYOUT_CONFIRM_NODE_COUNT,
   buildGraphEdges,
-  layoutRadialGraph
+  layoutForceGraph,
+  layoutRadialGraph,
+  shouldGuardForceLayout
 };

package/dist/index.d.ts

@@ -19,10 +19,16 @@ export { groupContentEntries, queryContentEntries, queryContentPage, resolveCont
 export type { ContentSource, ContentSourceContent, ContentSourceEntry, ContentSourceMetadata, } from "./src/content/content_source.js";
 export { getContentSourceEntry, readContentSourceEntry, } from "./src/content/content_source.js";
 export { resolveContentStableId } from "./src/content/content_stable_id.js";
-export { FileSystemContentSource } from "./src/content/file_system_content_source.js";
-export type { GraphEdge, GraphLayoutNode, LinkableGraphNode, RadialGraphLayoutOptions, } from "./src/content/graph_layout.js";
-export { buildGraphEdges, layoutRadialGraph, } from "./src/content/graph_layout.js";
+export { FileSystemContentSource, INTERNAL_CONTENT_IGNORE_PATTERNS, isIgnoredContentPath, } from "./src/content/file_system_content_source.js";
+export type { FolderEntryCandidate, FolderEntryKind, FolderEntryResolution, FolderEntryScope, FolderLocationResolution, ResolveFolderEntryOptions, } from "./src/content/folder_entry.js";
+export { resolveFolderEntry, resolveFolderLocation, resolveGeneratedFolderLocation, resolvePublicFolderLocation, } from "./src/content/folder_entry.js";
+export type { ForceGraphLayoutOptions, GraphEdge, GraphLayoutNode, LinkableGraphNode, RadialGraphLayoutOptions, } from "./src/content/graph_layout.js";
+export { buildGraphEdges, layoutForceGraph, layoutRadialGraph, } from "./src/content/graph_layout.js";
 export { IMAGE_EXTENSIONS } from "./src/content/image_extensions.js";
+export type { OutputChangeSet, OutputDescriptor, OutputKind, } from "./src/content/output_dependency.js";
+export { buildOutputInventory, determineOutputChanges, htmlOutputPath, } from "./src/content/output_dependency.js";
+export type { PublishingResolutionOptions, PublishingVisibility, ResolvedPublishingState, } from "./src/content/publishing.js";
+export { resolvePublishingBuildTime, resolvePublishingState, } from "./src/content/publishing.js";
 export { readOnlyContentGraph } from "./src/content/read_only_content_graph.js";
 export { createDeprecationDiagnostic, type DeprecationKind, type DeprecationNotice, formatDeprecationMessage, } from "./src/deprecation.js";
 export type { LogContext, Logger, LogLevel, Observability, ObservabilityValue, TraceAttributes, TraceEvent, Tracer, TraceSink, TraceSpan, } from "./src/observability.js";
@@ -34,12 +40,14 @@ export { PluginDependencyError, type PluginDependencyErrorKind, } from "./src/pl
 export type { CreatePluginMemoOptions, PluginMemo, } from "./src/plugin/plugin_memo.js";
 export { createPluginMemo, stableStringify, } from "./src/plugin/plugin_memo.js";
 export type { ConfigValidationIssue, PluginOptionsValidator, } from "./src/types/config_validation.js";
-export type { ContentAsset, ContentBodySlot, ContentLink, ContentLinkKind, ContentLocationInput, ContentManifest, ContentManifestEntry, ContentManifestPluginClientEntry, ContentPublicLocation, ContentRedirect, } from "./src/types/content_manifest.js";
+export type { ContentAsset, ContentBodySlot, ContentLink, ContentLinkKind, ContentLocationInput, ContentManifest, ContentManifestEntry, ContentManifestPluginClientEntry, ContentPublicLocation, ContentRedirect, FolderLocation, PluginPageRoute, } from "./src/types/content_manifest.js";
 export { appendContentBodySlot } from "./src/types/content_manifest.js";
 export type { Diagnostic, DiagnosticCode, DiagnosticSeverity, } from "./src/types/diagnostic.js";
-export type { GeneratedOutput, GeneratedOutputContent, GeneratedOutputInput, GeneratedOutputSink, } from "./src/types/generated_output.js";
-export { createUnavailableGeneratedOutputSink, normalizeGeneratedOutputPath, } from "./src/types/generated_output.js";
+export type { ContentAssetOutputInput, GeneratedOutput, GeneratedOutputContent, GeneratedOutputInput, GeneratedOutputSink, } from "./src/types/generated_output.js";
+export { createUnavailableGeneratedOutputSink, normalizeContentAssetOutputPath, normalizeGeneratedOutputPath, } from "./src/types/generated_output.js";
 export type { JsonValue } from "./src/types/json_value.js";
+export type { NavigationConfig, NavigationItem, } from "./src/types/navigation_config.js";
+export type { OutputDependency } from "./src/types/output_dependency.js";
 export type { PluginInput, ResolvedPluginMetadata, RiebeckitePlugin, } from "./src/types/plugin.js";
 export { definePlugin, getResolvedPluginMetadata, resolvePlugins, } from "./src/types/plugin.js";
 export type { PluginAsset, PluginAssetKind, PluginClientEntry, } from "./src/types/plugin_asset.js";