@forwardimpact/pathway 0.21.0 → 0.23.0

package/src/index.html

@@ -25,19 +25,38 @@
           "@forwardimpact/map/levels": "/map/lib/levels.js",
           "@forwardimpact/map/loader": "/map/lib/loader.js",
           "@forwardimpact/map/validation": "/map/lib/validation.js",
-          "@forwardimpact/libpathway": "/model/lib/index.js",
-          "@forwardimpact/libpathway/derivation": "/model/lib/derivation.js",
-          "@forwardimpact/libpathway/modifiers": "/model/lib/modifiers.js",
-          "@forwardimpact/libpathway/agent": "/model/lib/agent.js",
-          "@forwardimpact/libpathway/interview": "/model/lib/interview.js",
-          "@forwardimpact/libpathway/job": "/model/lib/job.js",
-          "@forwardimpact/libpathway/job-cache": "/model/lib/job-cache.js",
-          "@forwardimpact/libpathway/checklist": "/model/lib/checklist.js",
-          "@forwardimpact/libpathway/matching": "/model/lib/matching.js",
-          "@forwardimpact/libpathway/profile": "/model/lib/profile.js",
-          "@forwardimpact/libpathway/progression": "/model/lib/progression.js",
-          "@forwardimpact/libpathway/policies": "/model/lib/policies/index.js",
-          "@forwardimpact/libpathway/toolkit": "/model/lib/toolkit.js"
+          "@forwardimpact/libskill": "/model/lib/index.js",
+          "@forwardimpact/libskill/derivation": "/model/lib/derivation.js",
+          "@forwardimpact/libskill/modifiers": "/model/lib/modifiers.js",
+          "@forwardimpact/libskill/agent": "/model/lib/agent.js",
+          "@forwardimpact/libskill/interview": "/model/lib/interview.js",
+          "@forwardimpact/libskill/job": "/model/lib/job.js",
+          "@forwardimpact/libskill/job-cache": "/model/lib/job-cache.js",
+          "@forwardimpact/libskill/checklist": "/model/lib/checklist.js",
+          "@forwardimpact/libskill/matching": "/model/lib/matching.js",
+          "@forwardimpact/libskill/profile": "/model/lib/profile.js",
+          "@forwardimpact/libskill/progression": "/model/lib/progression.js",
+          "@forwardimpact/libskill/policies": "/model/lib/policies/index.js",
+          "@forwardimpact/libskill/toolkit": "/model/lib/toolkit.js",
+          "@forwardimpact/libui": "/ui/lib/index.js",
+          "@forwardimpact/libui/render": "/ui/lib/render.js",
+          "@forwardimpact/libui/reactive": "/ui/lib/reactive.js",
+          "@forwardimpact/libui/state": "/ui/lib/state.js",
+          "@forwardimpact/libui/errors": "/ui/lib/errors.js",
+          "@forwardimpact/libui/error-boundary": "/ui/lib/error-boundary.js",
+          "@forwardimpact/libui/router-core": "/ui/lib/router-core.js",
+          "@forwardimpact/libui/router-pages": "/ui/lib/router-pages.js",
+          "@forwardimpact/libui/router-slides": "/ui/lib/router-slides.js",
+          "@forwardimpact/libui/yaml-loader": "/ui/lib/yaml-loader.js",
+          "@forwardimpact/libui/markdown": "/ui/lib/markdown.js",
+          "@forwardimpact/libui/utils": "/ui/lib/utils.js",
+          "@forwardimpact/libui/components": "/ui/lib/components/index.js",
+          "@forwardimpact/libui/components/card": "/ui/lib/components/card.js",
+          "@forwardimpact/libui/components/grid": "/ui/lib/components/grid.js",
+          "@forwardimpact/libui/components/list": "/ui/lib/components/list.js",
+          "@forwardimpact/libui/components/detail": "/ui/lib/components/detail.js",
+          "@forwardimpact/libui/components/nav": "/ui/lib/components/nav.js",
+          "@forwardimpact/libui/components/error-page": "/ui/lib/components/error-page.js"
         }
       }
     </script>
@@ -83,7 +102,7 @@
           <div class="drawer-section">
             <span class="drawer-section-label">Browse</span>
             <a href="#/discipline">Disciplines</a>
-            <a href="#/grade">Grades</a>
+            <a href="#/level">Levels</a>
             <a href="#/track">Tracks</a>
             <a href="#/behaviour">Behaviours</a>
             <a href="#/skill">Skills</a>

package/src/lib/card-mappers.js

@@ -109,31 +109,31 @@ export function driverToCardConfig(driver) {
 }
 
 /**
- * Map grade to card config (for timeline)
- * @param {Object} grade
+ * Map level to card config (for timeline)
+ * @param {Object} level
  * @returns {Object}
  */
-export function gradeToCardConfig(grade) {
+export function levelToCardConfig(level) {
   return {
-    title: grade.displayName,
-    description: grade.scope || grade.truncatedDescription,
-    href: `/grade/${grade.id}`,
-    badges: [createBadge(grade.id, "default")],
+    title: level.displayName,
+    description: level.scope || level.truncatedDescription,
+    href: `/level/${level.id}`,
+    badges: [createBadge(level.id, "default")],
     meta: [
       createBadge(
-        `Primary: ${formatLevel(grade.baseSkillLevels?.primary)}`,
+        `Primary: ${formatLevel(level.baseSkillProficiencies?.primary)}`,
         "primary",
       ),
       createBadge(
-        `Secondary: ${formatLevel(grade.baseSkillLevels?.secondary)}`,
+        `Secondary: ${formatLevel(level.baseSkillProficiencies?.secondary)}`,
         "secondary",
       ),
       createBadge(
-        `Broad: ${formatLevel(grade.baseSkillLevels?.broad)}`,
+        `Broad: ${formatLevel(level.baseSkillProficiencies?.broad)}`,
         "broad",
       ),
     ],
-    yearsExperience: grade.yearsExperience,
+    yearsExperience: level.yearsExperience,
   };
 }
 
@@ -158,15 +158,15 @@ export function trackToCardConfig(track) {
  */
 export function jobToCardConfig(job) {
   const href = job.track
-    ? `/job/${job.discipline.id}/${job.grade.id}/${job.track.id}`
-    : `/job/${job.discipline.id}/${job.grade.id}`;
+    ? `/job/${job.discipline.id}/${job.level.id}/${job.track.id}`
+    : `/job/${job.discipline.id}/${job.level.id}`;
   return {
     title: job.title,
     description: job.track
-      ? `${job.discipline.specialization || job.discipline.name} at ${job.grade.professionalTitle} level on ${job.track.name} track`
-      : `${job.discipline.specialization || job.discipline.name} at ${job.grade.professionalTitle} level`,
+      ? `${job.discipline.specialization || job.discipline.name} at ${job.level.professionalTitle} level on ${job.track.name} track`
+      : `${job.discipline.specialization || job.discipline.name} at ${job.level.professionalTitle} level`,
     href,
-    badges: [createBadge(job.grade.id, "default")],
+    badges: [createBadge(job.level.id, "default")],
     meta: job.track ? [createBadge(job.track.name, "secondary")] : [],
   };
 }

package/src/lib/cli-command.js

@@ -21,7 +21,7 @@ const ROUTE_COMMANDS = [
     toCommand: () => "npx fit-pathway discipline",
   },
   { pattern: /^\/track$/, toCommand: () => "npx fit-pathway track" },
-  { pattern: /^\/grade$/, toCommand: () => "npx fit-pathway grade" },
+  { pattern: /^\/level$/, toCommand: () => "npx fit-pathway level" },
   { pattern: /^\/driver$/, toCommand: () => "npx fit-pathway driver" },
   { pattern: /^\/stage$/, toCommand: () => "npx fit-pathway stage" },
   { pattern: /^\/tool$/, toCommand: () => "npx fit-pathway tool" },
@@ -44,8 +44,8 @@ const ROUTE_COMMANDS = [
     toCommand: (m) => `npx fit-pathway track ${m[1]}`,
   },
   {
-    pattern: /^\/grade\/(.+)$/,
-    toCommand: (m) => `npx fit-pathway grade ${m[1]}`,
+    pattern: /^\/level\/(.+)$/,
+    toCommand: (m) => `npx fit-pathway level ${m[1]}`,
   },
   {
     pattern: /^\/driver\/(.+)$/,

package/src/lib/cli-output.js

@@ -126,11 +126,11 @@ export function formatTable(headers, rows, options = {}) {
 }
 
 /**
- * Format skill level with color
+ * Format skill proficiency with color
  * @param {string} level
  * @returns {string}
  */
-export function formatSkillLevel(level) {
+export function formatSkillProficiency(level) {
   const levelColors = {
     awareness: colors.gray,
     foundational: colors.blue,

package/src/lib/error-boundary.js

@@ -1,70 +1,7 @@
 /**
  * Error boundary wrapper for page rendering
+ *
+ * Re-exports from @forwardimpact/libui/error-boundary.
  */
 
-import { renderNotFound, renderError } from "../components/error-page.js";
-import { NotFoundError, InvalidCombinationError } from "./errors.js";
-
-/**
- * @typedef {Object} ErrorBoundaryOptions
- * @property {(error: Error) => void} [onError] - Error callback for logging
- * @property {string} [backPath] - Default back path
- * @property {string} [backText] - Default back text
- * @property {(title: string, message: string) => void} [renderErrorFn] - Custom error renderer
- */
-
-/**
- * Wrap a render function with error handling
- * @param {Function} renderFn - Page render function
- * @param {ErrorBoundaryOptions} [options]
- * @returns {Function}
- */
-export function withErrorBoundary(renderFn, options = {}) {
-  const errorRenderer =
-    options.renderErrorFn ||
-    ((title, message) => {
-      renderError({
-        title,
-        message,
-        backPath: options.backPath || "/",
-        backText: options.backText || "← Back to Home",
-      });
-    });
-
-  return (...args) => {
-    try {
-      return renderFn(...args);
-    } catch (error) {
-      console.error("Page render error:", error);
-
-      options.onError?.(error);
-
-      if (error instanceof NotFoundError) {
-        if (options.renderErrorFn) {
-          errorRenderer(
-            `${error.entityType} Not Found`,
-            `No ${error.entityType.toLowerCase()} found with ID: ${error.entityId}`,
-          );
-        } else {
-          renderNotFound({
-            entityType: error.entityType,
-            entityId: error.entityId,
-            backPath: error.backPath,
-            backText: `← Back to ${error.entityType}s`,
-          });
-        }
-        return;
-      }
-
-      if (error instanceof InvalidCombinationError) {
-        errorRenderer("Invalid Combination", error.message);
-        return;
-      }
-
-      errorRenderer(
-        "Something Went Wrong",
-        error.message || "An unexpected error occurred.",
-      );
-    }
-  };
-}
+export { withErrorBoundary } from "@forwardimpact/libui/error-boundary";

package/src/lib/errors.js

@@ -1,49 +1,11 @@
 /**
  * Custom error types for the application
+ *
+ * Re-exports from @forwardimpact/libui/errors.
  */
 
-/**
- * Entity not found error
- */
-export class NotFoundError extends Error {
-  /**
-   * @param {string} entityType - Type of entity (e.g., 'Skill', 'Behaviour')
-   * @param {string} entityId - ID that was not found
-   * @param {string} backPath - Path to navigate back to
-   */
-  constructor(entityType, entityId, backPath) {
-    super(`${entityType} not found: ${entityId}`);
-    this.name = "NotFoundError";
-    this.entityType = entityType;
-    this.entityId = entityId;
-    this.backPath = backPath;
-  }
-}
-
-/**
- * Invalid combination error (e.g., invalid job configuration)
- */
-export class InvalidCombinationError extends Error {
-  /**
-   * @param {string} message - Error message
-   * @param {string} backPath - Path to navigate back to
-   */
-  constructor(message, backPath) {
-    super(message);
-    this.name = "InvalidCombinationError";
-    this.backPath = backPath;
-  }
-}
-
-/**
- * Data loading error
- */
-export class DataLoadError extends Error {
-  /**
-   * @param {string} message - Error message
-   */
-  constructor(message) {
-    super(message);
-    this.name = "DataLoadError";
-  }
-}
+export {
+  NotFoundError,
+  InvalidCombinationError,
+  DataLoadError,
+} from "@forwardimpact/libui/errors";

package/src/lib/job-cache.js

@@ -5,7 +5,7 @@
  * Provides consistent key generation and get-or-create pattern.
  */
 
-import { deriveJob } from "@forwardimpact/libpathway/derivation";
+import { deriveJob } from "@forwardimpact/libskill/derivation";
 
 /** @type {Map<string, Object>} */
 const cache = new Map();
@@ -13,22 +13,22 @@ const cache = new Map();
 /**
  * Build a consistent cache key from job parameters
  * @param {string} disciplineId
- * @param {string} gradeId
+ * @param {string} levelId
  * @param {string} [trackId] - Optional track ID
  * @returns {string}
  */
-export function buildJobKey(disciplineId, gradeId, trackId = null) {
+export function buildJobKey(disciplineId, levelId, trackId = null) {
   if (trackId) {
-    return `${disciplineId}_${gradeId}_${trackId}`;
+    return `${disciplineId}_${levelId}_${trackId}`;
   }
-  return `${disciplineId}_${gradeId}`;
+  return `${disciplineId}_${levelId}`;
 }
 
 /**
  * Get or create a cached job definition
  * @param {Object} params
  * @param {Object} params.discipline
- * @param {Object} params.grade
+ * @param {Object} params.level
  * @param {Object} [params.track] - Optional track
  * @param {Array} params.skills
  * @param {Array} params.behaviours
@@ -37,18 +37,18 @@ export function buildJobKey(disciplineId, gradeId, trackId = null) {
  */
 export function getOrCreateJob({
   discipline,
-  grade,
+  level,
   track = null,
   skills,
   behaviours,
   capabilities,
 }) {
-  const key = buildJobKey(discipline.id, grade.id, track?.id);
+  const key = buildJobKey(discipline.id, level.id, track?.id);
 
   if (!cache.has(key)) {
     const job = deriveJob({
       discipline,
-      grade,
+      level,
       track,
       skills,
       behaviours,
@@ -73,11 +73,11 @@ export function clearCache() {
 /**
  * Invalidate a specific job from the cache
  * @param {string} disciplineId
- * @param {string} gradeId
+ * @param {string} levelId
  * @param {string} [trackId] - Optional track ID
  */
-export function invalidateCachedJob(disciplineId, gradeId, trackId = null) {
-  cache.delete(buildJobKey(disciplineId, gradeId, trackId));
+export function invalidateCachedJob(disciplineId, levelId, trackId = null) {
+  cache.delete(buildJobKey(disciplineId, levelId, trackId));
 }
 
 /**

package/src/lib/markdown.js

@@ -1,114 +1,7 @@
 /**
  * Simple Markdown to HTML converter
  *
- * Converts common markdown syntax to HTML. Designed for job descriptions
- * with headings, lists, bold text, and paragraphs.
+ * Re-exports from @forwardimpact/libui/markdown.
  */
 
-/**
- * Convert markdown text to HTML
- * @param {string} markdown - The markdown text to convert
- * @returns {string} HTML string
- */
-export function markdownToHtml(markdown) {
-  const lines = markdown.split("\n");
-  const htmlLines = [];
-  let inList = false;
-
-  for (let i = 0; i < lines.length; i++) {
-    let line = lines[i];
-
-    // Skip empty lines but close list if open
-    if (line.trim() === "") {
-      if (inList) {
-        htmlLines.push("</ul>");
-        inList = false;
-      }
-      continue;
-    }
-
-    // H1 heading
-    if (line.startsWith("# ")) {
-      if (inList) {
-        htmlLines.push("</ul>");
-        inList = false;
-      }
-      htmlLines.push(`<h1>${escapeHtml(line.slice(2))}</h1>`);
-      continue;
-    }
-
-    // H2 heading
-    if (line.startsWith("## ")) {
-      if (inList) {
-        htmlLines.push("</ul>");
-        inList = false;
-      }
-      htmlLines.push(`<h2>${escapeHtml(line.slice(3))}</h2>`);
-      continue;
-    }
-
-    // H3 heading
-    if (line.startsWith("### ")) {
-      if (inList) {
-        htmlLines.push("</ul>");
-        inList = false;
-      }
-      htmlLines.push(`<h3>${escapeHtml(line.slice(4))}</h3>`);
-      continue;
-    }
-
-    // List item
-    if (line.startsWith("- ")) {
-      if (!inList) {
-        htmlLines.push("<ul>");
-        inList = true;
-      }
-      const content = formatInlineMarkdown(line.slice(2));
-      htmlLines.push(`<li>${content}</li>`);
-      continue;
-    }
-
-    // Regular paragraph
-    if (inList) {
-      htmlLines.push("</ul>");
-      inList = false;
-    }
-    htmlLines.push(`<p>${formatInlineMarkdown(line)}</p>`);
-  }
-
-  // Close any open list
-  if (inList) {
-    htmlLines.push("</ul>");
-  }
-
-  return htmlLines.join("\n");
-}
-
-/**
- * Escape HTML special characters
- * @param {string} text - Text to escape
- * @returns {string} Escaped text
- */
-function escapeHtml(text) {
-  return text
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&#039;");
-}
-
-/**
- * Format inline markdown (bold text)
- * @param {string} text - Text to format
- * @returns {string} HTML formatted text
- */
-function formatInlineMarkdown(text) {
-  // First escape HTML
-  let result = escapeHtml(text);
-
-  // Convert **bold** to <strong>bold</strong>
-  result = result.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
-
-  return result;
-}
+export { markdownToHtml } from "@forwardimpact/libui/markdown";

package/src/lib/reactive.js

@@ -1,77 +1,11 @@
 /**
  * Reactive state utilities for local component state
+ *
+ * Re-exports from @forwardimpact/libui/reactive.
  */
 
-/**
- * @template T
- * @typedef {Object} Reactive
- * @property {() => T} get - Get current value
- * @property {(value: T) => void} set - Set new value
- * @property {(fn: (prev: T) => T) => void} update - Update value with function
- * @property {(fn: (value: T) => void) => () => void} subscribe - Subscribe to changes
- */
-
-/**
- * Create a reactive state container
- * @template T
- * @param {T} initial - Initial value
- * @returns {Reactive<T>}
- */
-export function createReactive(initial) {
-  let state = initial;
-  const subscribers = new Set();
-
-  return {
-    get: () => state,
-
-    set: (next) => {
-      state = next;
-      subscribers.forEach((fn) => fn(state));
-    },
-
-    update: (fn) => {
-      state = fn(state);
-      subscribers.forEach((sub) => sub(state));
-    },
-
-    subscribe: (fn) => {
-      subscribers.add(fn);
-      return () => subscribers.delete(fn);
-    },
-  };
-}
-
-/**
- * Create a computed value that updates when dependencies change
- * @template T
- * @param {() => T} compute - Computation function
- * @param {Reactive<*>[]} deps - Dependencies
- * @returns {Reactive<T>}
- */
-export function createComputed(compute, deps) {
-  const computed = createReactive(compute());
-
-  deps.forEach((dep) => {
-    dep.subscribe(() => {
-      computed.set(compute());
-    });
-  });
-
-  return computed;
-}
-
-/**
- * Bind a reactive value to an element attribute
- * @template T
- * @param {Reactive<T>} reactive - Reactive state
- * @param {HTMLElement} element - Element to bind
- * @param {string} attribute - Attribute name
- * @param {(value: T) => *} [transform] - Transform function
- */
-export function bind(reactive, element, attribute, transform = (v) => v) {
-  const update = (value) => {
-    element[attribute] = transform(value);
-  };
-  update(reactive.get());
-  reactive.subscribe(update);
-}
+export {
+  createReactive,
+  createComputed,
+  bind,
+} from "@forwardimpact/libui/reactive";