patram 0.1.1 → 0.3.0

package/lib/load-patram-config.types.ts

@@ -1,5 +1,5 @@
 import type {
-  KindDefinition,
+  ClassDefinition,
   MappingDefinition,
   RelationDefinition,
 } from './patram-config.types.ts';
@@ -8,10 +8,136 @@ export interface StoredQueryConfig {
   where: string;
 }
 
+export type FieldValueTypeName =
+  | 'string'
+  | 'integer'
+  | 'enum'
+  | 'path'
+  | 'glob'
+  | 'date'
+  | 'date_time';
+
+export interface FieldDisplayConfig {
+  hidden?: boolean;
+  order?: number;
+}
+
+export interface FieldQueryConfig {
+  contains?: boolean;
+  prefix?: boolean;
+}
+
+export interface StringFieldConfig {
+  display?: FieldDisplayConfig;
+  multiple?: boolean;
+  query?: FieldQueryConfig;
+  type: 'string';
+}
+
+export interface IntegerFieldConfig {
+  display?: FieldDisplayConfig;
+  multiple?: boolean;
+  type: 'integer';
+}
+
+export interface EnumFieldConfig {
+  display?: FieldDisplayConfig;
+  multiple?: boolean;
+  type: 'enum';
+  values: string[];
+}
+
+export interface PathFieldConfig {
+  display?: FieldDisplayConfig;
+  multiple?: boolean;
+  path_class?: string;
+  type: 'path';
+}
+
+export interface GlobFieldConfig {
+  display?: FieldDisplayConfig;
+  multiple?: boolean;
+  type: 'glob';
+}
+
+export interface DateFieldConfig {
+  display?: FieldDisplayConfig;
+  multiple?: boolean;
+  type: 'date';
+}
+
+export interface DateTimeFieldConfig {
+  display?: FieldDisplayConfig;
+  multiple?: boolean;
+  type: 'date_time';
+}
+
+export type MetadataFieldConfig =
+  | DateFieldConfig
+  | DateTimeFieldConfig
+  | EnumFieldConfig
+  | GlobFieldConfig
+  | IntegerFieldConfig
+  | PathFieldConfig
+  | StringFieldConfig;
+
+export interface ClassFieldRuleConfig {
+  presence: 'required' | 'optional' | 'forbidden';
+}
+
+export type DirectiveTypeConfig = MetadataFieldConfig;
+export type MetadataDirectiveRuleConfig = ClassFieldRuleConfig;
+
+export interface ClassSchemaConfig {
+  document_path_class?: string;
+  fields: Record<string, ClassFieldRuleConfig>;
+  unknown_fields?: 'ignore' | 'error';
+}
+
+export type MetadataSchemaConfig = ClassSchemaConfig;
+
+export interface PathClassConfig {
+  prefixes: string[];
+}
+
+export type DerivedSummaryScalar = boolean | number | string | null;
+
+export interface DerivedSummaryCountFieldConfig {
+  count: {
+    traversal: string;
+    where: string;
+  };
+  name: string;
+}
+
+export interface DerivedSummarySelectCaseConfig {
+  value: DerivedSummaryScalar;
+  when: string;
+}
+
+export interface DerivedSummarySelectFieldConfig {
+  default: DerivedSummaryScalar;
+  name: string;
+  select: DerivedSummarySelectCaseConfig[];
+}
+
+export type DerivedSummaryFieldConfig =
+  | DerivedSummaryCountFieldConfig
+  | DerivedSummarySelectFieldConfig;
+
+export interface DerivedSummaryConfig {
+  classes: string[];
+  fields: DerivedSummaryFieldConfig[];
+}
+
 export interface PatramRepoConfig {
+  class_schemas?: Record<string, ClassSchemaConfig>;
+  classes?: Record<string, ClassDefinition>;
+  derived_summaries?: Record<string, DerivedSummaryConfig>;
+  fields?: Record<string, MetadataFieldConfig>;
   include: string[];
-  kinds?: Record<string, KindDefinition>;
   mappings?: Record<string, MappingDefinition>;
+  path_classes?: Record<string, PathClassConfig>;
   queries: Record<string, StoredQueryConfig>;
   relations?: Record<string, RelationDefinition>;
 }

package/lib/load-project-graph.js

@@ -36,13 +36,14 @@ import { resolvePatramGraphConfig } from './resolve-patram-graph-config.js';
  * project directory.
  *
  * @param {string} project_directory
- * @returns {Promise<{ config: PatramRepoConfig, diagnostics: PatramDiagnostic[], graph: BuildGraphResult, source_file_paths: string[] }>}
+ * @returns {Promise<{ claims: PatramClaim[], config: PatramRepoConfig, diagnostics: PatramDiagnostic[], graph: BuildGraphResult, source_file_paths: string[] }>}
  */
 export async function loadProjectGraph(project_directory) {
   const load_result = await loadPatramConfig(project_directory);
 
   if (load_result.diagnostics.length > 0) {
     return {
+      claims: [],
       config: {
         include: [],
         queries: {},
@@ -74,6 +75,7 @@ export async function loadProjectGraph(project_directory) {
 
   if (collect_result.diagnostics.length > 0) {
     return {
+      claims: collect_result.claims,
       config: repo_config,
       diagnostics: collect_result.diagnostics,
       graph: {
@@ -85,6 +87,7 @@ export async function loadProjectGraph(project_directory) {
   }
 
   return {
+    claims: collect_result.claims,
     config: repo_config,
     diagnostics: [],
     graph: buildGraph(graph_config, collect_result.claims),

package/lib/output-view.types.ts

@@ -1,5 +1,22 @@
 import type { GraphNode } from './build-graph.types.ts';
 
+export type OutputDerivedValue = boolean | number | string | null;
+
+export interface OutputDerivedField {
+  name: string;
+  value: OutputDerivedValue;
+}
+
+export interface OutputDerivedSummary {
+  fields: OutputDerivedField[];
+  name: string;
+}
+
+export interface OutputMetadataField {
+  name: string;
+  value: string | string[];
+}
+
 export interface OutputViewSummary {
   count: number;
   kind: 'resolved_link_list' | 'result_list' | 'stored_query_list';
@@ -13,12 +30,14 @@ export interface QueryOutputViewSummary extends OutputViewSummary {
 }
 
 export interface OutputNodeItem {
+  derived_summary?: OutputDerivedSummary;
+  fields: Record<string, string | string[]>;
   id: string;
   kind: 'node';
-  node_kind: GraphNode['kind'];
-  path: string;
-  status?: string;
+  node_kind: string;
+  path?: string;
   title: string;
+  visible_fields: OutputMetadataField[];
 }
 
 export interface OutputStoredQueryItem {
@@ -28,10 +47,13 @@ export interface OutputStoredQueryItem {
 }
 
 export interface OutputResolvedLinkTarget {
-  kind?: string;
-  path: string;
-  status?: string;
+  derived_summary?: OutputDerivedSummary;
+  fields: Record<string, string | string[]>;
+  id: string;
+  kind: string;
+  path?: string;
   title: string;
+  visible_fields: OutputMetadataField[];
 }
 
 export interface OutputResolvedLinkItem {
@@ -57,6 +79,7 @@ export interface QueriesOutputView {
 
 export interface ShowOutputView {
   command: 'show';
+  document?: OutputNodeItem;
   hints: string[];
   items: OutputResolvedLinkItem[];
   path: string;