Lolly
Öppna appen

AutomatiseraArkitektur och kontrakt

Lollys arkitektur

signed by Lollyoverview.htmlHTMLpixels, not shapes12 KBAI generatedgenerated by ClaudeCheck it yourselfHämta den signerade filen

Lolly-ikon - Stor grön och vit klubba

Den här sidan är för dem som ändrar Lollys kod: hur motorn, skalen och verktygspaketen passar ihop, var var och en finns i arkivet och de åtaganden som begränsar varje ändring. Om du vill veta vad Lolly gör och vem som använder det, läs Så fungerar Lolly först.

Två följeslagare går djupare. engine/README.md är modul-för-modul-kartan över motorn, genererad från koden. Threat Model & Trust Boundaries läser samma arkitektur som förtroendegränser, och är sidan för varje fråga om vad motorn behandlar som opålitligt.

Helhetsbilden

Verktyg är data överst. Motorn i mitten vet ingenting om någon plattform. Skalen längst ner implementerar ett kontrakt, och katalogerna levererar innehållet.

Verktyg levererar ett manifest, en mall och hooks till den delade motorn. Webb-, Tauri- och terminalskal implementerar capability bridge HostV1 och läser verktyg och tillgångar från kataloger.Verktyg levererar ett manifest, en mall och hooks till den delade motorn. Webb-, Tauri- och terminalskal implementerar capability bridge HostV1 och läser verktyg och tillgångar från kataloger.Open this in Diagram Builder

Om du kan beskriva det i ren data och Handlebars hör det hemma i motorn. Om det rör DOM, filsystemet, nätverket eller något webbläsar- eller operativsystems-API hör det hemma i värden, skalets sida av bryggan. Motorn har öppen källkod, och inget som känner till ett visst varumärke eller en viss plattform hamnar i motorn.

Arkivets uppbyggnad

Lolly är ett arkiv. Varje katalog nedan är en vanlig katalog i det, utom brands/suse, en privat git-submodul som håller SUSE:s verktygspaket och katalog, som en publik klon inte hämtar. Vilka paket ett bygge läser är en innehållsprofil (profiles.json), som löses per process i stället för att växlas globalt. Build Guide har klonkommandot och hur en ändring inne i det privata paketet checkas in.

KatalogVad den innehåller
engine/Den plattformsoberoende kärnan: laddare, körmiljö, indata, mallar, URL-läge, enheter och formatmodulerna
shells/Webbappen, Tauri-dator- och mobilapparna, CLI, TUI och webbläsartillägget
packages/SDK för verktygsutvecklare (@lolly-tools/core), de delade Node-skaldelarna och dokumentationsrenderaren, bland annat
community/De varumärkesoberoende verktygen, plus de delade emojipaketen
brands/Varumärkespaket: lolly-demo (Lolly Demo, designsystemet lolly.tools kör), lolly-start (det tomma startpaketet) och det privata suse
services/De valfria MCP-, certifikat- och Penpot-tjänsterna, och serverkoden de delar
schemas/JSON Schema för verktygsmanifest, tillgångsposter och tillgångsreferenser
scripts/, tests/, docs/, api/Bygg- och katalogskript, motorns testsvit, de här dokumenten och de genererade serverlösa paketen
Motor- och skalfilerna du möter först
engine/src/
  index.ts          public surface: loader, runtime, template, inputs, url-mode
  loader.ts         fetches and validates tool files
  runtime.ts        orchestrates one mounted tool, from load to export
  template.ts       Handlebars hydration and annotateTemplate
  inputs.ts         manifest to runtime input model
  url-mode.ts       URL to input state and back
  validate.ts       JSON Schema validation of manifests
  compose.ts        nested tool renders (composes)
  embed.ts          portable lolly.tools embed URLs
  bridge/host-v1.ts type re-export of the @lolly-tools/core contract

shells/web/src/
  main.ts           boot and routing
  bridge/           the web implementations of the host APIs
  catalog/sync.ts   boot-time catalog sync and offline cache
  views/            the gallery, tool, projects, free canvas and the other views
  pro/              Batch (#/batch)

shells/cli/         bin/lolly.ts (entry), src/run.ts (headless render), src/bridge.ts
shells/tui/         src/main.tsx (the full-screen app), src/bridge.ts

Det finns ingen tools/- eller catalog/-katalog i arkivets rot. packages/node-shell/src/content-roots.ts svarar på "var finns verktyget <id>" och "var finns katalogen" utifrån profiles.json när det frågas. Ett riktigt tools/- och catalog/-par skrivs bara i en byggutdata, som dist/, en RPM-nyttolast eller en containerbild, eftersom en webbläsare hämtar de två sökvägarna över HTTP.

Var Lolly körs

Varje yta använder samma motor och samma verktygsfiler.

Datorns delade vy: kontroller genererade från manifestet till vänster, den levande ytan till höger signed by Lollyvector SVG131 paths~6.1k nodes158 groups1 image142 KBCheck it yourselfHämta den signerade filen

Samma verktyg i telefonbredd behöver ingen annan layout: kontrollerna blir ett blad överst och förhandsvisningen håller skärmen.

Ett audiogram på en 430 px bred skärm: kontrollbladet ovanför, det färdiga kvadratiska verket under och den flytande exportpillen signed by Lollyvector SVG97 paths~3.3k nodes113 groups99 KBCheck it yourselfHämta den signerade filenEtt audiogram på en 430 px bred skärm: kontrollbladet ovanför, det färdiga kvadratiska verket under och den flytande exportpillen signed by Lollyvector SVG97 paths~3.3k nodes113 groups100 KBCheck it yourselfHämta den signerade filen

Webbappen levereras också med Batch (#/batch, shells/web/src/pro/), ett rutnät i kalkylbladsstil som renderar många rader på en gång över ett eller många verktyg; Batch och Lolly Multi-edit beskriver Batch. Settings → Capabilities kartlägger allt plattformen deklarerar att den kan göra.

Batch på en ny installation: en tom rad som väntar på ett verktyg, med kalkylbladsytan och dess Render-knapp på plats innan några data kommer signed by Lollyvector SVG133 paths~15k nodes185 groups1 image195 KBCheck it yourselfHämta den signerade filenBatch på en ny installation: en tom rad som väntar på ett verktyg, med kalkylbladsytan och dess Render-knapp på plats innan några data kommer signed by Lollyvector SVG133 paths~15k nodes185 groups1 image195 KBCheck it yourselfHämta den signerade filen

Arkitektoniska åtaganden

De här besluten är avgjorda. Att ändra något av dem är ett stort åtagande, eftersom de formar varje annat beslut i kodbasen.

1. Deklarativa verktyg, med en imperativ nödutgång

Ett verktyg är ett manifest (tool.json), en mall (template.html) och valfria hooks.js. Manifestet deklarerar indata, aldrig mallen: indata härleds inte från Handlebars-token. De flesta verktyg är bara manifest och mall, vilket är det som låter icke-utvecklare skriva dem.

Street Maps kontrollstack: en stadsrullgardin, ett temaval, vikt-reglage och färgutlösare, var och en ritad från en manifestrad signed by Lollyvector SVG39 paths~2.6k nodes54 groups2 images43 KBCheck it yourselfHämta den signerade filenStreet Maps kontrollstack: en stadsrullgardin, ett temaval, vikt-reglage och färgutlösare, var och en ritad från en manifestrad signed by Lollyvector SVG39 paths~2.6k nodes54 groups2 images43 KBCheck it yourselfHämta den signerade filen

Verktyg som beräknar värden, som QR-kodning eller diagramformning, lägger till hooks: namngivna livscykelfunktioner som körmiljön anropar med capability bridge injicerad. Hooks är ett portabilitetskontrakt, inte en säkerhetssandlåda, och de körs inom en tidsbudget. Verktyg vars hooks bevisats fria från sidans globaler bär isolate: true och körs i en Worker. Tool hooks har livscykeln och budgetarna, och Threat Model säger vad den sidinterna exekutorn rymmer och inte rymmer.

2. Verktyg och tillgångar är data, inte paketerad kod

Webb- och Tauri-apparna hämtar verktygs- och tillgångskatalogerna vid start, cachar dem och arbetar med det som finns, så ett nytt verktyg eller en ny tillgång behöver ingen appversion. Tillgångsbyte kontrollsummeras med SHA-256, och en tillgångs id och version styr cacheinvalidering.

3. Capability bridge är det enda API som verktyg ser

Verktyg rör aldrig DOM utanför sin mall, anropar aldrig fetch direkt och läser aldrig filsystemet. De anropar versionshanterade host.*-metoder. Kontraktets kanoniska definition är packages/core/src/host-v1.ts, SDK:n för verktygsutvecklare @lolly-tools/core, så att en tredje part kan bygga mot den utan att bero på motorn; engine/src/bridge/host-v1.ts återexporterar dess typer.

Obligatoriskt APIVad det gör
host.profileAnvändarens uppgifter; fyller i indata via bindToProfile
host.assetsKatalogfrågor, tillgångsupplösning och värdens väljare
host.stateSpara och läsa in indataplatser: IndexedDB på webben, filsystemet i Tauri, minnet i CLI
host.clipboardSkriva text eller en bild till urklipp, med plattformsreserver
host.exportRastrera eller serialisera renderingsmålet, och filtransformvägen på enheten
host.logNivåindelad loggning till värden

Varje annat API är valfritt och additivt: tokens, text, color, geom, pdf, compose, media, recorder och många fler. Ett verktygs manifest listar under requires de valfria API:er som dess hooks anropar utan att kontrollera först, och en värd som saknar ett vägrar montera verktyget; hooks funktionsupptäcker resten. Några, som recorder, behöver också en enhetsförmåga som verktyget deklarerar. packages/core/src/host-v1/apis.ts listar dem alla och Host API dokumenterar var och en. Att lägga till en metod är en minorversion; att ta bort eller ändra en är en majorversion, och v1 fortsätter fungera när v2 släpps.

4. Tillgångs-id:n är för evigt

lolly/logo/primary är ett kontrakt. När det väl publicerats ändras ett id aldrig och återanvänds aldrig. En bytändring höjer version i tillgångsposten, och en ersättning sätter deprecated: true och, valfritt, replacedBy, så att befintliga referenser alltid löses. Det är det som håller sparade sessioner och delade länkar fungerande i åratal.

5. URL-läge är förstklassigt

Varje indata kan uttryckas som en URL-parameter, så en länk är en färdig fil:

https://lolly.tools/t/qr-code?url=https://example.com&ecl=H

Den länken ensam, med inget annat i den, är den färdiga filen signed by Lollyvector SVG55 paths~2.6k nodes38 groups60 KBCheck it yourselfHämta den signerade filenDen länken ensam, med inget annat i den, är den färdiga filen signed by Lollyvector SVG55 paths~2.6k nodes38 groups61 KBCheck it yourselfHämta den signerade filen

Ändra en parameter så har du en annan fil. Hela den här paletten är en fröfärg, en harmoni och ett antal steg:

Nio steg genom fyra nyanser, alla framodlade ur samma frökulör som bärs i länken signed by Lollyvector SVG10 groups25 KBCheck it yourselfHämta den signerade filenNio steg genom fyra nyanser, alla framodlade ur samma frökulör som bärs i länken signed by Lollyvector SVG10 groups25 KBCheck it yourselfHämta den signerade filen

CLI bygger samma URL-tillstånd från sina argument och kör samma pipeline, så CLI kan inte glida ifrån appen. engine/src/url-mode.ts tolkar och serialiserar; en uppsättning reserverade namn (format, width, dpi, c2pa, z med flera) skickas aldrig till ett verktyg, och Reserved URL parameters listar dem alla. Tillgångsindata färdas via id och löses genom host.assets.get() innan mallen fylls.

6. Lagring går genom bryggan

Webbappen använder IndexedDB, Tauri filsystemet och CLI minnet. Verktyg ser bara host.state.save(slot, data) och host.state.load(slot), aldrig localStorage. Man kan behålla flera namngivna sessioner per verktyg utan konto. Eftersom bryggan är den enda skarven är det tillståndet också portabelt: shells/web/src/data-transfer.ts läser ut det igen i en lolly-backup-fil som importeras på vilken annan installation som helst (Dataöverföring), och Sync skickar samma paket till lagring som personen väljer.

7. Mognadstaggar säger vad ett verktyg är

Varje verktyg deklarerar status: official | community | experimental. Galleriet sorterar efter status, och experimentella verktyg vattenstämplar sina exporter som standard: körmiljön slår på vattenstämpeln om inte anroparen skickar watermark: false, och verktyg på enheten är undantagna. Vilken process ett team än lägger kring katalogen ligger ovanpå detta.

8. Indata är typade i manifestet

En indata deklarerar en type: text, longtext, number, boolean, color, select, asset, date, time, datetime-local, url, blocks, vector, table eller file. Värden ritar en kontroll per typ, så verktyg skriver ingen kontrollkod, och varje indata kan bära bindToProfile. Tre väger tyngst:

9. Mallar är logikfria

Mallar är Handlebars, valt så att icke-utvecklare kan skriva dem: {{x}} escapar, och {{{x}}} är ett uttryckligt val. Logik finns i hooks.js, där den är explicit och granskningsbar. Många mallar använder {{{ för markup som en hook beräknat, så varje hook måste escapa det den lämnar över. Hjälparna är default, upper, lower, eq, markdown, asset, framing och media, plus icsStamp, rfcText, csvCell och arrow för syskonmallar för .ics, .vcf och .csv. Templates and rendering beskriver dem.

10. Verktyg komponerar verktyg

Ett verktyg kan bädda in ett annat verktygs rendering utan importer mellan verktyg; motorn löser kompositionen. Ett manifest kan deklarera composes: [{ id, tool, inputs }] och placera barnet med {{asset <id>}}, och en portabel inbäddnings-URL (https://lolly.tools/tool/<id>.svg?…) renderar barnet lokalt, vilket är hur Lolly Design placerar en levande QR-kod eller ett diagram. Ett SVG-barn förblir vektor i en SVG- eller PDF-förälder. Barn är mellanled, aldrig vattenstämplade eller stämplade, och ett skal som inte kan rendera ett lämnar platsen tom medan föräldern ändå renderas. Composition and brand overlays har detaljerna.

Vad vi valde att inte göra

Livscykeln för en rendering

Någon öppnar https://lolly.tools/t/qr-code?url=https://example.com&ecl=H:

  1. Start. Webbappen öppnar IndexedDB, bygger capability bridge och synkar verktygs- och tillgångskatalogerna, eller läser in dem från cachen offline.
  2. Väg. Sökvägen väljer verktygsvyn för qr-code, med frågan som dess startvärden.
  3. Läs in. loadTool hämtar tool.json, validerar det mot schemat och hämtar mallen, stilarna och hooks.
  4. Tolka länken. parseUrlState gör parametrarna till indatavärden. En tillgångsreferens som ?logo=lolly/logo/primary blir ett olöst { id }.
  5. Starta körmiljön. createRuntime(tool, host, initialValues) bygger indatamodellen från profildata, standardvärden och länken, löser tillgångsreferenser, läser in hooks och anropar onInit.
  6. Rendera. Skalet prenumererar på körmiljön, ritar kontrollerna från modellen och skriver den ifyllda mallen i #tool-canvas.
  7. Interagera. Att skriva anropar runtime.setInput, som tillämpar begränsningar, anropar onInput, fyller mallen igen och ritar om.
  8. Exportera. Download anropar runtime.export(node, format), och skalets host.export producerar filen: en raster, en vektor från DOM-vandraren, en PDF, ett dokument eller ett av de andra formaten i schemas/tool.schema.json. Fysiska enheter konverteras per format, och metadata och Content Credentials bäddas in där formatet kan hålla dem. Experimentella verktyg får sin vattenstämpel från värden, inte verktyget. Templates and rendering och Exportera en fil beskriver exportsteget.

Exportpanelen som ?options öppnar: filnamns- och formatparet, utdatastorleken och kontrollerna som skriver filen signed by Lollyvector SVG77 paths~6.0k nodes87 groups3 images88 KBCheck it yourselfHämta den signerade filenExportpanelen som ?options öppnar: filnamns- och formatparet, utdatastorleken och kontrollerna som skriver filen signed by Lollyvector SVG77 paths~6.0k nodes87 groups3 images88 KBCheck it yourselfHämta den signerade filen

Samma livscykel körs i Tauri, och i CLI med en DOM utan gränssnitt, där utdatan går till en fil eller stdout.

Licenser

Kod, inklusive engine/, shells/, services/, schemas/ och dokumentationsgeneratorn, är MPL-2.0, i ett publikt arkiv, lolly-tools/lolly. Dokumentationstext är CC BY-SA 4.0. Varumärkespaket bär egna villkor i varje pakets NOTICE.md: gemenskapsverktygen är MPL-2.0, och det privata SUSE-paketet är proprietärt för SUSE. About har hela licensnotisen.