@askrjs/cli 0.0.2

package/dist/templates/startkit/src/styles/tokens.css

@@ -0,0 +1,67 @@
+@layer tokens {
+  :root {
+    --ak-color-primary: #2166ee;
+    --ak-color-primary-hover: #154fbf;
+    --ak-color-bg: #f7f8fa;
+    --ak-color-fg: #0f1728;
+    --ak-color-surface: #ffffff;
+    --ak-color-surface-muted: #f1f3f7;
+    --ak-color-border: #dde2ea;
+    --ak-color-muted: #5a6578;
+    --ak-color-danger: #b03a3a;
+    --ak-color-focus-ring: rgba(33, 102, 238, 0.24);
+
+    --ak-space-2xs: 0.25rem;
+    --ak-space-lg-plus: 1.25rem;
+    --ak-space-2xl: 2rem;
+
+    --ak-font-size-xs: 0.75rem;
+    --ak-font-size-xl: 1.25rem;
+    --ak-font-size-2xl: 2rem;
+
+    --starter-color-success: #1f7a43;
+    --starter-content-max-ch: 74ch;
+    --starter-shadow-soft: 0 10px 30px rgba(13, 24, 43, 0.08);
+    --starter-shadow-press: 0 4px 14px rgba(13, 24, 43, 0.1);
+    --starter-surface-glass: color-mix(
+      in srgb,
+      var(--ak-color-surface) 88%,
+      transparent
+    );
+  }
+
+  :root[data-sk-appearance='harbor'] {
+    --ak-color-primary: #0f7b8f;
+    --ak-color-primary-hover: #0d6171;
+    --ak-color-bg: #eff5f8;
+    --ak-color-fg: #102736;
+    --ak-color-surface: #f9fcfe;
+    --ak-color-surface-muted: #e8f0f5;
+    --ak-color-border: #cedce8;
+    --ak-color-muted: #4f6879;
+    --ak-color-focus-ring: rgba(15, 123, 143, 0.24);
+    --starter-color-success: #0f7a4b;
+    --starter-shadow-soft: 0 10px 30px rgba(8, 34, 45, 0.08);
+    --starter-shadow-press: 0 4px 14px rgba(8, 34, 45, 0.1);
+  }
+
+  :root[data-sk-appearance='ink'] {
+    --ak-color-primary: #6fa6ff;
+    --ak-color-primary-hover: #4a89ee;
+    --ak-color-bg: #151a22;
+    --ak-color-fg: #e7eefc;
+    --ak-color-surface: #1c2230;
+    --ak-color-surface-muted: #252e41;
+    --ak-color-border: #334055;
+    --ak-color-muted: #aeb9d2;
+    --ak-color-focus-ring: rgba(111, 166, 255, 0.3);
+    --starter-color-success: #58c38a;
+    --starter-shadow-soft: 0 12px 32px rgba(0, 0, 0, 0.3);
+    --starter-shadow-press: 0 5px 16px rgba(0, 0, 0, 0.34);
+    --starter-surface-glass: color-mix(
+      in srgb,
+      var(--ak-color-surface) 78%,
+      transparent
+    );
+  }
+}

package/dist/templates/startkit/src/styles.css

@@ -0,0 +1,7 @@
+@layer reset, tokens, theme, layout, components;
+
+@import './styles/reset.css';
+@import './styles/tokens.css';
+@import './styles/theme.css';
+@import './styles/layout.css';
+@import './styles/components.css';

package/dist/templates/startkit/src/toast.ts

@@ -0,0 +1,55 @@
+export type AppToast = {
+  title: string;
+  description?: string;
+};
+
+type ToastBindings = {
+  setMessage: (message: AppToast | null) => void;
+  setOpen: (open: boolean) => void;
+};
+
+let toastMessageValue: AppToast | null = null;
+let toastOpenValue = false;
+let toastBindings: ToastBindings | null = null;
+
+export function bindToast(bindings: ToastBindings) {
+  toastBindings = bindings;
+}
+
+export function toastMessage() {
+  return toastMessageValue;
+}
+
+export function toastOpen() {
+  return toastOpenValue;
+}
+
+function syncToastBindings() {
+  if (!toastBindings) {
+    return;
+  }
+
+  toastBindings.setMessage(toastMessageValue);
+  toastBindings.setOpen(toastOpenValue);
+}
+
+export function setToastMessage(message: AppToast | null) {
+  toastMessageValue = message;
+  syncToastBindings();
+}
+
+export function setToastOpen(open: boolean) {
+  toastOpenValue = open;
+  syncToastBindings();
+}
+
+export function showToast(message: AppToast) {
+  setToastMessage(message);
+  setToastOpen(false);
+  queueMicrotask(() => setToastOpen(true));
+}
+
+export function clearToast() {
+  setToastOpen(false);
+  setToastMessage(null);
+}

package/dist/templates/startkit/src/utils/join-classes.ts

@@ -0,0 +1,4 @@
+/** Merge class name strings, dropping any empty/undefined values. */
+export function joinClasses(...parts: Array<string | undefined>): string {
+  return parts.filter(Boolean).join(' ');
+}

package/dist/templates/startkit/src/vite-env.d.ts

@@ -0,0 +1,5 @@
+declare module '*.css' {
+  const css: string;
+
+  export default css;
+}

package/dist/templates/startkit/tests/app.test.tsx

@@ -0,0 +1,32 @@
+import { describe, it, expect } from 'vite-plus/test';
+
+describe('App Component', () => {
+  it('exposes the current starter route set', () => {
+    const routes = [
+      '/',
+      '/login',
+      '/dashboard',
+      '/accounts',
+      '/settings',
+      '/*',
+    ];
+
+    expect(routes).toContain('/settings');
+    expect(routes).toContain('/accounts');
+    expect(routes).toContain('/login');
+  });
+
+  it('uses the updated primary nav labels', () => {
+    const navLabels = ['Dashboard', 'Accounts', 'Settings'];
+
+    expect(navLabels).toContain('Accounts');
+    expect(navLabels).toContain('Settings');
+  });
+
+  it('documents the starter appearance presets', () => {
+    const appearanceModes = ['Default', 'Harbor', 'Ink'];
+
+    expect(appearanceModes).toContain('Harbor');
+    expect(appearanceModes).toContain('Ink');
+  });
+});

package/dist/templates/startkit/tests/preferences.test.ts

@@ -0,0 +1,43 @@
+import { beforeEach, describe, expect, it } from 'vite-plus/test';
+import {
+  appearanceMode,
+  initializeAppSession,
+  nextAppearance,
+  resetAppearancePreference,
+  setAppearance,
+} from '../src/lib/mock-data';
+
+describe('appearance preferences', () => {
+  beforeEach(() => {
+    const values = new Map<string, string>();
+    Object.defineProperty(window, 'localStorage', {
+      configurable: true,
+      value: {
+        clear: () => values.clear(),
+        getItem: (key: string) => values.get(key) ?? null,
+        key: (index: number) => [...values.keys()][index] ?? null,
+        get length() {
+          return values.size;
+        },
+        removeItem: (key: string) => values.delete(key),
+        setItem: (key: string, value: string) => values.set(key, value),
+      },
+    });
+    resetAppearancePreference();
+  });
+
+  it('should persist and apply selected appearance', () => {
+    setAppearance('harbor');
+    initializeAppSession();
+
+    expect(appearanceMode()).toBe('harbor');
+    expect(document.documentElement.dataset.skAppearance).toBe('harbor');
+    expect(window.localStorage.getItem('startkit:appearance')).toBe('harbor');
+  });
+
+  it('should cycle appearance modes in stable order', () => {
+    expect(nextAppearance('default')).toBe('harbor');
+    expect(nextAppearance('harbor')).toBe('ink');
+    expect(nextAppearance('ink')).toBe('default');
+  });
+});

package/dist/templates/startkit/tests/resources.test.ts

@@ -0,0 +1,82 @@
+import { beforeEach, describe, expect, it } from 'vite-plus/test';
+import {
+  archiveAccounts,
+  getDashboardData,
+  isAuthenticated,
+  listAccounts,
+  resetMockData,
+  signIn,
+  signOut,
+} from '../src/lib/mock-data';
+
+describe('lib mock data', () => {
+  beforeEach(() => {
+    resetMockData();
+  });
+
+  it('should return dashboard stats and activities', async () => {
+    const result = await getDashboardData({
+      signal: new AbortController().signal,
+    });
+
+    expect(result.stats.length).toBeGreaterThan(0);
+    expect(result.activities.length).toBeGreaterThan(0);
+  });
+
+  it('should filter and paginate accounts', async () => {
+    const result = await listAccounts({
+      signal: new AbortController().signal,
+      query: 'northwind',
+      status: 'all',
+      page: 1,
+      pageSize: 5,
+    });
+
+    expect(result.items.length).toBeGreaterThan(0);
+    expect(result.items[0]?.name.toLowerCase()).toContain('northwind');
+    expect(result.totalPages).toBeGreaterThanOrEqual(1);
+  });
+
+  it('should archive selected accounts', async () => {
+    const before = await listAccounts({
+      signal: new AbortController().signal,
+      query: '',
+      status: 'active',
+      page: 1,
+      pageSize: 20,
+    });
+
+    const ids = before.items.slice(0, 2).map((item) => item.id);
+    const archiveResult = await archiveAccounts({
+      ids,
+      signal: new AbortController().signal,
+    });
+
+    expect(archiveResult.archived).toBe(2);
+
+    const after = await listAccounts({
+      signal: new AbortController().signal,
+      query: '',
+      status: 'archived',
+      page: 1,
+      pageSize: 20,
+    });
+
+    expect(after.items.some((item) => ids.includes(item.id))).toBe(true);
+  });
+
+  it('should sign in and sign out session state', async () => {
+    expect(isAuthenticated()).toBe(false);
+
+    await signIn({
+      email: 'alex@example.com',
+      password: 'askr1234',
+      signal: new AbortController().signal,
+    });
+
+    expect(isAuthenticated()).toBe(true);
+
+    signOut();
+    expect(isAuthenticated()).toBe(false);
+  });
+});

package/dist/templates/startkit/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "preserve",
+    "jsxImportSource": "@askrjs/askr"
+  },
+  "include": ["src"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

package/dist/templates/startkit/tsconfig.node.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["vite.config.ts", "vitest.config.ts"]
+}

package/dist/templates/startkit/vite.config.ts

@@ -0,0 +1,32 @@
+import { defineConfig } from 'vite-plus';
+import { askr } from '@askrjs/vite';
+
+export default defineConfig({
+  plugins: [askr()],
+  lint: {
+    ignorePatterns: ['dist/**', 'node_modules/**', 'coverage/**'],
+  },
+  fmt: {
+    semi: true,
+    singleQuote: true,
+    trailingComma: 'es5',
+    printWidth: 80,
+    tabWidth: 2,
+  },
+  server: {
+    host: '127.0.0.1',
+    port: 5173,
+    strictPort: true,
+    open: true,
+    hmr: {
+      host: '127.0.0.1',
+      port: 5173,
+      clientPort: 5173,
+      protocol: 'ws',
+    },
+  },
+  build: {
+    outDir: 'dist',
+    sourcemap: true,
+  },
+});

package/dist/templates/startkit/vitest.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'vite-plus';
+import { askr } from '@askrjs/vite';
+
+export default defineConfig({
+  plugins: [askr()],
+  test: {
+    environment: 'jsdom',
+    globals: true,
+    coverage: {
+      reporter: ['text', 'json', 'html'],
+    },
+  },
+});