The VS Code of video editing, built for agents.
TypeScript
Update brand documentation and assets
konstantin-pauluscb852b0ca53b
diff --git a/docs/brand/README.md b/docs/brand/README.mdindex fb49048d..4f93b467 100644--- a/docs/brand/README.md+++ b/docs/brand/README.md@@ -1,10 +1,8 @@-# Diffusion Studio brand+# House style-The fallback brand system: use it only when the brief, the project, or the user-supplies no branding of their own. Any branding they do specify wins.--When it applies, these references are the source of truth, and the bundled-library comes before anything newly made.+The fallback style: use it only when the brief, the project, or the user supplies no style+reference of their own. Any branding or direction they do specify wins, in whole or in part;+these references fill only the gaps it leaves.## Read the relevant references@@ -17,10 +15,10 @@ library comes before anything newly made.When work spans multiple rows, use each relevant reference.-## Apply the system+## Apply the style-1. Check `library.md` before creating a brand asset, component, or composition.+1. Check `library.md` before creating a reusable asset, component, or composition.2. Reuse the closest existing item and change its content or inputs.3. Use relative paths to bundled assets instead of external file-share links.-4. Do not invent product facts, claims, assets, or brand rules.-5. Report missing inputs, deliberate exceptions, and reusable work that should join the library.+4. Treat the values in these references as defaults. Depart from one when the subject, footage,+ or format calls for it, and keep the departure consistent across the piece.diff --git a/docs/brand/assets/components/tokens.ts b/docs/brand/assets/components/tokens.tsindex 7a84e2f6..ea36c21c 100644--- a/docs/brand/assets/components/tokens.ts+++ b/docs/brand/assets/components/tokens.ts@@ -3,7 +3,6 @@ export const colors = {surface: "#161616",text: "#F8F8F8",textSecondary: "#A4A4A4",- brandRed: "#F43535",} as const;export const fonts = {diff --git a/docs/brand/assets/logos/icon-white.svg b/docs/brand/assets/logos/icon-white.svgdeleted file mode 100644index 6772da3f..00000000--- a/docs/brand/assets/logos/icon-white.svg+++ /dev/null@@ -1,3 +0,0 @@-<svg width="150" height="150" viewBox="0 0 150 150" fill="none" xmlns="http://www.w3.org/2000/svg">-<path d="M63.0888 31.3278C70.7687 26.8907 80.2313 26.8907 87.9111 31.3278L107.089 42.4086C114.769 46.8457 119.5 55.0458 119.5 63.9196V86.0804C119.5 94.9539 114.769 103.154 107.089 107.591L87.9111 118.672C80.2313 123.109 70.7687 123.109 63.0888 118.672L43.9105 107.591C36.2309 103.154 31.5 94.9539 31.5 86.0804V63.9196C31.5 55.0458 36.2308 46.8457 43.9105 42.4086L63.0888 31.3278ZM81.8278 42.2313C77.9879 40.0131 73.2566 40.0131 69.4173 42.2313L50.2553 53.3032C46.4155 55.5218 44.0494 59.6218 44.0494 64.0586V86.1999C44.0494 90.637 46.4154 94.7369 50.2553 96.9554L69.4173 108.026C73.2566 110.245 77.9879 110.245 81.8278 108.026L100.989 96.9554C104.829 94.7369 107.195 90.637 107.195 86.1999V64.0586C107.195 59.6218 104.829 55.5217 100.989 53.3032L81.8278 42.2313Z" fill="white"/>-</svg>diff --git a/docs/brand/assets/logos/logo-white.svg b/docs/brand/assets/logos/logo-white.svgdeleted file mode 100644index 0a88cd37..00000000--- a/docs/brand/assets/logos/logo-white.svg+++ /dev/null@@ -1,20 +0,0 @@-<svg width="786" height="156" viewBox="0 0 786 156" fill="none" xmlns="http://www.w3.org/2000/svg">-<path d="M63.9286 33.1456C71.8245 28.5869 81.5532 28.5869 89.4492 33.1456L109.167 44.53C117.063 49.0887 121.927 57.5135 121.927 66.6305V89.3987C121.927 98.5154 117.063 106.941 109.167 111.499L89.4492 122.884C81.5532 127.442 71.8245 127.442 63.9286 122.884L44.2108 111.499C36.3152 106.941 31.4512 98.5154 31.4512 89.3987V66.6305C31.4512 57.5136 36.3151 49.0888 44.2108 44.53L63.9286 33.1456ZM83.1947 44.3479C79.2468 42.0689 74.3824 42.0688 70.4351 44.3479L50.7341 55.7232C46.7862 58.0026 44.3536 62.215 44.3536 66.7733V89.5215C44.3536 94.0801 46.7861 98.2924 50.7341 100.572L70.4351 111.946C74.3824 114.225 79.2468 114.225 83.1947 111.946L102.895 100.572C106.843 98.2924 109.276 94.0801 109.276 89.5215V66.7733C109.276 62.2149 106.843 58.0025 102.895 55.7232L83.1947 44.3479Z" fill="white"/>-<path d="M560.702 45.6675C565.496 45.6675 569.584 46.5463 572.967 48.3042C576.349 50.062 579.021 52.4657 580.983 55.5142C582.946 58.5626 584.153 62.0481 584.606 65.9702L574.558 66.5376C574.263 64.1665 573.54 62.0764 572.39 60.2671C571.239 58.4579 569.679 57.0434 567.707 56.0249C565.735 55.0065 563.342 54.4976 560.527 54.4976C557.009 54.4976 554.223 55.3162 552.17 56.9526C550.117 58.589 549.09 60.7351 549.09 63.3911C549.09 65.164 549.514 66.6329 550.363 67.7974C551.212 68.9619 552.711 69.9805 554.857 70.853C557.004 71.7255 560.064 72.6398 564.038 73.5952C569.46 74.824 573.764 76.3324 576.949 78.1206C580.134 79.9088 582.405 81.9917 583.761 84.3696C585.117 86.7476 585.795 89.4609 585.795 92.5093C585.795 96.2282 584.842 99.4519 582.938 102.179C581.035 104.906 578.381 107.002 574.978 108.468C571.574 109.934 567.608 110.667 563.078 110.667C558.065 110.667 553.721 109.762 550.047 107.952C546.372 106.141 543.48 103.628 541.372 100.41C539.264 97.1918 538.041 93.4379 537.705 89.1489L547.797 88.5601C548.178 91.403 549.006 93.8176 550.281 95.8032C551.557 97.7889 553.272 99.2915 555.427 100.31C557.582 101.329 560.191 101.837 563.253 101.837C565.893 101.837 568.137 101.503 569.984 100.835C571.832 100.167 573.243 99.1802 574.219 97.8745C575.194 96.5688 575.683 94.9696 575.683 93.0776C575.683 91.3466 575.271 89.8131 574.45 88.478C573.629 87.1431 572.06 85.9176 569.744 84.8022C567.428 83.6868 564.005 82.5857 559.476 81.4995C554.477 80.2872 550.481 78.9404 547.487 77.4595C544.494 75.9785 542.327 74.1449 540.987 71.9585C539.648 69.772 538.978 67.047 538.978 63.7837C538.978 60.1956 539.848 57.0411 541.59 54.3208C543.331 51.6005 545.827 49.4779 549.076 47.9536C552.325 46.4295 556.201 45.6675 560.702 45.6675Z" fill="white"/>-<path d="M375.09 61.5796C379.138 61.5796 382.542 62.2687 385.302 63.6479C388.062 65.0274 390.222 66.8764 391.781 69.1948C393.341 71.5133 394.339 74.1074 394.778 76.9761L384.884 77.5015C384.589 75.9083 384.02 74.5153 383.177 73.3228C382.333 72.1303 381.229 71.1969 379.865 70.5229C378.501 69.8491 376.873 69.5122 374.98 69.5122C372.058 69.5123 369.875 70.0881 368.432 71.2397C366.988 72.3914 366.267 73.883 366.267 75.7144C366.267 77.0786 366.596 78.1973 367.256 79.0698C367.916 79.9423 368.993 80.6535 370.488 81.2036C371.983 81.7538 373.985 82.2339 376.491 82.645C381.334 83.4205 385.132 84.4071 387.886 85.603C390.64 86.7991 392.589 88.2825 393.731 90.0532C394.874 91.8239 395.444 93.9849 395.444 96.5356C395.444 99.4672 394.617 101.961 392.962 104.018C391.307 106.075 389.037 107.64 386.153 108.712C383.27 109.785 379.936 110.321 376.154 110.321C371.728 110.321 367.996 109.645 364.958 108.295C361.92 106.945 359.573 105.084 357.918 102.711C356.263 100.339 355.319 97.6275 355.085 94.5767L365.043 94.0718C365.482 96.6506 366.575 98.6814 368.319 100.164C370.064 101.646 372.683 102.387 376.176 102.387C379.007 102.387 381.252 101.929 382.912 101.012C384.572 100.095 385.402 98.6375 385.402 96.6401C385.402 95.512 385.131 94.5704 384.589 93.8159C384.047 93.0615 382.996 92.4024 381.436 91.8384C379.875 91.2742 377.563 90.7276 374.501 90.1997C369.852 89.3681 366.201 88.3577 363.549 87.1675C360.896 85.9773 359.012 84.4777 357.896 82.6685C356.781 80.8592 356.224 78.6719 356.224 76.1069C356.224 71.8203 357.834 68.3277 361.053 65.6284C364.272 62.9292 368.951 61.5796 375.09 61.5796Z" fill="white"/>-<path fill-rule="evenodd" clip-rule="evenodd" d="M441.527 61.5796C446.001 61.5797 449.906 62.5828 453.243 64.5894C456.58 66.596 459.17 69.4166 461.013 73.0513C462.856 76.6861 463.777 80.9857 463.777 85.9497C463.777 90.8694 462.856 95.1616 461.013 98.8257C459.17 102.489 456.58 105.321 453.243 107.321C449.906 109.32 446.001 110.321 441.527 110.321C437.054 110.321 433.137 109.32 429.778 107.321C426.419 105.321 423.818 102.49 421.975 98.8257C420.131 95.1616 419.21 90.8694 419.21 85.9497C419.21 80.9857 420.131 76.6861 421.975 73.0513C423.818 69.4165 426.419 66.596 429.778 64.5894C433.137 62.5828 437.054 61.5796 441.527 61.5796ZM441.527 69.8276C437.657 69.8276 434.642 71.2552 432.486 74.1108C430.33 76.9666 429.252 80.9132 429.252 85.9497C429.252 91 430.33 94.9496 432.486 97.7983C434.642 100.647 437.657 102.072 441.527 102.072C445.398 102.072 448.4 100.647 450.534 97.7983C452.668 94.9496 453.735 91.0001 453.735 85.9497C453.735 80.9132 452.668 76.9666 450.534 74.1108C448.4 71.2553 445.398 69.8277 441.527 69.8276Z" fill="white"/>-<path fill-rule="evenodd" clip-rule="evenodd" d="M763.724 61.5796C768.197 61.5796 772.102 62.5827 775.439 64.5894C778.776 66.596 781.367 69.4165 783.21 73.0513C785.053 76.6861 785.975 80.9857 785.975 85.9497C785.975 90.8694 785.053 95.1616 783.21 98.8257C781.367 102.49 778.776 105.321 775.439 107.321C772.102 109.32 768.197 110.321 763.724 110.321C759.25 110.321 755.334 109.32 751.975 107.321C748.616 105.321 746.014 102.49 744.171 98.8257C742.328 95.1616 741.406 90.8694 741.406 85.9497C741.406 80.9857 742.328 76.6861 744.171 73.0513C746.014 69.4165 748.615 66.596 751.975 64.5894C755.334 62.5827 759.25 61.5796 763.724 61.5796ZM763.724 69.8276C759.853 69.8276 756.84 71.2553 754.684 74.1108C752.527 76.9666 751.449 80.9132 751.449 85.9497C751.449 91.0002 752.527 94.9495 754.684 97.7983C756.84 100.647 759.853 102.072 763.724 102.072C767.594 102.072 770.596 100.647 772.73 97.7983C774.864 94.9495 775.932 91.0002 775.932 85.9497C775.932 80.9132 774.864 76.9666 772.73 74.1108C770.597 71.2554 767.594 69.8276 763.724 69.8276Z" fill="white"/>-<path d="M319.208 90.1919C319.208 94.3383 319.916 97.3861 321.333 99.3354C322.75 101.285 324.933 102.259 327.884 102.259C331.171 102.259 333.739 101.182 335.589 99.0269C337.439 96.8719 338.364 93.8124 338.364 89.8481V62.6294H348.035V109.268H339.051L338.96 101.663C338.02 103.841 336.72 105.628 335.057 107.02C332.429 109.219 329.031 110.319 324.863 110.319C320.166 110.319 316.437 108.757 313.677 105.632C310.917 102.508 309.537 98.1797 309.537 92.6479V62.6294H319.208V90.1919Z" fill="white"/>-<path d="M636.149 90.1919C636.149 94.3382 636.858 97.386 638.274 99.3354C639.691 101.285 641.875 102.259 644.825 102.259C648.112 102.259 650.681 101.182 652.531 99.0269C654.381 96.8719 655.306 93.8122 655.306 89.8481V62.6294H664.978V109.268H655.993L655.901 101.665C654.961 103.842 653.661 105.628 651.998 107.02C649.37 109.219 645.972 110.319 641.805 110.319C637.107 110.319 633.378 108.757 630.618 105.632C627.858 102.508 626.479 98.1796 626.479 92.6479V62.6294H636.149V90.1919Z" fill="white"/>-<path fill-rule="evenodd" clip-rule="evenodd" d="M715.41 109.258H706.377L706.113 102.292C704.828 104.804 702.89 106.768 700.297 108.185C697.704 109.602 694.772 110.31 691.502 110.31C687.5 110.31 684.038 109.313 681.117 107.321C678.196 105.328 675.951 102.511 674.381 98.8696C672.811 95.2278 672.026 90.917 672.026 85.939C672.026 80.9611 672.815 76.651 674.392 73.0093C675.968 69.3675 678.221 66.5507 681.149 64.5581C684.078 62.5655 687.528 61.5688 691.502 61.5688C694.695 61.5689 697.549 62.2368 700.062 63.5718C702.576 64.9068 704.468 66.7787 705.738 69.187V47.062H715.41V109.258ZM694.126 69.8169C690.445 69.817 687.514 71.2519 685.336 74.1216C683.158 76.9913 682.068 80.9307 682.068 85.939C682.068 90.875 683.161 94.7966 685.347 97.7026C687.532 100.609 690.459 102.061 694.126 102.061C696.619 102.061 698.726 101.423 700.449 100.148C702.172 98.8725 703.484 97.0265 704.386 94.6099C705.287 92.1933 705.738 89.3028 705.738 85.939C705.738 82.4865 705.287 79.5628 704.386 77.1685C703.484 74.7742 702.172 72.95 700.449 71.6968C698.726 70.4436 696.618 69.8169 694.126 69.8169Z" fill="white"/>-<path d="M493.952 61.5796C497.444 61.5796 500.358 62.3467 502.692 63.8813C505.027 65.4161 506.789 67.5122 507.977 70.1694C509.164 72.8267 509.759 75.8604 509.759 79.271V109.269H500.088V82.2778C500.088 79.5566 499.801 77.2594 499.228 75.3872C498.654 73.5149 497.718 72.0879 496.419 71.1079C495.12 70.128 493.4 69.6382 491.261 69.6382C488.035 69.6382 485.433 70.7173 483.456 72.8745C481.479 75.0318 480.489 78.1664 480.489 82.2778V109.269H470.818V62.6304H479.603L479.839 70.7056C480.351 69.3574 480.994 68.1721 481.771 67.1519C483.224 65.2445 485.002 63.8391 487.104 62.9351C489.205 62.0311 491.488 61.5796 493.952 61.5796Z" fill="white"/>-<path d="M607.444 62.6294H619.797V70.436H607.444V95.7495C607.444 97.9078 607.915 99.3995 608.856 100.224C609.798 101.049 611.24 101.461 613.181 101.461H619.797V109.268H610.84C606.369 109.268 603.074 108.237 600.954 106.177C598.834 104.117 597.773 100.882 597.773 96.4712V70.436H590.646V62.6294H597.773V51.7036H607.444V62.6294Z" fill="white"/>-<path fill-rule="evenodd" clip-rule="evenodd" d="M192.892 47.062C202.68 47.062 210.211 49.7635 215.484 55.1655C220.758 60.5675 223.394 68.2614 223.395 78.2476C223.395 88.1757 220.801 95.8268 215.615 101.2C210.429 106.572 203.03 109.258 193.418 109.258H172.758V47.062H192.892ZM182.604 100.366H192.892C199.687 100.366 204.767 98.5313 208.131 94.8628C211.495 91.1941 213.177 85.6486 213.177 78.2271C213.177 70.7167 211.495 65.1272 208.131 61.4585C204.767 57.7898 199.687 55.9556 192.892 55.9556H182.604V100.366Z" fill="white"/>-<path d="M274.701 54.8687H267.742C265.932 54.8687 264.591 55.3474 263.721 56.3052C262.851 57.2629 262.416 58.6325 262.416 60.4126V63.3345H280.056V59.8442C280.056 55.9225 281.157 52.8119 283.359 50.5122C285.562 48.2124 288.984 47.062 293.623 47.062H302.032V54.8687H295.073C293.263 54.8687 291.923 55.3477 291.053 56.3052C290.183 57.2629 289.747 58.6325 289.747 60.4126V63.3345H301.398V71.1421H289.747V109.258H280.056V71.1421H262.416V109.258H252.724V71.1421H246.206V63.3345H252.724V59.8442C252.724 55.9224 253.826 52.8119 256.028 50.5122C258.231 48.2125 261.652 47.0621 266.291 47.062H274.701V54.8687Z" fill="white"/>-<path d="M239.931 109.255H230.259V62.6167H239.931V109.255Z" fill="white"/>-<path d="M412.15 109.255H402.479V62.6167H412.15V109.255Z" fill="white"/>-<path d="M734.348 109.255H724.677V62.6167H734.348V109.255Z" fill="white"/>-<path d="M240.127 55.9556H230.063V46.5718H240.127V55.9556Z" fill="white"/>-<path d="M412.347 55.9556H402.283V46.5718H412.347V55.9556Z" fill="white"/>-<path d="M734.544 55.9556H724.48V46.5718H734.544V55.9556Z" fill="white"/>-</svg>diff --git a/docs/brand/design.md b/docs/brand/design.mdindex 6fcb6a76..6646b0e3 100644--- a/docs/brand/design.md+++ b/docs/brand/design.md@@ -1,6 +1,6 @@-# Diffusion Studio visual guide+# Visual guide-Define color, type, identity, imagery, layout, safe areas, and captions. Use `video.md` for motion and sound, `voice.md` for words, and `library.md` for reusable files.+Define color, type, imagery, layout, safe areas, and captions. Use `video.md` for motion and sound, `voice.md` for words, and `library.md` for reusable files.Scale every pixel value below from a short edge of 1080.@@ -8,12 +8,12 @@ Scale every pixel value below from a short edge of 1080.- Build structure with scale, weight, spacing, and luminance.- Keep the frame near-achromatic. Use color only when it carries meaning.-- Show the product clearly. Do not decorate over controls or content the viewer must read.+- Show the subject clearly. Do not decorate over controls or content the viewer must read.- Prefer one clear focal point to several equal points.## Color-Use these hex values in Diffusion Studio source.+Default to this dark, neutral palette.| Role | Value || --- | --- |@@ -21,20 +21,20 @@ Use these hex values in Diffusion Studio source.| Surface | `#161616` || Text | `#F8F8F8` || Text, secondary | `#A4A4A4` |-| Brand red | `#F43535` |-Default to leaving red out. It lives on the app icon. At most one element may carry it. Never-use it for a title or a large fill. The app's destructive state is `#E62D2D`, so red beside-product UI may read as an error.+The palette has no accent of its own. When the piece needs one, take it from the subject: a+color already present in its footage, interface, or supplied material. Use one accent per piece,+on at most one element per shot, and never for a title or a large fill. Beside captured UI, avoid+an accent that reads as one of that interface's states, such as red for an error.-`#008CFF` is the product blue. Use it only when it already appears in real product UI. Never-use it as a brand accent.--Place text on `#000000` or `#161616`. Do not rely on a shadow or stroke for contrast.+Invert the palette for a piece whose footage is predominantly light. Place text on a plain+background or surface color. Do not rely on a shadow or stroke for contrast.## Typography-Use `Geist`. Use `Geist Mono` for code and figures. Do not use italic.+Default to `Geist`, with `Geist Mono` for code and figures. Any one clean sans-serif family may+replace it when the subject suggests another; keep to one family plus its mono companion. Do not+use italic.| Role | Size | Weight | Copy limit || --- | ---: | ---: | ---: |@@ -44,25 +44,17 @@ Use `Geist`. Use `Geist Mono` for code and figures. Do not use italic.| Lower-third detail | 30 | 400 | 40 characters || Label | 24 | 500 | 16 characters |-Rewrite copy that exceeds a limit. Do not shrink the type. Confirm that Geist and Geist Mono-are available before final output; no font files are bundled yet.--## Logo and icon--Use `assets/logos/logo-white.svg` or `assets/logos/icon-white.svg` on a dark, quiet background. Use the wordmark when the name must be clear. Use the icon only when the product is already named or the small space cannot hold the wordmark.+Sizes and weights are starting points; keep their order and rough ratios when adjusting them.+Rewrite copy that exceeds a limit instead of shrinking the type. Confirm that the chosen fonts+are available before final output; no font files are bundled.-Do not tint, outline, stretch, crop, rotate, rebuild, or place either mark over busy footage.-No dark mark, minimum size, clear-space rule, or video-scale logo bug has been supplied. Do not-invent one.+## Captured imagery-## Product imagery--- Show real product UI. Do not reconstruct or recolor it.+- Show real product UI rather than a reconstruction or recolor.- Use `contain` when viewers must read the whole interface.- Use `cover` only when the crop cannot hide a control, label, or result needed for the point.-- Keep product captures sharp and at their native aspect ratio.+- Keep captures sharp and at their native aspect ratio.- Use a plain surface around captures instead of stretching them to fill a frame.-- Add photography or illustration only when the request or library supplies a suitable asset.## Layout and aspect ratios@@ -76,7 +68,7 @@ Use at most two text elements in one shot: a primary line and its qualifier.Use these media forms:-- **Full frame:** one product view or one dominant subject.+- **Full frame:** one view or one dominant subject.- **Two-up:** two states, inputs, speakers, or before-and-after views.- **Four-up:** a set of equal details that remain legible at delivery size.@@ -96,8 +88,3 @@ exposes color slots. On 9:16, do not add another bottom offset to the preset.A preset carries its own legibility. Never put a band, plate, or gradient behind captions. When onedoes not read over the footage, change the preset or its `verticalAlign` or `offsetY`; if it still does not read,that is the answer for that stretch, not a reason to dim the picture.--## Known gaps--The brand has no bundled fonts, dark logo, approved video logo bug, image library, shared code-text size, or measured minimum logo size. Name the gap when a task depends on one.diff --git a/docs/brand/library.md b/docs/brand/library.mdindex f113d2df..be2e532a 100644--- a/docs/brand/library.md+++ b/docs/brand/library.md@@ -1,13 +1,13 @@-# Diffusion Studio brand library+# Library-Use this catalog before selecting or making a brand file. References define the brand; bundled-files apply it. Keep one-off project media with its project.+Use this catalog before selecting or making a reusable file. References define the style;+bundled files apply it. Keep one-off project media with its project.## Components and shared values| File | Use | Notes || --- | --- | --- |-| `assets/components/tokens.ts` | Share brand color, type, spacing, and safe-area values | Keep it in sync with `design.md` |+| `assets/components/tokens.ts` | Share default color, type, spacing, and safe-area values | Keep it in sync with `design.md`; override values in the project copy, not here || `assets/components/title-card.tsx` | Add a title and optional qualifier | Follow title and subtitle limits in `design.md` || `assets/components/lower-third.tsx` | Add a name and detail over footage | Keep both lines inside the text safe area || `assets/components/callout.tsx` | Add a short label and value | Use it for one fact, not a paragraph |@@ -20,30 +20,13 @@ files the project needs.| File | Use | Format | Required inputs || --- | --- | --- | --- |-| `assets/compositions/product-demo.tsx` | A single product capture with a lower third | 9:16 | `videoSrc`, `name`, `detail` |+| `assets/compositions/product-demo.tsx` | A single capture with a lower third | 9:16 | `videoSrc`, `name`, `detail` || `assets/compositions/product-tour.tsx` | Full frame to two-up to four-up and back | 16:9 by default; may use 9:16 or 1:1 | Four media sources, `name`, `detail` |-| `assets/compositions/end-card.tsx` | A plain branded end card | 9:16 | `title`, `cta` |+| `assets/compositions/end-card.tsx` | A plain end card | 9:16 | `title`, `cta` |Compositions own `<scene>`, timing, and editable inputs. They are starting points, not a second-component system in the Diffusion Studio app.+component system.-## Logos--| File | Use |-| --- | --- |-| `assets/logos/logo-white.svg` | Wordmark on a dark, quiet background |-| `assets/logos/icon-white.svg` | Product icon when the name is already clear |--No dark mark is bundled.--## Fonts, imagery, and audio--No font, reusable image, music, sound-effect, or voiceover file is bundled yet. Do not replace a-missing asset with an unlicensed or unrelated file.--Keep reusable fonts in `assets/fonts/`, imagery in `assets/imagery/`, music in-`assets/audio/music/`, sound effects in `assets/audio/sfx/`, and voiceovers in-`assets/audio/voiceovers/`. Reuse a recording only when its words, delivery, and usage rights fit.## Select media@@ -52,6 +35,5 @@ and widen the search only when needed.## Add to the library-When adding media, record its source and usage rights in this catalog. Add a reusable item only-after it has a clear repeated use. Give a component one job and a small input set. Add a-composition when the scene flow repeats. Do not add a one-off choice as a brand rule.+Add a reusable item once it has a clear repeated use. Give a component one job and a small+input set. Add a composition when the scene flow repeats.diff --git a/docs/brand/video.md b/docs/brand/video.mdindex 733fce9c..9db14788 100644--- a/docs/brand/video.md+++ b/docs/brand/video.md@@ -1,13 +1,14 @@-# Diffusion Studio video guide+# Video guide-Define how the brand behaves over time. Use `design.md` for visual rules, `voice.md` for words,+Define how the style behaves over time. Use `design.md` for visual rules, `voice.md` for words,and `library.md` for reusable source.-Work at 30 fps.+Work at 30 fps unless the source footage or the delivery target sets another rate. Frame counts+below assume 30 fps; keep the millisecond values when the rate differs.## Scene and media structure-Use full frame while one product state carries the point. Move to two-up to compare or connect+Use full frame while one view carries the point. Move to two-up to compare or connecttwo views. Move to four-up only when all four details remain readable. Return to full framewhen one view becomes primary again.@@ -15,7 +16,7 @@ Change the layout because the idea changes, not to add motion. Prefer a hard cutforms. Carry one element across the cut only when it represents the same object or state.In 9:16, hold split layouts longer because each panel is smaller. In 1:1, check that both copy-and product UI still have one clear focal point.+and footage still have one clear focal point.## Timing@@ -34,8 +35,6 @@ Use the nearest anchor and change it only when the motion needs a different qual| Travel | moving between states | `cubicBezier(1,0.49,0,0.55)` || Exit | leaving | `cubicBezier(1,0.02,0.54,0.42)` |-Do not use the `bouncy` or `strong` spring presets.-## MovementLead with one element and delay its support by `"3f"`. Stagger repeated items from a meaningful@@ -51,12 +50,13 @@ Use one flourish per beat. Treat a busy scene as a layout problem.| Hard cut on action | energy while authored motion is still moving || Jump cut | matched direction and speed across the seam || Continuous carry | the same object or state across two beats |-| Hold cut | read-critical text, product UI, and final lockups |+| Hold cut | read-critical text, captured UI, and final lockups |-Use a 300 ms `dissolve` only between two shots of the same subject. Use `fadeToBlack` only to-end a video. Do not use `fadeToWhite`, `slideFromLeft`, or `slideFromRight`.+Prefer these to transition presets. Reserve a 300 ms `dissolve` for two shots of the same+subject and `fadeToBlack` for the end of a video. Use `fadeToWhite` or a slide only when the+footage or brief motivates it.-Cut product captures after the needed action or label has been visible long enough to read.+Cut screen captures after the needed action or label has been visible long enough to read.Tighten a slow cut before adding motion.## Captions@@ -66,9 +66,9 @@ to read without racing the voice. Use the visual treatment in `design.md`.## Sound-Use audio supplied for the project or approved in `library.md`.+Use audio supplied for the project or cataloged in `library.md`.-Give speech priority. Use one clear source for product audio when several copies of the same+Give speech priority. Use one clear audio source when several copies of the samecapture appear on screen; mute the rest.-No house mix level has been supplied. Do not invent one.+Mix so speech stays intelligible over everything else.diff --git a/docs/brand/voice.md b/docs/brand/voice.mdindex 120fe069..a9d01468 100644--- a/docs/brand/voice.md+++ b/docs/brand/voice.md@@ -1,25 +1,20 @@-# Diffusion Studio language and voice guide+# Language and voice guide-Use this guide for what Diffusion Studio says and how it says it. Apply it to titles, labels,-scripts, captions, calls to action, and product descriptions.+Use this guide for what the work says and how it says it. Apply it to titles, labels, scripts,+captions, calls to action, and descriptions.-## Approved product language+## Names-| Name | Copy | Use |-| --- | --- | --- |-| Product name | `Diffusion Studio` | Every product reference |-| One-line description | The video editor for teams creating with agents. | Short introductions and summaries |--Keep `video editor`, `teams`, and `agents` when adapting the one-line description. Do not broaden-a product claim beyond what the request or supplied evidence supports.+Take names, taglines, and descriptions from the request or the supplied material, and keep their+spelling and capitalization exact.## Writing- Lead with the result or action.- Use short words, short sentences, and active voice.- Cut any word that adds no meaning.-- State what the product does. Do not add hype or an unsupported claim.-- Keep code, product names, technical terms, and interface labels exact.+- State what the subject does, without hype.+- Keep code, names, technical terms, and interface labels exact.- Avoid familiar figures of speech and vague claims.- Rewrite copy that breaks a length limit. Do not shrink the type.- Break a writing rule when accuracy or clarity requires it.@@ -28,11 +23,12 @@ Review every prose output against these rules before delivering it.## Tone-Sound clear, calm, and sure. Let the work supply the energy. Do not sound grand, cute, vague,-or eager to impress.+Default to clear, calm, and sure, and let the work supply the energy. Match the register of the+supplied footage or script when it has one: a playful piece may be playful. Do not sound grand,+vague, or eager to impress.-Avoid claims such as `effortless`, `magical`, `revolutionary`, or `all-in-one` unless the team-has approved and proved the claim.+Avoid claims such as `effortless`, `magical`, `revolutionary`, or `all-in-one` unless the+supplied material makes and supports them.## Calls to action@@ -41,5 +37,5 @@ outcome. Keep it short enough to work without punctuation.## Spoken copy-Apply the same writing and tone rules to scripts and narration. No house delivery or-pronunciation guide has been supplied. Do not invent one.+Apply the same writing and tone rules to scripts and narration. Take delivery and pronunciation+from the supplied material; when there is none, keep the read plain.diff --git a/docs/skills/editor.md b/docs/skills/editor.mdindex c556409b..4b0b050e 100644--- a/docs/skills/editor.md+++ b/docs/skills/editor.md@@ -25,7 +25,7 @@ How to understand source material before editing it. Inspect only the modalities- Don't darken, blur, or cover the picture to make something on top of it legible- Let visuals, sound, and voice carry context; let text punctuate rather than explain. Do not add copy, eyebrows, labels, underlines, or brand color highlights unless the brief or explicit video guidance calls for them; examples alone are not instructions.- Choose easing from the intended weight, energy, and continuity of the action.-- When the brief, project, or user specifies branding, follow it. Only when none is specified, fall back to the [Diffusion Studio brand](../brand/README.md) — its design, voice, video, and library references, and the components and compositions bundled with them.+- When the brief, project, or user specifies branding, follow it. Only when none is specified, fall back to the [house style](../brand/README.md) — its design, voice, video, and library references, and the components and compositions bundled with them.# Verification@@ -61,7 +61,7 @@ The authoring reference is served by the app for the installed version: read it- [Tool reference — every tool, its fields, its CLI spelling and its output](../reference/tools/README.md)- [Examples — complete compositions, basics through shaders](../examples/README.md)- [Easings: which cubic-bezier to use and when](../guides/motion/easings.md)-- [Diffusion Studio brand — the fallback when no other branding is specified](../brand/README.md)+- [House style — the fallback when no other branding is specified](../brand/README.md)# Examples