@riebeckite/plugin-bases 0.0.26 → 0.0.28

package/dist/src/dependencies.d.ts

@@ -0,0 +1,3 @@
+import type { OutputDependency } from "@riebeckite/core";
+import type { BasesSpec } from "./types.js";
+export declare function analyzeBasesDependencies(spec: BasesSpec): OutputDependency;

package/dist/src/evaluate.d.ts

@@ -1,6 +1,10 @@
 import type { ContentManifestEntry } from "@riebeckite/core";
-import type { BasesCondition, BasesValueRef } from "./types.js";
+import type { BasesCondition, BasesExpression, BasesValueRef } from "./types.js";
+export declare class BasesEvaluationError extends Error {
+    constructor(message: string);
+}
 /** Evaluates a compiled condition against one manifest entry. */
 export declare function matchesCondition(condition: BasesCondition, entry: ContentManifestEntry): boolean;
+export declare function evaluateBasesExpression(expression: BasesExpression, entry: ContentManifestEntry, formulas?: Readonly<Record<string, BasesExpression>>, scope?: Readonly<Record<string, unknown>>, active?: ReadonlySet<string>): unknown;
 /** Reads the entry value a filter reference points at. */
 export declare function resolveValueRef(reference: BasesValueRef, entry: ContentManifestEntry): unknown;

package/dist/src/expression.d.ts

@@ -0,0 +1,9 @@
+import type { BasesExpression } from "./types.js";
+export type ExpressionResult = {
+    readonly ok: true;
+    readonly value: BasesExpression;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+export declare function parseBasesExpression(source: string): ExpressionResult;

package/dist/src/page.d.ts

@@ -0,0 +1,17 @@
+import { type ContentManifest, type ContentSource, type Diagnostic, type PluginPage } from "@riebeckite/core";
+import type { BasesOptions } from "./types.js";
+export type BaseDocument = {
+    readonly pathname: string;
+    readonly dependencies: readonly import("@riebeckite/core").OutputDependency[];
+};
+export declare function listBaseDocuments(input: {
+    readonly manifest: ContentManifest;
+    readonly contentSource?: ContentSource;
+    readonly diagnostics: Diagnostic[];
+}): Promise<readonly BaseDocument[]>;
+export declare function resolveBaseDocument(input: {
+    readonly manifest: ContentManifest;
+    readonly contentSource?: ContentSource;
+    readonly pathname: string;
+    readonly diagnostics: Diagnostic[];
+}, options: BasesOptions): Promise<PluginPage | null>;

package/dist/src/runtime.d.ts

@@ -1,7 +1,10 @@
-import type { ContentManifest, Diagnostic, ResolvedRiebeckiteConfig } from "@riebeckite/core";
+import type { ContentManifest, Diagnostic, OutputDependency, ResolvedRiebeckiteConfig } from "@riebeckite/core";
 import type { BasesOptions } from "./types.js";
 export type BasesRuntime = {
     /** Replaces every Base placeholder in the manifest with rendered output. */
     resolve(manifest: ContentManifest, diagnostics: Diagnostic[], config?: ResolvedRiebeckiteConfig): void;
+    dependenciesFor(slug: string): readonly OutputDependency[];
+    dependenciesForPage(pathname: string): readonly OutputDependency[];
+    setDocumentDependencies(dependencies: ReadonlyMap<string, readonly OutputDependency[]>): void;
 };
 export declare function createBasesRuntime(options: BasesOptions): BasesRuntime;

package/dist/src/transform.d.ts

@@ -0,0 +1,10 @@
+import type { ContentManifestEntry } from "@riebeckite/core";
+import type { BasesGroupKey, BasesSpec, BasesView } from "./types.js";
+export type BasesGroup = {
+    readonly key: BasesGroupKey;
+    readonly entries: readonly ContentManifestEntry[];
+};
+export declare function resolveBasesProperty(entry: ContentManifestEntry, property: string, spec: BasesSpec): unknown;
+export declare function sortBasesEntries(entries: readonly ContentManifestEntry[], view: BasesView, spec: BasesSpec): ContentManifestEntry[];
+export declare function groupBasesEntries(entries: readonly ContentManifestEntry[], view: BasesView, spec: BasesSpec): readonly BasesGroup[];
+export declare function summarizeBasesValues(values: readonly unknown[], name: string, spec: BasesSpec): unknown;

package/dist/src/types.d.ts

@@ -1,4 +1,3 @@
-import type { ContentQuerySort } from "@riebeckite/core";
 /** View kinds supported by the MVP renderer. */
 export type BasesViewType = "table" | "cards";
 /** Scalar literal that can appear on the right-hand side of a comparison. */
@@ -6,7 +5,47 @@ export type BasesLiteral = string | number | boolean | null;
 /** Comparison operators supported in filter expressions. */
 export type BasesOperator = "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains";
 /** Built-in `file.*` values exposed to filter expressions. */
-export type BasesBuiltinValue = "file.name" | "file.path" | "file.slug" | "file.folder" | "file.title" | "file.link" | "file.permalink" | "file.tags";
+export type BasesBuiltinValue = "file.name" | "file.path" | "file.slug" | "file.folder" | "file.title" | "file.link" | "file.permalink" | "file.tags" | "file.ext" | "file.size" | "file.mtime" | "file.ctime";
+export type BasesExpression = {
+    readonly kind: "literal";
+    readonly value: BasesLiteral;
+} | {
+    readonly kind: "reference";
+    readonly path: readonly string[];
+} | {
+    readonly kind: "array";
+    readonly values: readonly BasesExpression[];
+} | {
+    readonly kind: "unary";
+    readonly operator: "!" | "-";
+    readonly value: BasesExpression;
+} | {
+    readonly kind: "binary";
+    readonly operator: "+" | "-" | "*" | "/" | "%" | "==" | "!=" | ">" | "<" | ">=" | "<=" | "&&" | "||";
+    readonly left: BasesExpression;
+    readonly right: BasesExpression;
+} | {
+    readonly kind: "call";
+    readonly callee: BasesExpression;
+    readonly arguments: readonly BasesExpression[];
+} | {
+    readonly kind: "member";
+    readonly object: BasesExpression;
+    readonly property: string;
+} | {
+    readonly kind: "index";
+    readonly object: BasesExpression;
+    readonly index: BasesExpression;
+};
+export type BasesSort = {
+    readonly property: string;
+    readonly direction: "asc" | "desc";
+};
+export type BasesGroupBy = {
+    readonly property: string;
+    readonly direction: "asc" | "desc";
+};
+export type BasesGroupKey = string | number | boolean | Date | null;
 /** A value read either from a built-in or from frontmatter. */
 export type BasesValueRef = {
     readonly source: "builtin";
@@ -42,6 +81,9 @@ export type BasesCondition = {
     readonly left: BasesValueRef;
     readonly operator: BasesOperator;
     readonly right: BasesLiteral;
+} | {
+    readonly kind: "expression";
+    readonly expression: BasesExpression;
 };
 /** A compiled Base view. */
 export type BasesView = {
@@ -52,8 +94,14 @@ export type BasesView = {
     readonly columns: readonly string[];
     /** View-local filter, combined with the top-level filter using AND. */
     readonly filter?: BasesCondition;
-    /** Sort keys, mapped onto the Core content query sort shape. */
-    readonly sort?: readonly ContentQuerySort[];
+    /** Sort keys, including formula properties. */
+    readonly sort?: readonly BasesSort[];
+    /** The single property used by Obsidian Bases to form row groups. */
+    readonly groupBy?: BasesGroupBy;
+    /** Manual group visibility and order, when configured by Obsidian. */
+    readonly groupOrder?: readonly BasesGroupKey[];
+    /** Property id -> named top-level summary formula. */
+    readonly summaries?: Readonly<Record<string, string>>;
     /** View-local row cap. Still bounded by {@link BasesOptions.limit}. */
     readonly limit?: number;
 };
@@ -63,6 +111,9 @@ export type BasesSpec = {
     readonly filter?: BasesCondition;
     /** Property id -> display label. */
     readonly properties: Readonly<Record<string, string>>;
+    readonly formulas: Readonly<Record<string, BasesExpression>>;
+    /** Named summary expressions, evaluated with `values` in scope. */
+    readonly summaries: Readonly<Record<string, BasesExpression>>;
     readonly views: readonly BasesView[];
 };
 export type BasesOptions = {

package/dist/src/yaml.d.ts

@@ -0,0 +1,7 @@
+export declare function parseBasesYaml(source: string): {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-bases",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,7 @@
     "@types/mdast": "^4.0.4",
     "unist-util-visit": "^5.1.0",
     "vfile-matter": "^5.0.1",
-    "@riebeckite/core": "0.0.26"
+    "@riebeckite/core": "0.0.28"
   },
   "publishConfig": {
     "access": "public"

package/style.css

@@ -17,26 +17,58 @@
   color: var(--rb-bases-ink);
 }
 
-.rb-bases__view + .rb-bases__view {
+.rb-bases-page {
+  margin: 0 auto;
+  max-width: 72rem;
+  padding: 1.5rem;
+}
+
+.rb-bases-page__title {
+  margin: 0;
+}
+
+.rb-bases-page__title + .rb-bases {
   margin-top: 1.5rem;
 }
 
+.rb-bases__view + .rb-bases__view {
+  margin-top: 2rem;
+}
+
 .rb-bases__view-name {
-  margin: 0 0 0.5rem;
-  font-size: 0.9375rem;
+  margin: 0;
+  font-size: 1rem;
   font-weight: 700;
-  letter-spacing: 0.01em;
+  letter-spacing: 0;
+}
+
+.rb-bases__count {
+  margin: 0.25rem 0 0.75rem;
+  color: var(--rb-bases-muted);
+  font-size: 0.8125rem;
+}
+
+.rb-bases__table-scroll {
+  overflow-x: auto;
+  border: 1px solid var(--rb-bases-rule);
+}
+
+.rb-bases__table-scroll:focus-visible {
+  outline: 2px solid var(--rb-bases-accent);
+  outline-offset: 2px;
 }
 
 .rb-bases__table {
   width: 100%;
+  min-width: 36rem;
   border-collapse: collapse;
   font-size: 0.9375rem;
 }
 
 .rb-bases__heading {
   padding: 0.5rem 0.75rem;
-  border-bottom: 1px solid var(--rb-bases-ink);
+  border-bottom: 1px solid var(--rb-bases-rule);
+  background: var(--rb-bases-surface);
   text-align: left;
   font-weight: 700;
 }
@@ -44,12 +76,39 @@
 .rb-bases__cell {
   padding: 0.5rem 0.75rem;
   vertical-align: top;
+  overflow-wrap: anywhere;
 }
 
 .rb-bases__row:not(:last-child) .rb-bases__cell {
   border-bottom: 1px solid var(--rb-bases-rule);
 }
 
+.rb-bases__group th,
+.rb-bases__summary {
+  padding: 0.45rem 0.75rem;
+  border-top: 1px solid var(--rb-bases-rule);
+  color: var(--rb-bases-muted);
+  text-align: left;
+  font-size: 0.8125rem;
+  font-weight: 600;
+}
+
+.rb-bases__group-count {
+  color: var(--rb-bases-muted);
+  font-weight: 400;
+}
+
+.rb-bases__empty-row td {
+  padding: 0.625rem 0.75rem;
+  color: var(--rb-bases-muted);
+  font-size: 0.875rem;
+  font-style: italic;
+}
+
+.rb-bases__summary-row--overall .rb-bases__summary {
+  border-top: 1px solid var(--rb-bases-ink);
+}
+
 .rb-bases__link {
   color: inherit;
   text-decoration: underline;
@@ -78,12 +137,30 @@
   list-style: none;
 }
 
+.rb-bases__card-group + .rb-bases__card-group {
+  margin-top: 1rem;
+}
+
+.rb-bases__group-title {
+  margin: 0 0 0.5rem;
+  font-size: 0.9375rem;
+}
+
 .rb-bases__card {
   padding: 0.75rem 1rem;
   border: 1px solid var(--rb-bases-rule);
   background: var(--rb-bases-surface);
 }
 
+.rb-bases__card-empty {
+  grid-column: 1 / -1;
+  padding: 0.75rem 1rem;
+  border: 1px dashed var(--rb-bases-rule);
+  color: var(--rb-bases-muted);
+  font-size: 0.875rem;
+  font-style: italic;
+}
+
 .rb-bases__card-title {
   font-weight: 700;
 }
@@ -107,6 +184,7 @@
 
 .rb-bases__field-value {
   margin: 0;
+  overflow-wrap: anywhere;
 }
 
 .rb-bases__empty {
@@ -115,6 +193,17 @@
   font-style: italic;
 }
 
+.rb-bases__sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
 .rb-bases__fallback {
   margin-top: 1rem;
   color: var(--rb-bases-muted);