@nesso-how/types 0.1.0-alpha.26 → 0.1.0-alpha.28

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export type { EdgeCategory, EdgeTypeDef, EdgeTypeName, GlyphKind } from '@nesso-how/relation-types';
+export type { EdgeCategory, EdgeTypeDef, EdgeTypeName, GlyphKind, CategoryPalette, } from '@nesso-how/relation-types';
 import type { Card } from 'ts-fsrs';
-import type { EdgeTypeName } from '@nesso-how/relation-types';
+import type { CategoryPalette, EdgeTypeName } from '@nesso-how/relation-types';
 export interface ConceptElaboration {
     definition: string;
     examples: string;
@@ -32,7 +32,6 @@ export interface NessoEdgeData extends Record<string, unknown> {
     curveFlip?: boolean;
     curveFlipPinned?: boolean;
 }
-export type CategoryPalette = 'default' | 'vivid' | 'muted' | 'monoCat';
 export type Language = 'en' | 'it';
 export interface GraphDisplaySettings {
     edgeEncoding: EdgeEncoding;
@@ -61,6 +60,8 @@ export interface NessoSettings {
     maximumInterval: number;
     inspectorExamplesOpen: boolean;
     inspectorRelationsOpen: boolean;
-    /** Desktop: custom folder for graph .json files; null = default app data graphs folder. */
-    graphWorkspacePath: string | null;
+    /** Desktop: absolute paths of folders the user has explicitly opened, most-recent first. */
+    knownProjects: string[];
+    /** Desktop: absolute path of the active project folder; null until resolved at startup. */
+    activeProjectPath: string | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nesso-how/types",
-  "version": "0.1.0-alpha.26",
+  "version": "0.1.0-alpha.28",
   "description": "Nesso shared TypeScript types — graph, node, edge, settings, FSRS",
   "license": "MIT",
   "repository": {
@@ -12,6 +12,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,14 +22,17 @@
     }
   },
   "dependencies": {
-    "ts-fsrs": "^5.3.2",
-    "@nesso-how/relation-types": "0.1.0-alpha.26"
+    "@nesso-how/relation-types": "0.1.0-alpha.28"
+  },
+  "peerDependencies": {
+    "ts-fsrs": "^5.3.2"
   },
   "devDependencies": {
+    "ts-fsrs": "^5.3.2",
     "typescript": "~5.8.3"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && tsc",
     "dev": "tsc --watch"
   }
 }

package/src/index.ts

@@ -1,127 +0,0 @@
-// SPDX-License-Identifier: MIT
-export type { EdgeCategory, EdgeTypeDef, EdgeTypeName, GlyphKind } from '@nesso-how/relation-types'
-import type { Card, State } from 'ts-fsrs'
-import type { EdgeTypeName } from '@nesso-how/relation-types'
-
-export interface ConceptElaboration {
-  definition: string
-  examples: string
-  notes: string
-  imageUrl?: string
-  imageTitle?: string
-  imageDescriptionUrl?: string
-}
-
-export interface ConceptNodeData extends Record<string, unknown> {
-  text: string
-  stability: number
-  difficulty: number
-  reps: number
-  lapses: number
-  fsrsState: number // State: 0=New 1=Learning 2=Review 3=Relearning
-  due: number // ms timestamp; 0 = due immediately (new card)
-  lastReview: number // ms timestamp; 0 = never reviewed
-  lastRating: number // 0=unrated, 1=Again 2=Hard 3=Good 4=Easy
-  elaboration?: ConceptElaboration
-}
-
-/** Fresh FSRS fields for a new or shared-import concept (no personal review history). */
-export function defaultConceptReviewFields(): Pick<
-  ConceptNodeData,
-  'stability' | 'difficulty' | 'reps' | 'lapses' | 'fsrsState' | 'due' | 'lastReview' | 'lastRating'
-> {
-  return {
-    stability: 0,
-    difficulty: 0,
-    reps: 0,
-    lapses: 0,
-    fsrsState: 0,
-    due: 0,
-    lastReview: 0,
-    lastRating: 0,
-  }
-}
-
-export function nodeToCard(data: ConceptNodeData): Card {
-  return {
-    due: new Date(data.due || Date.now()),
-    stability: data.stability,
-    difficulty: data.difficulty,
-    elapsed_days: 0,
-    scheduled_days: 0,
-    learning_steps: 0,
-    reps: data.reps,
-    lapses: data.lapses,
-    state: data.fsrsState as State,
-    last_review: data.lastReview ? new Date(data.lastReview) : undefined,
-  }
-}
-
-export type EdgeEncoding = 'full' | 'category' | 'minimal'
-export type CurveStyle = 'arc' | 'straight'
-
-export interface NessoEdgeData extends Record<string, unknown> {
-  type: EdgeTypeName
-  siblingIdx?: number
-  curveFlip?: boolean
-  curveFlipPinned?: boolean
-}
-
-export type CategoryPalette = 'default' | 'vivid' | 'muted' | 'monoCat'
-
-export type Language = 'en' | 'it'
-
-export interface GraphDisplaySettings {
-  edgeEncoding: EdgeEncoding
-  showHeatmap: boolean
-  curveStyle: CurveStyle
-  autoCurveFlip: boolean
-}
-
-export function defaultGraphDisplay(
-  settings?: Pick<NessoSettings, 'edgeEncoding' | 'showHeatmap' | 'curveStyle' | 'autoCurveFlip'>,
-): GraphDisplaySettings {
-  return {
-    edgeEncoding: settings?.edgeEncoding ?? 'full',
-    showHeatmap: settings?.showHeatmap ?? true,
-    curveStyle: settings?.curveStyle ?? 'arc',
-    autoCurveFlip: settings?.autoCurveFlip !== false,
-  }
-}
-
-export function mergeGraphDisplay(
-  stored: Partial<GraphDisplaySettings> | undefined,
-  settings: NessoSettings,
-): GraphDisplaySettings {
-  const base = defaultGraphDisplay(settings)
-  if (!stored) return base
-  return {
-    edgeEncoding: stored.edgeEncoding ?? base.edgeEncoding,
-    showHeatmap: stored.showHeatmap ?? base.showHeatmap,
-    curveStyle: stored.curveStyle ?? base.curveStyle,
-    autoCurveFlip: stored.autoCurveFlip !== undefined ? stored.autoCurveFlip : base.autoCurveFlip,
-  }
-}
-
-export interface NessoSettings {
-  dark: boolean
-  accent: string
-  language: Language
-  edgeEncoding: EdgeEncoding
-  showLabels: boolean
-  showConfidence: boolean
-  showHeatmap: boolean
-  curveStyle: CurveStyle
-  autoCurveFlip: boolean
-  categoryPalette: CategoryPalette
-  aiMode: 'remote' | 'local'
-  aiBaseUrl: string
-  aiModel: string
-  aiApiKey: string
-  fsrsRetention: number
-  maximumInterval: number
-  inspectorExamplesOpen: boolean
-  inspectorRelationsOpen: boolean
-  /** Desktop: custom folder for graph .json files; null = default app data graphs folder. */
-  graphWorkspacePath: string | null
-}

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "declaration": true,
-    "skipLibCheck": true
-  },
-  "include": ["src"]
-}