@jinion/core 0.3.0 → 0.4.0

package/dist/design/guides.js

@@ -6,7 +6,7 @@ export const GUIDES = {
     interface: `# Building interface in this project
 
 ## Before you write
-1. If the project has no interface yet, it has no look to follow, and the framework's defaults are not one. Don't settle on a look and describe it: read the \`variations\` guide and offer directions first. The rest of this guide is for building the one picked.
+1. If the project has no interface yet, it has no look to follow, and the framework's defaults are not one. Don't settle on a look and describe it: read the \`variations\` guide and offer directions first, drawn with the \`taste\` guide. The rest of this guide is for building the one picked.
 2. Sort the request into what is the user's and what is yours. The layout of a screen, a new visual idea, a color, a size, the tone of the copy: theirs. Consistency, spacing, states, alignment: yours, unasked.
 3. Find the closest relatives: the one or two existing screens or pieces most like what is asked. The project map in your instructions shows where pieces live, and \`find_existing\` finds one by what it does. Read them whole: the structure, what styles each part, how each state is done.
 4. List what you will build it from: existing components, tokens and classes. What isn't on that list is new. If the new thing is a look (a kind of surface, an accent, a control the project doesn't have), stop and offer options; read the \`variations\` guide for how.
@@ -33,6 +33,71 @@ Each of these, taken without being asked for, says nobody decided it: an accent
 - Hold it against its closest relative: the same row heights, corners, steps of type and gaps.
 - Say what you couldn't look at.
 - Tell the user what is new to the project in what you built, a line each: every new token, class, component or pattern.`,
+    research: `# Research before a new look
+
+Do it when the project has no look of its own yet, when a kind of screen comes up that it has nothing like, and when the user asks for options: before you draw, look at how strong products do it, as a designer would. Not inside a screen that exists: there the project's own language is the reference.
+
+## Find the references
+1. The user's own come first: the products, screens or sites they named, and what they said about them. When they named none in a new project, ask for two or three, and research meanwhile.
+2. Find three to five more that are known for being well made, in the same domain or of the same kind of screen: their own pages, not template galleries or collections of shots. Search the web for them. If you can't search the web here, say so and ask the user for references instead of naming products from memory as if you had looked.
+3. Look at each with \`look\`, at the address of the screen most like the one asked and at the width it is used at. Where the real screen is behind a sign-in, take its public pages or the pictures of it in its own docs, and say which.
+
+## Write the brief
+Before you draw, a short brief to the user, a line per aspect, of what the references share and where they differ:
+- Type: the families, how many steps the scale has, how much weight carries.
+- Density: how much is on a screen, rows or cards, how much air.
+- Color: the neutrals, the accent, how much the color carries.
+- Surfaces: told apart by space, lines or fills; corners; what has a shadow.
+- What each does best, in a few words.
+
+Then say what each direction takes from them: each one a position the brief makes clear, such as the density of one with the type of another. Draw them with the \`taste\` guide.
+
+## What a reference gives
+- The visual language, not a layout, a brand or content to copy: no one else's logo, pictures, copy or exact palette.
+- When the user picks, the note you save names the references that shaped the pick, so the next piece is drawn from the same ones.`,
+    taste: `# Taste, where the project hasn't spoken
+
+The project's own language always comes first. This guide is for where it has none: a new project, the first piece of a kind, the pages of a round of directions. Start each new look from references (the \`research\` guide), then make the decisions below on purpose, each for a reason you could say. Where they leave a choice open, the user's references settle it.
+
+## Decide the job first
+- Say what the screen is for and how it is used before you draw it, since that sets its density. A tool used all day is dense: small type, rows over cards, little chrome, much on one screen. A product used now and then has more air, larger targets and one task a screen. A page meant to be read or to persuade is generous: larger type, a clear order, one idea at a time.
+- Find the one thing the screen is for and give it the weight; everything else is quieter.
+
+## Type
+- One family for the interface. A second only with a job: a monospace for code and figures that line up, a serif or a display face for an editorial voice.
+- A scale of few steps, each clearly apart from the next: in an application about 12, 13 or 14 for the body, 16, 20 and one display size; on a page to be read, a body of 16 to 18 and larger steps between headings. Inside an application, sizes rarely change.
+- Hierarchy comes from size and color first (an ink, a muted and a faint text), then from weight, in two or three steps at most: regular, medium, semibold.
+- Body text at a line height of about 1.4 to 1.6 and 45 to 75 characters a line; large headings tighter, at 1.1 to 1.25, their letters a little closer.
+- Figures that change or line up in columns are tabular. Small uppercase labels are rare and a little more widely spaced.
+
+## Space
+- One base and a few steps from it, such as 4, 8, 12, 16, 24, 32, 48 and 64. Small steps inside a control, larger between groups; the space between two groups is at least twice the space inside one.
+- One content width and one grid a screen: edges line up from section to section.
+- Controls share a height: 28 to 32 in a dense tool, 36 to 40 elsewhere, 44 for a finger.
+
+## Color
+- Neutrals carry most of the screen: a background, a raised surface, an edge, and the three inks. Leaning them slightly warm or cool, after the accent, reads as decided; pure gray rarely does.
+- One accent, for the primary action, the selection and links. Success, warning and danger only where there is that state.
+- Body text at a contrast of at least 4.5 to 1, large text and the edges of controls at 3 to 1.
+- A dark scheme is drawn, not inverted: surfaces get lighter as they rise, the accent less saturated, the text not pure white.
+
+## Surfaces and depth
+- Separate with space first, then a hairline, then a fill. Elevation only for what floats over the rest.
+- One family of corners: a small radius for controls, one step larger for what holds them, concentric when nested. Sharp, slight or round is a choice of the whole look, not of each piece.
+
+## Real content
+- Draw with content that could be true: real names, figures of a real length, the longest likely one beside a short one, and the empty case. The content decides the layout; placeholder text hides where it breaks.
+- Copy is part of the design: short, plain, in the product's voice, saying what each thing is and what each button does.
+
+## Every state
+- Empty, with what to do from there; loading; failed, with what can be done; one item and many; very long content; disabled. A control has its hover, focus and pressed states, and a focus that shows.
+
+## Motion
+- Short, between 150 and 250 milliseconds, easing out, for what appears, moves or changes size. Nothing moves for its own sake, and nothing at all for someone who asked for reduced motion.
+
+## Restraint
+- Each element, size, color and line earns its place; when in doubt, take one away. A look made of few decisions applied everywhere reads as designed; many small ones read as assembled.
+- None of what the \`interface\` guide lists as giving a generated look away, unless the user asks for it.`,
     variations: `# Offering variations
 
 Offer them when you are about to decide something the project hasn't: the first screen of a new project, the first piece of a kind, a look nothing existing carries. Offer them too whenever the user asks. Don't offer them for what the project or your notes already settle: apply that.
@@ -43,15 +108,23 @@ Offer them when you are about to decide something the project hasn't: the first
 - Each is built from the project's language where there is one: the same components and tokens, put together another way. An option that needs something new says so.
 - When the look as it is now is one of the options, it comes first and is marked as the current one.
 - In a new project, before you draw anything, ask what the user finds well made, two or three products or screens, and what about them. A reference gives the visual language, not a layout to copy.
+- For a look the project doesn't have yet, research first and draw from the brief: read the \`research\` guide.
 
 ## How to show them, by the size of the decision
 - A piece inside a screen, such as a card, a row or a menu: describe the options in words, from the patterns already on that screen, and ask the user to pick. Build the one picked.
-- A screen, or a piece many screens will repeat: build the options for real, side by side, with the real screen and data that could be true, never placeholders. Use the project's playground or Storybook when it has one. When it has none, say in a line that you will keep the options on a playground page, where it goes and that it isn't shipped, and that they can say no. If they say no, save that with \`remember\` and don't offer one in this project again: describe options in words instead.
-- A whole new project: one real screen per direction, the screen the product is used on the most, not a landing page.
-- Never leave the options built into the real screen.
+- A screen, a piece many screens will repeat, or a look the project doesn't have: these are directions. Build each as a real page and show them with \`show_directions\`, never described in words alone. Jinion's viewer shows them side by side, outside the project, and the user picks there.
+- A whole new project: one page per direction, of the screen the product is used on the most, not a landing page.
+
+## How a direction's page is made
+- One whole HTML document: its CSS and any script inline, pictures as data URLs or from the web. Nothing from the project's files or its dev server, which the viewer can't reach.
+- In the project's language where it has one: the values of its tokens, its type, its spacing steps, its corners. In a project built with components, such as React, the page is drawn in its tokens, not with its components: enough to pick from, and the same in every stack.
+- Real content, as the \`taste\` guide says: names and figures that could be true, the long case and the empty one. Never placeholder text.
+- Only what tells the directions apart needs care; the rest is the same in each, so the difference shows.
+- Look at each page with \`look\`, at the address \`show_directions\` gives it, before you tell the user they are there. If one needs fixing, show the round again.
 
 ## After the pick
-- Only the one picked goes into the product. Take the others out of the code; in the playground keep at most the one picked, as the reference.
+- The pick comes as the user's next message. Until it does, nothing goes into the project.
+- Build the one picked in the project, with its components and tokens, as the \`interface\` guide says. The page was for picking, not code to copy.
 - Save the decision with \`remember\`, in the project's scope and as a decision: what was decided, in terms the next piece can be built from (sizes, tokens, what goes where), and each option turned down in a few words with the reason the user gave. What was turned down is as useful as the pick: it is what not to offer again.
 - When the pick replaces an earlier decision, update that note rather than adding one beside it.
 - From then on apply it without asking. When a later request seems to go against it, say so and ask which holds.`,

package/dist/design/guides.js.map

@@ -1 +1 @@
-{"version":3,"file":"guides.js","sourceRoot":"","sources":["../../src/design/guides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yHA6B4G;IAEvH,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;iHAqBmG;CACvG,CAAC;AAIX,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAkC,CAAC"}
+{"version":3,"file":"guides.js","sourceRoot":"","sources":["../../src/design/guides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yHA6B4G;IAEvH,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;mIAqBuH;IAEjI,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2GA0CkG;IAEzG,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iHA6BmG;CACvG,CAAC;AAIX,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAkC,CAAC"}

package/dist/design/prompt.d.ts

@@ -3,5 +3,5 @@
  * is what, and the project's language before the agent's habits. The craft in depth is in the guides, read when there
  * is interface to build, so a turn that fixes a query doesn't carry it.
  */
-export declare const DESIGN = "# Interface work\nOn an interface you work as a design engineer. How it looks is the user's to decide; the craft is yours, done without being asked.\n- The project's own language comes first, before your habits and before any general rule: its components, its design tokens, its steps of spacing and type, its classes, as the project map shows them. Where the project uses a library's card, a card is that card. Before you write a piece, open the one or two existing pieces most like it and build yours the same way: the same structure, sizes, surfaces and states.\n- A new piece gets no new idiom: no chip, tile, stepper, meter or icon style the screen doesn't already have, because a piece with a look of its own reads as made by someone else. When what exists can't carry it, that is a design decision, and the user's.\n- Before you build a screen, or a piece big enough to be wrong, say in two or three sentences what you understood: what goes where, what comes first, which existing pieces it is built from. For a new screen or a new visual direction, wait for the user's yes; inside a screen that exists, say it and go on.\n- Where the project hasn't spoken, as in a new project or for the first piece of its kind, don't pick a look and build it. Offer two or three directions that differ in a principle, such as density, how surfaces are told apart or what the type is like, each with a name and a sentence on what it stands for, and let the user pick. Offer them too whenever the user asks for options.\n- A pick is a decision: save it with `remember`, with what was turned down and why. A decision in your notes is applied to the next piece, not offered again; when the code and a note disagree, ask which holds rather than following either.\n- What the user points at as a reference gives the visual language, not a layout to copy, unless they say so. Feedback changes exactly what it names: everything else stays as it was, the neighbours you would have tidied included.\n- A build doesn't check an interface. Look at what you made with `look`, which shows you a picture of a page or of the simulator's screen, and say plainly when you couldn't.\n- The craft itself is in Jinion's guides. Read `design_guide` for `interface` before you design or build more than a line of interface, and for `variations` before you offer options; once in a conversation is enough.";
+export declare const DESIGN = "# Interface work\nOn an interface you work as a design engineer. How it looks is the user's to decide; the craft is yours, done without being asked.\n- The project's own language comes first, before your habits and before any general rule: its components, its design tokens, its steps of spacing and type, its classes, as the project map shows them. Where the project uses a library's card, a card is that card. Before you write a piece, open the one or two existing pieces most like it and build yours the same way: the same structure, sizes, surfaces and states.\n- A new piece gets no new idiom: no chip, tile, stepper, meter or icon style the screen doesn't already have, because a piece with a look of its own reads as made by someone else. When what exists can't carry it, that is a design decision, and the user's.\n- Before you build a screen, or a piece big enough to be wrong, say in two or three sentences what you understood: what goes where, what comes first, which existing pieces it is built from. For a new screen or a new visual direction, wait for the user's yes; inside a screen that exists, say it and go on.\n- Where the project hasn't spoken, as in a new project or for the first piece of its kind, don't pick a look and build it. Look first at how strong products do it, then offer two or three directions that differ in a principle, such as density, how surfaces are told apart or what the type is like, each with a name and a sentence on what it stands for. Build each as a real page and show them with `show_directions`, never described in words alone, and let the user pick there. Offer them too whenever the user asks for options.\n- A pick is a decision: save it with `remember`, with what was turned down and why. A decision in your notes is applied to the next piece, not offered again; when the code and a note disagree, ask which holds rather than following either.\n- What the user points at as a reference gives the visual language, not a layout to copy, unless they say so. Feedback changes exactly what it names: everything else stays as it was, the neighbours you would have tidied included.\n- A build doesn't check an interface. Look at what you made with `look`, which shows you a picture of a page or of the simulator's screen, and say plainly when you couldn't.\n- The craft itself is in Jinion's guides. Read `design_guide` for `interface` before you design or build more than a line of interface, for `variations` before you offer options, and for `research` and `taste` before you draw a look the project doesn't have yet; once in a conversation is enough.";
 //# sourceMappingURL=prompt.d.ts.map

package/dist/design/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/design/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM,20EAS4M,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/design/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM,+iFASgS,CAAC"}

package/dist/design/prompt.js

@@ -8,9 +8,9 @@ On an interface you work as a design engineer. How it looks is the user's to dec
 - The project's own language comes first, before your habits and before any general rule: its components, its design tokens, its steps of spacing and type, its classes, as the project map shows them. Where the project uses a library's card, a card is that card. Before you write a piece, open the one or two existing pieces most like it and build yours the same way: the same structure, sizes, surfaces and states.
 - A new piece gets no new idiom: no chip, tile, stepper, meter or icon style the screen doesn't already have, because a piece with a look of its own reads as made by someone else. When what exists can't carry it, that is a design decision, and the user's.
 - Before you build a screen, or a piece big enough to be wrong, say in two or three sentences what you understood: what goes where, what comes first, which existing pieces it is built from. For a new screen or a new visual direction, wait for the user's yes; inside a screen that exists, say it and go on.
-- Where the project hasn't spoken, as in a new project or for the first piece of its kind, don't pick a look and build it. Offer two or three directions that differ in a principle, such as density, how surfaces are told apart or what the type is like, each with a name and a sentence on what it stands for, and let the user pick. Offer them too whenever the user asks for options.
+- Where the project hasn't spoken, as in a new project or for the first piece of its kind, don't pick a look and build it. Look first at how strong products do it, then offer two or three directions that differ in a principle, such as density, how surfaces are told apart or what the type is like, each with a name and a sentence on what it stands for. Build each as a real page and show them with \`show_directions\`, never described in words alone, and let the user pick there. Offer them too whenever the user asks for options.
 - A pick is a decision: save it with \`remember\`, with what was turned down and why. A decision in your notes is applied to the next piece, not offered again; when the code and a note disagree, ask which holds rather than following either.
 - What the user points at as a reference gives the visual language, not a layout to copy, unless they say so. Feedback changes exactly what it names: everything else stays as it was, the neighbours you would have tidied included.
 - A build doesn't check an interface. Look at what you made with \`look\`, which shows you a picture of a page or of the simulator's screen, and say plainly when you couldn't.
-- The craft itself is in Jinion's guides. Read \`design_guide\` for \`interface\` before you design or build more than a line of interface, and for \`variations\` before you offer options; once in a conversation is enough.`;
+- The craft itself is in Jinion's guides. Read \`design_guide\` for \`interface\` before you design or build more than a line of interface, for \`variations\` before you offer options, and for \`research\` and \`taste\` before you draw a look the project doesn't have yet; once in a conversation is enough.`;
 //# sourceMappingURL=prompt.js.map

package/dist/design/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/design/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;+NASyM,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/design/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;mTAS6R,CAAC"}

package/dist/design/tools.d.ts

@@ -10,6 +10,8 @@ export declare function designTools(): {
     design_guide: DesignTool<{
         topic: z.ZodEnum<{
             interface: "interface";
+            research: "research";
+            taste: "taste";
             variations: "variations";
         }>;
     }>;

package/dist/design/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/design/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,8FAA8F;AAC9F,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAID,wBAAgB,WAAW;IAEvB,YAAY;;;;;;EAOf;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC;AAE7C,eAAO,MAAM,cAAc,aAA6D,CAAC;AAEzF,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAInD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/design/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,8FAA8F;AAC9F,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAID,wBAAgB,WAAW;IAEvB,YAAY;;;;;;;;EAaf;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC;AAE7C,eAAO,MAAM,cAAc,aAA6D,CAAC;AAEzF,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAInD"}

package/dist/design/tools.js

@@ -4,8 +4,12 @@ const define = (tool) => tool;
 export function designTools() {
     return {
         design_guide: define({
-            description: "Reads Jinion's guide to a kind of interface work: `interface` before designing or building any interface, `variations` before offering the user options to pick from. Read it once in a conversation, before the work it is about.",
-            input: { topic: z.enum(GUIDE_TOPICS).describe('`interface`: how interface is built here. `variations`: how options are offered, shown and recorded.') },
+            description: "Reads Jinion's guide to a kind of interface work: `interface` before designing or building any interface, `variations` before offering the user options to pick from, `research` and `taste` before drawing a look the project doesn't have yet. Read it once in a conversation, before the work it is about.",
+            input: {
+                topic: z
+                    .enum(GUIDE_TOPICS)
+                    .describe("`interface`: how interface is built here. `variations`: how options are offered, shown and recorded. `research`: how good products are looked at before a new look. `taste`: what well made means where the project has no language of its own."),
+            },
             run: async ({ topic }) => GUIDES[topic],
         }),
     };

package/dist/design/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/design/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASnD,MAAM,MAAM,GAAG,CAA0B,IAAmB,EAAE,EAAE,CAAC,IAAI,CAAC;AAEtE,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,YAAY,EAAE,MAAM,CAAC;YACnB,WAAW,EACT,oOAAoO;YACtO,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,sGAAsG,CAAC,EAAE;YACvJ,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;SACxC,CAAC;KACH,CAAC;AACJ,CAAC;AAMD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,CAA0B,CAAC,CAAC;AAEzF,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAwB,CAAC;IAEvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;AACnG,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/design/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASnD,MAAM,MAAM,GAAG,CAA0B,IAAmB,EAAE,EAAE,CAAC,IAAI,CAAC;AAEtE,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,YAAY,EAAE,MAAM,CAAC;YACnB,WAAW,EACT,+SAA+S;YACjT,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC;qBACL,IAAI,CAAC,YAAY,CAAC;qBAClB,QAAQ,CACP,iPAAiP,CAClP;aACJ;YACD,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;SACxC,CAAC;KACH,CAAC;AACJ,CAAC;AAMD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,CAA0B,CAAC,CAAC;AAEzF,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAwB,CAAC;IAEvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;AACnG,CAAC"}

package/dist/directions/directions.d.ts

@@ -0,0 +1,42 @@
+import { DirectionsStore, type Offered, type Round } from './store.js';
+export interface Picked {
+    round: Round;
+    direction: string;
+}
+/** What a viewer is told after a pick: the round as it is now, and whether a conversation took the pick. */
+export interface PickAnswer {
+    round: Round;
+    sent: boolean;
+}
+/** The viewer as a Preview beside the thread shows it, which has no room for the rounds. */
+export declare const SIDEBAR_CLOSED = "#sidebar-closed";
+/**
+ * Jinion's own place to show directions, the same for every project and client: the rounds kept under the project's
+ * folder in `~/.jinion`, served to a viewer on 127.0.0.1 behind a token. Nothing listens before a round is shown.
+ */
+export declare class Directions {
+    private readonly cwd;
+    readonly store: DirectionsStore;
+    private readonly token;
+    /** The conversation each round was shown in, while it is open; a pick on any other is only kept. */
+    private readonly listeners;
+    private server?;
+    private port?;
+    constructor(cwd: string);
+    show(offered: Offered, onPick: (picked: Picked) => void): Promise<{
+        round: Round;
+        address: string;
+        /** Each direction's page alone, for the agent to look at. */
+        pages: string[];
+        /** Each direction in the viewer without its sidebar, as a Preview shows the round. */
+        shown: string[];
+    }>;
+    /** The viewer, at the newest round. */
+    address(): Promise<string>;
+    pick(id: string, direction: string): PickAnswer | undefined;
+    close(): void;
+    private listen;
+    private receive;
+    private receivePick;
+}
+//# sourceMappingURL=directions.d.ts.map

package/dist/directions/directions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directions.d.ts","sourceRoot":"","sources":["../../src/directions/directions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGvE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4GAA4G;AAC5G,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAID,4FAA4F;AAC5F,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,UAAU;IAQT,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPhC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,oGAAoG;IACpG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IACzE,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,IAAI,CAAC,CAAkB;IAE/B,YAA6B,GAAG,EAAE,MAAM,EAEvC;IAEK,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;;;QAUzD,6DAA6D;;QAE7D,sFAAsF;;OAGzF;IAED,uCAAuC;IACjC,OAAO,oBAIZ;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAS1D;IAED,KAAK,SAIJ;IAED,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,OAAO;IA8Bf,OAAO,CAAC,WAAW;CAkBpB"}

package/dist/directions/directions.js

@@ -0,0 +1,120 @@
+import { randomBytes } from 'node:crypto';
+import { createServer } from 'node:http';
+import { basename } from 'node:path';
+import { DirectionsStore } from './store.js';
+import { viewerPage } from './viewer.js';
+const MAX_PICK_BYTES = 4 * 1024;
+/** The viewer as a Preview beside the thread shows it, which has no room for the rounds. */
+export const SIDEBAR_CLOSED = '#sidebar-closed';
+/**
+ * Jinion's own place to show directions, the same for every project and client: the rounds kept under the project's
+ * folder in `~/.jinion`, served to a viewer on 127.0.0.1 behind a token. Nothing listens before a round is shown.
+ */
+export class Directions {
+    cwd;
+    store;
+    token = randomBytes(16).toString('hex');
+    /** The conversation each round was shown in, while it is open; a pick on any other is only kept. */
+    listeners = new Map();
+    server;
+    port;
+    constructor(cwd) {
+        this.cwd = cwd;
+        this.store = new DirectionsStore(cwd);
+    }
+    async show(offered, onPick) {
+        const round = this.store.add(offered);
+        this.listeners.set(round.id, onPick);
+        const viewer = await this.address();
+        return {
+            round,
+            address: `${viewer}?round=${round.id}`,
+            /** Each direction's page alone, for the agent to look at. */
+            pages: round.directions.map((_, index) => `${viewer}rounds/${round.id}/${index + 1}`),
+            /** Each direction in the viewer without its sidebar, as a Preview shows the round. */
+            shown: round.directions.map((_, index) => `${viewer}?round=${round.id}&direction=${index + 1}${SIDEBAR_CLOSED}`),
+        };
+    }
+    /** The viewer, at the newest round. */
+    async address() {
+        this.port ??= this.listen();
+        return `http://127.0.0.1:${await this.port}/${this.token}/`;
+    }
+    pick(id, direction) {
+        const round = this.store.pick(id, direction);
+        if (!round)
+            return undefined;
+        const listener = this.listeners.get(id);
+        listener?.({ round, direction });
+        return { round, sent: listener !== undefined };
+    }
+    close() {
+        this.server?.close();
+        this.server = undefined;
+        this.port = undefined;
+    }
+    listen() {
+        const server = createServer((request, response) => this.receive(request, response));
+        this.server = server;
+        // The app quits whether or not a browser still holds a connection open.
+        server.unref();
+        return new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(0, '127.0.0.1', () => resolve(server.address().port));
+        });
+    }
+    receive(request, response) {
+        const { pathname } = new URL(request.url ?? '/', 'http://127.0.0.1');
+        const [token, ...rest] = pathname.split('/').slice(1);
+        const path = rest.join('/');
+        response.setHeader('Cache-Control', 'no-store');
+        if (token !== this.token)
+            return void response.writeHead(404).end();
+        if (request.method === 'GET' && path === '')
+            return send(response, 'text/html', viewerPage(basename(this.cwd)));
+        if (request.method === 'GET' && path === 'rounds')
+            return send(response, 'application/json', JSON.stringify(this.store.list()));
+        const page = /^rounds\/([^/]+)\/(\d+)$/.exec(path);
+        if (request.method === 'GET' && page) {
+            const html = this.store.page(page[1], Number(page[2]) - 1);
+            if (html === undefined)
+                return void response.writeHead(404).end();
+            // A page of its own origin, so what the agent wrote can't reach the viewer, its token or the picks.
+            response.setHeader('Content-Security-Policy', 'sandbox allow-scripts allow-forms allow-popups');
+            return send(response, 'text/html', html);
+        }
+        const pick = /^rounds\/([^/]+)\/pick$/.exec(path);
+        if (request.method === 'POST' && pick)
+            return this.receivePick(request, response, pick[1]);
+        response.writeHead(404).end();
+    }
+    receivePick(request, response, id) {
+        const chunks = [];
+        let size = 0;
+        request.on('data', (chunk) => {
+            size += chunk.length;
+            if (size <= MAX_PICK_BYTES)
+                chunks.push(chunk);
+        });
+        request.on('end', () => {
+            const direction = size <= MAX_PICK_BYTES ? directionOf(Buffer.concat(chunks).toString('utf8')) : undefined;
+            const answer = direction === undefined ? undefined : this.pick(id, direction);
+            if (!answer)
+                return void response.writeHead(400).end();
+            send(response, 'application/json', JSON.stringify(answer));
+        });
+    }
+}
+function send(response, type, body) {
+    response.writeHead(200, { 'Content-Type': `${type}; charset=utf-8` }).end(body);
+}
+function directionOf(body) {
+    try {
+        const { direction } = JSON.parse(body);
+        return typeof direction === 'string' ? direction : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=directions.js.map

package/dist/directions/directions.js.map

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

package/dist/directions/store.d.ts

@@ -0,0 +1,34 @@
+export interface Direction {
+    name: string;
+    idea: string;
+}
+/** A round as the agent hands it over: each direction with its page. */
+export interface Offered {
+    title: string;
+    directions: (Direction & {
+        html: string;
+    })[];
+}
+export interface Round {
+    id: string;
+    title: string;
+    /** When it was shown, in milliseconds. */
+    at: number;
+    directions: Direction[];
+    picked?: string;
+}
+/** The project's rounds of directions, a folder each, out of the project and of git. */
+export declare class DirectionsStore {
+    private readonly cwd;
+    constructor(cwd: string);
+    get dir(): string;
+    add({ title, directions }: Offered): Round;
+    /** The newest first. */
+    list(): Round[];
+    get(id: string): Round | undefined;
+    /** The page of a round's direction, by its place in the round. */
+    page(id: string, index: number): string | undefined;
+    pick(id: string, name: string): Round | undefined;
+    private save;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/directions/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/directions/store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CAAC,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wFAAwF;AACxF,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAhC,YAA6B,GAAG,EAAE,MAAM,EAAI;IAE5C,IAAI,GAAG,WAEN;IAED,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,GAAG,KAAK,CASzC;IAED,wBAAwB;IACxB,IAAI,IAAI,KAAK,EAAE,CAMd;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAMjC;IAED,kEAAkE;IAClE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,sBAK7B;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAShD;IAED,OAAO,CAAC,IAAI;CAGb"}

package/dist/directions/store.js

@@ -0,0 +1,61 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { projectDir } from '../lib/paths.js';
+/** The project's rounds of directions, a folder each, out of the project and of git. */
+export class DirectionsStore {
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    get dir() {
+        return join(projectDir(this.cwd), 'directions');
+    }
+    add({ title, directions }) {
+        const round = { id: randomUUID().slice(0, 8), title, at: Date.now(), directions: directions.map(({ name, idea }) => ({ name, idea })) };
+        const folder = join(this.dir, round.id);
+        mkdirSync(folder, { recursive: true });
+        for (const [index, { html }] of directions.entries())
+            writeFileSync(join(folder, pageName(index)), html);
+        this.save(round);
+        return round;
+    }
+    /** The newest first. */
+    list() {
+        if (!existsSync(this.dir))
+            return [];
+        return readdirSync(this.dir)
+            .flatMap((id) => this.get(id) ?? [])
+            .sort((a, b) => b.at - a.at);
+    }
+    get(id) {
+        if (!ROUND_ID.test(id))
+            return undefined;
+        const file = join(this.dir, id, 'round.json');
+        return existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : undefined;
+    }
+    /** The page of a round's direction, by its place in the round. */
+    page(id, index) {
+        const round = this.get(id);
+        if (!round || !Number.isInteger(index) || index < 0 || index >= round.directions.length)
+            return undefined;
+        return readFileSync(join(this.dir, id, pageName(index)), 'utf8');
+    }
+    pick(id, name) {
+        const round = this.get(id);
+        if (!round?.directions.some((direction) => direction.name === name))
+            return undefined;
+        const picked = { ...round, picked: name };
+        this.save(picked);
+        return picked;
+    }
+    save(round) {
+        writeFileSync(join(this.dir, round.id, 'round.json'), `${JSON.stringify(round, null, 2)}\n`);
+    }
+}
+// Ids come back in addresses, so only one of ours ever names a folder.
+const ROUND_ID = /^[0-9a-f]{8}$/;
+function pageName(index) {
+    return `${index + 1}.html`;
+}
+//# sourceMappingURL=store.js.map

package/dist/directions/store.js.map

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

package/dist/directions/tools.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ToolCall } from '../agent/tools.js';
+import type { Previews } from '../preview/previews.js';
+import { type Directions, type Picked } from './directions.js';
+/** A tool the agent shows directions with; each backend offers it its own way. */
+export interface DirectionsTool<S extends z.ZodRawShape = z.ZodRawShape> {
+    description: string;
+    input: S;
+    run(input: z.infer<z.ZodObject<S>>): Promise<string>;
+}
+/** `onPick` is told of a pick on a round this conversation showed; `previews` opens the round beside the thread where the app has a Preview. */
+export declare function directionsTools(directions: Directions, onPick: (picked: Picked) => void, previews?: Previews): {
+    show_directions: DirectionsTool<{
+        title: z.ZodString;
+        directions: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            idea: z.ZodString;
+            html: z.ZodString;
+        }, z.core.$strip>>;
+    }>;
+};
+export type DirectionsTools = ReturnType<typeof directionsTools>;
+export type DirectionsAction = keyof DirectionsTools;
+export declare const DIRECTIONS_ACTIONS: Set<string>;
+/** A call of the tool as the conversation shows it, worded alike whichever backend made it. */
+export declare function directionsCall(input: unknown): ToolCall;
+/** What the user's pick says to the agent, as their own message. */
+export declare function pickMessage({ round, direction }: Picked): string;
+//# sourceMappingURL=tools.d.ts.map

package/dist/directions/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/directions/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAkB,MAAM,iBAAiB,CAAC;AAE/E,kFAAkF;AAClF,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAMD,gJAAgJ;AAChJ,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAEzG,eAAe;;;;;;;;EA4ClB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,MAAM,eAAe,CAAC;AAErD,eAAO,MAAM,kBAAkB,aAAoE,CAAC;AAEpG,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAIvD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,UAEvD"}

package/dist/directions/tools.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { errorMessage } from '../lib/errors.js';
+import { SIDEBAR_CLOSED } from './directions.js';
+const MAX_PAGE_BYTES = 2 * 1024 * 1024;
+const define = (tool) => tool;
+/** `onPick` is told of a pick on a round this conversation showed; `previews` opens the round beside the thread where the app has a Preview. */
+export function directionsTools(directions, onPick, previews) {
+    return {
+        show_directions: define({
+            description: "Shows the user a round of directions to pick from, in Jinion's own viewer outside the project: each direction's name, its idea in a sentence and its page. Use it whenever you offer directions, rather than describing them in words or writing their pages into the project. Nothing is written in the project and nothing is asked. The user's pick comes back as their next message.",
+            input: {
+                title: z.string().describe('What the round decides, in a few words, such as "The today screen".'),
+                directions: z
+                    .array(z.object({
+                    name: z.string().describe('A word or two the user can call it by.'),
+                    idea: z.string().describe('What it stands for and what it gives up, in a sentence.'),
+                    html: z
+                        .string()
+                        .describe("Its page: one whole HTML document, its CSS and any script inline, pictures as data: URLs or from the web. Nothing from the project's files or its dev server, which the viewer can't reach."),
+                }))
+                    .min(2)
+                    .max(4),
+            },
+            run: async ({ title, directions: offered }) => {
+                const names = offered.map(({ name }) => name.trim());
+                if (new Set(names).size < names.length)
+                    return 'Two directions have the same name. Give each its own, so the user can tell them apart.';
+                const large = offered.find(({ html }) => Buffer.byteLength(html) > MAX_PAGE_BYTES);
+                if (large)
+                    return `The page of ${large.name} is over 2 MB. Leave large pictures out, or take them from the web.`;
+                const { address, pages, shown } = await directions.show({ title, directions: offered.map((direction, index) => ({ ...direction, name: names[index] })) }, onPick);
+                const preview = previews?.client;
+                const opened = preview && !(await preview.open(`${address}${SIDEBAR_CLOSED}`).catch((error) => ({ error: errorMessage(error) }))).error;
+                return [
+                    opened
+                        ? 'The directions are open in the Preview beside the conversation, where the user sees them now.'
+                        : `The directions are shown. Give the user this address to open in their browser: ${address}`,
+                    'They pick there, and the pick comes back as their next message; they may also answer in words. Until they pick, build none of the directions in the project.',
+                    'Before you tell them, look at each page with `look`; if one needs fixing, show the round again:',
+                    // In the Preview each is looked at in the viewer, so the round stays where the user sees it.
+                    ...(opened ? shown : pages).map((page, index) => `- ${names[index]}: ${page}`),
+                ].join('\n');
+            },
+        }),
+    };
+}
+export const DIRECTIONS_ACTIONS = new Set(['show_directions']);
+/** A call of the tool as the conversation shows it, worded alike whichever backend made it. */
+export function directionsCall(input) {
+    const { title } = (input ?? {});
+    return { name: 'other', input: { title: 'Show directions', detail: String(title ?? '') } };
+}
+/** What the user's pick says to the agent, as their own message. */
+export function pickMessage({ round, direction }) {
+    return `I pick ${direction}, of the directions for ${round.title}.`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/directions/tools.js.map

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

package/dist/directions/viewer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The viewer the core serves, as drawn in @jinion/ui's playground (`pages/directions`): one page that reads the rounds
+ * from beside it. The core draws no React, so it is written out here, with @jinion/ui's tokens by the same names.
+ */
+export declare function viewerPage(project: string): string;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/directions/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/directions/viewer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,UAezC"}