@forwardimpact/pathway 0.21.0 → 0.23.0

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";
 
 /**
@@ -17,12 +17,12 @@ import { jobToDOM } from "../formatters/index.js";
  */
 export function renderJobSlide({ render, data, params }) {
   const discipline = data.disciplines.find((d) => d.id === params.discipline);
-  const grade = data.grades.find((g) => g.id === params.grade);
+  const level = data.levels.find((g) => g.id === params.level);
   const track = data.tracks.find((t) => t.id === params.track);
 
   const view = prepareJobDetail({
     discipline,
-    grade,
+    level,
     track,
     skills: data.skills,
     behaviours: data.behaviours,
@@ -49,7 +49,7 @@ export function renderJobSlide({ render, data, params }) {
       showJobDescriptionHtml: true,
       showJobDescriptionMarkdown: false,
       discipline,
-      grade,
+      level,
       track,
     }),
   );

package/src/slides/level.js

@@ -0,0 +1,32 @@
+/**
+ * Level Slide View
+ *
+ * Printer-friendly view of a level.
+ */
+
+import { div, h1, p } from "../lib/render.js";
+import { levelToDOM } from "../formatters/index.js";
+
+/**
+ * Render level slide
+ * @param {Object} params
+ * @param {Function} params.render
+ * @param {Object} params.data
+ * @param {Object} params.params
+ */
+export function renderLevelSlide({ render, data, params }) {
+  const level = data.levels.find((g) => g.id === params.id);
+
+  if (!level) {
+    render(
+      div(
+        { className: "slide-error" },
+        h1({}, "Level Not Found"),
+        p({}, `No level found with ID: ${params.id}`),
+      ),
+    );
+    return;
+  }
+
+  render(levelToDOM(level, { framework: data.framework, showBackLink: false }));
+}

package/src/slides/overview.js

@@ -12,7 +12,7 @@ import {
   skillToCardConfig,
   behaviourToCardConfig,
   driverToCardConfig,
-  gradeToCardConfig,
+  levelToCardConfig,
   trackToCardConfig,
   jobToCardConfig,
 } from "../lib/card-mappers.js";
@@ -20,9 +20,9 @@ import { prepareDisciplinesList } from "../formatters/discipline/shared.js";
 import { prepareSkillsList } from "../formatters/skill/shared.js";
 import { prepareBehavioursList } from "../formatters/behaviour/shared.js";
 import { prepareDriversList } from "../formatters/driver/shared.js";
-import { prepareGradesList } from "../formatters/grade/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
@@ -92,12 +92,12 @@ export function renderOverviewSlide({ render, data, params }) {
       mapper: disciplineToCardConfig,
       isGrouped: true,
     },
-    grade: {
-      title: framework.entityDefinitions.grade.title,
-      emojiIcon: framework.entityDefinitions.grade.emojiIcon,
-      description: framework.entityDefinitions.grade.description,
-      entities: prepareGradesList(data.grades).items,
-      mapper: gradeToCardConfig,
+    level: {
+      title: framework.entityDefinitions.level.title,
+      emojiIcon: framework.entityDefinitions.level.emojiIcon,
+      description: framework.entityDefinitions.level.description,
+      entities: prepareLevelsList(data.levels).items,
+      mapper: levelToCardConfig,
     },
     track: {
       title: framework.entityDefinitions.track.title,
@@ -112,7 +112,7 @@ export function renderOverviewSlide({ render, data, params }) {
       description: framework.entityDefinitions.job.description,
       entities: generateAllJobs({
         disciplines: data.disciplines,
-        grades: data.grades,
+        levels: data.levels,
         tracks: data.tracks,
         skills: data.skills,
         behaviours: data.behaviours,

package/src/slides/progress.js

@@ -7,7 +7,7 @@
 import { div, h1, p } from "../lib/render.js";
 import {
   prepareProgressDetail,
-  getDefaultTargetGrade,
+  getDefaultTargetLevel,
 } from "../formatters/progress/shared.js";
 import { progressToDOM } from "../formatters/index.js";
 
@@ -20,12 +20,12 @@ import { progressToDOM } from "../formatters/index.js";
  */
 export function renderProgressSlide({ render, data, params }) {
   const discipline = data.disciplines.find((d) => d.id === params.discipline);
-  const grade = data.grades.find((g) => g.id === params.grade);
+  const level = data.levels.find((g) => g.id === params.level);
   const track = params.track
     ? data.tracks.find((t) => t.id === params.track)
     : null;
 
-  if (!discipline || !grade) {
+  if (!discipline || !level) {
     render(
       div(
         { className: "slide-error" },
@@ -36,23 +36,23 @@ export function renderProgressSlide({ render, data, params }) {
     return;
   }
 
-  // Get compare grade from URL query or default to next grade
+  // Get compare level from URL query or default to next level
   const urlParams = new URLSearchParams(window.location.search);
-  const compareGradeId = urlParams.get("compare");
+  const compareLevelId = urlParams.get("compare");
 
-  let targetGrade;
-  if (compareGradeId) {
-    targetGrade = data.grades.find((g) => g.id === compareGradeId);
+  let targetLevel;
+  if (compareLevelId) {
+    targetLevel = data.levels.find((g) => g.id === compareLevelId);
   } else {
-    targetGrade = getDefaultTargetGrade(grade, data.grades);
+    targetLevel = getDefaultTargetLevel(level, data.levels);
   }
 
-  if (!targetGrade) {
+  if (!targetLevel) {
     render(
       div(
         { className: "slide-error" },
         h1({}, "No Progression Available"),
-        p({}, "No next grade available for this role."),
+        p({}, "No next level available for this role."),
       ),
     );
     return;
@@ -60,10 +60,10 @@ export function renderProgressSlide({ render, data, params }) {
 
   const view = prepareProgressDetail({
     fromDiscipline: discipline,
-    fromGrade: grade,
+    fromLevel: level,
     fromTrack: track,
     toDiscipline: discipline,
-    toGrade: targetGrade,
+    toLevel: targetLevel,
     toTrack: track,
     skills: data.skills,
     behaviours: data.behaviours,

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/types.js

@@ -19,7 +19,7 @@
  * @property {boolean} [humanOnly] - Whether this skill requires human presence
  * @property {'primary'|'secondary'|'tertiary'} type - Skill type in this role
  * @property {string} level - Level ID (e.g., "advanced", "expert")
- * @property {string} levelDescription - Human-readable level description
+ * @property {string} proficiencyDescription - Human-readable level description
  */
 
 // ============================================================================

package/templates/job.template.md

@@ -1,6 +1,6 @@
 # {{{title}}}
 
-- **Level:** {{{gradeId}}}
+- **Level:** {{{levelId}}}
 - **Experience:** {{{typicalExperienceRange}}}
 {{#hasTrack}}- **Track:** {{{trackName}}}
 {{/hasTrack}}
@@ -34,7 +34,7 @@
 {{{responsibilityDescription}}}:
 
 {{#skills}}
-- **{{{skillName}}}:** {{{levelDescription}}}
+- **{{{skillName}}}:** {{{proficiencyDescription}}}
 {{/skills}}
 {{/capabilitySkills}}
 {{/hasCapabilitySkills}}

package/src/commands/grade.js

@@ -1,60 +0,0 @@
-/**
- * Grade CLI Command
- *
- * Handles grade summary, listing, and detail display in the terminal.
- *
- * Usage:
- *   npx pathway grade              # Summary with stats
- *   npx pathway grade --list       # IDs only (for piping)
- *   npx pathway grade <id>         # Detail view
- *   npx pathway grade --validate   # Validation checks
- */
-
-import { createEntityCommand } from "./command-factory.js";
-import { gradeToMarkdown } from "../formatters/grade/markdown.js";
-import { formatTable } from "../lib/cli-output.js";
-import { getConceptEmoji } from "@forwardimpact/map/levels";
-import { capitalize } from "../formatters/shared.js";
-
-/**
- * Format grade summary output
- * @param {Array} grades - Raw grade entities
- * @param {Object} data - Full data context
- */
-function formatSummary(grades, data) {
-  const { framework } = data;
-  const emoji = framework ? getConceptEmoji(framework, "grade") : "📊";
-
-  console.log(`\n${emoji} Grades\n`);
-
-  const rows = grades.map((g) => [
-    g.id,
-    g.displayName || g.id,
-    g.typicalExperienceRange || "-",
-    capitalize(g.baseSkillLevels?.primary || "-"),
-  ]);
-
-  console.log(formatTable(["ID", "Name", "Experience", "Primary Level"], rows));
-  console.log(`\nTotal: ${grades.length} grades`);
-  console.log(`\nRun 'npx pathway grade --list' for IDs`);
-  console.log(`Run 'npx pathway grade <id>' for details\n`);
-}
-
-/**
- * Format grade detail output
- * @param {Object} grade - Raw grade entity
- * @param {Object} framework - Framework config
- */
-function formatDetail(grade, framework) {
-  console.log(gradeToMarkdown(grade, framework));
-}
-
-export const runGradeCommand = createEntityCommand({
-  entityName: "grade",
-  pluralName: "grades",
-  findEntity: (data, id) => data.grades.find((g) => g.id === id),
-  presentDetail: (entity) => entity,
-  formatSummary,
-  formatDetail,
-  emojiIcon: "📊",
-});

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;
-  }
-}

package/src/css/components/badges.css

@@ -1,232 +0,0 @@
-/**
- * Badge Components
- *
- * All badge variants consolidated: type badges, level badges, capability badges, modifiers.
- */
-
-@layer components {
-  /* Base badge - 28px height matches tool icons for consistent row heights */
-  .badge {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    height: 28px;
-    padding: 0 var(--space-sm);
-    border-radius: var(--radius-md);
-    font-size: var(--font-size-xs);
-    font-weight: 500;
-    text-transform: uppercase;
-    letter-spacing: 0.025em;
-  }
-
-  .badge-default {
-    background: var(--color-primary-light);
-    color: var(--color-primary-dark);
-  }
-
-  .badge-human-only {
-    background: #fef3c7;
-    color: #92400e;
-  }
-
-  /* Skill type badges */
-  .badge-primary {
-    background: var(--color-primary-skill-light);
-    color: var(--color-primary-skill);
-  }
-
-  .badge-secondary {
-    background: var(--color-secondary-light);
-    color: #92400e;
-  }
-
-  .badge-broad {
-    background: var(--color-broad-light);
-    color: #047857;
-  }
-
-  .badge-negative {
-    background: var(--color-primary-skill-light);
-    color: var(--color-primary-skill);
-  }
-
-  /* Level badges (1-5) - consolidated definition */
-  .badge-1,
-  .level-badge-1 {
-    background: var(--color-level-1);
-    color: #991b1b;
-  }
-
-  .badge-2,
-  .level-badge-2 {
-    background: var(--color-level-2);
-    color: #92400e;
-  }
-
-  .badge-3,
-  .level-badge-3 {
-    background: var(--color-level-3);
-    color: #166534;
-  }
-
-  .badge-4,
-  .level-badge-4 {
-    background: var(--color-level-4);
-    color: #0e7490;
-  }
-
-  .badge-5,
-  .level-badge-5 {
-    background: var(--color-level-5);
-    color: #5b21b6;
-  }
-
-  /* Level badge base style - 28px height matches tool icons */
-  .level-badge {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    height: 28px;
-    padding: 0 var(--space-sm);
-    border-radius: var(--radius-md);
-    font-size: var(--font-size-sm);
-    font-weight: 500;
-  }
-
-  /* Capability badges - each capability ID maps to its own distinct color */
-  .badge-ai {
-    background: var(--color-cap-ai-light);
-    color: var(--color-cap-ai);
-  }
-
-  .badge-business {
-    background: var(--color-cap-business-light);
-    color: var(--color-cap-business);
-  }
-
-  .badge-data {
-    background: var(--color-cap-data-light);
-    color: var(--color-cap-data);
-  }
-
-  .badge-delivery {
-    background: var(--color-cap-delivery-light);
-    color: var(--color-cap-delivery);
-  }
-
-  .badge-documentation {
-    background: var(--color-cap-documentation-light);
-    color: var(--color-cap-documentation);
-  }
-
-  .badge-ml {
-    background: var(--color-cap-ml-light);
-    color: var(--color-cap-ml);
-  }
-
-  .badge-people {
-    background: var(--color-cap-people-light);
-    color: var(--color-cap-people);
-  }
-
-  .badge-process {
-    background: var(--color-cap-process-light);
-    color: var(--color-cap-process);
-  }
-
-  .badge-product {
-    background: var(--color-cap-product-light);
-    color: var(--color-cap-product);
-  }
-
-  .badge-reliability {
-    background: var(--color-cap-reliability-light);
-    color: var(--color-cap-reliability);
-  }
-
-  .badge-scale {
-    background: var(--color-cap-scale-light);
-    color: var(--color-cap-scale);
-  }
-
-  /* Tool badge */
-  .badge-tool {
-    background: var(--color-bg);
-    color: var(--color-text);
-    border: 1px solid var(--color-border);
-    font-size: 0.9rem;
-    padding: var(--space-xs) var(--space-sm);
-  }
-
-  /* Modifier tags - 28px height matches badges and tool icons */
-  .modifier {
-    display: inline-flex;
-    align-items: center;
-    height: 28px;
-    padding: 0 var(--space-sm);
-    border-radius: var(--radius-sm);
-    font-size: var(--font-size-sm);
-    font-weight: 600;
-    line-height: 1;
-  }
-
-  .modifier-positive {
-    background: var(--color-level-3);
-    color: #166534;
-  }
-
-  .modifier-negative {
-    background: var(--color-level-1);
-    color: #991b1b;
-  }
-
-  .modifier-neutral {
-    background: var(--color-surface);
-    color: var(--color-text-muted);
-    border: 1px solid var(--color-border);
-  }
-
-  /* Info tags */
-  .info-tags {
-    display: flex;
-    gap: var(--space-sm);
-    flex-wrap: wrap;
-  }
-
-  .info-tag {
-    display: inline-block;
-    padding: var(--space-xs) var(--space-sm);
-    background: var(--color-bg);
-    border-radius: var(--radius-md);
-    font-size: var(--font-size-sm);
-    color: var(--color-text-muted);
-  }
-
-  /* Tool/skill badges container */
-  .tool-badges,
-  .skill-badges {
-    display: flex;
-    flex-wrap: wrap;
-    gap: var(--space-sm);
-  }
-
-  /* Change indicators */
-  .change-indicator {
-    display: inline-flex;
-    align-items: center;
-    gap: var(--space-xs);
-    font-weight: 500;
-  }
-
-  .change-up {
-    color: var(--color-success);
-  }
-
-  .change-down {
-    color: var(--color-error);
-  }
-
-  .change-same {
-    color: var(--color-text-muted);
-  }
-}