epiq 0.0.0

package/dist/board/mock/board.js

@@ -0,0 +1,474 @@
+import { BoardItemTypes } from '../model/board.model.js';
+export const board = {
+    id: 'b1',
+    isSelected: false,
+    name: 'Product Development Board',
+    actionContext: 'BOARD',
+    childrenRenderAxis: 'horizontal',
+    children: [
+        {
+            isSelected: false,
+            id: 's1',
+            name: 'To Do',
+            childrenRenderAxis: 'vertical',
+            actionContext: BoardItemTypes.SWIMLANE,
+            enableChildNavigationAcrossContainers: true,
+            children: [
+                {
+                    isSelected: false,
+                    id: 't1',
+                    name: 'Setup CI/CD pipeline',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't1-desc',
+                            name: 'Configure GitHub Actions for test, build, and deploy stages.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't2',
+                    name: 'Create API contract for auth service',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't2-desc',
+                            name: 'Define request/response formats, error handling, and versioning.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't3',
+                    name: 'Draft OKRs for Q4',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't3-desc',
+                            name: 'Collaborate with leads to define team goals and key results.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't11',
+                    name: 'Define system architecture diagram',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't11-desc',
+                            name: 'Create high-level overview of services, databases, and communication flows.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't12',
+                    name: 'Setup monitoring and alerting',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't12-desc',
+                            name: 'Integrate tools like Prometheus and Grafana; define alert thresholds.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't13',
+                    name: 'Research data privacy regulations',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't13-desc',
+                            name: 'Identify GDPR and CCPA implications for data handling and user consent.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't14',
+                    name: 'Draft project onboarding guide',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't14-desc',
+                            name: 'Write setup instructions, repo structure, and coding standards.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't15',
+                    name: 'Evaluate state management solutions',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't15-desc',
+                            name: 'Compare Redux Toolkit, Zustand, and Jotai for frontend scalability.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't16',
+                    name: 'Write integration test plan',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't16-desc',
+                            name: 'Define test scenarios covering API and UI flows.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't17',
+                    name: 'Create performance benchmarks',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't17-desc',
+                            name: 'Set baseline response times for key endpoints and UI interactions.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't18',
+                    name: 'Design error handling strategy',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't18-desc',
+                            name: 'Standardize client and server error formats and fallback UIs.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't19',
+                    name: 'Define logging strategy',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't19-desc',
+                            name: 'Choose log levels, format, and storage mechanisms for observability.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't20',
+                    name: 'Setup feature flag framework',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't20-desc',
+                            name: 'Enable gradual rollouts using LaunchDarkly or Unleash.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't21',
+                    name: 'Conduct competitor analysis',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't21-desc',
+                            name: 'List comparable products and key differentiators for positioning.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't22',
+                    name: 'Organize kick-off meeting',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't22-desc',
+                            name: 'Schedule initial sync with stakeholders and present roadmap.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't23',
+                    name: 'Provision cloud infrastructure',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't23-desc',
+                            name: 'Set up base AWS resources using Terraform templates.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't24',
+                    name: 'Define user personas',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't24-desc',
+                            name: 'Collaborate with design to outline primary users and their needs.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't25',
+                    name: 'Plan retro cadence and format',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't25-desc',
+                            name: 'Decide on tools, frequency, and feedback channels for retrospectives.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+            ],
+        },
+        {
+            isSelected: false,
+            id: 's2',
+            name: 'In Progress',
+            childrenRenderAxis: 'vertical',
+            actionContext: 'SWIMLANE',
+            enableChildNavigationAcrossContainers: true,
+            children: [],
+        },
+        {
+            isSelected: false,
+            id: 's3',
+            name: 'Review',
+            childrenRenderAxis: 'vertical',
+            actionContext: 'SWIMLANE',
+            enableChildNavigationAcrossContainers: true,
+            children: [
+                {
+                    isSelected: false,
+                    id: 't4',
+                    name: 'Implement user login flow',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't4-desc',
+                            name: 'Integrate frontend with backend auth API and handle edge cases.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't5',
+                    name: 'Design new dashboard layout',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't5-desc',
+                            name: 'Collaborate with UX to create a grid-based responsive dashboard.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't6',
+                    name: 'Accessibility audit',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't6-desc',
+                            name: 'Evaluate color contrast, ARIA usage, and keyboard nav.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't7',
+                    name: 'Code review for analytics module',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't7-desc',
+                            name: 'Ensure test coverage, types, and data validation are in place.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't8',
+                    name: 'Review UI polish for mobile view',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't8-desc',
+                            name: 'Verify spacing, responsiveness, and visual hierarchy.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+            ],
+        },
+        {
+            isSelected: false,
+            id: 's4',
+            name: 'Done',
+            childrenRenderAxis: 'vertical',
+            actionContext: 'SWIMLANE',
+            enableChildNavigationAcrossContainers: true,
+            children: [
+                {
+                    isSelected: false,
+                    id: 't9',
+                    name: 'Setup Storybook',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't9-desc',
+                            name: 'Document reusable components and tokens in Storybook.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+                {
+                    isSelected: false,
+                    id: 't10',
+                    name: 'Deploy v1.2 to staging',
+                    actionContext: BoardItemTypes.TICKET_LIST_ITEM,
+                    childrenRenderAxis: 'vertical',
+                    children: [
+                        {
+                            isSelected: false,
+                            id: 't10-desc',
+                            name: 'All pipelines green. Ready for product team QA.',
+                            actionContext: BoardItemTypes.TICKET,
+                            childrenRenderAxis: 'vertical',
+                            children: [],
+                        },
+                    ],
+                },
+            ],
+        },
+    ],
+};

package/dist/board/model/board.model.d.ts

@@ -0,0 +1,26 @@
+import type { NavigationTree } from '../../navigation/model/navigation-tree.model.js';
+export declare const BoardItemTypes: {
+    readonly TICKET: "TICKET";
+    readonly TICKET_LIST_ITEM: "TICKET_LIST_ITEM";
+    readonly SWIMLANE: "SWIMLANE";
+    readonly BOARD: "BOARD";
+};
+export type Board = NavigationTree<{
+    actionContext: (typeof BoardItemTypes)['BOARD'];
+}> & {
+    children: Swimlane[];
+};
+export type Swimlane = NavigationTree<{
+    actionContext: (typeof BoardItemTypes)['SWIMLANE'];
+    enableChildNavigationAcrossContainers: true;
+}> & {
+    children: TicketListItem[];
+};
+export type TicketListItem = NavigationTree<{
+    actionContext: (typeof BoardItemTypes)['TICKET_LIST_ITEM'];
+}> & {
+    children: Ticket[];
+};
+export type Ticket = NavigationTree<{
+    actionContext: (typeof BoardItemTypes)['TICKET'];
+}>;

package/dist/board/model/board.model.js

@@ -0,0 +1,6 @@
+export const BoardItemTypes = {
+    TICKET: 'TICKET',
+    TICKET_LIST_ITEM: 'TICKET_LIST_ITEM',
+    SWIMLANE: 'SWIMLANE',
+    BOARD: 'BOARD',
+};

package/dist/board/move-actions-routes.d.ts

@@ -0,0 +1,4 @@
+import { ActionEntry } from '../navigation/model/action-map.model.js';
+import { NavigateCtx } from '../navigation/model/navigation-ctx.model.js';
+export declare const moveWithinParent: ActionEntry<[NavigateCtx]>[];
+export declare const moveAcrossParents: ActionEntry<[NavigateCtx]>[];

package/dist/board/move-actions-routes.js

@@ -0,0 +1,31 @@
+import { Mode } from '../navigation/model/action-map.model.js';
+import { KeyIntent } from '../navigation/utils/key-intent.js';
+import { moveChildNextWithinParent, moveChildPreviousWithinParent, moveChildToNextParent, moveChildToPreviousParent, } from './move-actions.js';
+export const moveWithinParent = [
+    {
+        mode: Mode.DEFAULT,
+        description: '[SHIFT + ARROW KEYS] Move item',
+    },
+    {
+        intent: KeyIntent.MovePreviousItem,
+        mode: Mode.DEFAULT,
+        action: moveChildPreviousWithinParent,
+    },
+    {
+        intent: KeyIntent.MoveNextItem,
+        mode: Mode.DEFAULT,
+        action: moveChildNextWithinParent,
+    },
+];
+export const moveAcrossParents = [
+    {
+        intent: KeyIntent.MoveToNextContainer,
+        mode: Mode.DEFAULT,
+        action: moveChildToNextParent,
+    },
+    {
+        intent: KeyIntent.MoveToPreviousContainer,
+        mode: Mode.DEFAULT,
+        action: moveChildToPreviousParent,
+    },
+];

package/dist/board/move-actions.d.ts

@@ -0,0 +1,5 @@
+import { NavigateCtx } from '../navigation/model/navigation-ctx.model.js';
+export declare const moveChildToNextParent: (ctx: NavigateCtx) => void;
+export declare const moveChildToPreviousParent: (ctx: NavigateCtx) => void;
+export declare const moveChildPreviousWithinParent: (ctx: NavigateCtx) => void;
+export declare const moveChildNextWithinParent: (ctx: NavigateCtx) => void;

package/dist/board/move-actions.js

@@ -0,0 +1,49 @@
+function moveItemInArray({ array, from, to, }) {
+    if (from < 0 || from >= array.length || to < 0 || to >= array.length)
+        return;
+    const [item] = array.splice(from, 1);
+    if (item)
+        array.splice(to, 0, item);
+}
+function moveNodeToSiblingContainer(ctx, direction) {
+    const ancestors = ctx.breadCrumb;
+    const parent = ancestors.at(-1);
+    const grandParent = ancestors.at(-2);
+    if (!parent || !grandParent)
+        return;
+    const parentIndex = grandParent.children.findIndex(x => x.id === parent.id);
+    const targetIndex = parentIndex + direction;
+    if (parentIndex < 0 ||
+        targetIndex < 0 ||
+        targetIndex >= grandParent.children.length)
+        return;
+    const sibling = grandParent.children[targetIndex];
+    if (!sibling)
+        return;
+    if (!sibling?.children?.length && !Array.isArray(sibling.children))
+        return;
+    const currentIndex = ctx._selectedIndex;
+    if (currentIndex < 0 || currentIndex >= parent.children.length)
+        return;
+    const [node] = parent.children.splice(currentIndex, 1);
+    sibling.children.push(node);
+    const newBreadCrumb = [...ctx.breadCrumb.slice(0, -1), sibling];
+    const newIndex = sibling.children.length - 1;
+    ctx.reInvokeNavigate(newIndex, newBreadCrumb);
+}
+export const moveChildToNextParent = (ctx) => moveNodeToSiblingContainer(ctx, 1);
+export const moveChildToPreviousParent = (ctx) => moveNodeToSiblingContainer(ctx, -1);
+function moveChildWithinParent(ctx, direction) {
+    const from = ctx._selectedIndex;
+    const to = from + direction;
+    if (to < 0 || to >= ctx.navigationNode.children.length)
+        return;
+    moveItemInArray({
+        array: ctx.navigationNode.children,
+        from,
+        to,
+    });
+    ctx.select(to);
+}
+export const moveChildPreviousWithinParent = (ctx) => moveChildWithinParent(ctx, -1);
+export const moveChildNextWithinParent = (ctx) => moveChildWithinParent(ctx, 1);

package/dist/board/render/color.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Applies ANSI color codes to a string for terminal output.
+ * @param text The text to colorize
+ * @param color One of: black, red, green, yellow, blue, magenta, cyan, white
+ * @returns A colorized string using ANSI escape codes
+ */
+export declare function highlight(text: string, color: string): string;

package/dist/board/render/color.js

@@ -0,0 +1,21 @@
+/**
+ * Applies ANSI color codes to a string for terminal output.
+ * @param text The text to colorize
+ * @param color One of: black, red, green, yellow, blue, magenta, cyan, white
+ * @returns A colorized string using ANSI escape codes
+ */
+export function highlight(text, color) {
+    const colors = {
+        black: '\x1b[30m',
+        red: '\x1b[31m',
+        green: '\x1b[32m',
+        yellow: '\x1b[33m',
+        blue: '\x1b[34m',
+        magenta: '\x1b[35m',
+        cyan: '\x1b[36m',
+        white: '\x1b[37m',
+        reset: '\x1b[0m',
+    };
+    const code = colors[color.toLowerCase()] ?? '';
+    return `${code}${text}${colors['reset']}`;
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare const main: () => void;