npm - @pikku/cli - Versions diffs - 0.12.22 → 0.12.24 - Mend

@pikku/cli 0.12.22 → 0.12.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (79) hide show

package/skills/pikku-rtl/SKILL.md CHANGED Viewed

@@ -14,7 +14,7 @@ registered `satisfies typeof en`) plus the document being told it is `rtl`.
 ## The one idea
 Set `dir` **once at the document root** from the active locale, then let the
-browser and Mantine mirror everything — *provided* every custom style is written
+browser and Mantine mirror everything — _provided_ every custom style is written
 **flow-relative** (start/end), never **physical** (left/right). Get those two
 things right and Arabic, Hebrew, Farsi and Urdu all work with zero per-component
 RTL code.
@@ -46,22 +46,22 @@ RTL code.
 Use the **inline-axis logical** property; never the physical one:
-| Don't (physical)            | Do (flow-relative)                          |
-| --------------------------- | ------------------------------------------- |
-| `margin-left` / `marginLeft`| `margin-inline-start` / `marginInlineStart` |
-| `margin-right`              | `margin-inline-end` / `marginInlineEnd`     |
-| `padding-left/right`        | `padding-inline-start/end`                  |
-| `left: 0` / `right: 0`      | `inset-inline-start: 0` / `inset-inline-end`|
-| `text-align: left/right`    | `text-align: start / end`                   |
-| `border-top-left-radius`    | `border-start-start-radius`                 |
-| `float: left/right`         | `float: inline-start / inline-end`          |
+| Don't (physical)             | Do (flow-relative)                           |
+| ---------------------------- | -------------------------------------------- |
+| `margin-left` / `marginLeft` | `margin-inline-start` / `marginInlineStart`  |
+| `margin-right`               | `margin-inline-end` / `marginInlineEnd`      |
+| `padding-left/right`         | `padding-inline-start/end`                   |
+| `left: 0` / `right: 0`       | `inset-inline-start: 0` / `inset-inline-end` |
+| `text-align: left/right`     | `text-align: start / end`                    |
+| `border-top-left-radius`     | `border-start-start-radius`                  |
+| `float: left/right`          | `float: inline-start / inline-end`           |
 In **Mantine**, use the logical style props — they emit the logical CSS above:
-| Don't        | Do            |
-| ------------ | ------------- |
-| `ml` / `mr`  | `ms` / `me`   |
-| `pl` / `pr`  | `ps` / `pe`   |
+| Don't       | Do          |
+| ----------- | ----------- |
+| `ml` / `mr` | `ms` / `me` |
+| `pl` / `pr` | `ps` / `pe` |
 Mantine's own components already use logical properties internally, so once the
 direction is set they mirror automatically — you only have to be disciplined in
@@ -76,6 +76,7 @@ logical order; let `dir` handle the visual order.
 ## Applying direction at the root
 ### Mantine app (e.g. environment-template)
 Mantine ships first-class RTL: wrap the tree in `DirectionProvider` and set the
 matching `dir` on `<html>`.
@@ -83,14 +84,13 @@ matching `dir` on `<html>`.
 import { DirectionProvider, MantineProvider } from '@mantine/core'
 import i18n, { detectLocale, localeDir } from './i18n/config'
-const locale = typeof window !== 'undefined'
-  ? detectLocale(window.location.pathname)
-  : 'en'
+const locale =
+  typeof window !== 'undefined' ? detectLocale(window.location.pathname) : 'en'
 const dir = localeDir(locale)
 if (typeof document !== 'undefined') {
   document.documentElement.lang = locale
-  document.documentElement.dir = dir   // Mantine + browser read this
+  document.documentElement.dir = dir // Mantine + browser read this
 }
 root.render(
@@ -98,14 +98,16 @@ root.render(
     <MantineProvider theme={theme} defaultColorScheme="dark">
       {/* …app… */}
     </MantineProvider>
-  </DirectionProvider>,
+  </DirectionProvider>
 )
 ```
 To flip direction live (a language switcher) call
 `document.documentElement.setAttribute('dir', localeDir(next))` and Mantine's
 `useDirection().setDirection(dir)`; both read the same value.
 ### Plain Vite SPA (kanban, test-harness vite-spa)
 No Mantine — just put `dir`/`lang` on `<html>` at bootstrap, after the locale is
 detected (the same `detectLocale` the i18n config uses):
@@ -116,9 +118,11 @@ const locale = detectLocale(window.location.pathname)
 document.documentElement.lang = locale
 document.documentElement.dir = localeDir(locale)
 ```
 Everything below inherits `dir` from `<html>`; logical CSS does the mirroring.
 ### Vite SSR (test-harness vite-ssr)
 The worker renders the full HTML, so set `lang`/`dir` on the server `<html>`
 from the **URL** locale (the client inherits it on hydration — no flash):
@@ -132,17 +136,23 @@ const html = `<!doctype html>
   …
 </html>`
 ```
 i18next's active language must match: call `i18n.changeLanguage(locale)` before
 `renderToString` so the SSR'd text and `dir` agree.
 ### Next.js app-router (test-harness next-ssr / next-static)
 Set it on the `<html>` in `app/layout.tsx`. With locale-prefixed routes the
 segment gives the locale; for a single-locale build it's a constant:
 ```tsx
 import { localeDir, defaultLocale } from './i18n/config'
-export default function RootLayout({ children }: { children: React.ReactNode }) {
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
   const locale = defaultLocale // or the [lang] route segment / params
   return (
     <html lang={locale} dir={localeDir(locale)}>
@@ -151,6 +161,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
   )
 }
 ```
 For `output: 'export'` with `/ar` prefixes, derive `locale` from the route
 segment so each statically-exported tree carries the right `dir`.
@@ -162,8 +173,11 @@ non-directional icon (search, settings, avatar) must **not**. Flip with the
 `:dir()` selector — no JS, no per-locale branching:
 ```css
-:dir(rtl) .icon-directional { transform: scaleX(-1); }
+:dir(rtl) .icon-directional {
+  transform: scaleX(-1);
+}
 ```
 Or in CSS-in-JS / inline, gate on the resolved direction:
 `transform: localeDir(locale) === 'rtl' ? 'scaleX(-1)' : undefined`.
 Prefer logical icon components if your icon set ships them.
@@ -171,8 +185,8 @@ Prefer logical icon components if your icon set ships them.
 ## Arabic typography niceties
 - **Font:** the default Latin stack renders Arabic with the system fallback,
-  which is inconsistent. Add an Arabic-capable family (e.g. *Noto Sans Arabic*,
-  *IBM Plex Sans Arabic*) to `font-family` so both scripts look intentional.
+  which is inconsistent. Add an Arabic-capable family (e.g. _Noto Sans Arabic_,
+  _IBM Plex Sans Arabic_) to `font-family` so both scripts look intentional.
 - **Numerals:** don't hardcode digits. Format numbers/dates with
   `Intl.NumberFormat`/`Intl.DateTimeFormat` (or i18next formatters) given the
   active locale, so Western vs Arabic-Indic digits follow the locale choice.
@@ -187,7 +201,7 @@ Prefer logical icon components if your icon set ships them.
 2. Confirm the `localeDir` helper includes `ar` (it does by default).
 3. Confirm the root sets `dir` from the locale (recipe above).
 4. Sweep the app's styles: replace every `left/right`, `ml/mr`, `text-align:
-   left` with the flow-relative equivalent; revert any manual `row-reverse`.
+left` with the flow-relative equivalent; revert any manual `row-reverse`.
 5. Flip directional icons.
 6. `tsc`, then load the Arabic route and verify the whole layout mirrors —
    sidebar on the right, text right-aligned, arrows pointing the other way.

package/dist/.pikku/schemas/schemas/GraphStarterInput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "workflowName": { "type": "string" }, "nodeId": { "type": "string" }, "data": {} }, "required": ["workflowName", "nodeId"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/GraphStarterOutput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "runId": { "type": "string" } }, "required": ["runId"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/WorkflowRunStatus.schema.json DELETED Viewed

@@ -1 +0,0 @@

- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "id": { "type": "string" }, "status": { "$ref": "#/definitions/WorkflowStatus" }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" }, "deterministic": { "type": "boolean" }, "plannedSteps": { "type": "array", "items": { "$ref": "#/definitions/WorkflowPlannedStep" } }, "steps": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "status": { "$ref": "#/definitions/StepStatus" }, "duration": { "type": "number" } }, "required": ["name", "status"], "additionalProperties": false } }, "output": {}, "error": { "type": "object", "properties": { "message": { "type": "string" } }, "required": ["message"], "additionalProperties": false } }, "required": ["id", "status", "startedAt", "steps"], "additionalProperties": false, "definitions": { "WorkflowStatus": { "type": "string", "enum": ["running", "suspended", "completed", "failed", "cancelled"], "description": "Workflow run status" }, "WorkflowPlannedStep": { "type": "object", "properties": { "stepName": { "type": "string", "description": "Human-readable step label for UI timeline" } }, "required": ["stepName"], "additionalProperties": false }, "StepStatus": { "type": "string", "enum": ["pending", "running", "scheduled", "succeeded", "failed", "suspended"], "description": "Workflow step status" } } }

package/dist/.pikku/schemas/schemas/WorkflowRunnerInput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "workflowName": { "type": "string" }, "data": {} }, "required": ["workflowName"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/WorkflowStarterInput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "workflowName": { "type": "string" }, "data": {} }, "required": ["workflowName"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/WorkflowStarterOutput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "runId": { "type": "string" } }, "required": ["runId"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/WorkflowStatusCheckerInput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "workflowName": { "type": "string" }, "runId": { "type": "string" } }, "required": ["workflowName", "runId"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/WorkflowStatusStreamFullInput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "workflowName": { "type": "string" }, "runId": { "type": "string" } }, "required": ["workflowName", "runId"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/WorkflowStatusStreamInput.schema.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "workflowName": { "type": "string" }, "runId": { "type": "string" } }, "required": ["workflowName", "runId"], "additionalProperties": false, "definitions": {} }

package/dist/src/scaffold/workflow-routes.gen.d.ts DELETED Viewed

@@ -1,84 +0,0 @@
-import type { WorkflowRunStatus } from '@pikku/core/workflow';
-export declare const workflowStarter: import("../../.pikku/pikku-types.gen.js").PikkuFunctionConfig<{
-    workflowName: string;
-    data?: unknown;
-}, {
-    runId: string;
-}, "rpc" | "session", import("../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
-    workflowName: string;
-    data?: unknown;
-}, {
-    runId: string;
-}, "rpc" | "session", import("../../types/application-types.js").Services> | import("../../.pikku/pikku-types.gen.js").PikkuFunction<{
-    workflowName: string;
-    data?: unknown;
-}, {
-    runId: string;
-}, "rpc" | "session", import("../../types/application-types.js").Services>, undefined, undefined>;
-export declare const workflowRunner: import("../../.pikku/pikku-types.gen.js").PikkuFunctionConfig<{
-    workflowName: string;
-    data?: unknown;
-}, unknown, "rpc" | "session", import("../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
-    workflowName: string;
-    data?: unknown;
-}, unknown, "rpc" | "session", import("../../types/application-types.js").Services> | import("../../.pikku/pikku-types.gen.js").PikkuFunction<{
-    workflowName: string;
-    data?: unknown;
-}, unknown, "rpc" | "session", import("../../types/application-types.js").Services>, undefined, undefined>;
-export declare const workflowStatusChecker: import("../../.pikku/pikku-types.gen.js").PikkuFunctionConfig<{
-    workflowName: string;
-    runId: string;
-}, WorkflowRunStatus, "rpc" | "session", import("../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
-    workflowName: string;
-    runId: string;
-}, WorkflowRunStatus, "rpc" | "session", import("../../types/application-types.js").Services> | import("../../.pikku/pikku-types.gen.js").PikkuFunction<{
-    workflowName: string;
-    runId: string;
-}, WorkflowRunStatus, "rpc" | "session", import("../../types/application-types.js").Services>, undefined, undefined>;
-/**
- * Minimal workflow status stream — sends step names and statuses only.
- * Use this for user-facing frontends where internal details should not be exposed.
- */
-export declare const workflowStatusStream: import("../../.pikku/pikku-types.gen.js").PikkuFunctionConfig<{
-    workflowName: string;
-    runId: string;
-}, unknown, "rpc" | "session", import("../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
-    workflowName: string;
-    runId: string;
-}, unknown, "rpc" | "session", import("../../types/application-types.js").Services> | import("../../.pikku/pikku-types.gen.js").PikkuFunction<{
-    workflowName: string;
-    runId: string;
-}, unknown, "rpc" | "session", import("../../types/application-types.js").Services>, undefined, undefined>;
-/**
- * Full workflow status stream — includes output, error, and child run IDs.
- * Use this for admin consoles and internal tooling.
- */
-export declare const workflowStatusStreamFull: import("../../.pikku/pikku-types.gen.js").PikkuFunctionConfig<{
-    workflowName: string;
-    runId: string;
-}, unknown, "rpc" | "session", import("../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
-    workflowName: string;
-    runId: string;
-}, unknown, "rpc" | "session", import("../../types/application-types.js").Services> | import("../../.pikku/pikku-types.gen.js").PikkuFunction<{
-    workflowName: string;
-    runId: string;
-}, unknown, "rpc" | "session", import("../../types/application-types.js").Services>, undefined, undefined>;
-export declare const graphStarter: import("../../.pikku/pikku-types.gen.js").PikkuFunctionConfig<{
-    workflowName: string;
-    nodeId: string;
-    data?: unknown;
-}, {
-    runId: string;
-}, "rpc" | "session", import("../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
-    workflowName: string;
-    nodeId: string;
-    data?: unknown;
-}, {
-    runId: string;
-}, "rpc" | "session", import("../../types/application-types.js").Services> | import("../../.pikku/pikku-types.gen.js").PikkuFunction<{
-    workflowName: string;
-    nodeId: string;
-    data?: unknown;
-}, {
-    runId: string;
-}, "rpc" | "session", import("../../types/application-types.js").Services>, undefined, undefined>;

package/dist/src/scaffold/workflow-routes.gen.js DELETED Viewed

@@ -1,229 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.12.21
- */
-/**
- * Workflow HTTP catch-all routes
- * Do not edit manually - regenerate with 'npx pikku'
- */
-import { pikkuSessionlessFunc, wireHTTPRoutes } from '../../.pikku/pikku-types.gen.js';
-import { MissingServiceError } from '@pikku/core/errors';
-function assertWorkflowService(workflowService) {
-    if (!workflowService)
-        throw new MissingServiceError('workflowService is required');
-}
-function assertWorkflowRunService(workflowRunService) {
-    if (!workflowRunService)
-        throw new MissingServiceError('workflowRunService is required');
-}
-export const workflowStarter = pikkuSessionlessFunc({
-    auth: false,
-    func: async (_services, { workflowName, data }, { rpc }) => {
-        return await rpc.startWorkflow(workflowName, (data ?? {}));
-    },
-});
-export const workflowRunner = pikkuSessionlessFunc({
-    auth: false,
-    func: async ({ workflowService }, { workflowName, data }, { rpc }) => {
-        assertWorkflowService(workflowService);
-        return await workflowService.runToCompletion(workflowName, (data ?? {}), rpc);
-    },
-});
-export const workflowStatusChecker = pikkuSessionlessFunc({
-    auth: false,
-    func: async ({ workflowService }, { runId }) => {
-        assertWorkflowService(workflowService);
-        const status = await workflowService.getRunStatus(runId);
-        if (!status)
-            throw new Error(`Run not found: ${runId}`);
-        return status;
-    },
-});
-/**
- * Minimal workflow status stream — sends step names and statuses only.
- * Use this for user-facing frontends where internal details should not be exposed.
- */
-export const workflowStatusStream = pikkuSessionlessFunc({
-    auth: false,
-    func: async ({ workflowRunService }, { runId }, { channel }) => {
-        assertWorkflowRunService(workflowRunService);
-        if (!channel)
-            return;
-        const terminalStatuses = new Set(['completed', 'failed', 'cancelled']);
-        let lastHash = '';
-        let initSent = false;
-        const poll = async () => {
-            const run = await workflowRunService.getRun(runId);
-            if (!run) {
-                channel.close();
-                return false;
-            }
-            const steps = await workflowRunService.getRunSteps(runId);
-            if (!initSent && run.deterministic) {
-                const statusByStep = new Map(steps.map((s) => [
-                    s.stepName,
-                    s.status,
-                ]));
-                channel.send({
-                    type: 'init',
-                    deterministic: true,
-                    steps: (run.plannedSteps ?? []).map((s) => ({
-                        stepName: s.stepName,
-                        status: statusByStep.get(s.stepName) ?? 'pending',
-                    })),
-                });
-                initSent = true;
-            }
-            const hash = JSON.stringify({
-                s: run.status,
-                steps: steps.map((s) => [s.stepName, s.status]),
-            });
-            if (hash !== lastHash) {
-                lastHash = hash;
-                channel.send({
-                    type: 'update',
-                    status: run.status,
-                    steps: steps.map((s) => ({
-                        stepName: s.stepName,
-                        status: s.status,
-                    })),
-                });
-            }
-            if (terminalStatuses.has(run.status)) {
-                channel.send({ type: 'done' });
-                channel.close();
-                return false;
-            }
-            return true;
-        };
-        const shouldContinue = await poll();
-        if (!shouldContinue)
-            return;
-        await new Promise((resolve) => {
-            const interval = setInterval(async () => {
-                const cont = await poll();
-                if (!cont) {
-                    clearInterval(interval);
-                    resolve();
-                }
-            }, 500);
-        });
-    },
-});
-/**
- * Full workflow status stream — includes output, error, and child run IDs.
- * Use this for admin consoles and internal tooling.
- */
-export const workflowStatusStreamFull = pikkuSessionlessFunc({
-    auth: false,
-    func: async ({ workflowRunService }, { runId }, { channel }) => {
-        assertWorkflowRunService(workflowRunService);
-        if (!channel)
-            return;
-        const terminalStatuses = new Set(['completed', 'failed', 'cancelled']);
-        let lastHash = '';
-        let initSent = false;
-        const poll = async () => {
-            const run = await workflowRunService.getRun(runId);
-            if (!run) {
-                channel.close();
-                return false;
-            }
-            const steps = await workflowRunService.getRunSteps(runId);
-            if (!initSent && run.deterministic) {
-                const statusByStep = new Map(steps.map((s) => [
-                    s.stepName,
-                    s.status,
-                ]));
-                channel.send({
-                    type: 'init',
-                    deterministic: true,
-                    steps: (run.plannedSteps ?? []).map((s) => ({
-                        stepName: s.stepName,
-                        status: statusByStep.get(s.stepName) ?? 'pending',
-                    })),
-                });
-                initSent = true;
-            }
-            const hash = JSON.stringify({
-                s: run.status,
-                o: run.output,
-                steps: steps.map((s) => [s.stepName, s.status]),
-            });
-            if (hash !== lastHash) {
-                lastHash = hash;
-                channel.send({
-                    type: 'update',
-                    status: run.status,
-                    output: run.output,
-                    error: run.error,
-                    steps: steps.map((s) => ({
-                        stepName: s.stepName,
-                        status: s.status,
-                        ...(s.childRunId ? { childRunId: s.childRunId } : {}),
-                    })),
-                });
-            }
-            if (terminalStatuses.has(run.status)) {
-                channel.send({ type: 'done' });
-                channel.close();
-                return false;
-            }
-            return true;
-        };
-        const shouldContinue = await poll();
-        if (!shouldContinue)
-            return;
-        await new Promise((resolve) => {
-            const interval = setInterval(async () => {
-                const cont = await poll();
-                if (!cont) {
-                    clearInterval(interval);
-                    resolve();
-                }
-            }, 500);
-        });
-    },
-});
-export const graphStarter = pikkuSessionlessFunc({
-    auth: false,
-    func: async (_services, { workflowName, nodeId, data }, { rpc }) => {
-        return await rpc.startWorkflow(workflowName, (data ?? {}), { startNode: nodeId });
-    },
-});
-wireHTTPRoutes({
-    auth: false,
-    routes: {
-        workflowStart: {
-            route: '/workflow/:workflowName/start',
-            method: 'post',
-            func: workflowStarter,
-        },
-        workflowRun: {
-            route: '/workflow/:workflowName/run',
-            method: 'post',
-            func: workflowRunner,
-        },
-        workflowStatus: {
-            route: '/workflow/:workflowName/status/:runId',
-            method: 'get',
-            func: workflowStatusChecker,
-        },
-        workflowStatusStream: {
-            route: '/workflow/:workflowName/status/:runId/stream',
-            method: 'get',
-            sse: true,
-            func: workflowStatusStream,
-        },
-        workflowStatusStreamFull: {
-            route: '/workflow/:workflowName/status/:runId/stream/full',
-            method: 'get',
-            sse: true,
-            func: workflowStatusStreamFull,
-        },
-        graphStart: {
-            route: '/workflow/:workflowName/graph/:nodeId',
-            method: 'post',
-            func: graphStarter,
-        },
-    },
-});