libretto 0.2.6 → 0.3.0

package/dist/shared/run/browser.d.ts

@@ -1,22 +0,0 @@
-import { Browser, BrowserContext, Page } from 'playwright';
-
-type LaunchBrowserArgs = {
-    sessionName: string;
-    headless?: boolean;
-    viewport?: {
-        width: number;
-        height: number;
-    };
-    storageStatePath?: string;
-};
-type BrowserSession = {
-    browser: Browser;
-    context: BrowserContext;
-    page: Page;
-    debugPort: number;
-    metadataPath: string;
-    close: () => Promise<void>;
-};
-declare function launchBrowser({ sessionName, headless, viewport, storageStatePath, }: LaunchBrowserArgs): Promise<BrowserSession>;
-
-export { type BrowserSession, type LaunchBrowserArgs, launchBrowser };

package/dist/shared/run/browser.js

@@ -1,74 +0,0 @@
-import { chromium } from "playwright";
-import { createServer } from "node:net";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { ensureLibrettoSessionStatePath } from "../paths/paths.js";
-import { SESSION_STATE_VERSION, SessionStateFileSchema } from "../state/session-state.js";
-async function pickFreePort() {
-  return await new Promise((resolve, reject) => {
-    const server = createServer();
-    server.unref();
-    server.on("error", reject);
-    server.listen(0, "127.0.0.1", () => {
-      const addr = server.address();
-      if (addr && typeof addr === "object") {
-        server.close(() => resolve(addr.port));
-        return;
-      }
-      server.close(() => reject(new Error("Failed to resolve debug port")));
-    });
-  });
-}
-async function launchBrowser({
-  sessionName,
-  headless = false,
-  viewport = { width: 1366, height: 768 },
-  storageStatePath
-}) {
-  const debugPort = await pickFreePort();
-  const browser = await chromium.launch({
-    headless,
-    args: [
-      "--disable-blink-features=AutomationControlled",
-      `--remote-debugging-port=${debugPort}`,
-      "--no-focus-on-check"
-    ]
-  });
-  const context = await browser.newContext({
-    viewport,
-    ...storageStatePath ? { storageState: storageStatePath } : {}
-  });
-  const page = await context.newPage();
-  page.setDefaultTimeout(3e4);
-  page.setDefaultNavigationTimeout(45e3);
-  const metadataPath = ensureLibrettoSessionStatePath(sessionName);
-  const existingStateRaw = existsSync(metadataPath) ? JSON.parse(readFileSync(metadataPath, "utf-8")) : void 0;
-  const parsedExistingState = SessionStateFileSchema.safeParse(existingStateRaw);
-  writeFileSync(
-    metadataPath,
-    JSON.stringify(
-      {
-        version: parsedExistingState.success ? parsedExistingState.data.version : SESSION_STATE_VERSION,
-        session: sessionName,
-        port: debugPort,
-        pid: process.pid,
-        startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        status: "active"
-      },
-      null,
-      2
-    )
-  );
-  return {
-    browser,
-    context,
-    page,
-    debugPort,
-    metadataPath,
-    close: async () => {
-      await browser.close();
-    }
-  };
-}
-export {
-  launchBrowser
-};

package/dist/shared/state/index.cjs

@@ -1,38 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var state_exports = {};
-__export(state_exports, {
-  SESSION_STATE_VERSION: () => import_session_state.SESSION_STATE_VERSION,
-  SessionStateFileSchema: () => import_session_state.SessionStateFileSchema,
-  SessionStatusSchema: () => import_session_state.SessionStatusSchema,
-  parseSessionStateContent: () => import_session_state.parseSessionStateContent,
-  parseSessionStateData: () => import_session_state.parseSessionStateData,
-  serializeSessionState: () => import_session_state.serializeSessionState
-});
-module.exports = __toCommonJS(state_exports);
-var import_session_state = require("./session-state.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  SESSION_STATE_VERSION,
-  SessionStateFileSchema,
-  SessionStatusSchema,
-  parseSessionStateContent,
-  parseSessionStateData,
-  serializeSessionState
-});

package/dist/shared/state/index.d.cts

@@ -1,2 +0,0 @@
-export { SESSION_STATE_VERSION, SessionState, SessionStateFile, SessionStateFileSchema, SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState } from './session-state.cjs';
-import 'zod';

package/dist/shared/state/index.d.ts

@@ -1,2 +0,0 @@
-export { SESSION_STATE_VERSION, SessionState, SessionStateFile, SessionStateFileSchema, SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState } from './session-state.js';
-import 'zod';

package/dist/shared/state/index.js

@@ -1,16 +0,0 @@
-import {
-  SESSION_STATE_VERSION,
-  SessionStatusSchema,
-  SessionStateFileSchema,
-  parseSessionStateData,
-  parseSessionStateContent,
-  serializeSessionState
-} from "./session-state.js";
-export {
-  SESSION_STATE_VERSION,
-  SessionStateFileSchema,
-  SessionStatusSchema,
-  parseSessionStateContent,
-  parseSessionStateData,
-  serializeSessionState
-};

package/dist/shared/state/session-state.cjs

@@ -1,85 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var session_state_exports = {};
-__export(session_state_exports, {
-  SESSION_STATE_VERSION: () => SESSION_STATE_VERSION,
-  SessionStateFileSchema: () => SessionStateFileSchema,
-  SessionStatusSchema: () => SessionStatusSchema,
-  parseSessionStateContent: () => parseSessionStateContent,
-  parseSessionStateData: () => parseSessionStateData,
-  serializeSessionState: () => serializeSessionState
-});
-module.exports = __toCommonJS(session_state_exports);
-var import_zod = require("zod");
-const SESSION_STATE_VERSION = 1;
-const SessionStatusSchema = import_zod.z.enum([
-  "active",
-  "paused",
-  "completed",
-  "failed",
-  "exited"
-]);
-const SessionStateFileSchema = import_zod.z.object({
-  version: import_zod.z.literal(SESSION_STATE_VERSION),
-  port: import_zod.z.number().int().min(0).max(65535),
-  pid: import_zod.z.number().int(),
-  session: import_zod.z.string().min(1),
-  startedAt: import_zod.z.string().datetime({ offset: true }),
-  status: SessionStatusSchema.optional()
-});
-function formatIssues(error) {
-  return error.issues.map((issue) => {
-    const path = issue.path.join(".") || "root";
-    return `${path}: ${issue.message}`;
-  }).join("; ");
-}
-function parseSessionStateData(rawState, source) {
-  const parsed = SessionStateFileSchema.safeParse(rawState);
-  if (!parsed.success) {
-    throw new Error(`Session state at ${source} is invalid: ${formatIssues(parsed.error)}`);
-  }
-  const { version: _version, ...state } = parsed.data;
-  return state;
-}
-function parseSessionStateContent(content, source) {
-  let rawState;
-  try {
-    rawState = JSON.parse(content);
-  } catch (error) {
-    throw new Error(
-      `Session state at ${source} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
-  return parseSessionStateData(rawState, source);
-}
-function serializeSessionState(state) {
-  return SessionStateFileSchema.parse({
-    version: SESSION_STATE_VERSION,
-    ...state
-  });
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  SESSION_STATE_VERSION,
-  SessionStateFileSchema,
-  SessionStatusSchema,
-  parseSessionStateContent,
-  parseSessionStateData,
-  serializeSessionState
-});

package/dist/shared/state/session-state.d.cts

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-
-declare const SESSION_STATE_VERSION = 1;
-declare const SessionStatusSchema: z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>;
-declare const SessionStateFileSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    port: z.ZodNumber;
-    pid: z.ZodNumber;
-    session: z.ZodString;
-    startedAt: z.ZodString;
-    status: z.ZodOptional<z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>>;
-}, "strip", z.ZodTypeAny, {
-    version: 1;
-    port: number;
-    pid: number;
-    session: string;
-    startedAt: string;
-    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
-}, {
-    version: 1;
-    port: number;
-    pid: number;
-    session: string;
-    startedAt: string;
-    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
-}>;
-type SessionStatus = z.infer<typeof SessionStatusSchema>;
-type SessionStateFile = z.infer<typeof SessionStateFileSchema>;
-type SessionState = Omit<SessionStateFile, "version">;
-declare function parseSessionStateData(rawState: unknown, source: string): SessionState;
-declare function parseSessionStateContent(content: string, source: string): SessionState;
-declare function serializeSessionState(state: SessionState): SessionStateFile;
-
-export { SESSION_STATE_VERSION, type SessionState, type SessionStateFile, SessionStateFileSchema, type SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState };

package/dist/shared/state/session-state.d.ts

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-
-declare const SESSION_STATE_VERSION = 1;
-declare const SessionStatusSchema: z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>;
-declare const SessionStateFileSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    port: z.ZodNumber;
-    pid: z.ZodNumber;
-    session: z.ZodString;
-    startedAt: z.ZodString;
-    status: z.ZodOptional<z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>>;
-}, "strip", z.ZodTypeAny, {
-    version: 1;
-    port: number;
-    pid: number;
-    session: string;
-    startedAt: string;
-    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
-}, {
-    version: 1;
-    port: number;
-    pid: number;
-    session: string;
-    startedAt: string;
-    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
-}>;
-type SessionStatus = z.infer<typeof SessionStatusSchema>;
-type SessionStateFile = z.infer<typeof SessionStateFileSchema>;
-type SessionState = Omit<SessionStateFile, "version">;
-declare function parseSessionStateData(rawState: unknown, source: string): SessionState;
-declare function parseSessionStateContent(content: string, source: string): SessionState;
-declare function serializeSessionState(state: SessionState): SessionStateFile;
-
-export { SESSION_STATE_VERSION, type SessionState, type SessionStateFile, SessionStateFileSchema, type SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState };

package/dist/shared/state/session-state.js

@@ -1,56 +0,0 @@
-import { z } from "zod";
-const SESSION_STATE_VERSION = 1;
-const SessionStatusSchema = z.enum([
-  "active",
-  "paused",
-  "completed",
-  "failed",
-  "exited"
-]);
-const SessionStateFileSchema = z.object({
-  version: z.literal(SESSION_STATE_VERSION),
-  port: z.number().int().min(0).max(65535),
-  pid: z.number().int(),
-  session: z.string().min(1),
-  startedAt: z.string().datetime({ offset: true }),
-  status: SessionStatusSchema.optional()
-});
-function formatIssues(error) {
-  return error.issues.map((issue) => {
-    const path = issue.path.join(".") || "root";
-    return `${path}: ${issue.message}`;
-  }).join("; ");
-}
-function parseSessionStateData(rawState, source) {
-  const parsed = SessionStateFileSchema.safeParse(rawState);
-  if (!parsed.success) {
-    throw new Error(`Session state at ${source} is invalid: ${formatIssues(parsed.error)}`);
-  }
-  const { version: _version, ...state } = parsed.data;
-  return state;
-}
-function parseSessionStateContent(content, source) {
-  let rawState;
-  try {
-    rawState = JSON.parse(content);
-  } catch (error) {
-    throw new Error(
-      `Session state at ${source} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
-  return parseSessionStateData(rawState, source);
-}
-function serializeSessionState(state) {
-  return SessionStateFileSchema.parse({
-    version: SESSION_STATE_VERSION,
-    ...state
-  });
-}
-export {
-  SESSION_STATE_VERSION,
-  SessionStateFileSchema,
-  SessionStatusSchema,
-  parseSessionStateContent,
-  parseSessionStateData,
-  serializeSessionState
-};

package/dist/shared/visualization/ghost-cursor.cjs

@@ -1,174 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var ghost_cursor_exports = {};
-__export(ghost_cursor_exports, {
-  ensureGhostCursor: () => ensureGhostCursor,
-  getGhostCursorPosition: () => getGhostCursorPosition,
-  ghostClick: () => ghostClick,
-  hideGhostCursor: () => hideGhostCursor,
-  moveGhostCursor: () => moveGhostCursor,
-  moveGhostCursorWithDistance: () => moveGhostCursorWithDistance
-});
-module.exports = __toCommonJS(ghost_cursor_exports);
-const DEFAULTS = {
-  style: "minimal",
-  color: "rgba(255, 70, 70, 0.9)",
-  size: 20,
-  zIndex: 2147483646,
-  easing: "cubic-bezier(0.16, 1, 0.3, 1)",
-  minDurationMs: 100,
-  maxDurationMs: 600,
-  speedPxPerMs: 1.5
-};
-const CURSOR_ID = "__libretto_ghost_cursor__";
-function buildCursorSvg(style, color, size) {
-  if (style === "dot") {
-    return `<div style="width:${size}px;height:${size}px;border-radius:50%;background:${color};"></div>`;
-  }
-  if (style === "screenstudio") {
-    return `<div style="width:${size * 1.4}px;height:${size * 1.4}px;border-radius:50%;background:${color};box-shadow:0 0 ${size * 0.6}px ${color};opacity:0.7;"></div>`;
-  }
-  return `<svg width="${size}" height="${size}" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-		<path d="M5 3L19 12L12 13L9 20L5 3Z" fill="${color}" stroke="rgba(0,0,0,0.3)" stroke-width="1"/>
-	</svg>`;
-}
-function buildInitScript(opts) {
-  const svg = buildCursorSvg(opts.style, opts.color, opts.size);
-  return `
-(function() {
-	if (document.getElementById("${CURSOR_ID}")) return;
-	var el = document.createElement("div");
-	el.id = "${CURSOR_ID}";
-	el.style.cssText = "position:fixed;top:0;left:0;z-index:${opts.zIndex};pointer-events:none;transform:translate3d(-100px,-100px,0);transition:none;will-change:transform,opacity;opacity:0;";
-	el.innerHTML = ${JSON.stringify(svg)};
-	document.documentElement.appendChild(el);
-})();
-`;
-}
-const installedPages = /* @__PURE__ */ new WeakSet();
-async function ensureGhostCursor(page, options) {
-  const existingOpts = page.__librettoGhostCursorOpts;
-  const opts = { ...DEFAULTS, ...existingOpts ?? {}, ...options };
-  const initScript = buildInitScript(opts);
-  if (!installedPages.has(page)) {
-    installedPages.add(page);
-    await page.addInitScript({ content: initScript });
-  }
-  page.__librettoGhostCursorOpts = opts;
-  try {
-    await page.evaluate(new Function(initScript));
-  } catch {
-  }
-}
-async function moveGhostCursor(page, target) {
-  const opts = page.__librettoGhostCursorOpts ?? DEFAULTS;
-  const durationMs = target.durationMs ?? Math.min(
-    opts.maxDurationMs,
-    Math.max(opts.minDurationMs, 200)
-    // default ~200ms if no distance info
-  );
-  try {
-    await page.evaluate(
-      ({ id, x, y, duration, easing }) => {
-        const el = document.getElementById(id);
-        if (!el) return;
-        el.style.opacity = "1";
-        el.style.transition = `transform ${duration}ms ${easing}`;
-        el.style.transform = `translate3d(${x}px, ${y}px, 0)`;
-      },
-      { id: CURSOR_ID, x: target.x, y: target.y, duration: durationMs, easing: opts.easing }
-    );
-    await page.waitForTimeout(durationMs);
-  } catch {
-  }
-}
-async function moveGhostCursorWithDistance(page, from, to) {
-  const opts = page.__librettoGhostCursorOpts ?? DEFAULTS;
-  const dx = to.x - from.x;
-  const dy = to.y - from.y;
-  const distance = Math.sqrt(dx * dx + dy * dy);
-  const durationMs = Math.min(
-    opts.maxDurationMs,
-    Math.max(opts.minDurationMs, distance / opts.speedPxPerMs)
-  );
-  await moveGhostCursor(page, { x: to.x, y: to.y, durationMs });
-}
-async function ghostClick(page, target) {
-  try {
-    await page.evaluate(
-      ({ id, x, y }) => {
-        const el = document.getElementById(id);
-        if (!el) return;
-        el.style.transform = `translate3d(${x}px, ${y}px, 0) scale(0.93)`;
-        el.style.transition = "transform 80ms ease-out";
-      },
-      { id: CURSOR_ID, x: target.x, y: target.y }
-    );
-    await page.waitForTimeout(100);
-    await page.evaluate(
-      ({ id, x, y }) => {
-        const el = document.getElementById(id);
-        if (!el) return;
-        el.style.transform = `translate3d(${x}px, ${y}px, 0) scale(1)`;
-        el.style.transition = "transform 120ms ease-out";
-      },
-      { id: CURSOR_ID, x: target.x, y: target.y }
-    );
-    await page.waitForTimeout(130);
-  } catch {
-  }
-}
-async function hideGhostCursor(page) {
-  try {
-    await page.evaluate(
-      ({ id }) => {
-        const el = document.getElementById(id);
-        if (!el) return;
-        el.style.transition = "opacity 300ms ease-out";
-        el.style.opacity = "0";
-      },
-      { id: CURSOR_ID }
-    );
-  } catch {
-  }
-}
-async function getGhostCursorPosition(page) {
-  try {
-    return await page.evaluate(({ id }) => {
-      const el = document.getElementById(id);
-      if (!el) return null;
-      const match = el.style.transform.match(
-        /translate3d\(\s*([\d.-]+)px\s*,\s*([\d.-]+)px/
-      );
-      if (!match) return null;
-      return { x: parseFloat(match[1]), y: parseFloat(match[2]) };
-    }, { id: CURSOR_ID });
-  } catch {
-    return null;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ensureGhostCursor,
-  getGhostCursorPosition,
-  ghostClick,
-  hideGhostCursor,
-  moveGhostCursor,
-  moveGhostCursorWithDistance
-});

package/dist/shared/visualization/ghost-cursor.d.cts

@@ -1,37 +0,0 @@
-import { Page } from 'playwright';
-
-type GhostCursorStyle = "minimal" | "dot" | "screenstudio";
-type GhostCursorOptions = {
-    style?: GhostCursorStyle;
-    color?: string;
-    size?: number;
-    zIndex?: number;
-    easing?: string;
-    minDurationMs?: number;
-    maxDurationMs?: number;
-    speedPxPerMs?: number;
-};
-declare function ensureGhostCursor(page: Page, options?: GhostCursorOptions): Promise<void>;
-declare function moveGhostCursor(page: Page, target: {
-    x: number;
-    y: number;
-    durationMs?: number;
-}): Promise<void>;
-declare function moveGhostCursorWithDistance(page: Page, from: {
-    x: number;
-    y: number;
-}, to: {
-    x: number;
-    y: number;
-}): Promise<void>;
-declare function ghostClick(page: Page, target: {
-    x: number;
-    y: number;
-}): Promise<void>;
-declare function hideGhostCursor(page: Page): Promise<void>;
-declare function getGhostCursorPosition(page: Page): Promise<{
-    x: number;
-    y: number;
-} | null>;
-
-export { type GhostCursorOptions, type GhostCursorStyle, ensureGhostCursor, getGhostCursorPosition, ghostClick, hideGhostCursor, moveGhostCursor, moveGhostCursorWithDistance };

package/dist/shared/visualization/ghost-cursor.d.ts

@@ -1,37 +0,0 @@
-import { Page } from 'playwright';
-
-type GhostCursorStyle = "minimal" | "dot" | "screenstudio";
-type GhostCursorOptions = {
-    style?: GhostCursorStyle;
-    color?: string;
-    size?: number;
-    zIndex?: number;
-    easing?: string;
-    minDurationMs?: number;
-    maxDurationMs?: number;
-    speedPxPerMs?: number;
-};
-declare function ensureGhostCursor(page: Page, options?: GhostCursorOptions): Promise<void>;
-declare function moveGhostCursor(page: Page, target: {
-    x: number;
-    y: number;
-    durationMs?: number;
-}): Promise<void>;
-declare function moveGhostCursorWithDistance(page: Page, from: {
-    x: number;
-    y: number;
-}, to: {
-    x: number;
-    y: number;
-}): Promise<void>;
-declare function ghostClick(page: Page, target: {
-    x: number;
-    y: number;
-}): Promise<void>;
-declare function hideGhostCursor(page: Page): Promise<void>;
-declare function getGhostCursorPosition(page: Page): Promise<{
-    x: number;
-    y: number;
-} | null>;
-
-export { type GhostCursorOptions, type GhostCursorStyle, ensureGhostCursor, getGhostCursorPosition, ghostClick, hideGhostCursor, moveGhostCursor, moveGhostCursorWithDistance };