portego-upload 0.1.2 → 0.3.2

package/dist/style/portego/DESIGN.md

@@ -0,0 +1,31 @@
+## Visual direction
+
+Use a quiet, content-first interface that matches the public Portego application.
+
+- Use the supplied CSS tokens and components. Do not replace their colors, typefaces, spacing, borders, or radii.
+- Use warm flat surfaces, one restrained verdigris accent, and muted rust only for errors or serious risks.
+- Use IBM Plex Serif for display headings, IBM Plex Sans for normal text, and IBM Plex Mono only for code, filenames, and small technical labels.
+- Use flat color. Do not use gradients, textures, glass effects, card shadows, decorative illustrations, or animation without a functional reason.
+- Prefer a single readable column. Use grids only when the content benefits from comparison.
+- Keep borders one pixel wide. Cards and sections use the supplied radius.
+- Use sentence case. Avoid all-caps headings, slogans, emoji, exclamation marks, and marketing language.
+- Write direct, complete sentences. State errors and constraints factually.
+- Keep the document responsive. At narrow widths, grids must become one column and wide tables must scroll.
+- Use semantic HTML, a useful heading hierarchy, visible keyboard focus, table headings, and alt text for meaningful images.
+
+## Document structure
+
+- Start with one clear title and a short summary.
+- Put the conclusion or recommendation before supporting detail.
+- Use sections with descriptive headings.
+- Use callouts sparingly for the most important decision, warning, or next step.
+- Use tables for comparisons, not for general page layout.
+- Keep code samples short and horizontally scrollable.
+- End with decisions, next steps, or provenance when they are relevant.
+
+## Technical constraints
+
+- The final document must be one self-contained HTML file.
+- Do not add network-loaded scripts, styles, fonts, images, frames, or media.
+- Keep links as normal anchors. Portego blocks document network requests but readers can still use explicit links where the browser policy permits.
+- Use the provided `data-portego-style` marker. The finalizer replaces it with the selected style and embeds its local font and image resources.

package/dist/style/portego/artifact.css

@@ -0,0 +1,293 @@
+* {
+  box-sizing: border-box;
+}
+
+html {
+  background: var(--page);
+  color: var(--ink);
+  font-family: var(--sans);
+  line-height: 1.5;
+}
+
+body {
+  margin: 0;
+  background: var(--page);
+  color: var(--ink);
+}
+
+a {
+  color: var(--accent);
+  text-underline-offset: 0.18em;
+}
+
+a:hover {
+  filter: brightness(0.85);
+}
+
+h1,
+h2,
+h3 {
+  font-family: var(--serif);
+  font-weight: 500;
+  line-height: 1.3;
+}
+
+h1 {
+  margin: 0;
+  font-size: clamp(2rem, 5vw, 3.4rem);
+  letter-spacing: -0.025em;
+}
+
+h2 {
+  margin: 0 0 var(--space-3);
+  font-size: clamp(1.45rem, 3vw, 2rem);
+}
+
+h3 {
+  margin: 0 0 var(--space-2);
+  font-size: 1.15rem;
+}
+
+p,
+ul,
+ol {
+  margin-top: 0;
+}
+
+code,
+pre {
+  font-family: var(--mono);
+}
+
+:not(pre) > code {
+  padding: 0.08rem 0.3rem;
+  border: 1px solid var(--line);
+  border-radius: 0.3rem;
+  background: var(--surface-sunken);
+  font-size: 0.88em;
+}
+
+pre {
+  margin: 0;
+  padding: var(--space-4);
+  overflow-x: auto;
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+  background: var(--surface-sunken);
+  color: var(--ink);
+  font-size: 0.85rem;
+  line-height: 1.55;
+}
+
+:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+  border-radius: 0.25rem;
+}
+
+.artifact-shell {
+  width: min(var(--shell-max), 100%);
+  margin: 0 auto;
+  padding: var(--space-8) var(--space-5) var(--space-12);
+}
+
+.artifact-header {
+  padding-bottom: var(--space-8);
+  border-bottom: 1px solid var(--line);
+}
+
+.artifact-kicker {
+  margin: 0 0 var(--space-2);
+  color: var(--accent);
+  font-family: var(--mono);
+  font-size: 0.75rem;
+}
+
+.artifact-summary {
+  max-width: 48rem;
+  margin: var(--space-4) 0 0;
+  color: var(--ink-muted);
+  font-size: 1.05rem;
+}
+
+.artifact-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-2);
+  margin-top: var(--space-5);
+}
+
+.artifact-badge {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.18rem 0.55rem;
+  border: 1px solid var(--line);
+  border-radius: var(--radius-pill);
+  color: var(--ink-muted);
+  font-size: 0.75rem;
+}
+
+.artifact-section {
+  padding-top: var(--space-8);
+}
+
+.artifact-section > p:first-of-type {
+  max-width: 48rem;
+  color: var(--ink-muted);
+}
+
+.artifact-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: var(--space-4);
+}
+
+.artifact-grid-three {
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+}
+
+.artifact-card {
+  padding: var(--space-5);
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+  background: var(--surface);
+}
+
+.artifact-card > :last-child {
+  margin-bottom: 0;
+}
+
+.artifact-card-label {
+  display: block;
+  margin-bottom: var(--space-3);
+  color: var(--accent);
+  font-family: var(--mono);
+  font-size: 0.72rem;
+}
+
+.artifact-callout {
+  margin-top: var(--space-5);
+  padding: var(--space-4) var(--space-5);
+  border: 1px solid var(--line);
+  border-left: 3px solid var(--accent);
+  border-radius: 0 var(--radius) var(--radius) 0;
+  background: var(--surface-sunken);
+}
+
+.artifact-callout > :last-child {
+  margin-bottom: 0;
+}
+
+.artifact-callout-danger {
+  border-left-color: var(--danger);
+}
+
+.artifact-table-wrap {
+  overflow-x: auto;
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+  background: var(--surface);
+}
+
+th,
+td {
+  padding: var(--space-3) var(--space-4);
+  border-bottom: 1px solid var(--line);
+  text-align: left;
+  vertical-align: top;
+}
+
+th {
+  background: var(--surface-sunken);
+  font-size: 0.8rem;
+  font-weight: 600;
+}
+
+tr:last-child td {
+  border-bottom: 0;
+}
+
+.artifact-metric {
+  margin: 0;
+  font-family: var(--serif);
+  font-size: 2rem;
+  font-weight: 500;
+  line-height: 1.2;
+}
+
+.artifact-muted {
+  color: var(--ink-muted);
+}
+
+.artifact-decision {
+  display: grid;
+  grid-template-columns: minmax(8rem, 0.28fr) minmax(0, 1fr);
+  gap: var(--space-4);
+  padding: var(--space-4) 0;
+  border-bottom: 1px solid var(--line);
+}
+
+.artifact-decision > strong {
+  color: var(--accent);
+}
+
+.artifact-footer {
+  margin-top: var(--space-12);
+  padding-top: var(--space-4);
+  border-top: 1px solid var(--line);
+  color: var(--ink-muted);
+  font-size: 0.8rem;
+}
+
+/* Markdown the server renders: bare elements with no template structure. */
+.artifact-markdown > h1 {
+  margin-bottom: var(--space-6);
+}
+
+.artifact-markdown h2 {
+  margin-top: var(--space-8);
+}
+
+.artifact-markdown h3 {
+  margin-top: var(--space-6);
+}
+
+.artifact-markdown pre,
+.artifact-markdown .artifact-table-wrap {
+  margin: 0 0 var(--space-4);
+}
+
+.artifact-markdown blockquote {
+  margin: 0 0 var(--space-4);
+  padding: var(--space-2) var(--space-4);
+  border-left: 3px solid var(--accent);
+  color: var(--ink-muted);
+}
+
+.artifact-markdown hr {
+  margin: var(--space-8) 0;
+  border: 0;
+  border-top: 1px solid var(--line);
+}
+
+@media (max-width: 44rem) {
+  .artifact-shell {
+    padding: var(--space-6) var(--space-4) var(--space-8);
+  }
+
+  .artifact-grid,
+  .artifact-grid-three,
+  .artifact-decision {
+    grid-template-columns: 1fr;
+  }
+
+  th,
+  td {
+    padding: var(--space-2) var(--space-3);
+  }
+}

package/dist/style/portego/assets/fonts/LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright 2019 IBM Corp. All rights reserved. IBMPlexSans-Italic[wdth,wght].ttf: Copyright 2019 IBM Corp. All rights reserved.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/style/portego/manifest.json

@@ -0,0 +1,20 @@
+{
+  "schemaVersion": 1,
+  "name": "Portego",
+  "instructions": "DESIGN.md",
+  "styles": ["tokens.css", "artifact.css"],
+  "templates": {
+    "report": {
+      "path": "templates/report.html",
+      "description": "A structured report, proposal, technical note, or analysis."
+    },
+    "decision": {
+      "path": "templates/decision.html",
+      "description": "A decision record with context, options, outcome, and consequences."
+    },
+    "dashboard": {
+      "path": "templates/dashboard.html",
+      "description": "A compact status report with metrics, findings, and follow-up work."
+    }
+  }
+}

package/dist/style/portego/templates/dashboard.html

@@ -0,0 +1,53 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>{{TITLE}}</title>
+  <style data-portego-style></style>
+</head>
+<body>
+  <div class="artifact-shell">
+    <header class="artifact-header">
+      <p class="artifact-kicker">Status report</p>
+      <h1>{{TITLE}}</h1>
+      <p class="artifact-summary">Replace this sentence with the current state and the main conclusion.</p>
+      <div class="artifact-meta">
+        <span class="artifact-badge">{{STYLE_NAME}} style</span>
+      </div>
+    </header>
+
+    <main data-portego-content>
+      <section class="artifact-section">
+        <h2>Current state</h2>
+        <div class="artifact-grid artifact-grid-three">
+          <article class="artifact-card">
+            <span class="artifact-card-label">Metric</span>
+            <p class="artifact-metric">0</p>
+            <p class="artifact-muted">Explain what this number means.</p>
+          </article>
+          <article class="artifact-card">
+            <span class="artifact-card-label">Metric</span>
+            <p class="artifact-metric">0%</p>
+            <p class="artifact-muted">Explain what this percentage means.</p>
+          </article>
+          <article class="artifact-card">
+            <span class="artifact-card-label">Metric</span>
+            <p class="artifact-metric">0</p>
+            <p class="artifact-muted">Explain what this number means.</p>
+          </article>
+        </div>
+      </section>
+
+      <section class="artifact-section">
+        <h2>Findings</h2>
+        <div class="artifact-decision"><strong>Healthy</strong><span>Describe what is working as expected.</span></div>
+        <div class="artifact-decision"><strong>Needs attention</strong><span>Describe the most important issue.</span></div>
+        <div class="artifact-decision"><strong>Next check</strong><span>Describe what should be verified next.</span></div>
+      </section>
+    </main>
+
+    <footer class="artifact-footer">Prepared as a self-contained Portego artifact.</footer>
+  </div>
+</body>
+</html>

package/dist/style/portego/templates/decision.html

@@ -0,0 +1,59 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>{{TITLE}}</title>
+  <style data-portego-style></style>
+</head>
+<body>
+  <div class="artifact-shell">
+    <header class="artifact-header">
+      <p class="artifact-kicker">Decision record</p>
+      <h1>{{TITLE}}</h1>
+      <p class="artifact-summary">Replace this sentence with the decision and its reason.</p>
+      <div class="artifact-meta">
+        <span class="artifact-badge">Proposed</span>
+        <span class="artifact-badge">{{STYLE_NAME}} style</span>
+      </div>
+    </header>
+
+    <main data-portego-content>
+      <section class="artifact-section">
+        <h2>Decision</h2>
+        <div class="artifact-callout">
+          <strong>We will…</strong> State the decision in one direct sentence.
+        </div>
+      </section>
+
+      <section class="artifact-section">
+        <h2>Context</h2>
+        <p>Explain the problem, constraints, and relevant evidence.</p>
+      </section>
+
+      <section class="artifact-section">
+        <h2>Options considered</h2>
+        <div class="artifact-table-wrap">
+          <table>
+            <thead><tr><th>Option</th><th>Benefits</th><th>Costs</th></tr></thead>
+            <tbody>
+              <tr><td>Option A</td><td>Replace with benefits.</td><td>Replace with costs.</td></tr>
+              <tr><td>Option B</td><td>Replace with benefits.</td><td>Replace with costs.</td></tr>
+            </tbody>
+          </table>
+        </div>
+      </section>
+
+      <section class="artifact-section">
+        <h2>Consequences</h2>
+        <ul>
+          <li>Describe an expected consequence.</li>
+          <li>Describe a risk or follow-up action.</li>
+        </ul>
+      </section>
+    </main>
+
+    <footer class="artifact-footer">Prepared as a self-contained Portego artifact.</footer>
+  </div>
+</body>
+</html>

package/dist/style/portego/templates/report.html

@@ -0,0 +1,57 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>{{TITLE}}</title>
+  <style data-portego-style></style>
+</head>
+<body>
+  <div class="artifact-shell">
+    <header class="artifact-header">
+      <p class="artifact-kicker">Report</p>
+      <h1>{{TITLE}}</h1>
+      <p class="artifact-summary">Replace this sentence with the conclusion or purpose of the report.</p>
+      <div class="artifact-meta">
+        <span class="artifact-badge">{{STYLE_NAME}} style</span>
+      </div>
+    </header>
+
+    <main data-portego-content>
+      <section class="artifact-section">
+        <h2>Recommendation</h2>
+        <p>State the recommendation before the supporting detail.</p>
+        <div class="artifact-callout">
+          <strong>Key point.</strong> Use this callout for the most important conclusion.
+        </div>
+      </section>
+
+      <section class="artifact-section">
+        <h2>Analysis</h2>
+        <div class="artifact-grid">
+          <article class="artifact-card">
+            <span class="artifact-card-label">Finding 1</span>
+            <h3>Descriptive heading</h3>
+            <p>Replace this content with evidence and implications.</p>
+          </article>
+          <article class="artifact-card">
+            <span class="artifact-card-label">Finding 2</span>
+            <h3>Descriptive heading</h3>
+            <p>Replace this content with evidence and implications.</p>
+          </article>
+        </div>
+      </section>
+
+      <section class="artifact-section">
+        <h2>Next steps</h2>
+        <ol>
+          <li>Replace this list with concrete actions.</li>
+          <li>Name decisions or dependencies that remain.</li>
+        </ol>
+      </section>
+    </main>
+
+    <footer class="artifact-footer">Prepared as a self-contained Portego artifact.</footer>
+  </div>
+</body>
+</html>