@captain_z/zsk 1.8.4 → 1.8.6

package/dist/commands/config.js

@@ -40,8 +40,9 @@ export async function setup(opts = {}) {
     console.log(pc.dim(`config: ${result.configFile}`));
     console.log([
         "",
-        "Give your AI assistant the local paths, materialized snapshots, or remote/provider references for SRS, PRD, design assets/sources, API contracts, management-system records, and test cases.",
-        "The assistant should update .zsk/config.yaml sources under grouped prepare lanes such as sources.prepare.product/backend/design/ux/qa or project-defined lanes, with type, origin, and optional snapshot fields under paths.raws, then run zsk config check or zsk config draft.",
+        "Give your AI assistant the stable entry links or local paths for SRS, PRD, design sources, API contracts, management-system feeds, and test cases.",
+        "Configure each platform provider once. Keep .zsk/config.yaml focused on durable entry sources, not every discovered child page, node, issue, or file.",
+        "For discovered candidates, run zsk prepare draft or zsk prepare plan and review config-draft.yaml plus source-promotion-suggestions.md. Apply selected entries to .zsk/config.yaml only after human confirmation, then run zsk config check.",
     ].join("\n"));
 }
 export async function draft(opts = {}) {
@@ -106,7 +107,7 @@ export async function eject(part, opts = {}) {
     for (const warning of result.warnings) {
         console.warn(pc.yellow(`! ${warning.file}: ${warning.message}`));
     }
-    const blockingIssues = result.issues.filter((issue) => !(parts.includes("roles") && issue.path === "/customize/roles"));
+    const blockingIssues = result.issues.filter((issue) => !(parts.includes("roles") && (issue.path === "/customize/roles" || issue.path === "/staffing/rolePool")));
     if (blockingIssues.length > 0) {
         console.error(pc.red("✗ zsk config eject stopped: config check failed"));
         console.error(formatConfigIssues(blockingIssues));

package/dist/commands/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}

package/dist/commands/demo.d.ts

@@ -12,6 +12,10 @@ export type McpConfigOptions = {
     target?: string;
     write?: boolean;
 };
+export type DemoAuthOptions = DemoOptions & {
+    url?: string;
+    out?: string;
+};
 export type DemoRunOptions = DemoOptions & {
     optimized?: boolean;
     playwright?: boolean;
@@ -30,3 +34,4 @@ export declare function scenarioRecord(opts?: DemoOptions): Promise<void>;
 export declare function scenarioPromote(opts?: DemoOptions): Promise<void>;
 export declare function scenarioGenerate(opts?: ScenarioGenerateOptions): Promise<void>;
 export declare function mcpConfig(opts?: McpConfigOptions): Promise<void>;
+export declare function auth(opts?: DemoAuthOptions): Promise<void>;

package/dist/commands/demo.js

@@ -1,9 +1,13 @@
 import pc from "picocolors";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
+import { dirname, join, relative, resolve } from "node:path";
 import YAML from "yaml";
 import { resolvePath } from "../core/targets.js";
 import { checkProjectConfig, findModuleConfigFiles, readProjectConfig, } from "../core/config.js";
+import { renderDemoLoginHelper, resolveDemoAuthConfig, validatePlaywrightAuthState, } from "../core/demo-auth.js";
+import { collectDemoSourceBasis, summarizeText, testCasePathsFromModule, } from "../core/demo-sources.js";
+import { escapeForDoubleQuotedString, inferScenarioName, parseRoleTargets, renderOptimizedSpec, slugify, synthesizeOptimizedDemoCases, synthesizePlaywrightSteps, } from "../core/demo-scenarios.js";
+import { resolvePlaywrightAuthStatePath } from "../core/workspace-conformance.js";
 import { getWorkspacePath, interpolateModulePath } from "../core/workspace-layout.js";
 export async function start(opts = {}) {
     const ctx = await prepare(opts);
@@ -85,7 +89,11 @@ export async function run(opts = {}) {
     await persistSession(ctx, session);
     console.log(pc.green(`✓ zsk demo run prepared (${mode})`));
     if (mode === "optimized") {
-        console.log(pc.dim("optimized: raw testing inputs -> test-plan.json -> Playwright spec; no MCP or bridge fallback."));
+        console.log(pc.dim("optimized: source-backed inputs -> test-plan.json -> Playwright spec; no MCP or bridge fallback."));
+        if (ctx.demoAuth.required && session.auth?.status === "missing") {
+            console.log(pc.yellow(`! demo auth state missing: ${session.auth.storageState}`));
+            console.log(pc.dim(`  run once with ZSK_DEMO_LOGIN=1, or run zsk demo auth -m ${ctx.moduleId} and execute the generated helper; set automation.demo.auth.required=false only for public flows.`));
+        }
     }
     if (mode === "computer-use") {
         console.log(pc.yellow("! Computer Use is the preferred visual/system observation lane when available; record fallback if the runtime does not provide it."));
@@ -228,6 +236,33 @@ export async function mcpConfig(opts = {}) {
     }
     console.log(content);
 }
+export async function auth(opts = {}) {
+    const ctx = await prepare(opts);
+    const moduleConfig = await readModuleConfig(ctx.target, ctx.moduleId);
+    let statePath;
+    try {
+        statePath = resolvePlaywrightAuthStatePath(ctx.target, ctx.config, opts.out ?? ctx.demoAuth.storageState);
+    }
+    catch {
+        console.error(pc.red("✗ zsk demo auth stopped: storageState must stay under module or shared Playwright .auth"));
+        process.exit(1);
+    }
+    const scriptPath = join(dirname(statePath), "login.mjs");
+    const loginUrl = opts.url ?? ctx.demoAuth.loginUrl ?? moduleConfig.runtime?.url ?? "";
+    const script = renderDemoLoginHelper({
+        loginUrl,
+        storageState: statePath,
+        envFiles: ctx.demoAuth.envFiles,
+        env: ctx.demoAuth.env,
+        selectors: ctx.demoAuth.selectors,
+    });
+    await mkdir(dirname(statePath), { recursive: true });
+    await writeFile(scriptPath, script, "utf8");
+    console.log(pc.green("✓ zsk demo auth helper written"));
+    console.log(pc.dim(`script: ${relative(ctx.target, scriptPath)}`));
+    console.log(pc.dim(`storageState: ${relative(ctx.target, statePath)}`));
+    console.log(pc.dim("Run the helper once after installing Playwright, then reuse the stored state in generated demo specs."));
+}
 async function updateExisting(opts, status, eventType, terminal = false) {
     const ctx = await prepare(opts);
     const session = await requireSession(ctx);
@@ -263,6 +298,7 @@ async function prepare(opts) {
     const scenarioDir = interpolate(demoConfig?.scenarioDir ?? getWorkspacePath(config, "playwrightSpecs", { module: moduleId }), moduleId);
     const bridgePlan = interpolate(demoConfig?.bridge?.planFile ?? getWorkspacePath(config, "bridgeOperationPlan", { module: moduleId }), moduleId);
     const bridgeExecution = interpolate(demoConfig?.bridge?.executionFile ?? getWorkspacePath(config, "bridgeExecution", { module: moduleId }), moduleId);
+    const demoAuth = resolveDemoAuthConfig(config, moduleId);
     const sessionRoot = resolve(target, getWorkspacePath(config, "playwrightExecution", { module: moduleId }));
     await mkdir(sessionRoot, { recursive: true });
     await mkdir(resolve(target, evidenceDir), { recursive: true });
@@ -277,7 +313,8 @@ async function prepare(opts) {
         evidenceDirAbs: resolve(target, evidenceDir),
         scenarioDir,
         scenarioDirAbs: resolve(target, scenarioDir),
-        playwrightAuthState: getWorkspacePath(config, "playwrightAuthState", { module: moduleId }),
+        playwrightAuthState: demoAuth.storageState,
+        demoAuth,
         defaultMode: normalizeMode(demoConfig?.defaultMode),
         bridge: {
             decisionTool: demoConfig?.bridge?.decisionTool ?? (demoConfig?.computerUse?.enabled ? "computer_use" : "playwright_mcp"),
@@ -364,13 +401,11 @@ async function ensureBridgeArtifacts(ctx, session) {
 }
 async function ensureOptimizedArtifacts(ctx, session) {
     const moduleConfig = await readModuleConfig(ctx.target, ctx.moduleId);
-    const rawInputs = [
-        ...(moduleConfig.tests?.raw_cases ?? []),
-        ...((moduleConfig.tests?.raw_cases?.length ?? 0) > 0 ? [] : (moduleConfig.sources?.testing ?? [])),
-    ];
-    if (rawInputs.length === 0) {
-        console.error(pc.red("✗ optimized demo stopped: no raw testing inputs mapped"));
-        console.error(pc.dim("Add .zsk/raws/prepare/qa/testing cases to .zsk/modules/{module}/module.yaml tests.raw_cases or sources.testing."));
+    const sourceBasis = await collectDemoSourceBasis(ctx.target, ctx.config, ctx.moduleId, moduleConfig);
+    const rawInputs = testCasePathsFromModule(moduleConfig);
+    if (sourceBasis.length === 0) {
+        console.error(pc.red("✗ optimized demo stopped: no source-backed demo inputs mapped"));
+        console.error(pc.dim("Add module spec/design/tasks docs, .zsk/raws test cases, existing tests, or implementation paths to .zsk/modules/{module}/module.yaml."));
         process.exit(1);
     }
     const testPlanRel = chooseTestPlanPath(moduleConfig, ctx.scenarioDir);
@@ -383,86 +418,12 @@ async function ensureOptimizedArtifacts(ctx, session) {
         process.exit(1);
     }
     session.auth = authValidation;
-    const cases = [];
-    for (const rawInput of rawInputs) {
-        const rawPath = resolve(ctx.target, rawInput);
-        const content = await readOptional(rawPath);
-        if (!content.trim()) {
-            console.error(pc.red(`✗ optimized demo stopped: raw testing input is empty or missing: ${rawInput}`));
-            process.exit(1);
-        }
-        const title = inferScenarioName(content) ?? rawInput.split("/").pop()?.replace(/\.[^.]+$/, "") ?? "generated case";
-        const fillValue = inferFillValue(content);
-        const expectedText = inferExpectedText(content, fillValue);
-        const caseId = slugify(`${ctx.moduleId}-${title}`);
-        const steps = [
-            {
-                id: "step-1",
-                intent: "Open the demo entry page",
-                action: "goto",
-                target: "{{baseUrl}}",
-            },
-            {
-                id: "step-2",
-                intent: "Perform the primary user input from the raw test case",
-                action: "fill",
-                locator: {
-                    strategy: "role",
-                    role: "textbox",
-                },
-                value: fillValue,
-            },
-            {
-                id: "step-3",
-                intent: "Submit or advance the flow",
-                action: "click",
-                locator: {
-                    strategy: "role",
-                    role: "button",
-                },
-            },
-            {
-                id: "step-4",
-                intent: "Verify the expected visible result",
-                action: "assert",
-                locator: {
-                    strategy: "text",
-                    text: expectedText,
-                },
-            },
-        ];
-        cases.push({
-            id: caseId,
-            title,
-            source: rawInput,
-            priority: "P0",
-            preconditions: [
-                "Raw test case is mapped in module.yaml.",
-                `If authentication is required, Playwright storageState is prepared under ${ctx.playwrightAuthState} and gitignored.`,
-                "Computer Use observation is preferred for visual/current-page refinement when available; otherwise use Playwright MCP/ARIA/CDP, manual evidence, or Browser Use only in runtimes that support it.",
-            ],
-            uiObservationBoundary: {
-                role: "observation-only",
-                allowedOutput: "structured observation with URL, page title, visible targets, role/label hints, auth/session note, and privacy note",
-                prohibitedOutputs: ["test-plan.json", ".spec.ts"],
-            },
-            steps,
-            assertions: [
-                {
-                    intent: "Expected result from raw test case is visible",
-                    type: "visible",
-                    locator: {
-                        strategy: "text",
-                        text: expectedText,
-                    },
-                },
-            ],
-            risks: [
-                "Generated locator names must be refined from Computer Use, Playwright MCP/ARIA/CDP, manual evidence, or supported Browser Use observation before promotion.",
-                "Do not fall back to Playwright MCP or the hybrid bridge in optimized mode.",
-            ],
-        });
-    }
+    const cases = synthesizeOptimizedDemoCases({
+        moduleId: ctx.moduleId,
+        sourceBasis,
+        runtimeUrl: moduleConfig.runtime?.url,
+        playwrightAuthState: ctx.playwrightAuthState,
+    });
     await writeJson(resolve(ctx.target, testPlanRel), {
         version: 1,
         mode: "optimized",
@@ -473,15 +434,31 @@ async function ensureOptimizedArtifacts(ctx, session) {
         forbiddenSurfaces: ["playwright_mcp", "hybrid_bridge"],
         sources: {
             testing: rawInputs,
+            stageDocs: sourceBasis.filter((source) => source.kind === "stage-doc").map((source) => source.path),
+            raws: sourceBasis.filter((source) => source.kind === "raw").map((source) => source.path),
+            existingTests: sourceBasis.filter((source) => source.kind === "existing-test").map((source) => source.path),
+            implementation: sourceBasis.filter((source) => source.kind === "implementation").map((source) => source.path),
         },
+        sourceBasis: sourceBasis.map((source) => ({
+            kind: source.kind,
+            path: source.path,
+            summary: summarizeText(source.content),
+        })),
         auth: {
             storageState: ctx.playwrightAuthState,
+            required: ctx.demoAuth.required,
+            loginUrl: ctx.demoAuth.loginUrl,
+            envFiles: ctx.demoAuth.envFiles,
+            envKeys: ctx.demoAuth.env,
+            selectors: ctx.demoAuth.selectors,
             validation: authValidation,
             gitignoreRequired: true,
             runtimeEnv: "ZSK_PLAYWRIGHT_STORAGE_STATE",
             note: authValidation.status === "valid"
                 ? "Storage state was validated as a reusable Playwright login/session state. It may contain sensitive cookies/localStorage and must not be committed."
-                : "No reusable storageState file was found. Public demos may proceed; authenticated demos must capture and validate storageState before completion.",
+                : ctx.demoAuth.required
+                    ? "No reusable storageState file was found. Generated specs fail fast by default; run once with ZSK_DEMO_LOGIN=1 or use zsk demo auth, and set automation.demo.auth.required=false only for public flows."
+                    : "Auth is configured as not required; generated specs run without storageState unless ZSK_DEMO_AUTH overrides it.",
         },
         uiObservationHandoff: {
             requiredBeforePromotion: true,
@@ -504,7 +481,7 @@ async function ensureOptimizedArtifacts(ctx, session) {
     });
     const specPath = resolve(ctx.target, specRel);
     await mkdir(resolve(specPath, ".."), { recursive: true });
-    await writeFile(specPath, renderOptimizedSpec(ctx.moduleId, cases), "utf8");
+    await writeFile(specPath, renderOptimizedSpec(ctx.moduleId, ctx.demoAuth, cases), "utf8");
     console.log(pc.dim(`test plan: ${testPlanRel}`));
     console.log(pc.dim(`spec: ${specRel}`));
 }
@@ -529,108 +506,6 @@ function chooseSpecPath(moduleConfig, scenarioDir, moduleId) {
         return e2e;
     return join(e2e ?? scenarioDir, `${moduleId}-generated.spec.ts`);
 }
-function renderOptimizedSpec(moduleId, cases) {
-    const lines = [
-        `import { test, expect } from "@playwright/test";`,
-        ``,
-        `const storageState = process.env.ZSK_PLAYWRIGHT_STORAGE_STATE;`,
-        `if (storageState) test.use({ storageState });`,
-        ``,
-        `test.describe("${escapeForDoubleQuotedString(moduleId)} optimized demo scenarios", () => {`,
-    ];
-    for (const testCase of cases) {
-        const fill = testCase.steps.find((step) => step.action === "fill");
-        const click = testCase.steps.find((step) => step.action === "click");
-        const assertion = testCase.steps.find((step) => step.action === "assert");
-        lines.push(`  test("${escapeForDoubleQuotedString(testCase.title)}", async ({ page }) => {`, `    const baseUrl = process.env.ZSK_DEMO_BASE_URL;`, `    if (!baseUrl) throw new Error("Set ZSK_DEMO_BASE_URL to run this scenario.");`, `    await page.goto(baseUrl);`, ``, `    // Source: ${escapeForLineComment(testCase.source)}`, `    // ZSK_GENERATED_REFINEMENT_REQUIRED: refine locator names from Computer Use, Playwright MCP/ARIA/CDP, manual evidence, or compatible Browser Use before promotion.`);
-        if (fill?.locator?.role && fill.value) {
-            lines.push(`    await ${renderRoleLocator(fill.locator.role, fill.locator.name)}.fill(${quote(fill.value)});`);
-        }
-        if (click?.locator?.role) {
-            lines.push(`    await ${renderRoleLocator(click.locator.role, click.locator.name)}.click();`);
-        }
-        if (assertion?.locator?.text) {
-            lines.push(`    await expect(page.getByText(${quote(assertion.locator.text)})).toBeVisible();`);
-        }
-        else {
-            lines.push(`    await expect(page).toHaveURL(/.+/);`);
-        }
-        lines.push(`  });`, ``);
-    }
-    lines.push(`});`, ``);
-    return lines.join("\n");
-}
-async function validatePlaywrightAuthState(target, storageState, validatedAt) {
-    const file = resolve(target, storageState);
-    let parsed;
-    try {
-        parsed = JSON.parse(await readFile(file, "utf8"));
-    }
-    catch (error) {
-        const code = typeof error === "object" && error !== null && "code" in error
-            ? String(error.code)
-            : "";
-        if (code === "ENOENT") {
-            return {
-                storageState,
-                status: "missing",
-                validatedAt,
-                cookies: 0,
-                origins: 0,
-                message: "storageState file does not exist yet",
-            };
-        }
-        return {
-            storageState,
-            status: "invalid",
-            validatedAt,
-            cookies: 0,
-            origins: 0,
-            message: "storageState file is not valid JSON",
-        };
-    }
-    if (!isRecord(parsed)) {
-        return {
-            storageState,
-            status: "invalid",
-            validatedAt,
-            cookies: 0,
-            origins: 0,
-            message: "storageState JSON must be an object",
-        };
-    }
-    const cookies = Array.isArray(parsed.cookies) ? parsed.cookies.length : -1;
-    const origins = Array.isArray(parsed.origins) ? parsed.origins.length : -1;
-    if (cookies < 0 || origins < 0) {
-        return {
-            storageState,
-            status: "invalid",
-            validatedAt,
-            cookies: Math.max(cookies, 0),
-            origins: Math.max(origins, 0),
-            message: "storageState must include Playwright cookies and origins arrays",
-        };
-    }
-    if (cookies === 0 && origins === 0) {
-        return {
-            storageState,
-            status: "invalid",
-            validatedAt,
-            cookies,
-            origins,
-            message: "storageState contains no cookies or localStorage origins, so it cannot prove reusable login/session credentials",
-        };
-    }
-    return {
-        storageState,
-        status: "valid",
-        validatedAt,
-        cookies,
-        origins,
-        message: "storageState is parseable and contains reusable session material",
-        loginBypassEvidence: "Generated Playwright specs can reuse this state through ZSK_PLAYWRIGHT_STORAGE_STATE.",
-    };
-}
 async function updateWorkflowState(file, moduleId, session) {
     let state = { version: 1, modules: {} };
     try {
@@ -687,7 +562,7 @@ function mapWorkflowStatus(status) {
 }
 function automationNote(mode) {
     if (mode === "optimized")
-        return "Generated test-plan.json and Playwright spec from raw testing inputs.";
+        return "Generated source-backed test-plan.json and Playwright spec with auth bootstrap.";
     if (mode === "playwright")
         return "Prepared Playwright demo run and scenario preservation paths.";
     if (mode === "hybrid")
@@ -730,109 +605,7 @@ async function readOptional(file) {
         return "";
     }
 }
-function parseRoleTargets(snapshot) {
-    const targets = [];
-    const rolePattern = /(?:^|\n)\s*-\s*(button|link|textbox|checkbox|heading|combobox|radio|menuitem)\s+"([^"]+)"/gi;
-    for (const match of snapshot.matchAll(rolePattern)) {
-        const role = normalizeRole(match[1] ?? "");
-        const name = (match[2] ?? "").trim();
-        if (!role || !name)
-            continue;
-        targets.push({ role, name });
-    }
-    return targets;
-}
-function synthesizePlaywrightSteps(targets, testCase) {
-    const steps = [];
-    const textbox = targets.find((target) => target.role === "textbox");
-    const button = targets.find((target) => target.role === "button");
-    const link = targets.find((target) => target.role === "link");
-    const checkbox = targets.find((target) => target.role === "checkbox");
-    const heading = targets.find((target) => target.role === "heading");
-    const fillValue = inferFillValue(testCase);
-    steps.push(`// Generated from test case and structured aria/accessibility snapshot.`);
-    if (textbox) {
-        steps.push(`await page.getByRole("textbox", { name: ${quote(textbox.name)} }).fill(${quote(fillValue)});`);
-    }
-    if (checkbox && shouldCheck(testCase)) {
-        steps.push(`await page.getByRole("checkbox", { name: ${quote(checkbox.name)} }).check();`);
-    }
-    if (button) {
-        steps.push(`await page.getByRole("button", { name: ${quote(button.name)} }).click();`);
-    }
-    else if (link) {
-        steps.push(`await page.getByRole("link", { name: ${quote(link.name)} }).click();`);
-    }
-    if (heading) {
-        steps.push(`await expect(page.getByRole("heading", { name: ${quote(heading.name)} })).toBeVisible();`);
-    }
-    else if (textbox || button || link || checkbox) {
-        steps.push(`await expect(page).toHaveURL(/.+/);`);
-    }
-    else {
-        steps.push(`// Provide a Playwright accessibility snapshot to synthesize role-first locators.`);
-        steps.push(`await expect(page).toHaveURL(/.+/);`);
-    }
-    return steps;
-}
-function renderRoleLocator(role, name) {
-    if (name)
-        return `page.getByRole(${quote(role)}, { name: ${quote(name)} })`;
-    return `page.getByRole(${quote(role)}).first()`;
-}
-function normalizeRole(role) {
-    if (role === "textbox")
-        return "textbox";
-    return role.toLowerCase();
-}
-function inferFillValue(testCase) {
-    const quoted = testCase.match(/["“”']([^"“”']{2,80})["“”']/);
-    if (quoted?.[1])
-        return quoted[1];
-    const afterInput = testCase.match(/(?:输入|type|fill|enter)\s*[:：]?\s*([^\n，,。]{2,80})/i);
-    if (afterInput?.[1])
-        return afterInput[1].trim();
-    return "demo value";
-}
-function shouldCheck(testCase) {
-    return /check|toggle|勾选|选中|切换/i.test(testCase);
-}
-function inferScenarioName(testCase) {
-    const heading = testCase.match(/^#\s+(.+)$/m);
-    if (heading?.[1])
-        return heading[1];
-    const title = testCase.match(/(?:title|标题|用例)[:：]\s*(.+)/i);
-    if (title?.[1])
-        return title[1];
-    return null;
-}
-function slugify(value) {
-    const slug = value
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "");
-    return slug || "generated-from-test-case";
-}
-function quote(value) {
-    return JSON.stringify(value);
-}
-function escapeForDoubleQuotedString(value) {
-    return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
-}
-function escapeForLineComment(value) {
-    return value.replace(/\*\//g, "* /").replace(/\n/g, " ");
-}
-function inferExpectedText(testCase, fallback) {
-    const expected = testCase.match(/(?:expect|should see|visible|断言|期望|显示|可见)\s*[:：]?\s*["“”']?([^"“”'\n。]{2,80})/i);
-    if (expected?.[1])
-        return expected[1].trim();
-    const quoted = [...testCase.matchAll(/["“”']([^"“”']{2,80})["“”']/g)].map((match) => match[1]).filter(Boolean);
-    return quoted.at(-1) ?? fallback;
-}
 function isModuleConfig(value) {
     return typeof value === "object" && value !== null;
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 //# sourceMappingURL=demo.js.map