@forwardimpact/pathway 0.22.0 → 0.23.0

package/src/lib/state.js

@@ -1,15 +1,13 @@
 /**
  * Application state management
+ *
+ * Uses generic store from @forwardimpact/libui/state
+ * with Pathway-specific state shape and accessors.
  */
 
-/**
- * @typedef {Object} AppState
- * @property {Object} data - Loaded data from YAML files
- * @property {Object} ui - UI state
- */
+import { createStore } from "@forwardimpact/libui/state";
 
-/** @type {AppState} */
-const state = {
+const store = createStore({
   data: {
     skills: [],
     behaviours: [],
@@ -35,48 +33,18 @@ const state = {
       drivers: { search: "" },
     },
   },
-};
-
-/** @type {Set<Function>} */
-const listeners = new Set();
-
-/**
- * Get the current state
- * @returns {AppState}
- */
-export function getState() {
-  return state;
-}
-
-/**
- * Get a specific path from state
- * @param {string} path - Dot-notation path (e.g., 'data.skills')
- * @returns {*}
- */
-export function getStatePath(path) {
-  return path.split(".").reduce((obj, key) => obj?.[key], state);
-}
+});
 
-/**
- * Update state at a specific path
- * @param {string} path - Dot-notation path
- * @param {*} value - New value
- */
-export function updateState(path, value) {
-  const keys = path.split(".");
-  const lastKey = keys.pop();
-  const target = keys.reduce((obj, key) => obj[key], state);
-  target[lastKey] = value;
-  notifyListeners();
-}
+export const { getState, getStatePath, updateState, subscribe } = store;
 
 /**
  * Merge data into state
  * @param {Object} data - Data to merge
  */
 export function setData(data) {
+  const state = getState();
   Object.assign(state.data, data, { loaded: true, error: null });
-  notifyListeners();
+  updateState("data", state.data);
 }
 
 /**
@@ -84,25 +52,7 @@ export function setData(data) {
  * @param {Error} error
  */
 export function setError(error) {
-  state.data.error = error.message;
-  notifyListeners();
-}
-
-/**
- * Subscribe to state changes
- * @param {Function} listener
- * @returns {Function} Unsubscribe function
- */
-export function subscribe(listener) {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-}
-
-/**
- * Notify all listeners of state change
- */
-function notifyListeners() {
-  listeners.forEach((listener) => listener(state));
+  updateState("data.error", error.message);
 }
 
 /**
@@ -112,9 +62,10 @@ function notifyListeners() {
  * @param {*} value - Filter value
  */
 export function setFilter(entity, filterKey, value) {
+  const state = getState();
   if (state.ui.filters[entity]) {
     state.ui.filters[entity][filterKey] = value;
-    notifyListeners();
+    updateState("ui.filters", state.ui.filters);
   }
 }
 
@@ -124,7 +75,7 @@ export function setFilter(entity, filterKey, value) {
  * @returns {Object}
  */
 export function getFilters(entity) {
-  return state.ui.filters[entity] || {};
+  return getState().ui.filters[entity] || {};
 }
 
 /**
@@ -140,7 +91,7 @@ export function getFilters(entity) {
  * @returns {Branding}
  */
 export function getBranding() {
-  const { framework } = state.data;
+  const { framework } = getState().data;
   return {
     title: framework.title || "Engineering Pathway",
     tag: framework.tag || "#BenchTools",

package/src/lib/utils.js

@@ -1,14 +1,7 @@
 /**
  * General utility functions
+ *
+ * Re-exports from @forwardimpact/libui/utils.
  */
 
-/**
- * Get an array of items by their IDs
- * @param {Array} items - Array of items with id property
- * @param {string[]} ids - Array of IDs to find
- * @returns {Array} - Found items, filtered to remove nulls
- */
-export function getItemsByIds(items, ids) {
-  if (!ids) return [];
-  return ids.map((id) => items.find((item) => item.id === id)).filter(Boolean);
-}
+export { getItemsByIds } from "@forwardimpact/libui/utils";

package/src/lib/yaml-loader.js

@@ -1,56 +1,21 @@
 /**
  * Browser-compatible YAML loading
  *
- * Uses _index.yaml files to discover files in directory structures.
- * These index files are auto-generated by the CLI (npx pathway --generate-index).
+ * Generic utilities from @forwardimpact/libui/yaml-loader,
+ * plus Pathway-specific entity loaders.
  */
 
-import { parse as parseYaml } from "https://cdn.jsdelivr.net/npm/yaml@2.3.4/+esm";
+export {
+  loadYamlFile,
+  tryLoadYamlFile,
+  loadDirIndex,
+} from "@forwardimpact/libui/yaml-loader";
 
-/**
- * Load and parse a YAML file
- * @param {string} path - Path to the YAML file
- * @returns {Promise<*>}
- */
-export async function loadYamlFile(path) {
-  const response = await fetch(path);
-  if (!response.ok) {
-    throw new Error(
-      `Failed to load ${path}: ${response.status} ${response.statusText}`,
-    );
-  }
-  const text = await response.text();
-  return parseYaml(text);
-}
-
-/**
- * Try to load a YAML file, return null if not found
- * @param {string} path - Path to the YAML file
- * @returns {Promise<*|null>}
- */
-async function tryLoadYamlFile(path) {
-  const response = await fetch(path);
-  if (response.status === 404) {
-    return null;
-  }
-  if (!response.ok) {
-    throw new Error(
-      `Failed to load ${path}: ${response.status} ${response.statusText}`,
-    );
-  }
-  const text = await response.text();
-  return parseYaml(text);
-}
-
-/**
- * Load directory index (list of file IDs)
- * @param {string} dir - Directory path
- * @returns {Promise<string[]>} Array of file IDs
- */
-async function loadDirIndex(dir) {
-  const index = await loadYamlFile(`${dir}/_index.yaml`);
-  return index.files || [];
-}
+import {
+  loadYamlFile,
+  tryLoadYamlFile,
+  loadDirIndex,
+} from "@forwardimpact/libui/yaml-loader";
 
 /**
  * Load skills from capability files
@@ -115,23 +80,18 @@ async function loadDisciplinesFromDir(disciplinesDir) {
   const disciplines = await Promise.all(
     disciplineIds.map(async (id) => {
       const content = await loadYamlFile(`${disciplinesDir}/${id}.yaml`);
-      // Shared content at top level, role summaries under human:
       const {
         specialization,
         roleTitle,
-        // Track constraints
         isProfessional,
         isManagement,
         validTracks,
         minLevel,
-        // Shared content - now at root level
         description,
-        // Structural properties (derivation inputs)
         coreSkills,
         supportingSkills,
         broadSkills,
         behaviourModifiers,
-        // Presentation sections
         human,
         agent,
       } = content;
@@ -139,19 +99,15 @@ async function loadDisciplinesFromDir(disciplinesDir) {
         id,
         specialization,
         roleTitle,
-        // Track constraints
         isProfessional,
         isManagement,
         validTracks,
         minLevel,
-        // Shared content at top level
         description,
-        // Structural properties
         coreSkills,
         supportingSkills,
         broadSkills,
         behaviourModifiers,
-        // Human presentation content (role summaries only)
         ...human,
         ...(agent && { agent }),
       };
@@ -171,27 +127,21 @@ async function loadTracksFromDir(tracksDir) {
   const tracks = await Promise.all(
     trackIds.map(async (id) => {
       const content = await loadYamlFile(`${tracksDir}/${id}.yaml`);
-      // Shared content at top level (no human section for tracks anymore)
       const {
         name,
-        // Shared content - now at root level
         description,
         roleContext,
-        // Structural properties (derivation inputs)
         skillModifiers,
         behaviourModifiers,
         matchingWeights,
         minLevel,
-        // Agent section (no human section anymore for tracks)
         agent,
       } = content;
       return {
         id,
         name,
-        // Shared content at top level
         description,
         roleContext,
-        // Structural properties
         skillModifiers,
         behaviourModifiers,
         matchingWeights,
@@ -214,7 +164,6 @@ async function loadBehavioursFromDir(behavioursDir) {
   const behaviours = await Promise.all(
     behaviourIds.map(async (id) => {
       const content = await loadYamlFile(`${behavioursDir}/${id}.yaml`);
-      // Flatten human properties to top level (behaviours use human: section in YAML)
       const { name, human, agent } = content;
       return {
         id,
@@ -297,13 +246,9 @@ async function loadQuestionFolder(
  * @returns {Promise<Object>}
  */
 export async function loadAllData(dataDir = "./data") {
-  // Load capabilities first (skills are embedded in capabilities)
   const capabilities = await loadCapabilitiesFromDir(`${dataDir}/capabilities`);
-
-  // Extract skills from capabilities
   const skills = await loadSkillsFromCapabilities(`${dataDir}/capabilities`);
 
-  // Load remaining core data in parallel (using _index.yaml for discovery)
   const [drivers, behaviours, disciplines, tracks, levels, stages, framework] =
     await Promise.all([
       loadYamlFile(`${dataDir}/drivers.yaml`),
@@ -315,7 +260,6 @@ export async function loadAllData(dataDir = "./data") {
       loadYamlFile(`${dataDir}/framework.yaml`),
     ]);
 
-  // Load questions using skill/behaviour/capability IDs
   const questions = await loadQuestionFolder(
     `${dataDir}/questions`,
     skills,
@@ -339,9 +283,8 @@ export async function loadAllData(dataDir = "./data") {
 
 /**
  * Load agent-specific data for browser-based agent generation
- * Uses co-located files where agent sections are embedded in entity files
  * @param {string} [dataDir='./data'] - Path to data directory
- * @returns {Promise<Object>} Agent data including disciplines, tracks, behaviours, vscodeSettings, devcontainer, copilotSetupSteps
+ * @returns {Promise<Object>}
  */
 export async function loadAgentDataBrowser(dataDir = "./data") {
   const [
@@ -360,7 +303,6 @@ export async function loadAgentDataBrowser(dataDir = "./data") {
     tryLoadYamlFile(`${dataDir}/copilot-setup-steps.yaml`),
   ]);
 
-  // Extract agent sections from co-located files
   return {
     disciplines: disciplines
       .filter((d) => d.agent)

package/src/pages/agent-builder.js

@@ -29,7 +29,7 @@ import {
   deriveReferenceLevel,
   deriveToolkit,
   buildAgentIndex,
-} from "@forwardimpact/libpathway";
+} from "@forwardimpact/libskill";
 import {
   createSelectWithValue,
   createDisciplineSelect,

package/src/pages/assessment-results.js

@@ -19,7 +19,7 @@ import { getState } from "../lib/state.js";
 import { createBadge } from "../components/card.js";
 import { formatLevel } from "../lib/render.js";
 import { getAssessmentState, resetAssessment } from "./self-assessment.js";
-import { findRealisticMatches } from "@forwardimpact/libpathway/matching";
+import { findRealisticMatches } from "@forwardimpact/libskill/matching";
 
 /**
  * Render the assessment results page

package/src/pages/job-builder.js

@@ -5,7 +5,7 @@
 import { render } from "../lib/render.js";
 import { getState } from "../lib/state.js";
 import { createBuilder, createStandardPreview } from "../components/builder.js";
-import { prepareJobBuilderPreview } from "@forwardimpact/libpathway/job";
+import { prepareJobBuilderPreview } from "@forwardimpact/libskill/job";
 
 /**
  * Render job builder page

package/src/pages/job.js

@@ -5,7 +5,7 @@
 import { render, div, p } from "../lib/render.js";
 import { getState } from "../lib/state.js";
 import { renderError } from "../components/error-page.js";
-import { prepareJobDetail } from "@forwardimpact/libpathway/job";
+import { prepareJobDetail } from "@forwardimpact/libskill/job";
 import { jobToDOM } from "../formatters/job/dom.js";
 
 /** @type {string|null} Cached job template */

package/src/pages/skill.js

@@ -11,7 +11,7 @@ import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { skillToDOM } from "../formatters/skill/dom.js";
 import { skillToCardConfig } from "../lib/card-mappers.js";
 import { getCapabilityEmoji, getConceptEmoji } from "@forwardimpact/map/levels";
-import { generateSkillMarkdown } from "@forwardimpact/libpathway";
+import { generateSkillMarkdown } from "@forwardimpact/libskill";
 import { formatAgentSkill } from "../formatters/agent/skill.js";
 
 /** @type {string|null} Cached skill template */

package/src/slide-main.js

@@ -8,7 +8,7 @@ import { createSlideRouter } from "./lib/router-slides.js";
 import { setData, getState } from "./lib/state.js";
 import { loadAllData } from "./lib/yaml-loader.js";
 import { span, a } from "./lib/render.js";
-import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
+import { generateAllJobs } from "@forwardimpact/libskill/derivation";
 import { sortTracksByName } from "./formatters/track/shared.js";
 
 // Import slide renderers

package/src/slides/index.js

@@ -6,7 +6,7 @@
 
 import { div, heading1, heading2, p, a, ul, li, span } from "../lib/render.js";
 import { getConceptEmoji } from "@forwardimpact/map/levels";
-import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
+import { generateAllJobs } from "@forwardimpact/libskill/derivation";
 
 /**
  * Render the slide index

package/src/slides/job.js

@@ -5,7 +5,7 @@
  */
 
 import { div, h1, p } from "../lib/render.js";
-import { prepareJobDetail } from "@forwardimpact/libpathway/job";
+import { prepareJobDetail } from "@forwardimpact/libskill/job";
 import { jobToDOM } from "../formatters/index.js";
 
 /**

package/src/slides/overview.js

@@ -22,7 +22,7 @@ import { prepareBehavioursList } from "../formatters/behaviour/shared.js";
 import { prepareDriversList } from "../formatters/driver/shared.js";
 import { prepareLevelsList } from "../formatters/level/shared.js";
 import { prepareTracksList } from "../formatters/track/shared.js";
-import { generateAllJobs } from "@forwardimpact/libpathway/derivation";
+import { generateAllJobs } from "@forwardimpact/libskill/derivation";
 
 /**
  * Format discipline group name for display

package/src/slides.html

@@ -13,19 +13,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>

package/src/css/base.css

@@ -1,56 +0,0 @@
-/**
- * Base Styles
- *
- * Typography, links, and body defaults using design tokens.
- * Import after tokens.css and reset.css.
- */
-
-@layer base {
-  body {
-    font-family: var(--font-family);
-    font-size: var(--font-size-base);
-    line-height: 1.6;
-    color: var(--color-text);
-    background-color: var(--color-bg);
-  }
-
-  h1,
-  h2,
-  h3,
-  h4,
-  h5,
-  h6 {
-    margin-bottom: var(--space-md);
-  }
-
-  h1 {
-    font-size: var(--font-size-3xl);
-    font-weight: 700;
-  }
-
-  h2 {
-    font-size: var(--font-size-2xl);
-  }
-
-  h3 {
-    font-size: var(--font-size-xl);
-  }
-
-  h4 {
-    font-size: var(--font-size-lg);
-  }
-
-  p {
-    margin-bottom: var(--space-md);
-  }
-
-  a {
-    color: var(--color-primary);
-    text-decoration: none;
-  }
-
-  a:hover {
-    color: var(--color-primary-dark);
-    text-decoration: underline;
-  }
-}