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.
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.
| Katalog | Vad 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.tsDet 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.
- Webbappen. En progressiv webbapp som fungerar offline när dess service worker har cachat verktygen och tillgångarna. Den behöver inget konto; tillstånd lever i IndexedDB på varje enhet. En responsiv layout tjänar dator och telefon: på en telefon blir kontrollerna ett blad och exportkontrollerna öppnas från en flytande pill.
- Dator- och mobilapparna. Tauri-paket av samma webbapp, med inbyggda fildialoger, filsystemstillstånd och full offlineanvändning.
- CLI.
lolly <tool-id> --input=value --output=file.pngladdar samma motor i en DOM utan gränssnitt och skriver filen. Det är URL-läge över en annan transport, inte en separat implementation. Se CLI. - TUI. En helskärmsapp för terminalen med tangentbordet i första hand som återanvänder CLI:s brygga, behåller sparade sessioner på disk (i datorappens egen mapp när appen är installerad, annars under
~/.lolly) och startar en avgränsad webbläsare utan gränssnitt bara när ett format behöver en. Se TUI.
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.
signed by Lollyvector SVG97 paths~3.3k nodes113 groups99 KBCheck it yourselfHämta den signerade filen
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.
signed by Lollyvector SVG133 paths~15k nodes185 groups1 image195 KBCheck it yourselfHämta den signerade filen
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.
signed by Lollyvector SVG39 paths~2.6k nodes54 groups2 images43 KBCheck it yourselfHämta den signerade filen
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 API | Vad det gör |
|---|---|
host.profile | Användarens uppgifter; fyller i indata via bindToProfile |
host.assets | Katalogfrågor, tillgångsupplösning och värdens väljare |
host.state | Spara och läsa in indataplatser: IndexedDB på webben, filsystemet i Tauri, minnet i CLI |
host.clipboard | Skriva text eller en bild till urklipp, med plattformsreserver |
host.export | Rastrera eller serialisera renderingsmålet, och filtransformvägen på enheten |
host.log | Nivå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 signed by Lollyvector SVG55 paths~2.6k nodes38 groups60 KBCheck it yourselfHämta den signerade 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:
signed by Lollyvector SVG10 groups25 KBCheck it yourselfHämta den signerade filen
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:
asset, medfilterochallowUpload, är bryggan till tillgångssystemet.allowUpload: falsebegränsar en plats till biblioteksbilder, och användaruppladdningar delar biblioteketsAssetRef-form.blocksär en upprepad fältgrupp som redigeras i en sidopanel, använd av Meeting Planner, Wayfinding, Diagrams med flera. Att klicka på ett renderat block fokuserar dess rad.filehåller användarens egen fil i minnet för verktyg på enheten som Lolly Strip Hidden Data och Compress, ochvectorgrupperar en fast uppsättning tal i en kontroll.
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
- Ingen godtycklig JavaScript i mallar. Logik finns i
hooks.js. - Ingen obligatorisk tillgångsserver. Man lägger till egna filer i Assets i appen och för arbetet vidare som en session: en delningslänk för indata och inställningar, en
.lolly-fil när uppladdningar följer med. En delad session kan bli en mall i ett verktygs väljare. En organisation som vill ha en styrd katalog kan använda Lolly Works katalog, godkännanden och policyer, eller hantera varumärkespaketet i git och granska ändringar där. - Ingen påtvingad åtkomstkontroll. Den öppna appen är publik som standard, och mognadsetiketter och vattenstämplar bär varumärkesrisken. Organisationsinloggning, roller och policy kommer från Lolly Work när ett team vill ha dem.
- Ingen central databas. Användartillstånd lever på varje enhet, och valfri Sync kopierar det till lagring som personen väljer, aldrig till en Lolly-databas.
- Ingen delad kodväg mellan verktyg och motorn. Motorn och gemenskapsverktygen har öppen källkod, och ett varumärkespaket som det privata
brands/suse/bär sina egna verktyg och sin egen katalog under egna villkor. Inget verktyg importerar frånengine/, så uppdelningen förblir ren.
Livscykeln för en rendering
Någon öppnar https://lolly.tools/t/qr-code?url=https://example.com&ecl=H:
- Start. Webbappen öppnar IndexedDB, bygger capability bridge och synkar verktygs- och tillgångskatalogerna, eller läser in dem från cachen offline.
- Väg. Sökvägen väljer verktygsvyn för
qr-code, med frågan som dess startvärden. - Läs in.
loadToolhämtartool.json, validerar det mot schemat och hämtar mallen, stilarna och hooks. - Tolka länken.
parseUrlStategör parametrarna till indatavärden. En tillgångsreferens som?logo=lolly/logo/primaryblir ett olöst{ id }. - 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 anroparonInit. - Rendera. Skalet prenumererar på körmiljön, ritar kontrollerna från modellen och skriver den ifyllda mallen i
#tool-canvas. - Interagera. Att skriva anropar
runtime.setInput, som tillämpar begränsningar, anroparonInput, fyller mallen igen och ritar om. - Exportera. Download anropar
runtime.export(node, format), och skaletshost.exportproducerar filen: en raster, en vektor från DOM-vandraren, en PDF, ett dokument eller ett av de andra formaten ischemas/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.
signed by Lollyvector SVG77 paths~6.0k nodes87 groups3 images88 KBCheck it yourselfHämta den signerade 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.