- Added `horizontalConstraintName` and `verticalConstraintName` functions to map constraint types to their respective names.
- Updated `ConstraintsRow` component to utilize these functions for setting `constrainX` and `constrainY` properties.
- Introduced `HORIZONTAL_CONSTRAINTS` and `VERTICAL_CONSTRAINTS` constants in the runtime to define available constraints.
- Enhanced documentation to clarify the behavior of `constrainX` and `constrainY` properties in the JSX elements reference.
- Updated `11-redraw.tsx` to incorporate `useResolution`, ensuring sharp rendering at any export size by adapting the bitmap to the display's pixel ratio.
- Modified the `draw` function to accept a resolution parameter, allowing dynamic adjustments during rendering.
- Enhanced documentation in `README.md` to reflect the new resolution handling feature in the Redraw example.
- Introduced a new example file `10-typegpu.tsx` demonstrating an underwater caustics shader using TypeGPU and Solid.js.
- Implemented shader functionality with adjustable parameters for tile density, speed, fog color, and ambient light.
- Updated `README.md` to include the new example and installation instructions for required packages.
- Enhanced `module.md` with details on using TypeGPU's compile-time plugins in the project's Babel configuration.
- Introduced new export command in the CLI to encode scenes into video files, utilizing settings from the project's package.json.
- Added types for export formats and settings, including video and audio configurations.
- Implemented exportScene function to handle the export process and output results.
- Updated README.md to include documentation for the new export command.
- Updated the `EXCLUDED_PROPS` in `history.ts` to include 'timeline', ensuring proper state handling.
- Introduced `reportView` function in `controller.ts` to track timeline view changes, integrating it into the timeline update process.
- Modified `timeline.ts` to call `updateTimelineTransform` every draw pass, improving responsiveness to view changes.
- Added `timeline` property to `SceneProps` in `types.ts` to store the scene's timeline viewport state.
- Updated documentation to reflect the new `timeline` property and its implications for scene state management.
- Revised the `KeyframeProps` type definition to specify that `time` is source-local, meaning it refers to the source's first frame rather than the clip's start.
- Enhanced the `keyframes.md` documentation to reflect this change, providing clearer guidance on how keyframes relate to trimmed clips and playback rates.
- Added an example to illustrate the impact of `sourceIn` on keyframe timing, improving understanding for developers.
- Added support for boolean and select types in the @inspect annotation, allowing for more diverse variable configurations.
- Implemented UI controls for boolean toggles and select dropdowns in the inspector, improving user interaction.
- Updated the inspect plugin to validate options for select types and ensure proper initialization.
- Enhanced documentation to reflect the new variable types and their usage in the inspector.
- Introduced the `@inspect` annotation for top-level constants, allowing live editing through the inspector.
- Implemented the `VariablesSettings` component to manage and display `@inspect` variables in the sidebar.
- Enhanced the editor to handle variable edits, ensuring changes are reflected in the source code.
- Updated the history management to track variable changes, allowing for undo functionality.
- Added utility functions to manage `@inspect` entries within the project, ensuring consistent access across components.
- Modified the `capture` command to render single frames of a scene instead of a node, ensuring the output matches the export's encoding.
- Updated command descriptions and argument details to reflect the new functionality, including changes to the time reference and scene handling.
- Enhanced documentation for the `capture` command and related references to clarify usage and expected behavior.
- Improved error messages for invalid scene captures, guiding users to capture the correct scene id.
- Added a new channel `PROJECTS_FS_REAL_PATH` to resolve the real path of a given source, accommodating symbolic links.
- Updated the `listEntries` function to include a `link` property for entries that are symbolic links, improving asset management.
- Introduced the `realPathEntry` function to handle symlink resolution, ensuring accurate path retrieval.
- Enhanced the `removeEntry` function to prevent deletion of files outside the project directory, maintaining project integrity.
- Updated documentation to clarify symlink handling and the implications of linked assets in the project.
- Replaced references to GSAP with anime.js in the JSX documentation, ensuring consistency with the current animation framework.
- Updated code examples to reflect the new anime.js syntax and functionality, enhancing clarity for users transitioning from GSAP.
- Improved explanations regarding timeline creation and usage, emphasizing the benefits of using anime.js for frame-accurate animations.
- Updated the `listEntries` function in `projects.ts` to include support for symbolic links, ensuring they are treated as valid entries.
- Revised the `media.md` documentation to clarify the handling of symlinks in the asset library, emphasizing the benefits of linking over copying files.
- Improved the description of the `assets/` directory in `module.md` to reflect the inclusion of symlinks and their role in the asset management process.
- Introduced a new command `dapi check` to analyze a node's subtree for structural issues, including black frames, never-visible nodes, and source errors.
- Implemented types for check requests and results, detailing the structure of issues found during analysis.
- Added a new `check.ts` file to handle the logic for checking nodes, including coverage calculations and issue reporting.
- Updated the `README.md` and reference documentation to include usage instructions and details about the new command.
- Enhanced the CLI with a new command option for checking node integrity without rendering, providing instant feedback on potential issues in the project.
- Revised the description of the `assets/` directory in `projects.ts` to clarify its role in the library and the handling of media files.
- Expanded the `media.md` documentation to include instructions on adding assets to the library, detailing the process for importing files and managing image sequences.
- Updated the `README.md` to reflect changes in the `media.md` section, ensuring consistency in documentation across the project.
- Updated the `LayoutPanel` component to improve aspect ratio management by introducing a `lockedRatio` function, which determines the aspect ratio based on the current dimensions or authored values.
- Simplified the `resize` function to utilize the new `lockedRatio` for enforcing aspect ratios during resizing operations.
- Enhanced the `toggleAspectRatio` function to directly edit the `keepAspectRatio` property, streamlining the locking mechanism.
- Added documentation for the `keepAspectRatio` property in relevant types and reference materials, clarifying its purpose and usage in the editor.
- Updated the canvas creation in `createCapture` to ensure it remains within the viewport and utilizes `will-change:opacity` for better performance.
- Modified the `AnimeTimeline` component to use `opacity` for text dimming while clarifying the limitations of using fractional opacity on painted boxes in captures.
- Enhanced documentation in `html.md` to provide clearer guidance on the effects of nested opacity on rendering and captures.
- Updated the canvas creation in `createCapture` to ensure it remains within the viewport, preventing issues with cached paints and blank captures.
- Enhanced the `AnimeTimeline` component to use alpha colors instead of opacity for better rendering during animations, avoiding subtree blanking.
- Introduced a `WeakSet` in `render.ts` to track failed HTML roots, preventing console flooding by logging errors only once per root.
- Clarified documentation regarding nested opacity effects on captures to improve user understanding of rendering limitations.
- Updated all example files and relevant documentation to incorporate the `camera` property in the `<stage>` component, ensuring proper framing for various scene dimensions.
- Marked one scene as `active` in each example to prevent projects from opening on an empty timeline, enhancing usability and clarity in project structure.
- Adjusted the `StageProps` and `SceneProps` types to reflect the new requirements for camera and active properties, improving type safety and documentation accuracy.
- Introduced the `hold` method in the `useTicker` hook to manage async operations, ensuring frames wait for necessary resources before sampling.
- Updated example files to utilize the `hold` method for loading models and setting up WebGPU devices, improving frame accuracy during exports and captures.
- Added documentation for the `hold` method, detailing its purpose and usage in managing async work within the rendering pipeline.
- Implemented a timeout mechanism for held promises to prevent indefinite waits during rendering.
- Updated the CLI context command description to clarify the information reported, including the application root folder and project details.
- Modified the DAPI context handling to return both the projects root directory and the open project directory, improving the context information available when no project is open.
- Adjusted related documentation to reflect the new structure of the context report, ensuring consistency and clarity for users.
- Added support for the `syncTo` trait, allowing elements to align their playback based on the timing of another element's recording.
- Introduced `PendingSync` to manage in-progress sync requests and ensure proper correlation between audio and video sources.
- Enhanced the asset system to handle sync requests, including error handling for cycles and missing sources.
- Updated documentation to reflect the new `syncTo` functionality and its implications for element placement and playback management.
- Updated all example files to replace <rect> with <stage> and <scene> for improved structure and consistency.
- Enhanced the README.md to reflect the new project entry format for examples.
- Added a new dependency on "koota" in package.json for better integration.
- Improved documentation and comments throughout the examples for clarity.
- Updated the `AssetRef` type to only accept paths, simplifying asset reference management.
- Refactored media command descriptions to clarify that local files and URLs can be used without an open project, while library paths require one.
- Enhanced error handling in media commands to specify when paths cannot be resolved, improving user feedback.
- Removed the deprecated `ShellApi` component and integrated its functionality into the new `EditorApi` for better organization and clarity.
- Changed the `id` type in `CaptureRequest` from number to string to accommodate JSX element IDs.
- Refactored the `resolveNode` function to handle string IDs, improving error handling for ambiguous and non-existent nodes.
- Updated the `README.md` and `capture.md` to clarify the expected format for node IDs, including the use of `file:id` for disambiguation.
- Enhanced the `dapi capture` command documentation to reflect changes in ID handling and provide clearer usage instructions.
- Added the `dapi open` command to launch the app and open or create a project folder, with updates to the `README.md` and `projects.ts` for clarity.
- Implemented `initProject` function to initialize project folders, ensuring they can be opened from any location on disk.
- Updated the `main-channels.ts` and `main.ts` to handle new project initialization requests.
- Enhanced the database schema to support project root types, allowing for better project organization and retrieval.
- Improved the IPC layer to manage multiple routers for different command contexts, ensuring efficient command handling.
- Revised the `dapi context` command description in `README.md`, `index.ts`, and `projects.ts` to clarify its purpose in reporting the current project and playhead position.
- Enhanced the `handleContextGet` function to return detailed project information, including project ID, name, directory, and frame rate.
- Updated the API response structure in `context.ts` to reflect the new project context format, ensuring accurate data representation for users.
- Improved documentation in `context.md` and `README.md` to provide clearer guidance on the command's functionality and expected output.
- Revised the documentation in `projects.ts` to clarify that npm packages are treated as standard packages, allowing for direct installation and bundling from `node_modules`.
- Updated `module.md` to reflect changes in userland package resolution, emphasizing the need for browser compatibility and the removal of CDN fallback.
- Enhanced clarity on local imports and the handling of type declarations for userland packages, ensuring accurate guidance for developers.
- Introduced `useMediaSelection` to streamline the management of selected image and video nodes.
- Updated `ActionBar` to utilize the new media selection logic, simplifying the determination of media types.
- Refactored `PromptInputActions` to leverage `useMediaSelection`, enhancing clarity and reducing complexity in handling selected nodes.
- Removed obsolete functions related to media type determination, improving code maintainability.
- Added new constants for voice model and aspect ratio dimensions in `config.ts`, enhancing configurability for media generation.
- Added `nanoid` dependency for generating unique project IDs, ensuring stable identification across renames.
- Introduced `PROJECTS_RESOLVE` channel to resolve project references by ID or folder name, improving project retrieval.
- Updated project-related functions to utilize the new ID system, enhancing consistency in project management.
- Refactored project handling in various components to accommodate the new project structure, ensuring seamless integration with existing functionality.
- Adjusted routing to reflect project IDs in URLs, maintaining user experience during project renaming.
- Introduced `<adjustmentLayer>` element to the JSX framework, allowing for transformations on the clip below it without drawing its own content.
- Updated type definitions to include `AdjustmentLayerProps` for better type safety and documentation.
- Enhanced the reconciler to handle the new adjustment layer entity, ensuring proper integration within the document structure.
- Added comprehensive documentation for the adjustment layer, detailing its functionality and usage examples.
- Improved overall code organization and readability across affected components, setting the stage for future enhancements.
- Refactored `AppearanceSettings` to utilize new hooks from `@diffusionstudio/koota-solid`, improving state management for opacity, blend modes, visibility, and corner radii.
- Enhanced keyframe handling by integrating `syncKeyframe` and `removeKeyframeTrack` functions, ensuring smoother animations and property edits.
- Updated the `Keyframe` component to support new properties and improve interaction with the editor, enhancing user experience.
- Replaced `Keyframe` imports across various components to use the new `keyframe-bitecs` module, ensuring consistency in keyframe management.
- Documented changes in migration notes to reflect updates in appearance settings and keyframe functionality.
- Added support for asset manifests with read and write capabilities, allowing for better organization of project assets.
- Introduced new project channels for manifest reading and writing, enhancing communication between main and renderer processes.
- Improved file system interactions with new methods for listing, statting, and removing project files, streamlining asset management.
- Updated package dependencies to include `yaml` for manifest handling and linked `@diffusionstudio/assets` for asset management.
- Refactored existing code to integrate new asset handling features and improve overall project structure.
- Introduced `TextCase` type for controlling glyph casing during rendering, with options for original, upper, and lower case.
- Added `TextRange` as a sub-entity for `<text>`, allowing style overrides for specific runs of glyphs by character index.
- Updated `TextProps` to include new properties such as `letterSpacing`, `leading`, and `textCase`, enhancing text styling capabilities.
- Enhanced rendering logic to support the new `TextRange` functionality, ensuring proper application of styles and colors.
- Updated migration documentation to reflect the addition of text handling features, detailing their usage and integration within existing structures.
- Removed `PATCH_PROP_KEYS` and `PatchProps`, streamlining property management as the document structure no longer requires patching by prop name.
- Updated type definitions to introduce new internal prop groups (`IdentityProps`, `PositionProps`, `OffsetProps`, `SizeProps`, `TransformProps`, `TimingProps`, `SequenceItemProps`), enhancing clarity and organization of properties.
- Refactored animation and keyframe structures to utilize `<animation>` and `<keyframeTrack>` elements, ensuring consistent handling of animatable properties.
- Updated migration documentation to reflect the removal of obsolete structures and the introduction of new prop groups, detailing their usage in the context of animations and keyframes.
- Replaced references to `DocumentRoot` with `Stage` across the codebase, aligning with the new stage model.
- Updated entity management and hierarchy functions to reflect the transition from document-based to stage-based parenting.
- Adjusted comments and documentation to clarify the role of the stage in the entity structure.
- Enhanced queries and actions to utilize the new stage terminology, ensuring consistency throughout the runtime environment.
Eliminated the `compile-project.ts` and `open-folder.ts` files from the CLI, streamlining the codebase. Updated the README to reflect changes in CLI commands, including the removal of outdated examples. Adjusted the API to enhance clarity and maintainability by consolidating asset handling functions and removing unused types. This refactor improves the overall architecture and reduces complexity in the CLI interactions.
- Added detailed explanations for common issues related to blank or partial `<html>` content in captures, including stateful animations, scaling, and opacity handling.
- Updated example code to recommend using GSAP for timeline animations instead of anime.js, ensuring frame accuracy and proper timeline management.
- Clarified best practices for using CSS properties like `scale()` and `opacity` in JSX to prevent rendering issues.
Deleted the `09-html-scene.tsx` example file, which demonstrated an HTML scene as a mount root. Updated the README and related documentation to remove references to this example and clarified that only `<rect>` can be promoted to a scene. Adjusted descriptions in the JSX documentation to reflect this change.
Eliminated the `--open` option from the `dapi report` command, which previously opened the created issue in the default browser. Removed the `openInBrowser` function and updated related documentation to reflect these changes, streamlining the command's functionality and focusing on direct issue filing without browser interaction.
Updated the `dapi report` command to file GitHub issues directly using the `gh` CLI, removing the previous markdown report generation step. Enhanced the command's description and options in the README and reference documentation to clarify the immediate submission process and the requirement for `gh` authentication. Adjusted related code in the report handling to streamline issue creation and improve user experience.
Updated the `whenReady` method in the HtmlHost class to streamline the resolution of asynchronously loaded HTML resources. Replaced the previous image decoding handling with a more efficient promise management approach, ensuring that all images and fonts are ready before rendering updates. Adjusted related documentation to clarify the changes in resource readiness handling.
Implemented a new `whenReady` method in the HtmlHost class to ensure all images in its subtree are decoded before rendering updates. Updated the playback system to utilize this method for improved rendering reliability. Enhanced the WorldDocument class to manage image sources more effectively, including support for various input types and object URL management. Updated documentation to reflect changes in image handling and source resolution.
Updated the MediaFrameResult and NodeCaptureResult types to utilize a new TimecodedImage format, which includes timecodes for better clarity. Introduced options for combining frames into contact sheets and specifying frames per sheet, enhancing the output structure. Adjusted related functions and documentation to reflect these changes, improving user understanding of the output format and capabilities.
Updated the naming convention for output PNG files in both media frame and node capture functions to use a more descriptive timecode format (e.g., 00h00m01s15f.png). Introduced a new utility function, `timecodeFilename`, to handle the formatting. Adjusted related documentation to reflect these changes, enhancing clarity for users regarding the output file naming structure.
Updated the MediaFrameResult and related functions to replace the timestamp with a timecode string for better clarity. Adjusted the output structure in both media frame and node capture processes to include timecode, ensuring that captured images and frames are named accordingly. Enhanced documentation to reflect these changes, improving user understanding of the output format.
Introduced a new command `dapi report` that allows users to report bugs in the CLI or the app. This command generates a markdown report containing diagnostics, including the app's status and recent logs, and provides a prefilled GitHub issue URL. Updated the README and reference documentation to include details about the new command and its usage.
Revised the README to better describe Diffusion Studio's functionality, emphasizing the role of the `dapi` CLI and providing detailed prompt examples for video understanding, motion graphics, video editing, and clipping. Additionally, clarified the caching behavior of transcripts in the captions documentation by removing the optional seed parameter reference, ensuring accurate information for users.
Updated the audio generation functionality to include an optional `duration` parameter in the `GenerateAudioOptions` type. This change allows users to specify the duration for audio prompts, improving flexibility in audio generation. Additionally, validation was added to ensure the duration is a positive number. Updated related documentation to reflect this new option.