@jini-ai/ui 0.1.2 → 0.3.0

package/dist/features/skills/react/hooks/useSkillsTab.js

@@ -0,0 +1,282 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { EMPTY_SKILL_DRAFT, filterSkills, hasAnyCategory, isBuiltInSkill, parseTriggers, skillFilterOptions, summaryToDraft, validateSkillDraft, } from '../../rules.js';
+/**
+ * Owns every async edge and piece of interaction state for the Skills tab:
+ * the initial list load, lazy per-skill body/file-tree fetches, the
+ * create/edit draft form (including the built-in "creates a shadow copy"
+ * confirmation), and the two-click delete confirmation. Origin:
+ * `SkillsSection`'s own `useState` block — ported as a hook rather than
+ * inline so the component stays render-only, same split as every other tab
+ * in this feature.
+ *
+ * Filtering/search/counts are NOT recomputed here beyond calling this
+ * feature's own pure `rules.ts` functions over the current `skills` +
+ * `filters` — see
+ * `filterSkills`/`skillFilterOptions` for the actual logic.
+ */
+export function useSkillsTab({ port, locale = 'en' }) {
+    const [skills, setSkills] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [loadError, setLoadError] = useState(null);
+    const [filters, setFilters] = useState({ search: '', source: 'all', mode: 'all', category: 'all' });
+    const [expandedId, setExpandedId] = useState(null);
+    const [bodyById, setBodyById] = useState({});
+    const [bodyLoadingId, setBodyLoadingId] = useState(null);
+    const [filesById, setFilesById] = useState({});
+    const [filesLoadingId, setFilesLoadingId] = useState(null);
+    const [editingId, setEditingId] = useState(null);
+    const [creating, setCreating] = useState(false);
+    const [draft, setDraftState] = useState(EMPTY_SKILL_DRAFT);
+    const [draftError, setDraftError] = useState(null);
+    const [draftSaving, setDraftSaving] = useState(false);
+    const [confirmDeleteId, setConfirmDeleteId] = useState(null);
+    const [confirmBuiltInEditId, setConfirmBuiltInEditId] = useState(null);
+    const portRef = useRef(port);
+    portRef.current = port;
+    const bodyByIdRef = useRef(bodyById);
+    bodyByIdRef.current = bodyById;
+    const filesByIdRef = useRef(filesById);
+    filesByIdRef.current = filesById;
+    const alive = useRef(true);
+    useEffect(() => {
+        alive.current = true;
+        return () => {
+            alive.current = false;
+        };
+    }, []);
+    const refresh = useCallback(async () => {
+        const list = await portRef.current.listSkills();
+        if (alive.current)
+            setSkills(list);
+        return list;
+    }, []);
+    useEffect(() => {
+        let cancelled = false;
+        setLoading(true);
+        refresh()
+            .catch((error) => {
+            if (cancelled || !alive.current)
+                return;
+            setLoadError(error instanceof Error ? error.message : String(error));
+        })
+            .finally(() => {
+            if (!cancelled && alive.current)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [refresh]);
+    const filteredSkills = useMemo(() => filterSkills(skills, filters, locale), [skills, filters, locale]);
+    const sourceOptions = useMemo(() => skillFilterOptions(skills, filters, locale, 'source'), [skills, filters, locale]);
+    const modeOptions = useMemo(() => skillFilterOptions(skills, filters, locale, 'mode'), [skills, filters, locale]);
+    const categoryOptions = useMemo(() => (hasAnyCategory(skills) ? skillFilterOptions(skills, filters, locale, 'category') : null), [skills, filters, locale]);
+    const setSearch = useCallback((value) => setFilters((f) => ({ ...f, search: value })), []);
+    const setSourceFilter = useCallback((value) => setFilters((f) => ({ ...f, source: value })), []);
+    const setModeFilter = useCallback((value) => setFilters((f) => ({ ...f, mode: value })), []);
+    const setCategoryFilter = useCallback((value) => setFilters((f) => ({ ...f, category: value })), []);
+    const ensureBody = useCallback(async (id) => {
+        const cached = bodyByIdRef.current[id];
+        if (cached !== undefined)
+            return cached;
+        setBodyLoadingId(id);
+        try {
+            const detail = await portRef.current.fetchSkillDetail(id);
+            if (alive.current)
+                setBodyById((cur) => ({ ...cur, [id]: detail.body }));
+            return detail.body;
+        }
+        finally {
+            if (alive.current)
+                setBodyLoadingId((cur) => (cur === id ? null : cur));
+        }
+    }, []);
+    const ensureFiles = useCallback(async (id) => {
+        if (filesByIdRef.current[id])
+            return;
+        setFilesLoadingId(id);
+        try {
+            const entries = await portRef.current.fetchSkillFiles(id);
+            if (alive.current)
+                setFilesById((cur) => ({ ...cur, [id]: entries }));
+        }
+        finally {
+            if (alive.current)
+                setFilesLoadingId((cur) => (cur === id ? null : cur));
+        }
+    }, []);
+    const toggleExpanded = useCallback((id) => {
+        setExpandedId((cur) => {
+            if (cur === id)
+                return null;
+            void ensureBody(id);
+            void ensureFiles(id);
+            return id;
+        });
+        setEditingId((cur) => (cur === id ? cur : null));
+        setConfirmDeleteId(null);
+        setConfirmBuiltInEditId(null);
+    }, [ensureBody, ensureFiles]);
+    const startCreate = useCallback(() => {
+        setCreating(true);
+        setDraftState(EMPTY_SKILL_DRAFT);
+        setDraftError(null);
+        setEditingId(null);
+        setConfirmDeleteId(null);
+        setConfirmBuiltInEditId(null);
+    }, []);
+    const startEdit = useCallback(async (skill) => {
+        const body = await ensureBody(skill.id);
+        if (!alive.current)
+            return;
+        setDraftState(summaryToDraft(skill, body));
+        setDraftError(null);
+        setEditingId(skill.id);
+        setExpandedId(skill.id);
+        setCreating(false);
+        setConfirmDeleteId(null);
+        setConfirmBuiltInEditId(null);
+    }, [ensureBody]);
+    const requestEdit = useCallback((skill) => {
+        if (isBuiltInSkill(skill)) {
+            setConfirmBuiltInEditId(skill.id);
+            setConfirmDeleteId(null);
+            return;
+        }
+        void startEdit(skill);
+    }, [startEdit]);
+    const confirmBuiltInEdit = useCallback(() => {
+        const id = confirmBuiltInEditId;
+        setConfirmBuiltInEditId(null);
+        if (!id)
+            return;
+        const skill = skills.find((s) => s.id === id);
+        if (skill)
+            void startEdit(skill);
+    }, [confirmBuiltInEditId, skills, startEdit]);
+    const cancelBuiltInEdit = useCallback(() => setConfirmBuiltInEditId(null), []);
+    const cancelDraft = useCallback(() => {
+        setDraftState(EMPTY_SKILL_DRAFT);
+        setDraftError(null);
+        setEditingId(null);
+        setCreating(false);
+    }, []);
+    const setDraft = useCallback((updater) => {
+        setDraftState((current) => updater(current));
+    }, []);
+    const submitDraft = useCallback(() => {
+        if (draftSaving)
+            return;
+        const validation = validateSkillDraft(draft);
+        if (validation) {
+            setDraftError({ kind: validation });
+            return;
+        }
+        const payload = {
+            name: draft.name.trim(),
+            description: draft.description.trim() || undefined,
+            body: draft.body.trim(),
+            triggers: parseTriggers(draft.triggers),
+        };
+        setDraftSaving(true);
+        setDraftError(null);
+        const write = editingId ? portRef.current.updateSkill(editingId, payload) : portRef.current.createSkill(payload);
+        void write.then(async (updated) => {
+            if (!alive.current)
+                return;
+            setDraftSaving(false);
+            await refresh();
+            if (!alive.current)
+                return;
+            setBodyById((cur) => ({ ...cur, [updated.id]: updated.body }));
+            // Drop the cached file tree so the next expand re-walks the on-disk
+            // folder — the body may have been the only file before, but the
+            // operator might have meant to add more.
+            setFilesById((cur) => {
+                const next = { ...cur };
+                delete next[updated.id];
+                return next;
+            });
+            setExpandedId(updated.id);
+            setEditingId(null);
+            setCreating(false);
+            setDraftState(EMPTY_SKILL_DRAFT);
+        }, (error) => {
+            if (!alive.current)
+                return;
+            setDraftSaving(false);
+            setDraftError({ kind: 'submit-failed', message: error instanceof Error ? error.message : String(error) });
+        });
+    }, [draft, draftSaving, editingId, refresh]);
+    const armDelete = useCallback((id) => setConfirmDeleteId(id), []);
+    const cancelDelete = useCallback(() => setConfirmDeleteId(null), []);
+    const commitDelete = useCallback((id) => {
+        void portRef.current.deleteSkill(id).then(async () => {
+            if (!alive.current)
+                return;
+            setConfirmDeleteId(null);
+            await refresh();
+            if (!alive.current)
+                return;
+            setBodyById((cur) => {
+                const next = { ...cur };
+                delete next[id];
+                return next;
+            });
+            setFilesById((cur) => {
+                const next = { ...cur };
+                delete next[id];
+                return next;
+            });
+            setExpandedId((cur) => (cur === id ? null : cur));
+            setEditingId((cur) => {
+                if (cur !== id)
+                    return cur;
+                setDraftState(EMPTY_SKILL_DRAFT);
+                return null;
+            });
+        }, (error) => {
+            if (!alive.current)
+                return;
+            setDraftError({ kind: 'submit-failed', message: error instanceof Error ? error.message : String(error) });
+        });
+    }, [refresh]);
+    return {
+        skills,
+        loading,
+        loadError,
+        filters,
+        setSearch,
+        setSourceFilter,
+        setModeFilter,
+        setCategoryFilter,
+        filteredSkills,
+        sourceOptions,
+        modeOptions,
+        categoryOptions,
+        expandedId,
+        toggleExpanded,
+        bodyById,
+        bodyLoadingId,
+        filesById,
+        filesLoadingId,
+        editingId,
+        creating,
+        draft,
+        setDraft,
+        draftError,
+        draftSaving,
+        startCreate,
+        requestEdit,
+        confirmBuiltInEditId,
+        confirmBuiltInEdit,
+        cancelBuiltInEdit,
+        cancelDraft,
+        submitDraft,
+        confirmDeleteId,
+        armDelete,
+        cancelDelete,
+        commitDelete,
+    };
+}
+//# sourceMappingURL=useSkillsTab.js.map

package/dist/features/skills/react/hooks/useSkillsTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillsTab.js","sourceRoot":"","sources":["../../../../../src/features/skills/react/hooks/useSkillsTab.ts"],"names":[],"mappings":"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"}

package/dist/features/skills/rules.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Origin: the `useMemo` block of `SkillsSection.tsx` (lines ~146-240) plus its
+ * three module-level helpers (`summaryToDraft`, `parseTriggers`,
+ * `skillMatchesSearch`). All of it is pure derivation over a skill list — no
+ * React, no I/O — so it belongs here rather than in the component.
+ *
+ * ONE DELIBERATE DIVERGENCE FROM THE ORIGIN, called out because a reviewer
+ * diffing the two will notice it immediately: the origin repeats the same
+ * "does this skill match every active filter EXCEPT my own dimension"
+ * predicate six times, once inline per `useMemo` (`sourceCounts`,
+ * `modeOptions`, `modeAllCount`, `categoryOptions`, `categoryAllCount`,
+ * `filteredSkills`). Those six copies are not identical by accident — they are
+ * identical by intent, and they had already drifted in one respect: the
+ * category memos skip skills with no category before counting, while the mode
+ * memos do not. Here it is ONE parameterised predicate
+ * (`skillMatchesFilters` + its `except` option), which is why this file is
+ * shorter than the region it replaces while covering the same cases.
+ *
+ * Why counts exclude their own dimension: a filter pill should say what
+ * picking it WOULD yield, not what is showing now. Counting "mode" pills with
+ * the mode filter still applied would show 0 on every unselected pill, which
+ * reads as "empty" when it means "not currently selected".
+ */
+import type { SkillDraft, SkillFilterOption, SkillFilters, SkillSummary } from './types.js';
+/** The blank draft a "create new skill" form starts from. */
+export declare const EMPTY_SKILL_DRAFT: SkillDraft;
+/**
+ * The skill's name in `locale`, falling back to the untranslated `name`.
+ *
+ * A host that does not localize its catalog omits `displayName` entirely, so
+ * the fallback is the normal path rather than an error case.
+ */
+export declare function localizedSkillName(skill: SkillSummary, locale: string): string;
+/** The skill's description in `locale`, falling back to the untranslated one. */
+export declare function localizedSkillDescription(skill: SkillSummary, locale: string): string;
+/**
+ * Whether `skill` matches the free-text `query`.
+ *
+ * Searches the untranslated name AND the localized one, the untranslated
+ * description AND the localized one, every trigger phrase, and the category —
+ * so an operator can find a skill by what their UI calls it or by what its
+ * files call it.
+ *
+ * `query` is normalised (trimmed and lowercased) INSIDE this function. The
+ * origin required callers to pre-lowercase it and silently returned nothing
+ * for a capitalised query if they forgot; every call site there did the
+ * normalisation separately. An empty or whitespace-only query matches
+ * everything, which is what makes an untouched search box a no-op.
+ */
+export declare function skillMatchesSearch(skill: SkillSummary, query: string, locale: string): boolean;
+/** Which filter dimension a count is being computed FOR, and therefore which
+ *  one to ignore while computing it. */
+export type SkillFilterDimension = 'source' | 'mode' | 'category';
+/**
+ * Whether `skill` survives every active filter, optionally ignoring one
+ * dimension.
+ *
+ * `except` is what makes the filter-pill counts correct — see this file's
+ * header. Omit it and this is the plain "is this row visible" predicate.
+ */
+export declare function skillMatchesFilters(skill: SkillSummary, filters: SkillFilters, locale: string, except?: SkillFilterDimension): boolean;
+/** The rows the list should render. */
+export declare function filterSkills(skills: readonly SkillSummary[], filters: SkillFilters, locale: string): SkillSummary[];
+/**
+ * The pills for one filter dimension, plus the count its "all" pill shows.
+ *
+ * Replaces five of the origin's six memos. Two properties are preserved from
+ * it deliberately:
+ *
+ * - **The option SET comes from every skill, the COUNTS from the filtered
+ *   ones.** So an option can legitimately show 0 — it stays visible, telling
+ *   the operator the value exists but is excluded by their other filters.
+ *   Dropping zero-count options would make pills appear and vanish as filters
+ *   change, which is worse.
+ * - **`source` always offers its two known pills**, even when no skill has
+ *   that origin, because they are a fixed vocabulary rather than data-derived.
+ *   Unknown origins a host may report are counted in `all` but get no pill.
+ *
+ * Options are sorted by value (`localeCompare`) so the row is stable across
+ * renders rather than reflecting list order.
+ */
+export declare function skillFilterOptions(skills: readonly SkillSummary[], filters: SkillFilters, locale: string, dimension: SkillFilterDimension): {
+    all: number;
+    options: SkillFilterOption[];
+};
+/**
+ * Whether the category filter row should render at all.
+ *
+ * Categories are optional per-skill metadata. A host shipping only
+ * uncategorised skills should see no row rather than a row with nothing but
+ * an "all" pill — the origin's own note calls this out.
+ */
+export declare function hasAnyCategory(skills: readonly SkillSummary[]): boolean;
+/**
+ * Splits the raw triggers textarea into phrases.
+ *
+ * Comma OR newline separated, trimmed, blanks dropped — so trailing
+ * separators and a stray blank line while typing don't produce empty
+ * triggers. The draft keeps the RAW text (see `SkillDraft.triggers`); this
+ * runs at save time, which is why a half-typed entry survives re-renders.
+ */
+export declare function parseTriggers(raw: string): string[];
+/**
+ * Seeds the edit form from an existing skill plus its lazily-fetched body.
+ *
+ * `triggers` is joined back to comma-separated text because the form edits the
+ * raw string, not the array. The `Array.isArray` guard is kept from the origin:
+ * `triggers` is optional in the contract and a host can return `null` for it,
+ * which `.join` would throw on.
+ */
+export declare function summaryToDraft(skill: SkillSummary, body: string): SkillDraft;
+/** Which required field a draft is missing, or `null` when it may be
+ *  submitted. Origin: the two sequential `if (!name) {...}; if (!body)
+ *  {...}` checks inline in `submitDraft` — one pure predicate instead of two
+ *  inline early-returns, so the component only has to pick which message to
+ *  show, not decide whether to. Checked in this order (name before body) to
+ *  match the origin's precedence — an operator who left both blank sees the
+ *  name error first. */
+export declare function validateSkillDraft(draft: SkillDraft): 'name-required' | 'body-required' | null;
+/**
+ * Kebab-case category slugs (`'image-generation'`) rendered as Title Case
+ * (`'Image Generation'`) for the filter pill / category badge. Origin:
+ * `humanizeCategory` inline in `SkillsSection.tsx`.
+ */
+export declare function humanizeSkillCategory(slug: string): string;
+/** The last `/`-separated segment of a skill file's path — its own file/
+ *  folder name, without the parent tree. Origin: `leafName` inline in
+ *  `SkillsSection.tsx`. Unlike `locationLabel` (project-locations), a skill
+ *  file path is always daemon-reported and forward-slash-only, so this does
+ *  not also handle `\`. */
+export declare function skillFileLeafName(path: string): string;
+/**
+ * Indent (in px) for one row of the file-tree list, from its path depth.
+ *
+ * Each `/`-separated segment indents by 12px so a small `assets/` tree reads
+ * as a tree without building a nested list, capped at 4 levels so a deeply
+ * nested bundle does not push the file label out of the panel. Origin:
+ * `depthIndent` inline in `SkillsSection.tsx`.
+ */
+export declare function skillFileTreeIndent(path: string): number;
+/** A byte count as `'N B'` / `'N.N KB'` / `'N.N MB'`. Origin: `formatSize`
+ *  inline in `SkillsSection.tsx`. */
+export declare function formatSkillFileSize(bytes: number): string;
+/** Whether a skill's built-in origin means editing it must go through the
+ *  "creates a user-owned override" confirmation rather than editing in
+ *  place. Origin: `isBuiltIn = skill.source !== 'user'` inline in
+ *  `SkillRow`/`SkillsSection.requestEdit` — matches the origin's own
+ *  (deliberately inclusive) test: anything that is not `'user'` counts,
+ *  including a host's own third-party origins, not only `'built-in'`
+ *  literally. */
+export declare function isBuiltInSkill(skill: SkillSummary): boolean;
+/** Whether a skill may be deleted by the operator — only ones they imported
+ *  themselves. Origin: `canDelete = skill.source === 'user'` inline in
+ *  `SkillRow`. */
+export declare function isDeletableSkill(skill: SkillSummary): boolean;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/skills/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/skills/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,EAAE,UAK/B,CAAC;AAOF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAc9F;AAED;wCACwC;AACxC,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAOT;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,GACb,YAAY,EAAE,CAEhB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,oBAAoB,GAC9B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,CA4C/C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAO5E;AAED;;;;;;wBAMwB;AACxB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,GAAG,eAAe,GAAG,IAAI,CAI9F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;2BAI2B;AAC3B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;qCACqC;AACrC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;;;;iBAMiB;AACjB,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAE3D;AAED;;kBAEkB;AAClB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAE7D"}